Microsoft Entra-inrichting configureren om pronoungegevens op te halen uit Workday

In dit artikel wordt beschreven hoe u de volgende twee HR-gestuurde inrichtingsapps kunt aanpassen om voornaamwoorden op te halen uit Workday.

• Gebruikersinrichting van Workday naar on-premises Active Directory
• Gebruikersinrichting van Workday naar Microsoft Entra

Informatie over voornaamwoorden in Workday

Workday heeft in de release van Workday 2021 R1 de mogelijkheid voor werknemers geïntroduceerd om voornaamwoorden weer te geven in hun werkprofiel. De mogelijkheid om voornaamwoordgegevens op te halen met de WWS-API-aanroep (Workday Web Services) is geïntroduceerd in Get_Workers API-versie 38.1 in Workday-release 2022 R1.

Notitie

Voor koppelingen naar bepaalde notities en documenten van de Workday-community in dit artikel zijn referenties voor het Workday-communityaccount vereist. Neem contact op met uw Workday-beheerder of -partner om de vereiste toegang te krijgen.

Voornaamwoordgegevens inschakelen in Workday

In deze sectie worden de stappen beschreven die nodig zijn voor het inschakelen van pronoungegevens in Workday. We raden u aan uw Workday-beheerder in te schakelen om de vermelde stappen uit te voeren.

1. Zorg ervoor dat de voorkeuren voor weergave en delen zijn ingeschakeld volgens de richtlijnen van Workday. Raadpleeg de Workday-documenten:

   • Stappen: Geslachtsnaamwoorden instellen om weer te geven op een werkrolprofiel * Human Capital Management * Lezer * Beheerdershandleiding (workday.com)
   • Stappen: Voorkeuren voor openbaar profiel instellen * Human Capital Management * Lezer * Beheerdershandleiding (workday.com)

2. Gebruik de taak Workday Maintain Pronouns om voorkeursgegevens (HIJ/HEM, ZIJ/HAAR en X) in uw Workday-tenant te definiëren.

3. Gebruik de taak Localisatie-instellingen voor Workday onderhouden :> gebied persoonlijke gegevens om gegevens voor verschillende landen/regio's te activeren.

4. Selecteer de Workday Integration System Security Group die wordt gebruikt met uw Microsoft Entra-integratie. Werk de domeinmachtigingen voor de beveiligingsgroep bij, zodat deze GET-toegang heeft voor het Workday-domein Rapporten: openbaar profiel.

   

5. In behandeling zijnde wijzigingen voor beveiligingsbeleid activeren.

6. Selecteer een werknemer in uw Workday-tenant voor testdoeleinden. Stel de voornaamwoordinformatie voor deze werknemer in met behulp van de taak Persoonlijke gegevens bewerken. Zorg ervoor dat de werknemer de weergave van het voornaamwoord heeft ingeschakeld voor iedereen in de openbare profielvoorkeur.

   

7. Gebruik Workday Studio om Get_Workers API-versie 38.1 aan te roepen voor de testgebruiker met behulp van de workday Microsoft Entra-integratiesysteemgebruiker. Geef in de SOAP-aanvraagheader de optie op 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. Bekijk in het Get_Workers antwoord de naamwoordinformatie.

   

Notitie

Als u geen voornaamwoordgegevens in het antwoord van Get_Workers kunt ophalen, moet u problemen met de beveiligingsmachtigingen van het Workday-domein oplossen. Zorg ervoor dat uw integratiebeveiligingsgroep gemachtigd is voor de gesegmenteerde beveiligingsgroep die toegang verleent tot de naamwoordgegevens.

Zodra u hebt bevestigd dat de pronoun-gegevens beschikbaar zijn in het Get_Workers antwoord, gaat u naar de volgende stap van het bijwerken van de configuratie van uw Microsoft Entra-inrichtings-app.

Werk uw Microsoft Entra-inrichtings-app bij om query's uit te voeren op Workday met behulp van v38.1 van de Workday-webservices om de naamwoorden van Workday op te halen. We raden u aan deze configuratie eerst te testen in uw test-/sandboxomgeving voordat u de wijziging in productie implementeert.

1. Meld u als toepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.

2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>.

3. Selecteer uw Workday naar Active Directory/Microsoft Entra-toepassing voor het inrichten van gebruikers en ga naar Inrichten .

4. Werk in de sectie Referenties voor beheerders de tenant-URL bij zodat deze de workday-webserviceversie v38.1 bevat, zoals wordt weergegeven.

   

5. Open de blade Kenmerktoewijzingen. Schuif omlaag en klik op Geavanceerde opties weergeven. Klik op Kenmerkenlijst bewerken voor Workday.

6. Als uw inrichtings-app is geconfigureerd voor het gebruik van de standaard WWS API versie v21.1, raadpleegt u dit artikel om de XPATH’s voor elk kenmerk te controleren en bij te werken.

7. Een nieuw kenmerk met de naam PreferredPronoun toevoegen met XPATH

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

8. Sla uw wijzigingen op.

9. U kunt nu een nieuwe kenmerktoewijzing toevoegen om het Workday-kenmerk PreferredPronoun door te geven aan elk kenmerk in AD/Microsoft Entra-id.

10. Als u naamwoordinformatie wilt opnemen als onderdeel van de weergavenaam, kunt u de kenmerktoewijzing voor het kenmerk DisplayName bijwerken om de expressie te gebruiken.

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

11. Als werkrol Aaron Hall zijn voornaamwoord in Workday heeft ingesteld als HE/HIM, stelt de bovenstaande expressie de weergavenaam in Microsoft Entra ID in als: Aaron Hall (HE/HIM)

12. Sla uw wijzigingen op.

13. Test de configuratie voor één gebruiker met inrichting op aanvraag.

Volgende stappen

• Meer informatie over het configureren van gebruikersinrichting van Workday naar Active Directory
• Meer informatie over het configureren van write-back naar Workday
• Informatie over ondersteunde Workday-kenmerken voor inkomende inrichting