Centro de suporte da Workiva

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 .

1. Ingressado em "Public Web Services" na barra de pesquisa do Workday, você pode selecionar esse relatório.
2. 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, ....
3. 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).
4. No arquivo XML, localize o elemento soapbind:address (geralmente próximo à parte inferior do arquivo).
5. 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

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. 

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.

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.

1. Em Chain Builder, clique em Connectionscompare_arrows e, em seguida, Create no canto superior direito.
2. Em Connector Connection, selecione Workday Connector e o CloudRunner padrão.
   
3. Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
   

4. 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, , como workday.com ou myworkday.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.