Ir para o conteúdo principal
Documentação
Documentação
Peakon
Última atualização: 2024-09-06
Baixar PDF
Conecte-se ao Workday usando OAuth

Conecte-se ao Workday usando OAuth

No Workday, crie estes itens de integração:
  • Domínio
    de Segurança de Integração
     na área funcional de Integração.
  • Usuário do sistema de integração.
  • Grupo de segurança do sistema de integração.
Segurança: Acesso de administrador no Peakon.
Você pode conectar o Peakon ao Workday e autenticar os dados transferidos usando o OAuth.
Recomendamos que você Conecte-se ao Workday usando o nome e a senha da ISU, que é mais fácil de configurar e menos sujeito a desconexões devido a fatores externos.
  1. No Workday, acesse a tarefa
    Editar configuração do locatário – Segurança
     .
  2. Marque a caixa de seleção
    Clientes OAuth 2.0 habilitados
     .
  3. Ainda no Workday, acesse a tarefa
    Registrar cliente da API
     .
  4. Digite o
    Nome do Cliente
     e selecione
    Concessão do Código de Autorização
    .
  5. Selecione
    Portador
     como o
    Tipo de Token de Acesso
     e insira o
    URL de Redirecionamento
    .
    O formato do URL de redirecionamento é
    https://companyname.peakon.com/workday/complete
    . Você deve substituir
    companyname.peakon.com
     pelo seu subdomínio personalizado.
  6. Marque a caixa de seleção
    Tokens de atualização que não expiram
     .
  7. Selecione estas áreas funcionais no prompt
    Escopo (Áreas Funcionais)
     :
    • Informações de contato
    • Implementação
    • Dados Pessoais
    • Dados Públicos
    • Pessoal
    • Sistema
  8. Clique em
    OK
    .
  9. Colete os valores de
    Tenant
    ,
    Webservice Host
    ,
    Client ID
    ,
    Client Secret
    e
    Auth Host
     .
    O
    Workday REST API Endpoint
     contém o
    Webservice Host
     e o
    Tenant
    . Exemplo: quando o ponto de extremidade é
    https://wd3-services1.myworkday.com/api/v1/tenant_name
    , o
    host do Webservice
     é
    wd3-services1.myworkday.com
     e o
    locatário
     é
    tenant_name
    .
    O
    ponto de extremidade de autorização
     contém o
    host de autenticação
    . Exemplo: quando o ponto de extremidade de autorização é
    https://wd3.myworkday.com/tenant_name/authorize
    , o
    Host de autenticação
     é
    wd3.myworkday.com
    .
    O Workday rotula
    o ID do cliente
     e
    o segredo do cliente
    adequadamente.
    Anote o valor
    do Segredo do Cliente
     , pois não é possível recuperá-lo após fechar esta página. É necessário em caso de desconexão.
  10. Abra o Peakon em uma janela anônima para fazer login como um usuário do sistema de integração Peakon (ISU).
    Quando sua empresa usa o SSO para fazer login nos seus locatários do Workday, use este modelo de URL para fazer login no Workday como o ISU Peakon: (https://<workdayDomain>/wday/authgwy/<tenant>/login.htmld?redirect=n). <workdayDomain> é o domínio do seu locatário do Workday e <tenant> é o nome do seu locatário do Workday.
    Fazer login por meio de uma janela anônima garante que a integração não se conecte com as credenciais erradas para o locatário do Workday, o que causaria problemas de sincronização.
  11. No Peakon, acesse
    Administração
    Integrações
    Workday
    .
  12. Selecione
    OAuth
     no prompt
    do modo de autenticação
     .
  13. Insira os valores da Etapa 9 nestes campos:
    • Locatário
    • Host de serviço da Web
    • ID do cliente
    • Segredo do cliente
    • Host de autenticação
  14. Clique em
    Conectar
    .
    A sincronização agora está ativa e será executada automaticamente. Se você precisar evitar que isso aconteça e ainda poder continuar a configuração na Etapa 17, clique em
    Desativar
    .
  15. (Opcional) Na página de login, faça login como ISU.
  16. Clique em
    Permitir
    .
  17. Configure as definições que agora são exibidas na página de integração do Workday no Peakon.
    Algumas das opções exigem acesso de segurança de domínio adicional. Ver Configurar domínios no grupo de segurança para integração do Workday.
    Opção
    Descrição
    ID do sistema de integração
    (Opcional) Preencha este campo se precisar criar substituições de campo para transferir campos personalizados ou usar a funcionalidade
    PEAKON_INCLUDED
     .
    ID da organização
    (Opcional) Preencha este campo para filtrar por funcionários por organização. Para sincronizar funcionários em várias organizações, separe os IDs da organização por um único espaço.
    Recomendamos usar isso em vez da funcionalidade
    PEAKON_INCLUDED
     ao filtrar por organizações, porque:
    • Configurar a funcionalidade
      PEAKON_INCLUDED
       de uma forma que espelhe o campo
      ID da organização
       é difícil de ser feito corretamente e, portanto, a sincronização pode não fornecer o resultado desejado.
    • Ele funciona mais rápido que a funcionalidade
      PEAKON_INCLUDED
       .
    Fuso horário
    (Opcional) Selecione esta opção para sincronizar os fusos horários locais dos funcionários. A Peakon enviará uma pesquisa aos funcionários em seu fuso horário local.
    Localidade
    (Opcional) Selecione esta opção para sincronizar os idiomas locais dos funcionários. A Peakon usará os idiomas sincronizados nas comunicações da pesquisa com funcionários, se esses idiomas estiverem habilitados nas configurações de pesquisa da sua organização.
    Número de telefone
    (Opcional) Selecione esta opção para revelar as opções de sincronização do número de telefone dos funcionários.
    • Comercial
    • Residencial
    • Sincronizar números privados
    Sincronizar números de telefone é útil se você quiser enviar notificações de pesquisas via SMS.
    Quando você seleciona números de
    telefone comercial
     e
    residencial
     , o número de telefone
    comercial principal
     tem precedência.
    Incluir funcionários específicos - Com base em critérios personalizados definidos no Workday
    (Opcional) Selecione esta opção para sincronizar apenas determinados grupos de funcionários.
    Além de habilitar esta caixa de seleção, crie uma entrada de substituição de campo
    PEAKON_INCLUDED
     no
    Field Override Service
    . A substituição de origem deve ser um campo calculado booleano que retorne
    Verdadeiro
     para funcionários que você deseja incluir.
    Incluir funcionários específicos - Trabalhadores temporários
    (Opcional) Selecione esta opção para incluir também trabalhadores temporários.
    Mapa por ID externo (somente se os dados não contiverem segmentos duplicados)
    (Opcional) Selecione esta opção para corresponder IDs externas com segmentos ao mapear atributos do Workday para o Peakon.
    Esse recurso permite que você use mapeamento de atributos mais avançado quando não houver segmentos duplicados.
    O Workday mapeia os IDs externos do segmento desses atributos para o Peakon:
    • Departamento
    • Tipo de emprego
    • Gênero
    • Família de empregos
    • Nível de Gestão
    • Motivo da Separação
    O Workday não mapeia o ID externo quando há uma substituição de campo para o atributo.
    O Workday não cria um novo segmento no Peakon quando o nome de um segmento muda no Workday. Exemplo: quando, no Workday, você altera o nome do segmento
    Região EMEA de Benefícios
     para
    Benefícios Globais
    , o Peakon atualiza automaticamente o nome do segmento
    Região EMEA de Benefícios
     existente para
    Benefícios Globais
    .
    Quando os segmentos contêm nomes duplicados, o Peakon não sincroniza o segmento para os funcionários afetados e, em vez disso, exibe uma mensagem de erro
Execute uma sincronização completa clicando em
Sincronizar tudo
 em
Administração
Integrações
Workday
. Após a conclusão, execute a sincronização completa novamente para coletar quaisquer relacionamentos de trabalho restantes que possam ter sido perdidos na primeira vez. Exemplo: o gerente de um funcionário não pode ser preenchido no Peakon se a sincronização ainda não tiver criado o gerente quando sincronizar o funcionário.
Após a sincronização completa inicial, o Peakon sincronizará quaisquer alterações futuras incrementalmente a cada hora. No entanto, é possível iniciar uma sincronização completa manualmente.
Você pode usar o botão
Exportar para CSV
 em auditorias de integração para exportar os últimos 5.000 registros de logs de auditoria de eventos de integração no formato CSV.