Share via


Configurar o provisionamento do Microsoft Entra para recuperar informações de pronome do Workday

Este artigo descreve como você pode personalizar os dois aplicativos de provisionamento controlados por RH a seguir para buscar informações de pronome do Workday.

Sobre informações de pronome no Workday

O Workday apresentou a capacidade de os trabalhadores exibirem informações de pronome nos perfis de trabalho na versão Workday 2021 R1. A capacidade de buscar dados de pronome usando a chamada à API dos WWS (Workday Web Services) foi introduzida na API Get_Workers versão 38.1 no Workday 2022 R1.

Observação

Links para determinadas observações e documentos da comunidade do Workday neste artigo exigem credenciais de conta da comunidade do Workday. Verifique com o administrador ou parceiro do Workday para obter o acesso necessário.

Como habilitar dados de pronome no Workday

Esta seção descreve as etapas necessárias para habilitar os dados do pronome no Workday. Recomendamos envolver o administrador do Workday para concluir as etapas listadas.

  1. Verifique se as preferências de exibição e compartilhamento do pronome estão habilitadas de acordo com as diretrizes do Workday. Consulte a documentação do Workday:

  2. Use a tarefa Manter Pronomes do Workday para definir os dados de pronome preferenciais no locatário do Workday.

  3. Use a área Workday Manter Configurações de Localização -> Informações Pessoais para ativar os dados de pronome para diferentes países/regiões.

  4. Selecione o Grupo de Segurança do Sistema de Integração do Workday usado com sua integração do Microsoft Entra. Atualize as permissões de domínio do grupo de segurança, para que ele tenha acesso aos Relatórios: Perfil Público de domínio do Workday.

    Screenshot of permissions to setup in Workday.

  5. Ative as alterações de política de segurança pendentes.

  6. Selecione um trabalhador em seu locatário do Workday para fins de teste. Defina informações de pronome para esse trabalhador usando a tarefa Editar Informações Pessoais. Verifique se o trabalhador habilitou a exibição do pronome para todos na preferência de perfil público dele.

    Screenshot of enabling pronoun display option.

  7. Use o Workday Studio ou o Postman para invocar a API Get_Workers versão 38.1 para o usuário de teste usando o usuário do sistema de integração do Workday com o Microsoft Entra. No cabeçalho de solicitação SOAP, especifique a opção Include_Reference_Descriptors_In_Response.

      <bsvc:Workday_Common_Header>
         <bsvc:Include_Reference_Descriptors_In_Response>true</bsvc:Include_Reference_Descriptors_In_Response>
      </bsvc:Workday_Common_Header> 
    
  8. Na resposta Get_Workers, veja a informação de pronome.

    Screenshot of Workday Get Workers API response.

Observação

Se você não conseguir recuperar dados de pronome na resposta Get_Workers, solucione problemas de permissões de segurança de domínio do Workday. Verifique se o grupo de segurança da integração tem permissão para o grupo de segurança segmentado que concede acesso aos dados de pronome.

Depois de confirmar que os dados do pronome estão disponíveis na resposta Get_Workers, vá para a próxima etapa de atualização da configuração do aplicativo de provisionamento do Microsoft Entra.

Para recuperar pronomes do Workday, atualize seu aplicativo de provisionamento do Microsoft Entra para consultar o Workday usando a v38.1 do Workday Web Services. Recomendamos testar essa configuração primeiro no ambiente de teste/área restrita antes de implementar a alteração na produção.

  1. Entre no centro de administração do Microsoft Entra como, no mínimo, um Administrador de aAplicativos.

  2. Navegue até Identidade>Aplicativos>Aplicativos empresariais.

  3. Selecione seu Workday para o Active Directory/aplicativo de provisionamento de usuário do Microsoft Entra e vá para Provisionamento.

  4. Na seção Credenciais do Administrador, atualize a URL do Locatário para incluir a versão do Workday Web Services v38.1, conforme mostrado.

    Screenshot of Microsoft Entra admin center provisioning app with Workday version.

  5. Abra a folha Mapeamentos de atributo. Role para baixo e clique em Mostrar opções avançadas. Clique em Editar lista de atributos do Workday.

  6. Se o aplicativo de provisionamento estiver configurado para usar a versão padrão da API do WWS v21.1, confira este artigo para examinar e atualizar os XPATHs para cada atributo.

  7. Adicionar um novo atributo chamado PreferredPronoun com o XPATH

    /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Personal_Information_Data/wd:Pronoun_Reference/@wd:Descriptor

  8. Salve suas alterações.

  9. Agora você pode adicionar um novo mapeamento de atributo para que o atributo do Workday PreferredPronoun flua para qualquer atributo no AD/Microsoft Entra.

  10. Se quiser incorporar informações de pronome como parte do nome de exibição, você pode atualizar o mapeamento de atributos para o atributo displayName para usar a expressão.

    Switch([PreferredPronoun], Join("", [PreferredNameData], " (", [PreferredPronoun], ")"), "", [PreferredNameData])

  11. Se o trabalhador Aaron Hall definiu suas informações de pronome no Workday como HE/HIM, a expressão acima define o nome de exibição no Microsoft Entra ID como: Aaron Hall (HE/HIM)

  12. Salve suas alterações.

  13. Teste a configuração de um usuário com provisionamento sob demanda.

Próximas etapas