Compartilhar 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 introduziu a capacidade dos trabalhadores de exibir informações de pronome em seu perfil de trabalho na versão do Workday 2021 R1. A capacidade de buscar dados de pronome usando a chamada à API do Workday Web Services (WWS) foi introduzida no Get_Workers versão 38.1 da API 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 dados de pronome preferenciais (HE/HIM, SHE/HER e THEY/THEM) em seu locatário do Workday.

  3. Use a tarefa Configurações de Localização de Manutenção do Workday –> Área de Informações Pessoais para ativar 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 para o grupo de segurança, para que ele tenha acesso GET para os Relatórios de domínio do Workday : Perfil Público.

    Captura de tela das permissões para instalação no 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 trabalho 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.

    Captura de tela da opção habilitar a exibição do pronome.

  7. Use o Workday Studio para invocar Get_Workers API versão 38.1 para o usuário de teste usando o usuário do sistema de integração do Microsoft Entra do Workday. 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.

    Captura de tela da resposta da API Get Workers do Workday.

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 de 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 pelo menos um Administrador de Aplicativos.

  2. Navegue até aplicativos Entra ID>Enterprise.

  3. Selecione o workday para o aplicativo de provisionamento de usuário do Active Directory/Microsoft Entra e acesse Provisionamento .

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

    Captura de tela do aplicativo de provisionamento do Centro de Administração do Microsoft Entra com a versão do Workday.

  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 WWS v21.1, faça referência a este artigo para examinar e atualizar os XPATHs para cada atributo.

  7. Adicionar um novo atributo chamado PreferredPronoun com 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 fluir o atributo Workday PreferredPronoun para qualquer atributo no AD/Microsoft Entra ID.

  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 na ID do Microsoft Entra 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