Solucionar problemas de atualização do usuário de RH
Valores nulos e vazios não processados como esperado
Aplica-se a:
- Provisionamento de usuário do Ative Directory local para dia útil
- Dia útil para provisionamento de usuários do Microsoft Entra
- SAP SuccessFactors para provisionamento de usuários do Ative Directory local
- SAP SuccessFactors para provisionamento de usuários do Microsoft Entra
| Resolução de Problemas | Detalhes |
|---|---|
| Problema | Você configurou com êxito o aplicativo de provisionamento de entrada. Você está recebendo um valor nulo ou vazio do aplicativo de RH. Você espera que o serviço de provisionamento limpe o valor do atributo de destino correspondente no Ative Directory local / ID do Microsoft Entra. Mas a operação falha com a mensagem de erro: InvalidAttributeSyntax-LdapErr: The syntax is invalid. The parameter is incorrect. Error in attribute conversion operation, data 0, v3839 |
| Motivo | O serviço de provisionamento não tem uma lógica padrão para processamento de valor nulo. Quando o serviço de provisionamento obtém uma cadeia de caracteres vazia do aplicativo de origem, ele tenta fluir o valor "no estado em que se encontra" para o aplicativo de destino. Nesse caso, o conector de provisionamento do Ative Directory local atualmente não oferece suporte à configuração de valores de cadeia de caracteres vazia e, portanto, você vê o erro mencionado anteriormente. |
| Resolução | Verifique os logs de provisionamento. Identifique atributos no Ative Directory de destino que estão recebendo valores de cadeia de caracteres nulos ou vazios. Atualize o mapeamento de atributos para esses atributos para usar um mapeamento de expressão. Consulte as resoluções recomendadas. |
Resoluções recomendadas
Digamos que o atributo BusinessTitle mapeado para o atributo jobTitle AD pode ser nulo ou vazio no Workday.
- Opção 1: Use a função Alternar para verificar se há valores vazios ou nulos e passar um valor literal não em branco.
Switch([BusinessTitle],[BusinessTitle],"","N/A")
Opção 2: Use a função IgnoreFlowIfNullOrEmpty para soltar atributos vazios ou nulos na carga enviada para o Ative Directory local / ID do Microsoft Entra.
IgnoreFlowIfNullOrEmpty([BusinessTitle])
Algumas atualizações de atributos do Workday estão faltando
Aplica-se a:
- Provisionamento de usuário do Ative Directory local para dia útil
- Dia útil para provisionamento de usuários do Microsoft Entra
| Resolução de Problemas | Detalhes |
|---|---|
| Problema | Você configurou com êxito o aplicativo de provisionamento de entrada do Workday e se conectou com êxito à URL do locatário do Workday. Você está observando que há um atraso no fluxo de certas atualizações de atributos do Workday ou, em alguns casos, as alterações de atributos do Workday não estão fluindo como esperado durante a sincronização incremental. |
| Motivo | Durante a sincronização incremental, o aplicativo de provisionamento consulta o log de transações do Workday em busca de alterações na entidade Worker principal e apenas as alterações controladas pelo log de transações do Workday são processadas. Se as alterações em um atributo Workday em sua configuração não forem rastreadas no log de transações do Workday, o Microsoft Entra ID não buscará essa alteração. Por exemplo: o atributo LocalReference Workday faz parte do mapeamento de atributo padrão e tem XPATH wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Local_Reference/wd:ID[@wd:type='Locale_ID']/text(). Este atributo faz parte da entidade Business_Site_Summary_Data. Uma alteração no valor desse atributo no Workday não aparece no log de transações do Workday. Assim, durante a sincronização incremental, o novo valor desse atributo aparecerá somente se um atributo associado à entidade Worker primária também for alterado durante o intervalo de sincronização. |
| Resolução | Se você notar esse comportamento com frequência, onde as alterações em determinados atributos do Workday não estão fluindo, recomendamos executar periodicamente uma sincronização completa semanal ou mensal. |
O atributo não foi encontrado
Aplica-se a:
- Provisionamento de usuário do Ative Directory local para dia útil
- Dia útil para provisionamento de usuários do Microsoft Entra
- Provisionamento de usuário do Ative Directory local para dia útil
- SAP SuccessFactors para provisionamento de usuários do Ative Directory local
- Provisionamento controlado por API para o Ative Directory local
| Resolução de Problemas | Detalhes |
|---|---|
| Problema | Você recebe o código de erro: HybridSynchronizationActiveDirectoryCannotFindAttribute |
| Motivo | O nome do atributo não foi encontrado no esquema do Ative Directory: atributo. |
| Resolução | Se o atributo tiver sido adicionado recentemente ao Ative Directory, reinicie o agente de provisionamento, pois ele armazena em cache o esquema na inicialização. |
Correspondência de usuário com extensionAttribute não funciona
Aplica-se a:
- Dia útil para provisionamento de usuários do Microsoft Entra
- SAP SuccessFactors para provisionamento de usuários do Microsoft Entra
| Resolução de Problemas | Detalhes |
|---|---|
| Problema | Digamos que você esteja usando extensionAttribute3 no Microsoft Entra ID para armazenar o ID do funcionário e mapeá-lo para o atributo Workday WorkerID ou SuccessFactors personIdExternal para correspondência de usuário. Com essa configuração, a etapa correspondente no processo de provisionamento falha. Esse problema afeta a criação e as atualizações do usuário. |
| Motivo | O Microsoft Entra ID OnPremisesExtensionAttributes () não pode ser usado como um atributo correspondente porque o $filter parâmetro da API do Azure AD Graph não oferece suporte à filtragem por extensionAttributes.extensionAttributes1-15 |
| Resolução | Não use o Microsoft Entra ID OnPremisesExtensionAttributes (extensionAttributes1-15) no par de atributos correspondentes. Use employeeID. |
Não há suporte para atualizações do atributo de email do Microsoft Entra ID
Aplica-se a:
- Dia útil para provisionamento de usuários do Microsoft Entra
- SAP SuccessFactors para provisionamento de usuários do Microsoft Entra
- Provisionamento orientado por API ID do Microsoft Entra
| Resolução de Problemas | Detalhes |
|---|---|
| Problema | Você configurou o provisionamento de atributos de email do seu sistema de RH para o Microsoft Entra ID. Qualquer atualização para o atributo mail não está funcionando, mesmo que os logs de provisionamento exibam um registro para o atributo mail. |
| Motivo | O conector de provisionamento para o Microsoft Entra oferece suporte à configuração do atributo mail somente durante a criação do usuário. Depois que o usuário é criado, o conector não suporta a atualização do endereço de e-mail. |
| Resolução | Para atualizar o atributo de email para usuários existentes, considere usar o portal do Exchange Online ou o PowerShell. |
Campo Provisionamento do último dia de trabalho do dia útil
Aplica-se a:
- Provisionamento de usuário do Ative Directory local para dia útil
- Dia útil para provisionamento de usuários do Microsoft Entra
| Resolução de Problemas | Detalhes |
|---|---|
| Problema | Você configurou o mapeamento de atributos para o atributo "Último dia de trabalho" (StatusTerminationLastDayOfWork) do Workday no aplicativo de provisionamento. No entanto, a atualização 'Último Dia de Trabalho' só acontece depois que a data de término é efetiva, enquanto você gostaria de buscar este 'Último Dia de Trabalho' antes da data de término. |
| Motivo | Em Dia de trabalho, o campo 'Último dia de trabalho' é definido no perfil do trabalhador somente após a data de rescisão ser efetivada. Portanto, o conector de provisionamento do Workday não consegue obter essa data com antecedência antes da data de término. |
| Resolução | No Workday, crie um grupo de provisionamento chamado "Trabalhadores após o último dia de trabalho". Adicione automação no Workday para atribuir usuários a esse grupo quando o último dia de trabalho de um trabalhador for atingido. No trabalho de provisionamento do Microsoft Entra, adicione um atributo XPATH do Workday para buscar essa atribuição de grupo. |
- Exemplo:
`LastDayOfWorkWorkers = wd:Worker/wd:Worker_Data/wd:Account_Provisioning_Data/wd:Provisioning_Group_Assignment_Data[wd:Status='Assigned' and wd:Provisioning_Group=" Workers past Last Day of Work"]/wd:Provisioning_Group/text()`
Use este campo na lógica de mapeamento de atributos para o sinalizador accountDisabled.
- Exemplo:
`Switch([LastDayOfWorkWorkers], Switch([Active], , "1", "False", "0", "True"), 'Workers past Last Day of Work', "True")`
Atraso no processamento de rescisão do dia útil
Aplica-se a:
- Provisionamento de usuário do Ative Directory local para dia útil
- Dia útil para provisionamento de usuários do Microsoft Entra
| Resolução de Problemas | Detalhes |
|---|---|
| Problema | Durante a sincronização incremental, pode haver um atraso de 12 a 18 horas no processamento do evento de rescisão para trabalhadores localizados nas regiões Ásia-Pacífico e Austrália/Nova Zelândia. |
| Motivo | As contas ISU (Workday Integration System User) sempre recuperam dados com base no fuso horário do Pacífico. Atualmente, o conector não implementa uma consulta especializada para processar registros de terminação específicos de um fuso horário. |
| Resolução | Há duas soluções possíveis: |
Use o provisionamento sob demanda para processar o evento de rescisão de um usuário específico.
Em Dia de trabalho, crie um grupo de provisionamento chamado Trabalhadores Encerrados. Atualize o processo comercial de rescisão no Workday para atribuir usuários a esse grupo quando a rescisão acontecer. No trabalho de provisionamento do Microsoft Entra, adicione um atributo XPATH do Workday para buscar essa atribuição de grupo.
- Exemplo:
`TerminatedWorkers = wd:Worker/wd:Worker_Data/wd:Account_Provisioning_Data/wd:Provisioning_Group_Assignment_Data[wd:Status='Assigned' and wd:Provisioning_Group="Terminated Workers"]/wd:Provisioning_Group/text()`
Use este campo na lógica de mapeamento de atributos para o sinalizador accountDisabled.
- Exemplo:
`Switch([TerminatedWorkers], Switch([Active], , "1", "False", "0", "True"), "Terminated Workers", "True")`