Centro de suporte da Workiva

Anteriormente conhecido como Adaptive Insights, o conector Workday Adaptive Planning usa comandos em uma cadeia para importar ou exportar dados ou metadados.

Nota: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Requisitos

Para ativar a conexão, o conector usa a API REST do Workday Adaptive Planning. Para configurar o conector, você precisará de:

• Um usuário de integração configurado no Adaptive Planning a quem foi atribuída uma função com as permissões adequadas para executar os comandos do conector.
• O nome de usuário e a senha do usuário de integração.
• Se o usuário da integração puder acessar várias instâncias do Adaptive Planning, o código da instância ao qual ele se conectará.

  Observação: Para determinar os códigos de instância disponíveis do usuário de integração, você pode usar o ponto de extremidade da API do Adaptive Planning exportInstances.

Configurar o conector do Workday Adaptive Planning

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. Em Construtor de Cadeias, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Conector Conexão, selecione Workday Adaptive Planning e o CloudRunner padrão.
   

A Workiva oferece dois métodos de autenticação (Basic e JWT Bearer Grant (Workday Credentials)). Você pode selecionar o método que deseja usar em Credentials na configuração da conexão.

Autenticar com autenticação básica

1. Em Propriedades, insira opcionalmente o código da instância do Adaptive Planning.
2. Selecione "Basic Credential" (Credencial básica) como o tipo de autenticação.
3. Insira os seguintes valores:
   Username: O nome de usuário do usuário de integração a ser usado com o conector.
   Senha: A senha do usuário fornecida no campo Nome de usuário.

Você autentique com uma concessão de portador JWT (credenciais do Workday)

Este método de autenticação usa as credenciais do Workday para autenticar com o Planejamento adaptativo e requer que:

• O SSO esteja ativado.
• As configurações do locatário do Workday para o logon de usuário do Adaptive Planning e as APIs públicas ativadas estão ativadas.
• Uma ISU de API pública é mapeada entre o Workday e o Adaptive Planning.

Para obter detalhes específicos sobre essa configuração, consulte a seguinte documentação do Workday:

• Definir SSO SAML no Adaptive Planning para usuários sincronizados
• Solução de problemas: Sincronização do usuário com o Adaptive Planning

Como parte dessa configuração, uma chave privada x509 deve ser carregada na parte Connection Resources dessa conexão, e um certificado público criado por essa chave deve ser carregado no Workday e associado a um cliente de API do tipo "JWT Bearer Grant". Esse cliente, por sua vez, deve ser associado à ISU que você está usando para solicitações ao Adaptive Planning, com credenciais mapeadas entre os dois sistemas.

Para obter detalhes específicos sobre essa configuração, faça referência à seguinte documentação do Workday: Registrar clientes de API.

Detalhes da chave

Você pode criar uma nova chave usando o openssl com o seguinte comando: O formato de chave privada compatível é o PKCS#8 e pode ser protegido ou não por senha. Uma nova chave pode ser criada usando o openssl com o seguinte comando:

openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650

Determinando o host, o domínio e o locatário do Workday

Usando o ponto de extremidade da API REST do Workday listado no cliente da API, identifique o host, o domínio e o locatário, que segue o formato https://{host}.{domain}/ccx/api/v1/{tenant}

Exemplo

https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany

Definir o tipo de credenciais do portador no conector do Adaptive Planning

1. Carregue sua chave privada na parte de Recursos da conexão.
   
2. Selecione o tipo de autenticação "Bearer".
   
3. Insira as seguintes informações:

   Propriedade	Detalhes
   Chave privada x509	Insira o nome da chave privada carregada exatamente como mostrado em recursos de conexão.
   Senha	Insira a senha da chave privada. Deixe esse campo em branco se a chave não estiver protegida por senha.
   ID do cliente	Insira o ID do cliente da API de concessão do portador do JWT.
   Usuário do serviço de integração	Insira o nome do usuário do serviço de integração (ISU) associado ao cliente da API
   Anfitrião	Digite 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.
   inquilino	Digite o locatário do Workday ao qual você deve se conectar.
   Domínio	Insira o domínio do ambiente do Workday ao qual você deseja se conectar, como workday.com ou myworkday.com.

Depois que você tiver definido a autenticação:

1. Selecione os ambientes para usar a conexão e clique em Salvar.
2. Para testar a conexão, crie e execute uma cadeia com o comando Export Versions do conector e verifique se ele retorna uma saída válida.

Solução de problemas

Se a conexão com o Workday Adaptive Planning falhar:

• Verifique as credenciais de autenticação do usuário de integração.
• Certifique-se de que a função do usuário de integração tenha as permissões adequadas para os comandos que o conector executa.
• Se o usuário da integração puder acessar várias instâncias do Adaptive Planning, verifique o código de instância inserido para o conector.

Para obter informações adicionais sobre como fazer solicitações da API do Adaptive Planning usando credenciais do Workday, consulte esta página do Workday: Fazer solicitações de API do Adaptive Planning com credenciais do Workday.