Como configurar a integração Ceridian Dayforce no ADManager Plus

Pré-requisitos

• O Ceridian Dayforce utiliza autenticação básica para autorizar as requisições de API.
• Credenciais necessárias: nome de usuário e senha obtidos no Ceridian Dayforce.

Privilégios

Importar usuários (ação de entrada): Sua função deve ter acesso ao subrecurso Ler Dados em HCM Anywhere > Web Services in the Features tab of System Admin > Roles.

Além disso, por segurança, habilite o Código de referência cruzada (XRefCode) em RESTful Services > Human Resources > Employee in the Web Services Field-Level Access tab of System Admin > Roles.

Para executar qualquer ação ou consulta no Ceridian Dayforce (ação de saída): Sua função deve ter acesso ao subrecurso PATCH/POST dados de RH do colaborador em HCM Anywhere > Web Services in the Features tab of System Admin > Roles.

Além disso, por segurança, habilite Permitir criação na guia Autorizações correspondente em System Admin > Roles.

Configuração de autorização

• Faça login no ADManager Plus e acesse Directory/Application Settings.
• Em Application Integrations, localize e selecione Ceridian Dayforce.
• Ative a opção habilitar integração Ceridian Dayforce.
• Na página de configuração do Ceridian Dayforce, clique em Authorization.
• Insira as credenciais, substituindo nome de usuário e senha pelos seus dados de login.
• Clique Configure.

Configuração de webhook de entrada

O webhook de entrada permite buscar dados de usuários no Ceridian Dayforce e enviá-los ao ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como fonte de dados durante a configuração de automações para executar a ação desejada na lista de usuários retornada pela resposta da API. Para configurar um webhook de entrada para o Ceridian Dayforce:

• Em Inbound Webhook, clique em Ceridian Dayforce Endpoint Configuration.
• O Ceridian Dayforce segue um design de chamadas encadeadas, exigindo dois endpoints para recuperar dados de usuários: o endpoint Lista de usuários, que coleta os IDs de usuário, e o endpoint de Usuários, que obtém os detalhes de cada ID coletado.
• Para usar esses endpoints pré-configurados, substitua em ambos {subdomain} e {clientNamespace} pelos valores correspondentes da sua instância Dayforce.
• Cada endpoint deve ser testado e salvo individualmente antes de prosseguir. No entanto, se desejar usar um novo endpoint para importar usuários, clique em + Add API endpoint e preencha os campos obrigatórios conforme as conforme as referências de API do Ceridian Dayforce. Clique aqui para saber como.
• Você pode usar os parâmetros filterUpdatedStartDate e filterUpdatedEndDate para recuperar somente as respostas filtradas pelo Dayforce,. atendendo às necessidades específicas do seu ambiente.

Nota

• O par chave-valor da API já vem pré-configurado como cabeçalho para autenticar as solicitações de API, conforme definido durante a Configuração de Autorização.
• É possível adicionar macros na configuração do endpoint para alterá-lo dinamicamente por meio do componente de seleção de macros.
• Consulte as referências de API do Ceridian Dayforce e configure cabeçalhos ou parâmetros, se necessário.
• Após concluir, clique em Test & Save. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Clique em Proceed.

Nota

• Consulte a referência de API do Ceridian Dayforce para verificar quais parâmetros configurar e retornar apenas os dados desejados.
• Clique em + Add API endpoint para criar quantos endpoints forem necessários. Clique aqui para saber como.
• Clique em Data Source - LDAP Attribute Mapping para vincular endpoints e mapear atributos LDAP do AD aos atributos correspondentes no Ceridian Dayforce.

[O ADManager Plus também permite personalizar o formato de atributos importados do Ceridian Dayforce]

• Clique em + Add New Configuration e faça o seguinte:
  • Insira o Nome da configuração e a Descrição e selecione a Categoria de automação no menu suspenso.
  • No campo Select Endpoint escolha o endpoint desejado e defina uma Chave primária única para o usuário (por exemplo, employeeIdentifier).
  Nota: Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles.
• No campo Attribute Mapping selecione o atributo LDAP Attribute Name no menu suspenso e associe-o à coluna correspondente no Ceridian Dayforce.
• Se quiser criar um formato personalizado, clique em Mapping Attribute.
• Clique em Save.

Configuração de webhook de saída

O webhook de saída permite atualizar no Ceridian Dayforce as alterações feitas no AD via ADManager Plus e sincronizá-las com o AD. Para configurar um webhook de saída para o Ceridian Dayforce:

• Em Outbound Webhook, clique em Ceridian Dayforce Webhook Configuration.
• Clique em + Add Webhook.
• Insira um nome e uma descrição para este webhook.
• Defina a ação a ser executada e consulte as referências de API do Ceridian Dayforce para obter detalhes como URL, cabeçalhos, parâmetros e demais requisitos.
• Selecione, no menu suspenso, o método HTTP que permitirá executar a ação desejada no endpoint.
• Insira a URL do endpoint.
• Configure a URL, os cabeçalhos, parâmetros e o corpo da mensagem no formato apropriado para a chamada de API desejada.
• Clique em Test and Save.
• Uma janela pop-up exibirá uma lista de usuários e grupos do AD para testar a chamada de API configurada. Selecione o usuário ou grupo desejado para testar a chamada de API e clique em OK. Isso enviará uma solicitação em tempo real para a URL do endpoint e aplicará as modificações configuradas aos objetos selecionados.
• Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em Save.
• Os webhooks configurados podem ser incorporados a Modelos de Orquestração—permitindo automações agendadas ou acionadas por eventos — para que a ação definida no webhook de saída seja executada sequencialmente em um grupo de usuários ou em usuários individuais.