Nota: Esse conector desenvolvido pela Workiva permite que você conecte as plataformas Workiva e Workday. O Workiva Support terá prazer em orientar você na configuração do conector em seu espaço de trabalho|workspace. No entanto, qualquer erro ou solução de problemas na plataforma Workday deve ser tratado pelo administrador do Workday ou pela equipe de suporte.
Com o conector do Workday, você pode usar os comandos em uma cadeia para interagir com o Workday® HR and Financials para:
- Baixar relatórios personalizados do Workday
- Importar dados orçamentários para o Workday
- Iniciar uma integração do Workday Enterprise Interface Builder (EIB)
Requisitos
Para configurar a conexão, você precisará de:
- O locatário do Workday ao qual você deve se conectar.
- O host e o domínio do ambiente Workday ao qual se conectar.
- As credenciais de autenticação de um usuário do sistema de integração criado no Workday.
Etapa 1: Obter as informações do locatário do Workday
Você pode determinar as informações do locatário, do host e do domínio a partir do arquivo XML WSDL do serviço público da Web do Workday .
- Ingressado em "Public Web Services" na barra de pesquisa do Workday, você pode selecionar esse relatório.
- Localize o Web Service para a integração específica que você está usando.
Entre os exemplos estão: alocação de pessoal para o Get Workers, gestão financeira para o Import Budget, integrações para comandos relacionados ao EIB,…. - Clique no botão “Ações relacionadas” desse serviço e, em seguida, clique em “ ” (Exibir WSDL) no menu “Serviço da Web”.
- No arquivo XML, localize o elemento
soapbind:address(geralmente próximo à parte inferior do arquivo). - Usando a URL do atributo do local
, extraia as informações de locatário, host e domínio da URL.
A URL segue o seguinte formato:https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number
Exemplo
Usando o formato acima, podemos identificar o locatário, o host e o domínio a partir de uma URL WSDL de exemplo:https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1
| Propriedade | Valor de amostra |
|---|---|
| inquilino | minha empresa |
| Anfitrião | wd2-impl-services1 |
| Domínio | workday.com |
Você precisará desses valores ao configurar seu conector na próxima etapa.
Etapa 2: Configurar a autenticação do Workday
Este conector oferece duas formas de autenticação: OAuth2 via API e nome de usuário + senha.
Autenticação via API OAuth2
Se você estiver usando a autenticação por API OAuth2 do , é necessário ter um cliente de API configurado no Workday. Consulte a página de suporte do Workday e a página “Registrar clientes de API” para obter instruções sobre como criar um cliente de API.
Como parte dessa configuração do cliente da API, certifique-se de que você tenha:
- Selecione “ ” como “Bearer” e “ ” como “Access Token Type”.
- Marquei as seguintes caixas de seleção:
- Tokens de atualização sem prazo de validade
- Incluir o escopo de propriedade da Workday
URLs de redirecionamento
A Workiva disponibiliza URLs de substituição de conexão específicas para cada região para as configurações dos conectores. Use a tabela a seguir para selecionar a URL correta para a sua localidade.
| Ambiente | URI de redirecionamento |
|---|---|
| Produtos da APAC (região da Ásia-Pacífico) | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| Produto da CA (Canadá) | https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback |
| Produto da UE (EMEA) | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| Produção dos EUA (EUA, América Central, América do Sul) | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
Pontos de extremidade OAuth2
Se você estiver usando o OAuth2 para verificar sua conexão, precisará ter os seguintes valores de endpoint. Essas informações serão exibidas quando você configurar o Cliente da API do Workday na página “ ” (Editar Cliente da API) no Workday.
| Ponto final | Valor de amostra |
|---|---|
| Ponto de extremidade REST do Workday | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Endpoint do token OAuth2 do Workday | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Ponto de conexão de autorização OAuth2 do Workday | https://xxxx.workday.com/xxxx/authorize |
DICA: Se você estiver usando uma instância de cliente de API existente que utilize um token e um segredo OAuth2, poderá consultar essas informações na parte superior da página “ ” do Workday, em “View API”.
Autenticação básica
Se você estiver usando a autenticação básica d , consulte a página de suporte do WorkdayCriar uma conta de usuário do sistema de integração (ISU) no Workday para obter instruções sobre como criar um usuário do sistema de integração (ISU).
Etapa 3: Configurar o conector do Workday
Observação: Para disponibilizar o conector para uso nas cadeias da sua organização, um administrador de segurança da organização deve primeiro habilitá-lo a partir de Configuração.
- No site , na seção “Chain Builder” (), clique em “ ” (Connections) () e, em seguida, em “ ” (Create) ( ) no canto superior direito.
- Em “ ” (Conectores do Workday), na seção “Connection” (Conexão), selecione “ ” (Conector do Workday) e o CloudRunner padrão.
- Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
-
Em Propriedades, insira os detalhes da conexão.
Se você estiver usando o OAuth2, precisará inserir os valores para (Ponto de conexão REST do Workday), (Ponto de conexão de token OAuth2 do Workday) e (Ponto de conexão de autorização OAuth2 do Workday).
Se você estiver usando a autenticação básica do (nome de usuário + senha), deixe esses campos em branco.Campo Conteúdo inquilino O locatário do Workday ao qual você deve se conectar. Anfitrião O host do ambiente do Workday ao qual você deve se conectar. Na URL do ambiente, os caracteres que precedem a propriedade do domínio representam o host. Domínio O domínio do ambiente do Workday ao qual se conectar,
, comoworkday.com,oumyworkday.com,.Ponto de extremidade REST do Workday A URL do endpoint REST fornecida pela Workday.
(Somente se estiver usando a autenticação OAuth2.)Endpoint do token OAuth2 do Workday A URL do endpoint do token OAuth2 fornecida pela Workday.
(Somente se estiver usando a autenticação OAuth2.)Ponto de conexão de autorização OAuth2 do Workday A URL do endpoint OAuth2 fornecida pela Workday.
(Somente se estiver usando a autenticação OAuth2.)
Solução de problemas
Se a conexão com o Workday falhar:
- Verifique se as credenciais de autenticação do usuário do sistema de integração estão corretas.
- Verifique se o usuário do sistema de integração possui as permissões adequadas para acessar os grupos funcionais e domínios relacionados aos comandos da conexão.
- Verifique se o tenant, o host e o domínio corretos do Workday foram inseridos para o conector.
- Ao executar o comando Download de relatório personalizado, certifique-se de que o tipo de relatório esteja definido como Advanced. No momento, os relatórios compostos não estão disponíveis por meio da API do Workday.