Ir para o conteúdo principal
Peakon
Última atualização: 2025-05-16
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 da 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 seu nome de usuário e senha da ISU., que é mais fácil de configurar e menos suscetível a desconexões devido a fatores externos.
  1. No Workday, acesse a tarefa
    Editar Configuração do Locatário – Segurança
    .
  2. Selecione a caixa de seleção
    "Clientes OAuth 2.0 ativados"
    .
  3. Ainda no Workday, acesse a tarefa
    "Registrar cliente da API"
    .
  4. Insira o
    nome do cliente
    e selecione
    Conceder código de autorização
    .
  5. Selecione
    "Bearer"
    como o
    tipo de token de acesso
    e insira o
    URL de redirecionamento
    .
    O formato da URL de redirecionamento é
    https://companyname.peakon.com/workday/complete
    . Você deve substituir
    companyname.peakon.com
    pelo seu subdomínio personalizado.
  6. Selecione a caixa de seleção
    Tokens de atualização que não expiram
    .
  7. Selecione estas áreas funcionais no
    campo Escopo (Áreas Funcionais)
    :
    • Informações de contato
    • Implementação
    • Dados pessoais
    • Dados públicos
    • Contratação de pessoal
    • Sistema
  8. Clique em
    OK
    .
  9. Colete os valores de
    Tenant (Inquilino)
    ,
    Webservice Host (Host do Serviço Web)
    ,
    Client ID (ID do Cliente)
    ,
    Client Secret (Segredo do Cliente
    ) e
    Auth Host (Host de Autenticação
    ).
    O
    endpoint da API REST do Workday
    contém o
    host do serviço web
    e o
    locatário
    . Exemplo: Quando o endpoint é
    https://wd3-services1.myworkday.com/api/v1/tenant_name
    , então o
    host do serviço web
    é
    wd3-services1.myworkday.com
    e o
    locatário
    é
    tenant_name
    .
    O
    endpoint de autorização
    contém o
    host de autenticação
    . Exemplo: Quando o endpoint de autorização é
    https://wd3.myworkday.com/tenant_name/authorize
    , o
    host de autenticação
    é
    wd3.myworkday.com
    .
    A Workday rotula
    o ID do Cliente
    e
    o Segredo do Cliente
    de acordo com suas respectivas atribuições.
    Anote o valor
    do Segredo do Cliente
    , pois não será 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 usuário do sistema de integração do Peakon (ISU).
    Quando sua empresa usa SSO para fazer login em seus tenants do Workday, use este modelo de URL para fazer login no Workday como o ISU da Peakon: (https://<workdayDomain>/wday/authgwy/<tenant>/login.htmld?redirect=n). <workdayDomain> é o domínio do seu tenant do Workday e <tenant> é o nome do seu tenant do Workday.
    Fazer login por meio de uma janela anônima garante que a integração não se conecte com credenciais incorretas para o locatário do Workday, o que causaria problemas de sincronização.
  11. No Peakon, acesse
    Integrações
    de Administração
    do Workday
    .
  12. Selecione
    OAuth
    no prompt
    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 já está ativa e será executada automaticamente. Se você precisar impedir que isso aconteça, mas ainda assim conseguir 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 com o Workday.
    Opção
    Descrição
    ID do sistema de integração
    (Opcional) Preencha este campo se precisar criar substituições de campos para transferir campos personalizados ou usar a funcionalidade
    PEAKON_INCLUDED
    .
    ID da organização
    (Opcional) Preencha este campo para filtrar os funcionários por organização. Para sincronizar funcionários em várias organizações, separe os IDs das organizações por um único espaço. Ao inserir um ID de organização para filtrar, incluímos automaticamente as organizações subordinadas.
    Recomendamos usar esta opção em vez da funcionalidade
    PEAKON_INCLUDED
    ao filtrar por organizações, porque:
    • Configurar a funcionalidade
      PEAKON_INCLUDED
      de forma a espelhar o campo
      ID da Organização
      é difícil de alcançar corretamente e, portanto, a sincronização pode não produzir o resultado esperado.
    • Funciona mais rápido do 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 utilizará os idiomas sincronizados nas comunicações da pesquisa com os funcionários, caso esses idiomas estejam habilitados nas configurações da pesquisa da sua organização.
    Número de telefone
    (Opcional) Selecione esta opção para exibir as opções de sincronização de números 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 por SMS.
    Ao selecionar números de telefone tanto
    para o trabalho
    quanto
    para casa
    , o número de telefone
    principal do trabalho
    terá prioridade.
    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 ativar essa caixa de seleção, crie uma entrada de substituição de campo
    PEAKON_INCLUDED
    no
    Serviço de Substituição de Campo
    . A fonte de dados de substituição deve ser um campo calculado booleano que retorne
    Verdadeiro
    para os 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.
    Mapear por ID externo (somente se os dados não contiverem segmentos duplicados)
    (Opcional) Selecione esta opção para associar IDs externos a segmentos ao mapear atributos do Workday para o Peakon.
    Este recurso permite usar mapeamento de atributos mais avançado quando não houver segmentos duplicados.
    A Workday mapeia os IDs externos de segmento desses atributos para o Peakon:
    • Departamento
    • Tipo de emprego
    • Gênero
    • Família de Cargos
    • 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 é alterado 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.
Para realizar uma sincronização completa, clique em
Sincronizar tudo
em
Administração
Integrações
Workday
.
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
nas auditorias de integração para exportar os 5.000 registros mais recentes dos logs de auditoria de eventos de integração em formato CSV.