Solucionar problemas de atualização do usuário de RH
Valores nulos e vazios não processados conforme o esperado
Aplica-se a:
- Provisionamento de usuário do Workday para o Active Directory local
- Provisionamento de usuário do Workday para o Microsoft Entra
- Provisionamento de usuário do SAP SuccessFactors para o Active Directory local
- Provisionamento de usuário do SAP SuccessFactors para o Microsoft Entra
| Solução de problemas | Detalhes |
|---|---|
| Problema | Você configurou com êxito o aplicativo de provisionamento de entrada. Você está obtendo 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 local Active Directory/Microsoft Entra ID. Mas, a operação de criaçã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 |
| Causa | 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 enviar o valor "no estado em que se encontra" para o aplicativo de destino. Nesse caso, o conector de provisionamento do Active Directory local atualmente não dá suporte à definição de valores de cadeia de caracteres vazios e, portanto, você vê o erro mencionado anteriormente. |
| Resolução | Verifique os logs de provisionamento. Identifique os atributos no Active Directory de destino que estão recebendo valores de cadeia de caracteres nulos ou vazios. Atualize o mapeamento de atributo para tais atributos para usar um mapeamento de expressão. Veja as resoluções recomendadas. |
Resoluções recomendadas
Digamos que o atributo BusinessTitle mapeado para o atributo do AD jobTitle possa 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 vazio.
Switch([BusinessTitle],[BusinessTitle],"","N/A")
Opção 2: Use a função IgnoreFlowIfNullOrEmpty para descartar atributos vazios ou nulos na carga enviada para Active Directory/ID do Microsoft Entra ID local.
IgnoreFlowIfNullOrEmpty([BusinessTitle])
Algumas atualizações de atributo do Workday estão ausentes
Aplica-se a:
- Provisionamento de usuário do Workday para o Active Directory local
- Provisionamento de usuário do Workday para o Microsoft Entra
| Solução de problemas | Detalhes |
|---|---|
| Problema | Você configurou com sucesso o aplicativo de provisionamento de entrada do Workday e conectou-se com sucesso à URL do locatário do Workday. Você está observando que há um atraso no fluxo de determinadas atualizações de atributos do Workday ou, em alguns casos, as alterações de atributos do Workday não estão fluindo conforme o esperado durante a sincronização incremental. |
| Causa | Durante a sincronização incremental, o aplicativo de provisionamento consulta o log de transações do WORKDAY para alterações na entidade de trabalho principal e somente as alterações controladas pelo log de transações do Workday são processadas. Se as alterações em um atributo do 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(). Esse 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. Portanto, durante a sincronização incremental, o novo valor desse atributo será exibido apenas se um atributo associado à entidade Worker principal também mudar durante o intervalo de sincronização. |
| Resolução | Se você observar esse comportamento com frequência, em que 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 é encontrado
Aplica-se a:
- Provisionamento de usuário do Workday para o Active Directory local
- Provisionamento de usuário do Workday para o Microsoft Entra
- Provisionamento de usuário do Workday para o Active Directory local
- Provisionamento de usuário do SAP SuccessFactors para o Active Directory local
- Provisionamento controlado por API para o Active Directory local
| Solução de problemas | Detalhes |
|---|---|
| Problema | Você recebe o código de erro: HybridSynchronizationActiveDirectoryCannotFindAttribute |
| Causa | O nome do atributo não foi encontrado no esquema do Active Directory: atributo. |
| Resolução | Se o atributo foi adicionado recentemente ao Active Directory, reinicie o agente de provisionamento, pois ele armazena o esquema em cache na inicialização. |
Correspondência de usuário com extensionAttribute não está funcionando
Aplica-se a:
- Provisionamento de usuário do Workday para o Microsoft Entra
- Provisionamento de usuário do SAP SuccessFactors para o Microsoft Entra
| Solução de problemas | Detalhes |
|---|---|
| Problema | Digamos que você esteja usando extensionAttribute3 no Microsoft Entra ID para armazenar a ID do funcionário e mapeá-la 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. |
| Causa | O ID Entra da Microsoft OnPremisesExtensionAttributes (extensionAttributes1-15) não pode ser usado como um atributo correspondente porque o parâmetro $filter da API do Graph do Azure AD não oferece suporte à filtragem por extensionAttributes. |
| Resolução | Não use OnPremisesExtensionAttributes do Microsoft Entra ID (extensionAttributes1-15) no par de atributos correspondentes. Use employeeID. |
Atualizações para o atributo email Microsoft Entra ID não são suportadas
Aplica-se a:
- Provisionamento de usuário do Workday para o Microsoft Entra
- Provisionamento de usuário do SAP SuccessFactors para o Microsoft Entra
- Provisionamento baseado em API Microsoft Entra ID
| Solução de problemas | Detalhes |
|---|---|
| Problema | Você configurou o provisionamento de atributos email do seu sistema de RH para o Microsoft Entra ID. Qualquer atualização no atributo email não está funcionando, mesmo que os logs de provisionamento exibam um registro para o atributo email. |
| Causa | O conector de provisionamento para o Microsoft Entra dá suporte à definição do atributo de email somente durante a criação do usuário. Depois que o usuário for criado, o conector não dará suporte à atualização do endereço de email. |
| Resolução | Para atualizar o atributo de email para usuários existentes, considere usar o portal Exchange Online ou o PowerShell. |
Provisionando o campo Último dia de trabalho do Workday
Aplica-se a:
- Provisionamento de usuário do Workday para o Active Directory local
- Provisionamento de usuário do Workday para o Microsoft Entra
| Solução de problemas | Detalhes |
|---|---|
| Problema | Você configurou o mapeamento de atributos para o atributo “Último dia de trabalho” (StatusTerminationLastDayOfWork) do dia útil no aplicativo de provisionamento. No entanto, a atualização do “Último dia de trabalho” só acontece após a data de rescisão entrar em vigor, enquanto você gostaria de buscar este “Último dia de trabalho” antes da data de rescisão. |
| Causa | No Workday, o campo “Último dia de trabalho” é definido no perfil do trabalhador somente após a data de rescisão entrar em vigor. Portanto, o conector de provisionamento do Workday não consegue obter essa data antecipadamente antes da data de encerramento. |
| Resolução | No Workday, crie um grupo de provisionamento chamado “Trabalhos 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 esse campo na lógica de mapeamento de atributo para o sinalizador accountDisabled.
- Exemplo:
`Switch([LastDayOfWorkWorkers], Switch([Active], , "1", "False", "0", "True"), 'Workers past Last Day of Work', "True")`
Atraso no processamento de encerramento do Workday
Aplica-se a:
- Provisionamento de usuário do Workday para o Active Directory local
- Provisionamento de usuário do Workday para o Microsoft Entra
| Solução de problemas | Detalhes |
|---|---|
| Problema | Durante a sincronização incremental, pode haver um atraso de 12 a 18 horas no processamento do evento de encerramento para trabalhadores localizados nas regiões Pacífico Asiático e Austrália/Nova Zelândia. |
| Causa | As contas do Usuário do Sistema de Integração do Workday (ISU) 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 encerramento específicos de um fuso horário. |
| Resolução | Há duas soluções alternativas possíveis: |
Use o provisionamento sob demanda para processar o evento de encerramento de um usuário específico.
No Workday, crie um grupo de provisionamento chamado Trabalhos Encerrados. Atualize o processo de negócios de encerramento no Workday para atribuir usuários a esse grupo quando o encerramento ocorrer. 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 esse campo na lógica de mapeamento de atributo para o sinalizador accountDisabled.
- Exemplo:
`Switch([TerminatedWorkers], Switch([Active], , "1", "False", "0", "True"), "Terminated Workers", "True")`