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 do Workday ao qual se conectar.
- As credenciais de autenticação de um usuário do sistema de integração criado no Workday.
Etapa 1: Obtenha 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.
Os exemplos incluem: Equipe para Get Workers, Gestão Financeira para Orçamento de Importação, Integrações para comandos relacionados ao EIB, .... - Clique no botão "Related Actions" (Ações relacionadas) desse serviço e, em seguida, clique em View WSDL no menu "Web Service" (Serviço da Web).
- No arquivo XML, localize o elemento
soapbind:address(geralmente próximo à parte inferior do arquivo). - Usando o URL do atributo
location, extraia as informações de locatário, host e domínio do URL.
O URL usa o seguinte formato:https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number
Exemplo
Usando o formato acima, podemos encontrar o locatário, o host e o domínio em um exemplo de URL WSDL:https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1
| Propriedade | Valor da amostra |
|---|---|
| inquilino | minha empresa |
| Anfitrião | wd2-impl-services1 |
| Domínio | workday.com |
Você precisará desses valores ao configurar o conector na próxima etapa.
Etapa 2: Configurar a autenticação do Workday
Esse conector oferece duas formas de autenticação: OAuth2 via API e Usuário + Senha.
Autenticação da API OAuth2
Se estiver usando a autenticação de API OAuth2, você deve ter um cliente de API configurado no Workday. Consulte a página de suporte do Workday Registrar clientes de API para obter instruções sobre como criar um cliente de API.
Como parte da configuração do cliente da API, certifique-se de que você tenha:
- Selecionado Bearer como o tipo de token de acesso .
- Ativou (marcou) as seguintes caixas de seleção:
- Tokens de atualização que não expiram
- Incluir escopo próprio do Workday
URLs de redirecionamento
A Workiva tem URLs de substituição de conexão específicos da região para configurações de conector. Use a tabela a seguir para selecionar o URL correto para seu local.
Se você estiver na América do Norte, Central ou do Sul, use o URL padrão. Se você estiver na região da Ásia-Pacífico, use o URL APAC. Se você estiver na região EMEA, use o URL da UE.
| Ambiente | URL de redirecionamento |
|---|---|
| Produtos APAC | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| Prod. da UE | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| Prod. dos EUA | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
Pontos de extremidade OAuth2
Se estiver usando o OAuth2 para verificar sua conexão, você precisará ter os seguintes valores de endpoint. Eles serão listados quando você configurar o cliente da API do Workday na página Edit API Client no Workday.
| Ponto final | Valor da amostra |
|---|---|
| Ponto de extremidade REST do Workday | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Ponto de extremidade do token OAuth2 do Workday | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Ponto de extremidade de autorização Workday OAuth2 | https://xxxx.workday.com/xxxx/authorize |
DICA: Se você estiver usando uma instância de cliente de API existente que usa um token e um segredo OAuth2, poderá ver essas informações na parte superior da página Workday View API.
Autenticação básica
Se estiver usando Basic Authentication, consulte a página de suporte do Workday Create an Integration System User (ISU) account in Workday para obter instruções sobre como criar um Integration System User (ISU).
Etapa 3: Configurar o conector do Workday
Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um Administrador de Segurança da Organização deve primeiro habilitá-lo em Configuration.
- Em Chain Builder, clique em Connections e, em seguida, Create no canto superior direito.
- Em Connector Connection, selecione Workday Connector 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 estiver usando o OAuth2, será necessário inserir os valores para Workday REST Endpoint, Workday OAuth2 Token Endpoint e Workday OAuth2 Authorization Endpoint.
Se estiver usando a autenticação básica (nome de usuário + senha), deixe-os 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. No URL do ambiente, os caracteres antes da propriedade Domain representam o host. Domínio O domínio do ambiente do Workday ao qual se conectar,
, comoworkday.comoumyworkday.com.Ponto de extremidade REST do Workday O URL do ponto de extremidade REST fornecido pelo Workday.
(Somente se estiver usando a autenticação OAuth2)Ponto de extremidade do token OAuth2 do Workday O URL do ponto de extremidade do token OAuth2 fornecido pelo Workday.
(Somente se estiver usando a autenticação OAuth2)Ponto de extremidade de autorização Workday OAuth2 O URL do ponto de extremidade OAuth2 fornecido pelo 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 tem as permissões adequadas para acessar os grupos funcionais e os domínios relacionados aos comandos da conexão.
- Verifique se o locatário, 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.