Conceito: relatórios como serviço (RaaS)
Introduction to RaaS
You can enable advanced and search reports as web services. Workday Web Services
enable access to report results through URLs, which you can use in:
- Custom Workday Extend applications.
- Integrations between Workday and external business services. Example: Payroll or benefits providers.
- External reporting tools to access Workday data. Example: Microsoft Excel.
Output options for web services include:
- CSV
- GData
- JSON
- RSS
- Simple XML
- Workday XML
Before enabling a standard report as a web service, consider copying the standard
report to a custom report. To avoid any disruption to your integration processes if
Workday updates a standard report, enable the custom report as a web service
instead.
GET RaaS requests fail if you enable a custom report as a web service and the
username of the report owner contains a backslash (\) character.
Namespaces RaaS
Quando você habilita um relatório personalizado como serviço Web, o Workday gera um namespace RaaS exclusivo para o relatório, usando este formato:
urn:com.workday.report/
Report_Name
Para minimizar as interrupções nas integrações que usam a saída do relatório, o namespace RaaS não é alterado quando o nome ou o proprietário do relatório é alterado.
Você pode editar o namespace de um relatório personalizado. No entanto, considere:
- O Workday não verifica se um namespace RaaS é exclusivo.
- Se uma integração usa o relatório como um serviço Web, você deve atualizá-lo com o novo namespace.
Tipos de saída de serviço Web
Tipo de saída | Descrição |
|---|---|
CSV | Você pode usar a opção de saída CSV quando quiser importar dados para uma planilha da forma mais simples e rápida possível. Você não precisa conhecer XML ou esquemas.
Se você gera dados em um arquivo CSV que usa a codificação UTF-8, anexe este parâmetro de consulta ao URL do serviço Web: &bom=true Esse parâmetro garante que outros aplicativos, como o Microsoft Excel, possam interpretar corretamente a codificação e exibir os caracteres no arquivo CSV. Para relatórios avançados com cabeçalhos de coluna de grupo , a saída do CSV não retém os agrupamentos de colunas ou os cabeçalhos do grupo de colunas.As colunas na saída do CSV podem não corresponder à ordem das colunas na definição do relatório. |
GData | Você pode usar a saída de GData para integrações com os dispositivos Google. |
JSON | Você pode usar a opção de saída JSON em integrações de sistema para sistema que exigem o formato JSON. |
RSS | Você pode habilitar qualquer relatório personalizado avançado como um serviço Web RSS, que os usuários podem assinar como um feed RSS. Os usuários podem monitorar as atualizações em um locatário por meio de um feed RSS sem se conectar ao Workday. |
XML simples | O XML simples simplifica o Workday XML para que outros aplicativos de computador possam processá-lo. Alterações simples no XML:
Você pode usar XML simples para integrações básicas de computador com outras ferramentas de relatório, como o Microsoft Excel ou oCristal Reports. A opção de saída XML simples fornece estes URLs:
|
XML do Workday | A opção XML do Workday gera o código XML literal do Workday. Essa opção pode ser útil em integrações com base em REST ou SOAP. O Workday XML pode ser muito complexo para algumas necessidades de integração. Exemplo: criar rapidamente um relatório atualizável com o Microsoft Excel. Nesses casos, XML simples pode ser mais apropriado.
A opção de saída XML do Workday disponibiliza três URLs:
|