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 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 .

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.
   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,….
3. Clique no botão “Ações relacionadas” desse serviço e, em seguida, clique em “ ” e selecione “Exibir WSDL” no menu “Serviço da Web”.
4. No arquivo XML, localize o elemento soapbind:address (geralmente próximo à parte inferior do arquivo).
5. Usando a URL do atributo do endereço , 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 de WSDL de exemplo:
https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1

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 via API OAuth2 d , é 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:

• Selecionei “ ” como “Bearer” e “ ” como “Tipo de token de acesso” .
• 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 localização.

Pontos de extremidade OAuth2

Se você estiver usando o OAuth2 para verificar sua conexão, precisará ter os seguintes valores de endpoint. Essas opções serão exibidas quando você configurar o Cliente da API do Workday na página “ ” (Editar Cliente da API) no Workday.

DICA: Se você estiver usando uma instância de cliente de API existente que utilize um token e um segredo OAuth2, é possível visualizar essas informações na parte superior da página “ ” do Workday: .

Autenticação básica 

Se você estiver usando a autenticação básica d , consulte a página de suporte do Workday Crie 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 na Configuração .

1. No site , na seção “Chain Builder” ( ), clique em “ ” (Connections) ( ) compare_arrows e, em seguida, em “ ” (Create) ( ) no canto superior direito.
2. Em “ ” (Conectores do Workday) “Connection” (Conexão) , selecione “ ” (Conector do Workday) e o CloudRunner padrão.
   
3. Em Informações básicas, insira um nome e uma descrição únicos para ajudar a identificar a conexão.
   

4. Em Propriedades, insira os detalhes da conexão.
   Se você estiver usando o OAuth2, será necessário inserir os valores para (Ponto de conexão REST do Workday) , (Ponto de conexão de tokens 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 “ Domain ” representam o host.
   Domínio	O domínio do ambiente do Workday ao qual se conectar, , como, por exemplo, workday.com, ou myworkday.com, .
   Ponto de conexão REST do Workday	A URL do endpoint REST fornecida pela Workday. (Apenas se estiver usando a autenticação OAuth2.)
   Endpoint do token OAuth2 do Workday	A URL do endpoint do token OAuth2 fornecida pela Workday. (Apenas 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.)

Notas

O Workday impõe um limite de 2 GB (ou 3 milhões de registros) para exportações do RaaS.

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.