Conector Workday no Jitterbit Studio

Resumo

O conector Workday estabelece acesso ao Workday.

O conector Workday fornece uma interface para criar uma conexão Workday, a base usada para gerar instâncias de atividades Workday. Essas atividades, uma vez configuradas, interagem com o Workday através da conexão.

O conector Workday é acessado a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Dica

Integration recipes e process templates estão disponíveis para este conector através do Jitterbit Marketplace.

Visão geral do conector

Este conector é usado primeiro para configurar uma conexão Workday, estabelecendo acesso a uma conta no servidor Workday, e depois para configurar uma ou mais atividades Workday associadas a essa conexão como origem ou destino dentro de uma operação.

As operações na API Workday Web Services (WWS) versões 32.0 até 45.1 são categorizadas nestas atividades:

Add
Adjust
Assign
Cancel
Change
Close
Contract
Create
Edit
Enter
Get
Import
Manage
Put
Remove
Request
Set
Submit
Other

As operações de cada serviço web são categorizadas sob essas atividades com base no token inicial da operação. Exemplos:

A operação Add_Additional_Job do serviço web Staffing está na atividade Add.
A operação Put_Carryover_Override do serviço web Absence_Management está na atividade Put.

Operações que não são cobertas pela categorização acima (operações cujo token inicial não está listado acima), como as operações Start_International_Assignment ou Switch_Primary_Job do serviço web Staffing, estão disponíveis na atividade Other.

Atividades

Nesta documentação, apenas uma atividade Workday genérica é documentada, pois cada atividade tem um design similar.

Workday activity: Uma atividade Workday recupera dados de e/ou envia dados para um serviço web Workday selecionado e é usada como origem ou destino em uma operação.

Juntos, uma conexão Workday específica e suas atividades são referidas como um endpoint Workday. Uma vez que uma conexão é configurada, as atividades associadas ao endpoint estão disponíveis no filtro Endpoints:

Connections tab

Os endpoints criados com este conector são incluídos em endpoint usage reporting e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política de organização Disable Auto Connector Update.

Para se conectar ao servidor Workday, entre em contato com o administrador do Workday para obter as credenciais necessárias:

Host do Workday (será uma URL como https://example.workday.com/)
Tenant do Workday
Nome de usuário do Workday
Senha do Workday

Este conector suporta autenticação OAuth 2.0 de 2 pernas. Consulte Pré-requisitos do Workday OAuth para obter instruções sobre como configurar a instância do Workday.

O conector Workday usa a API de serviços web do Workday (wws) com versões WSDL 32.0 até 45.1, dependendo da versão selecionada em uma conexão Workday. Consulte a documentação da API para obter informações sobre os campos de esquema.

Limitações

Algumas versões do WSDL do Workday, embora suportadas por uma conexão Workday, retornam erros ao tentar buscar dados de determinados serviços. Estes estão listados abaixo:

Versão WSDL do Workday	Serviço indisponível
v42.0	Human_Resources (v42.0) Resource_Management (v42.0)
v42.1	Human_Resources (v42.1)

A impossibilidade de buscar dados para esses serviços é devido a um problema na definição WSDL fornecida pelo Workday. Se você precisar usar esses serviços, a recomendação da Jitterbit é usar uma versão WSDL do Workday anterior à v42.0 ou posterior à v42.1, onde o problema não existe. As versões 32.0 até 45.1 são suportadas.

Solução de problemas

Se você tiver problemas com o conector Workday, recomenda-se seguir estas etapas de solução de problemas:

Clique no botão Test na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política de organização Disable Auto Connector Update).
Verifique os logs de operação para obter informações registradas durante a execução da operação.
Ative o log de depuração de operação (para agentes na nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.
Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:
```
<logger name="org.jitterbit.connector.workday" level="DEBUG"/>
```
Para obter mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.
Se estiver usando agentes privados, você pode consultar os logs do agente para obter mais informações.
Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.
Para problemas e resoluções específicos do conector Workday, consulte o guia Solução de problemas do conector:
- Workday: WSDL v42.0 e v42.1 retornam erros para serviços específicos
- Workday: Teste de conexão falha com "A tarefa enviada não está autorizada"

Recursos adicionais

Um tutorial de microaprendizado Jitterbit para Workday para FTP está disponível através da nossa série de vídeos de conceitos básicos do Jitterbit, criada pela Jitterbit University.