Partilhar via


Solucionar problemas de atualização do usuário de RH

Valores nulos e vazios não processados como esperado

Aplica-se a:

  • Provisionamento de utilizadores do Workday para o Active Directory local
  • 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 apague o valor correspondente do atributo no Active Directory local/Microsoft Entra ID. 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 descartar atributos vazios ou nulos na carga enviada para o Active Directory local / Microsoft Entra ID.

    IgnoreFlowIfNullOrEmpty([BusinessTitle])

Algumas atualizações de atributos do Workday estão faltando

Aplica-se a:

  • Provisionamento de utilizadores do Workday para o Active Directory local
  • Dia útil para provisionamento de usuários do Microsoft Entra
Resolução de Problemas Detalhes
Problema Você configurou com êxito o aplicativo de aprovisionamento de entrada do Workday e conectou-se com êxito ao URL do tenant 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 notar frequentemente este comportamento, em que as alterações em determinados atributos do Workday não estão a ser aplicadas, recomendamos executar periodicamente uma sincronização completa semanal ou mensal.

O atributo não foi encontrado

Aplica-se a:

  • Provisionamento de utilizadores do Workday para o Active Directory local
  • Dia útil para provisionamento de usuários do Microsoft Entra
  • Provisionamento de utilizadores do Workday para o Active Directory local
  • 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. Este problema afeta tanto a criação de utilizadores como as atualizações.
Motivo O atributo OnPremisesExtensionAttributes do Microsoft Entra ID não pode ser usado como um atributo de correspondência porque o parâmetro da extensionAttributes1-15 não $filter.
Resolução Não use o Microsoft Entra ID OnPremisesExtensionAttributes (extensionAttributes1-15) no par de atributos correspondentes. Utilize o ID do funcionário.

Não são suportadas atualizações ao atributo mail 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 do Microsoft Entra ID
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 não oferece suporte à configuração do atributo de email durante o provisionamento do usuário, pois esse atributo é gerenciado pelo Microsoft Exchange online.
Resolução Depois de criar o usuário, atribuir a licença do Exchange Online ao usuário define automaticamente o nome principal do usuário como o endereço de email. Para atualizar o atributo de email, use o portal do Exchange Online ou o PowerShell.

Definição do campo Último Dia de Trabalho a partir do Workday

Aplica-se a:

  • Provisionamento de utilizadores do Workday para o Active Directory local
  • 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 do 'Último Dia de Trabalho' só acontece depois que a data de terminação se torna efetiva, enquanto você gostaria de obter este 'Último Dia de Trabalho' antes da data de terminação.
Motivo Em Workday, o campo 'Último dia de trabalho' é definido no perfil do trabalhador somente após a data de rescisão se tornar efetiva. 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 indicador "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 utilizadores do Workday para o Active Directory local
  • 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 registos de terminação específicos de um determinado fuso horário.
Resolução Há duas soluções possíveis:
  1. Use o provisionamento sob demanda para processar o evento de rescisão de um usuário específico.

  2. No Workday, crie um grupo de provisionamento chamado Colaboradores Demitidos. 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 indicador "accountDisabled".

  • Exemplo:
    `Switch([TerminatedWorkers], Switch([Active], , "1", "False", "0", "True"), "Terminated Workers", "True")`

Próximos passos