Delen via


Hoe Microsoft Entra-inrichting kan worden geïntegreerd met SAP SuccessFactors

De Microsoft Entra-service voor het inrichten van gebruikers kan worden geïntegreerd met SAP SuccessFactors Employee Central om de identiteitslevenscyclus van gebruikers te beheren. Microsoft Entra ID biedt drie vooraf gedefinieerde integraties:

In dit artikel wordt uitgelegd hoe de integratie werkt en hoe u het inrichtingsgedrag voor verschillende HR-scenario's kunt aanpassen.

Microsoft Entra biedt ook ondersteuning voor eenmalige aanmelding bij SuccessFactors. Zie Integratie van eenmalige aanmelding (SSO) van Microsoft Entra met SuccessFactors voor meer informatie.

Connectiviteit tot stand brengen

Microsoft Entra-inrichtingsservice maakt gebruik van basisverificatie om verbinding te maken met OData API-eindpunten van Employee Central. Wanneer u de inrichtings-app successFactors instelt, gebruikt u de parameter Tenant-URL in de sectie Referenties voor beheerder om de URL van het API-datacenter te configureren.

Als u de connectiviteit tussen de Microsoft Entra-inrichtingsservice en SuccessFactors verder wilt beveiligen, voegt u de IP-bereiken van Microsoft Entra toe aan de acceptatielijst voor SuccessFactors IP:

  1. Download de nieuwste IP-bereiken voor de openbare Azure-cloud.
  2. Open het bestand en zoek naar tag AzureActiveDirectory.
  3. Kopieer alle IP-adresbereiken die worden vermeld in de element addressPrefixes en gebruik het bereik om uw IP-adresbeperkingslijst te maken.
  4. Vertaal de CIDR-waarden naar IP-bereiken.
  5. Meld u aan bij de SuccessFactors-beheerportal om IP-bereiken toe te voegen aan de acceptatielijst. Raadpleeg sap-ondersteuningsnotitie 2253200. U kunt nu IP-bereiken invoeren in dit hulpprogramma.

Ondersteunde entiteiten

Voor elke gebruiker in SuccessFactors haalt Microsoft Entra-inrichtingsservice de volgende entiteiten op. Elke entiteit wordt uitgebreid met behulp van de OData-API $expand queryparameter, zoals wordt beschreven in de kolom Regel ophalen. Sommige entiteiten worden standaard uitgevouwen, terwijl sommige entiteiten alleen worden uitgevouwen als er een specifiek kenmerk aanwezig is in de toewijzing.

# SuccessFactors-entiteit OData-knooppunt Regel voor ophalen
1 PerPerson *root node* Altijd
2 PerPersonal personalInfoNav Altijd
3 PerPhone phoneNav Altijd
4 PerEmail emailNav Altijd
5 EmpEmployment employmentNav Altijd
6 User employmentNav/userNav Altijd
7 EmpJob employmentNav/jobInfoNav Altijd
8 EmpEmploymentTermination activeEmploymentsCount Altijd
9 User's manager employmentNav/userNav/manager/empInfo Altijd
10 FOCompany employmentNav/jobInfoNav/companyNav Alleen als company of companyId kenmerk is toegewezen
11 FODepartment employmentNav/jobInfoNav/departmentNav Alleen als department of departmentId kenmerk is toegewezen
12 FOBusinessUnit employmentNav/jobInfoNav/businessUnitNav Alleen als businessUnit of businessUnitId kenmerk is toegewezen
13 FOCostCenter employmentNav/jobInfoNav/costCenterNav Alleen als costCenter of costCenterId kenmerk is toegewezen
14 FODivision employmentNav/jobInfoNav/divisionNav Alleen als division of divisionId kenmerk is toegewezen
15 FOJobCode employmentNav/jobInfoNav/jobCodeNav Alleen als jobCode of jobCodeId kenmerk is toegewezen
16 FOPayGrade employmentNav/jobInfoNav/payGradeNav Alleen als payGrade kenmerk is toegewezen
17 FOLocation employmentNav/jobInfoNav/locationNav Alleen als location kenmerk is toegewezen
18 FOCorporateAddressDEFLT employmentNav/jobInfoNav/addressNavDEFLT Als toewijzing een van de volgende kenmerken bevat: officeLocationAddress, officeLocationCity, officeLocationZipCode
19 FOEventReason employmentNav/jobInfoNav/eventReasonNav Alleen als eventReason kenmerk is toegewezen
20 EmpGlobalAssignment employmentNav/empGlobalAssignmentNav Alleen als assignmentType is toegewezen
21 EmploymentType Picklist employmentNav/jobInfoNav/employmentTypeNav Alleen als employmentType is toegewezen
22 EmployeeClass Picklist employmentNav/jobInfoNav/employeeClassNav Alleen als employeeClass is toegewezen
23 EmplStatus Picklist employmentNav/jobInfoNav/emplStatusNav Alleen als emplStatus is toegewezen
24 AssignmentType Picklist employmentNav/empGlobalAssignmentNav/assignmentTypeNav Alleen als assignmentType is toegewezen
25 Position employmentNav/jobInfoNav/positionNav Alleen als positioNav is toegewezen
26 Manager User employmentNav/jobInfoNav/managerUserNav Alleen als managerUserNav is toegewezen

Hoe volledige synchronisatie werkt

Op basis van de kenmerktoewijzing verzendt Microsoft Entra-inrichtingsservice tijdens de volledige synchronisatie de volgende GET OData API-query om effectieve gegevens van alle actieve en beëindigde werknemers op te halen.

Parameter Description
OData-API-host Voegt https toe aan de tenant-URL. Voorbeeld: https://api4.successfactors.com
OData-API-eindpunt /odata/v2/PerPerson
OData $format-queryparameter json
OData $filter queryparameter (personEmpTerminationInfoNav/activeEmploymentsCount ne null) and (lastModifiedDateTime le <CurrentExecutionTime>)
OData $expand queryparameter Deze parameterwaarde is afhankelijk van de kenmerken die zijn toegewezen. Voorbeeld: employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,phoneNav,emailNav,employmentNav/jobInfoNav/companyNav/countryOfRegistrationNav,employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav
OData customPageSize-queryparameter 100

Notitie

Tijdens de volledige initiële synchronisatie worden zowel actieve als beëindigde werknemers van SAP SuccessFactors opgehaald.

Voor elke SuccessFactors-gebruiker zoekt de inrichtingsservice naar een account in het doel (Microsoft Entra-id/on-premises Active Directory) met behulp van het overeenkomende kenmerk dat in de toewijzing is gedefinieerd. Bijvoorbeeld: als personIdExternal wordt toegewezen aan employeeId en is ingesteld als het overeenkomende kenmerk, gebruikt de inrichtingsservice de waarde personIdExternal om te zoeken naar de gebruiker met het employeeId-filter. Als er een overeenkomst voor een gebruiker wordt gevonden, worden de doelkenmerken bijgewerkt. Als er geen overeenkomst wordt gevonden, wordt er een nieuwe vermelding in het doel gemaakt.

Als u de gegevens wilt valideren die worden geretourneerd door uw OData-API-eindpunt voor een specifiek personIdExternal, werkt u de SuccessFactorsAPIEndpoint in de API-query bij met de URL van uw API-datacenterserver en gebruikt u een hulpprogramma zoals cURL of Graph Explorer om de query aan te roepen. Als het filter 'in' niet werkt, kunt u het 'eq'-filter proberen.

https://[SuccessFactorsAPIEndpoint]/odata/v2/PerPerson?$format=json&
$filter=(personIdExternal in '[personIdExternalValue]')&
$expand=employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,
phoneNav,phoneNav/phoneTypeNav,emailNav,employmentNav/jobInfoNav/businessUnitNav,employmentNav/jobInfoNav/companyNav,
employmentNav/jobInfoNav/companyNav/countryOfRegistrationNav,employmentNav/jobInfoNav/costCenterNav,
employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav,employmentNav/jobInfoNav/jobCodeNav,
employmentNav/jobInfoNav/locationNav,employmentNav/jobInfoNav/locationNav/addressNavDEFLT,employmentNav/jobInfoNav/payGradeNav,
employmentNav/empGlobalAssignmentNav,employmentNav/empGlobalAssignmentNav/assignmentTypeNav,employmentNav/jobInfoNav/emplStatusNav,
employmentNav/jobInfoNav/employmentTypeNav,employmentNav/jobInfoNav/employeeClassNav,employmentNav/jobInfoNav/eventReasonNav

Hoe incrementele synchronisatie werkt

Na volledige synchronisatie onderhoudt de Microsoft Entra-inrichtingsservice LastExecutionTimestamp deze om deltaquery's te maken voor het ophalen van incrementele wijzigingen. De tijdstempelkenmerken die aanwezig zijn in elke SuccessFactors-entiteit, zoals lastModifiedDateTime, endDatestartDate, en latestTerminationDate, worden geëvalueerd om te zien of de wijziging tussen de LastExecutionTimestamp en CurrentExecutionTime. Zo ja, dan wordt de invoerwijziging beschouwd als effectief en verwerkt voor synchronisatie.

Hier volgt de OData API-aanvraagsjabloon die door Microsoft Entra ID wordt gebruikt om successFactors op te vragen voor incrementele wijzigingen. U kunt de variabelen SuccessFactorsAPIEndpointLastExecutionTimestamp bijwerken en CurrentExecutionTime in de aanvraagsjabloon een hulpprogramma zoals cURL of Graph Explorer gebruiken om te controleren welke gegevens worden geretourneerd. U kunt ook de werkelijke nettolading van de aanvraag ophalen uit SuccessFactors door auditlogboeken van OData-API in te schakelen.

https://[SuccessFactorsAPIEndpoint]/odata/v2/PerPerson/$count?$format=json&$filter=(personEmpTerminationInfoNav/activeEmploymentsCount ne null) and
((lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') or
(personalInfoNav/startDate ge datetimeoffset'<LastExecutionTimestamp>' and personalInfoNav/startDate le datetimeoffset'<CurrentExecutionTime>') or
((personalInfoNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and personalInfoNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') and (personalInfoNav/startDate le datetimeoffset'<CurrentExecutionTime>' and (personalInfoNav/endDate ge datetimeoffset'<CurrentExecutionTime>' or  personalInfoNav/endDate eq null))) or
(employmentNav/startDate ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/startDate le datetimeoffset'<CurrentExecutionTime>') or
((employmentNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') and (employmentNav/startDate le datetimeoffset'<CurrentExecutionTime>' and (employmentNav/endDate ge datetimeoffset'<CurrentExecutionTime>' or employmentNav/endDate eq null))) 
(employmentNav/jobInfoNav/startDate ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/jobInfoNav/startDate le datetimeoffset'<CurrentExecutionTime>') or
((employmentNav/jobInfoNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/jobInfoNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') and (employmentNav/jobInfoNav/startDate le datetimeoffset'<CurrentExecutionTime>' and (employmentNav/jobInfoNav/endDate ge datetimeoffset'<CurrentExecutionTime>' or employmentNav/jobInfoNav/endDate eq null))) or
(phoneNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and phoneNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') or
(emailNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and emailNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') or
(personEmpTerminationInfoNav/latestTerminationDate ge datetimeoffset'<previousDayDateStartTime24hrs>' and personEmpTerminationInfoNav/latestTerminationDate le datetimeoffset'<previousDayDateTime24hrs>') or
(employmentNav/userNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/userNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>'))
&$expand=employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,phoneNav,emailNav,employmentNav/userNav/manager/empInfo,employmentNav/jobInfoNav/companyNav,employmentNav/jobInfoNav/departmentNav,employmentNav/jobInfoNav/locationNav,employmentNav/jobInfoNav/locationNav/addressNavDEFLT,employmentNav/jobInfoNav/locationNav/addressNavDEFLT/stateNav&customPageSize=100

Hoe pre-hire verwerking werkt

In deze sectie wordt uitgelegd hoe de SAP SuccessFactors-connector vooraf inhuurrecords verwerkt (werknemers met huurdatum/begindatum in de toekomst). Stel dat er een prehuur is met employeeId "1234" in SuccessFactors Employee Central met begindatum op 1 juni-2023. Laten we er verder van uitgaan dat deze record vooraf is gemaakt in Employee Central of in de onboarding-module op 15-mei-2023. Wanneer de inrichtingsservice deze record voor het eerst bekijkt op 15 mei-2023 (ofwel als onderdeel van volledige synchronisatie of incrementele synchronisatie), heeft deze record nog steeds de status vooraf in dienst. Als gevolg hiervan verzendt SuccessFactors niet alle kenmerken van de inrichtingsservice (bijvoorbeeld: userNav/username) die aan de gebruiker zijn gekoppeld. Er zijn slechts nauwelijks minimale gegevens over de gebruiker, zoals companyName, personIdExternalen startDate firstnamelastname is beschikbaar. Om pre-hires succesvol te kunnen verwerken, moet aan de volgende vereisten worden voldaan:

  1. Het personIdExternal kenmerk moet worden ingesteld als de primaire overeenkomende id (samenvoegingseigenschap). Als u een ander kenmerk configureert (bijvoorbeeld: userName) als de eigenschap voor deelname, kan de inrichtingsservice de informatie voor vooraf inhuren niet ophalen.
  2. Het startDate kenmerk moet beschikbaar zijn en het JSONPath moet zijn ingesteld op of $.employmentNav.results[0].startDate $.employmentNav.results[-1:].startDate.
  3. De record vooraf in dienst moet een van de volgende statussen hebben in Employee Central: 'actief' (t), 'inactief' (f) of 'active_external_suite' (e). Raadpleeg de SAP-ondersteuningsnotitie 2736579 voor meer informatie over deze statussen.

Notitie

Voor een pre-hire die geen geschiedenis heeft met de organisatie, werken zowel de index [0] als [-1:] voor startDate. Voor een pre-hire die een nieuwe inhuur of conversie is, kunnen we de order niet deterministisch vertellen en dit kan ertoe leiden dat bepaalde werknemers die opnieuw worden ingehuurd/geconverteerd, worden verwerkt op hun werkelijke begindatum. Dit is een bekende beperking in de connector.

Tijdens een volledige synchronisatie of incrementele synchronisatie of inrichting op aanvraag, wordt, wanneer de inrichtingsservice een record vóór inhuren tegenkomt, de volgende OData-query verzonden naar SuccessFactors met het filter 'asOfDate' ingesteld op de startDate van de gebruiker (zoalsOfDate=2023-06-01).

https://[SuccessFactorsAPIEndpoint]/odata/v2/PerPerson?$format=json&$
filter=(personIdExternal in '1234' and employmentNav/userNav/status in 't','f','e')&asOfDate=2023-06-01&$
expand=employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,phoneNav,emailNav,employmentNav/userNav/manager/empInfo,employmentNav/jobInfoNav/companyNav,employmentNav/jobInfoNav/costCenterNav,employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav,employmentNav/

Als u problemen ondervindt met de verwerking vooraf inhuren, kunt u de bovenstaande OData-aanvraagindeling gebruiken om een query uit te voeren op uw SuccessFactors-exemplaar dat het API-eindpunt personIdExternal vervangt en asOfDate filtert u met waarden die overeenkomen met uw testscenario.

Kenmerkgegevens lezen

Wanneer microsoft Entra-inrichtingsservice query's op SuccessFactors opvraagt, wordt er een JSON-resultatenset opgehaald. De JSON-resultatenset bevat veel kenmerken die zijn opgeslagen in Employee Central. Standaard is het inrichtingsschema geconfigureerd om alleen een subset van deze kenmerken op te halen.

Als u meer kenmerken wilt ophalen, volgt u de stappen die worden vermeld:

  1. Blader naar de bedrijfstoepassingen ->SuccessFactors-app ->Provisioning ->Edit Provisioning ->attribute-mapping page.

  2. Schuif omlaag en klik op Geavanceerde opties weergeven.

  3. Klik op Kenmerkenlijst bewerken voor SuccessFactors.

    Notitie

    Als de optie Kenmerken bewerken voor SuccessFactors niet wordt weergegeven in het Microsoft Entra-beheercentrum, gebruikt u de URL https://portal.azure.com/?Microsoft_AAD_IAM_forceSchemaEditorEnabled=true voor toegang tot de pagina.

  4. In de kolom API-expressie in deze weergave worden de JSONPath-expressies weergegeven die door de connector worden gebruikt.

    API-Expressie

  5. U kunt een bestaande JSONPath-waarde bewerken of een nieuw kenmerk met een geldige JSONPath-expressie toevoegen aan het schema.

De volgende sectie bevat een lijst met veelvoorkomende scenario's voor het bewerken van de JSONPath-waarden.

Verschillende HR-scenario's verwerken

JSONPath is een querytaal voor JSON die vergelijkbaar is met XPath voor XML. Net als XPath maakt JSONPath het mogelijk om gegevens uit een JSON-nettolading te extraheren en te filteren.

Met behulp van JSONPath-transformatie kunt u het gedrag van de Microsoft Entra-inrichtings-app aanpassen om aangepaste kenmerken op te halen en scenario's te verwerken, zoals rehiring, werkrolconversie en globale toewijzing.

In deze sectie wordt beschreven hoe u de inrichtings-app kunt aanpassen voor de volgende HR-scenario's:

Meer kenmerken ophalen

Het standaardinrichtingsschema van Microsoft Entra SuccessFactors wordt geleverd met 90+ vooraf gedefinieerde kenmerken. Als u meer SuccessFactors-kenmerken wilt toevoegen aan het inrichtingsschema, gebruikt u de volgende stappen:

  1. Gebruik de OData-query om gegevens op te halen voor een geldige testgebruiker van Employee Central.

     https://[SuccessFactorsAPIEndpoint]/odata/v2/PerPerson?$format=json&
     $filter=(personIdExternal in '[personIdExternalValue]')&
     $expand=employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,
     phoneNav,phoneNav/phoneTypeNav,emailNav,employmentNav/jobInfoNav/businessUnitNav,employmentNav/jobInfoNav/companyNav,
     employmentNav/jobInfoNav/companyNav/countryOfRegistrationNav,employmentNav/jobInfoNav/costCenterNav,
     employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav,employmentNav/jobInfoNav/jobCodeNav,
     employmentNav/jobInfoNav/locationNav,employmentNav/jobInfoNav/locationNav/addressNavDEFLT,employmentNav/jobInfoNav/payGradeNav,
     employmentNav/empGlobalAssignmentNav,employmentNav/empGlobalAssignmentNav/assignmentTypeNav,employmentNav/jobInfoNav/emplStatusNav,
     employmentNav/jobInfoNav/employmentTypeNav,employmentNav/jobInfoNav/employeeClassNav,employmentNav/jobInfoNav/eventReasonNav
    
  2. De entiteit Employee Central bepalen die is gekoppeld aan het kenmerk

    • Als het kenmerk deel uitmaakt van de entiteit EmpEmployment , zoekt u het kenmerk onder het employmentNav-knooppunt .
    • Als het kenmerk deel uitmaakt van de entiteit Gebruiker , zoekt u het kenmerk onder het node employmentNav/userNav .
    • Als het kenmerk deel uitmaakt van de EmpJob-entiteit , zoekt u het kenmerk onder het knooppunt employmentNav/jobInfoNav .
  3. Maak het JSON-pad dat is gekoppeld aan het kenmerk en voeg dit nieuwe kenmerk toe aan de lijst met SuccessFactors-kenmerken.

    • Voorbeeld 1: Stel dat u het kenmerk okToRehirewilt toevoegen, dat deel uitmaakt van employmentNav de entiteit en vervolgens het JSONPath gebruikt $.employmentNav.results[0].okToRehire
    • Voorbeeld 2: Stel dat u de tijdzone van het kenmerk wilt toevoegen, die deel uitmaakt van de entiteit userNav en vervolgens het JSONPath gebruikt$.employmentNav.results[0].userNav.timeZone
    • Voorbeeld 3: Stel dat u het kenmerk flsaStatus wilt toevoegen, dat deel uitmaakt van de jobInfoNav-entiteit en vervolgens het JSONPath gebruikt $.employmentNav.results[0].jobInfoNav.results[0].flsaStatus
  4. Sla het schema op.

  5. Inrichten opnieuw starten.

Aangepaste kenmerken ophalen

Standaard zijn de volgende aangepaste kenmerken vooraf gedefinieerd in de microsoft Entra SuccessFactors-inrichtings-app:

  • custom01-custom15 van de entiteit User (userNav)
  • customString1-customString15 van de entiteit EmpEmployment (employmentNav) met de naam empNavCustomString1-empNavCustomString15
  • customString1-customString15 van de entiteit EmpJobInfo (jobInfoNav) met de naam empJobNavCustomString1-empNavJobCustomString15

Stel dat in uw employee central-exemplaar het kenmerk customString35 in EmpJobInfo de locatiebeschrijving opslaat. U wilt deze waarde doorstromen naar het kenmerk PhysicalDeliveryOfficeName van Active Directory. Als u kenmerktoewijzing voor dit scenario wilt configureren, gebruikt u de volgende stappen:

  1. Bewerk de lijst met SuccessFactors-kenmerken om een nieuw kenmerk toe te voegen met de naam empJobNavCustomString35.
  2. Stel de JSONPath API-expressie voor dit kenmerk in als: $.employmentNav.results[0].jobInfoNav.results[0].customString35
  3. Sla de toewijzingswijziging op en laad deze opnieuw in het Microsoft Entra-beheercentrum.
  4. Wijs op de blade kenmerktoewijzing empJobNavCustomString35 toe aan physicalDeliveryOfficeName.
  5. Sla de toewijzing op.

Dit scenario uitbreiden:

  • Als u het aangepaste35-kenmerk van de entiteit Gebruiker wilt toewijzen, gebruikt u het JSONPath$.employmentNav.results[0].userNav.custom35
  • Als u het kenmerk customString35 wilt toewijzen vanuit de entiteit EmpEmployment, gebruikt u het JSONPath$.employmentNav.results[0].customString35

De status van de werkgelegenheid toewijzen aan de accountstatus

De Microsoft Entra SuccessFactors-connector gebruikt standaard het activeEmploymentsCount veld van het object om de PersonEmpTerminationInfo accountstatus in te stellen. Mogelijk ondervindt u een van de volgende problemen met dit kenmerk.

  1. Er is een bekend probleem waarbij de connector het account van een beëindigde werknemer één dag vóór de beëindiging op de laatste dag van het werk kan uitschakelen.
  2. Als het PersonEmpTerminationInfo object wordt ingesteld op null, werkt het uitschakelen van AD-accounts niet, omdat de inrichtingsengine records filtert waarin het personEmpTerminationInfoNav object is ingesteld op null.

Als u een van deze problemen ondervindt of de status van de werkgelegenheid wilt toewijzen aan de accountstatus, kunt u de toewijzing bijwerken om het emplStatus veld uit te vouwen en de werkstatuscode in het veld emplStatus.externalCodete gebruiken. Op basis van SAP-ondersteuningsnotitie 2505526 ziet u hier een lijst met statuscodes voor de werkgelegenheid die u kunt ophalen in de inrichtings-app.

  • A = Actief
  • D = Slapend
  • U = Onbetaald verlof
  • P = Betaald verlof
  • S = Onderbroken
  • F = Furlough
  • O = Verwijderd
  • R = Buiten gebruik gesteld
  • T = Beëindigd

Gebruik de stappen om uw toewijzing bij te werken om deze codes op te halen.

  1. Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.

  2. Klik onder Geavanceerde opties weergeven op De kenmerkenlijst SuccessFactors bewerken.

  3. Zoek het kenmerk emplStatus en werk het JSONPath bij naar $.employmentNav.results[0].jobInfoNav.results[0].emplStatusNav.externalCode. De update zorgt ervoor dat de connector de werkstatuscodes in de tabel ophaalt.

  4. De wijzigingen opslaan.

  5. Werk op de blade kenmerktoewijzing de expressietoewijzing voor de vlag accountstatus bij.

    Inrichtingstaak Accountstatuskenmerk Toewijzingsexpressie
    SuccessFactors naar Active Directory-gebruikersinrichting accountDisabled Switch([emplStatus], "True", "A", "False", "U", "False", "P", "False")
    SuccessFactors voor microsoft Entra-inrichting van gebruikers accountEnabled Switch([emplStatus], "False", "A", "True", "U", "True", "P", "True")
  6. De wijzigingen opslaan.

  7. Test de configuratie met behulp van inrichting op aanvraag.

  8. Nadat u hebt bevestigd dat de synchronisatie werkt zoals verwacht, start u de inrichtingstaak opnieuw.

Scenario's voor het verwerken van werkrollenconversie en -herbezetting

Over werkrolconversiescenario: Werkrolconversie is het proces van het converteren van een bestaande fulltime werknemer naar een aannemer of een contractant naar een fulltime-werknemer. In dit scenario voegt Employee Central een nieuwe EmpEmployment-entiteit toe, samen met een nieuwe gebruikersentiteit voor dezelfde persoonsentiteit . De entiteit Gebruiker die is genest onder de vorige EmpEmployment-entiteit , is ingesteld op null.

Over rehiring-scenario's: In SuccessFactors zijn er twee opties voor het verwerken van het opnieuw inschakelen van werknemers:

  • Optie 1: Een nieuw persoonsprofiel maken in Employee Central
  • Optie 2: Bestaand persoonsprofiel opnieuw gebruiken in Employee Central

Als uw HR-proces optie 1 gebruikt, zijn er geen wijzigingen nodig in het inrichtingsschema. Als uw HR-proces optie 2 gebruikt, voegt Employee Central een nieuwe EmpEmployment-entiteit toe, samen met een nieuwe gebruikersentiteit voor dezelfde persoonsentiteit .

U kunt beide scenario's afhandelen, zodat de nieuwe werkgelegenheidsgegevens worden weergegeven wanneer er een conversie of rehire plaatsvindt. Werk het schema van de inrichtings-app bulksgewijs bij met behulp van de vermelde stappen:

  1. Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.

  2. Schuif omlaag en klik op Geavanceerde opties weergeven.

  3. Klik op de koppeling Controleer uw schema hier om de schema-editor te openen.

    Schermopname van de koppeling Uw schema hier controleren waarmee de schema-editor wordt geopend.

  4. Klik op de koppeling Downloaden om een kopie van het schema op te slaan voordat u het bewerkt.

    Schermopname van de Schema-editor met Download selecteren om een kopie van het schema op te slaan.

  5. Druk in de schema-editor op Ctrl-H om het besturingselement zoeken en vervangen te openen.

  6. Kopieer en plak de waarde in het tekstvak Zoeken $.employmentNav.results[0]

  7. Kopieer en plak de waarde $.employmentNav.results[-1:]in het tekstvak Vervangen. Deze JSONPath-expressie retourneert de meest recente EmpEmployment-record .

    find-replace-conversion

  8. Klik op de optie Alles vervangen om het schema bij te werken.

  9. Sla het schema op.

  10. Met het bovenstaande proces worden alle JSONPath-expressies als volgt bijgewerkt:

    • Oud JSONPath: $.employmentNav.results[0].jobInfoNav.results[0].departmentNav.name_localized
    • Nieuw JSONPath: $.employmentNav.results[-1:].jobInfoNav.results[0].departmentNav.name_localized
  11. Test de configuratie met behulp van inrichting op aanvraag.

  12. Nadat u hebt bevestigd dat de synchronisatie werkt zoals verwacht, start u de inrichtingstaak opnieuw.

Notitie

De hierboven beschreven benadering werkt alleen als SAP SuccessFactors de werkgelegenheidsobjecten in oplopende volgorde retourneert, waarbij de laatste record altijd de laatste record is in de matrix met resultaten van employmentNav . De volgorde waarin meerdere arbeidsrecords worden geretourneerd, wordt niet gegarandeerd door SuccessFactors. Als uw SuccessFactors-exemplaar meerdere arbeidsrecords heeft die overeenkomen met een werknemer en u altijd kenmerken wilt ophalen die zijn gekoppeld aan de actieve arbeidsovereenkomst, gebruikt u de stappen die worden beschreven in de volgende sectie.

Huidige actieve arbeidsrecord ophalen

Het gebruik van de JSONPath-hoofdmap van of $.employmentNav.results[-1:] het ophalen van $.employmentNav.results[0] werkrecords werkt in de meeste scenario's en houdt de configuratie eenvoudig. Afhankelijk van hoe uw SuccessFactors-exemplaar is geconfigureerd, moet u deze configuratie mogelijk bijwerken om ervoor te zorgen dat de connector altijd de meest recente actieve arbeidsovereenkomstrecord ophaalt.

In deze sectie wordt beschreven hoe u de JSONPath-instellingen kunt bijwerken om zeker de huidige actieve werkrecord van de gebruiker op te halen. Het verwerkt ook werkrolconversie- en rehiringscenario's.

  1. Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.

  2. Schuif omlaag en klik op Geavanceerde opties weergeven.

  3. Klik op de koppeling Controleer uw schema hier om de schema-editor te openen.

  4. Klik op de koppeling Downloaden om een kopie van het schema op te slaan voordat u het bewerkt.

  5. Druk in de schema-editor op Ctrl-H om het besturingselement zoeken en vervangen te openen.

  6. Voer de volgende zoekbewerkingen uit. Zorg ervoor dat er geen voorloop- of volgruimte is bij het uitvoeren van de zoek-vervangbewerkingen. Als u [-1:] index gebruikt in plaats van [0], werkt u het veld tekenreeks-naar-find dienovereenkomstig bij.

    Tekenreeks om te zoeken Tekenreeks die moet worden gebruikt voor vervanging Doel
    $.employmentNav.results[0].jobInfoNav.results[0].emplStatus $.employmentNav..jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P' )].emplStatusNav.externalCode Met deze find-replace voegen we de mogelijkheid toe om het OData-object emplStatusNav uit te breiden.
    $.employmentNav.results[0].jobInfoNav.results[0] $.employmentNav..jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P')] Met deze find-replace geven we de connector de opdracht om altijd kenmerken op te halen die zijn gekoppeld aan de actieve SuccessFactors EmpJobInfo-record. Kenmerken die zijn gekoppeld aan beëindigde/inactieve records in SuccessFactors, worden genegeerd.
    $.employmentNav.results[0] $.employmentNav..results[?(@.jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P')])] Met deze find-replace geven we de connector de opdracht om altijd kenmerken op te halen die zijn gekoppeld aan de actieve SuccessFactors Employment-record. Kenmerken die zijn gekoppeld aan beëindigde/inactieve records in SuccessFactors, worden genegeerd.
  7. Sla het schema op.

  8. Met het bovenstaande proces worden alle JSONPath-expressies bijgewerkt.

  9. De prehire-verwerking werkt alleen als het JSONPath dat aan het kenmerk is gekoppeld startDate , ofwel [0] een [-1:] index gebruikt. Klik onder Geavanceerde opties weergeven op De kenmerkenlijst SuccessFactors bewerken. Zoek het kenmerk startDate en stel het in op de waarde $.employmentNav.results[-1:].startDate

  10. Sla het schema op.

  11. Om ervoor te zorgen dat beëindigingen worden verwerkt zoals verwacht, kunt u een van de volgende instellingen in de sectie kenmerktoewijzing gebruiken.

    Inrichtingstaak Accountstatuskenmerk Expressie die moet worden gebruikt als de accountstatus is gebaseerd op 'activeEmploymentsCount' Expressie die moet worden gebruikt als de accountstatus is gebaseerd op de waarde 'emplStatus'.
    SuccessFactors naar Active Directory-gebruikersinrichting accountDisabled Switch([activeEmploymentsCount], "False", "0", "True") Switch([emplStatus], "True", "A", "False", "U", "False", "P", "False")
    SuccessFactors voor microsoft Entra-inrichting van gebruikers accountEnabled Switch([activeEmploymentsCount], "True", "0", "False") Switch([emplStatus], "False", "A", "True", "U", "True", "P", "True")
  12. Sla uw wijzigingen op. 1.

  13. Test de configuratie met behulp van inrichting op aanvraag.

  14. Nadat u hebt bevestigd dat de synchronisatie werkt zoals verwacht, start u de inrichtingstaak opnieuw.

Globale toewijzingsscenario verwerken

Wanneer een gebruiker in Employee Central wordt verwerkt voor globale toewijzing, voegt SuccessFactors een nieuwe EmpEmployment-entiteit toe en stelt de assignmentClass in op 'GA'. Er wordt ook een nieuwe gebruikersentiteit gemaakt. De gebruiker heeft dus nu:

  • Eén EmpEmployment + User-entiteit die overeenkomt met de thuistoewijzing met assignmentClass ingesteld op 'ST' en
  • Een andere EmpEmployment + User-entiteit die overeenkomt met de globale toewijzing met assignmentClass ingesteld op 'GA'

Als u kenmerken wilt ophalen die behoren tot het standaardtoewijzings- en globale toewijzingsgebruikersprofiel, gebruikt u de volgende stappen:

  1. Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.

  2. Schuif omlaag en klik op Geavanceerde opties weergeven.

  3. Klik op de koppeling Controleer uw schema hier om de schema-editor te openen.

  4. Klik op de koppeling Downloaden om een kopie van het schema op te slaan voordat u het bewerkt.

  5. Druk in de schema-editor op Ctrl-H om het besturingselement zoeken en vervangen te openen.

  6. Kopieer en plak de waarde in het tekstvak Zoeken $.employmentNav.results[0]

  7. Kopieer en plak de waarde $.employmentNav.results[?(@.assignmentClass == 'ST')]in het tekstvak Vervangen. Let op de witruimte rond de operator == die belangrijk is voor een succesvolle verwerking van de JSONPath-expressie.

  8. Klik op de optie Alles vervangen om het schema bij te werken.

  9. Sla het schema op.

  10. Met het bovenstaande proces worden alle JSONPath-expressies als volgt bijgewerkt:

    • Oud JSONPath: $.employmentNav.results[0].jobInfoNav.results[0].departmentNav.name_localized
    • Nieuw JSONPath: $.employmentNav.results[?(@.assignmentClass == 'ST')].jobInfoNav.results[0].departmentNav.name_localized
  11. Laad de blade kenmerktoewijzing van de app opnieuw.

  12. Schuif omlaag en klik op Geavanceerde opties weergeven.

  13. Klik op Kenmerkenlijst bewerken voor SuccessFactors.

  14. Voeg nieuwe kenmerken toe om globale toewijzingsgegevens op te halen. Als u bijvoorbeeld de afdelingsnaam wilt ophalen die is gekoppeld aan een globaal toewijzingsprofiel, kunt u het kenmerk globalAssignmentDepartment toevoegen met de JSONPath-expressie ingesteld op $.employmentNav.results[?(@.assignmentClass == 'GA')].jobInfoNav.results[0].departmentNav.name_localized.

  15. U kunt nu beide afdelingswaarden naar Active Directory-kenmerken laten stromen of selectief een waarde laten stromen met behulp van expressietoewijzing. Voorbeeld: met de expressie wordt de waarde van het AD-afdelingskenmerk ingesteld op globalAssignmentDepartment indien aanwezig, anders wordt de waarde ingesteld op afdeling die is gekoppeld aan standaardtoewijzing.

    • IIF(IsPresent([globalAssignmentDepartment]),[globalAssignmentDepartment],[department])
  16. Sla de toewijzing op.

  17. Test de configuratie met behulp van inrichting op aanvraag.

  18. Nadat u hebt bevestigd dat de synchronisatie werkt zoals verwacht, start u de inrichtingstaak opnieuw.

Scenario voor gelijktijdige taken verwerken

Wanneer een gebruiker in Employee Central gelijktijdige/meerdere taken heeft, zijn er twee EmpEmployment - en Gebruikersentiteiten met assignmentClass ingesteld op 'ST'. Als u kenmerken van beide taken wilt ophalen, gebruikt u de volgende stappen:

  1. Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.
  2. Schuif omlaag en klik op Geavanceerde opties weergeven.
  3. Klik op Kenmerkenlijst bewerken voor SuccessFactors.
  4. Stel dat u de afdeling wilt ophalen die is gekoppeld aan taak 1 en job 2. De vooraf gedefinieerde kenmerkafdeling haalt al de waarde van de afdeling voor de eerste taak op. U kunt een nieuw kenmerk met de naam secondJobDepartment definiëren en de JSONPath-expressie instellen op $.employmentNav.results[1].jobInfoNav.results[0].departmentNav.name_localized
  5. U kunt nu beide afdelingswaarden naar Active Directory-kenmerken laten stromen of selectief een waarde laten stromen met behulp van expressietoewijzing.
  6. Sla de toewijzing op.
  7. Test de configuratie met behulp van inrichting op aanvraag.
  8. Nadat u hebt bevestigd dat de synchronisatie werkt zoals verwacht, start u de inrichtingstaak opnieuw.

Positiedetails ophalen

De SuccessFactors-connector ondersteunt uitbreiding van het positieobject. Als u positieobjectkenmerken zoals taakniveau of positienamen in een specifieke taal wilt uitvouwen en ophalen, kunt u JSONPath-expressies gebruiken zoals wordt weergegeven.

Kenmerknaam JSONPath-expressie
positionJobLevel $.employmentNav.results[0].jobInfoNav.results[0].positionNav.jobLevel
positionNameFR $.employmentNav.results[0].jobInfoNav.results[0].positionNav.externalName_fr_FR
positionNameDE $.employmentNav.results[0].jobInfoNav.results[0].positionNav.externalName_de_DE

Gebruikers inrichten in de onboarding-module

Het inrichten van binnenkomende gebruikers van SAP SuccessFactors naar on-premises Active Directory en Microsoft Entra ID biedt nu ondersteuning voor het vooraf inrichten van prehires die aanwezig zijn in de module SAP SuccessFactors Onboarding 2.0. Wanneer de Microsoft Entra-inrichtingsservice een nieuw huurprofiel tegenkomt met een toekomstige begindatum, vraagt deze SAP SuccessFactors om nieuwe medewerkers te krijgen met een van de volgende statuscodes: active, , active_external_suiteinactive. De statuscode active_external_suite komt overeen met prehires die aanwezig zijn in de module SAP SuccessFactors Onboarding 2.0. Raadpleeg de SAP-ondersteuningsnotitie 2736579 voor een beschrijving van deze statuscodes.

Het standaardgedrag van de inrichtingsservice is het verwerken van prehires in de onboarding-module.

Als u de verwerking van prehires in de onboarding-module wilt uitsluiten, werkt u de configuratie van de inrichtingstaak als volgt bij:

  1. Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.
  2. Bewerk onder Geavanceerde opties de lijst met SuccessFactors-kenmerken om een nieuw kenmerk toe te voegen met de naam userStatus.
  3. Stel de JSONPath API-expressie voor dit kenmerk in als: $.employmentNav.results[0].userNav.status
  4. Sla het schema op om terug te keren naar de blade kenmerktoewijzing.
  5. Het bereik bronobject bewerken om een bereikfilter toe te passen userStatus NOT EQUALS
  6. Sla de toewijzing op en controleer of het bereikfilter werkt met inrichting op aanvraag.

Auditlogboeken voor OData-API inschakelen in SuccessFactors

De Microsoft Entra SuccessFactors-connector maakt gebruik van successFactors OData-API om wijzigingen op te halen en gebruikers in te richten. Als u problemen ondervindt met de inrichtingsservice en wilt controleren welke gegevens zijn opgehaald uit SuccessFactors, kunt u OData API-auditlogboeken inSchakelen in SuccessFactors. Haal de nettolading van de aanvraag op die door Microsoft Entra-id is verzonden uit de auditlogboeken. Als u problemen wilt oplossen, kunt u deze nettolading van de aanvraag kopiëren in een hulpprogramma, zoals cURL of Graph Explorer, instellen om dezelfde API-gebruiker te gebruiken die door de connector wordt gebruikt en te zien of deze de gewenste wijzigingen van SuccessFactors retourneert.

Scenario's voor terugschrijven

In deze sectie worden verschillende scenario's voor write-back behandeld. Het raadt configuratiemethoden aan op basis van hoe e-mail en telefoonnummer in SuccessFactors worden ingesteld.

Ondersteunde scenario's voor terugschrijven van telefoon en e-mail

# Scenariovereiste Primaire e-mail
vlagwaarde
Zakelijke telefoon
primaire vlagwaarde
Mobieltje
primaire vlagwaarde
Zakelijke telefoon
mapping
Mobieltje
mapping
1 * Stel alleen zakelijke e-mail in als primair.
* Stel geen telefoonnummers in.
true true false [Niet ingesteld] [Niet ingesteld]
2 * In SuccessFactors is zakelijke e-mail en zakelijke telefoon primair
* Flow Microsoft Entra phone to business phone and mobile to cell phone.
true true false telephoneNumber mobiele apparaten
3 * In SuccessFactors is zakelijke e-mail en mobiele telefoon primair
* Flow Microsoft Entra phone to business phone and mobile to cell phone
true false true telephoneNumber mobiele apparaten
4 * In De zakelijke e-mail van SuccessFactors is primair.
* Controleer in Microsoft Entra ID of het telefoonnummer van het werk aanwezig is, indien aanwezig, en controleer of er ook een mobiel nummer aanwezig is. Markeer werktelefoonnummer alleen als primair als mobiel nummer niet aanwezig is.
true Expressietoewijzing gebruiken: IIF(IsPresent([telephoneNumber]), IIF(IsPresent([mobile]),"false", "true"), "false") Expressietoewijzing gebruiken: IIF(IsPresent([mobile]),"false", "true") telephoneNumber mobiele apparaten
5 * In SuccessFactors zakelijke e-mail en zakelijke telefoon is primair.
* In Microsoft Entra ID, als mobiel beschikbaar is, stelt u deze in als de zakelijke telefoon, anders gebruikt u telephoneNumber.
true true false IIF(IsPresent([mobile]), [mobile], [telephoneNumber]) [Niet ingesteld]
  • Als er geen toewijzing is voor telefoonnummer in de kenmerktoewijzing write-back, wordt alleen e-mail opgenomen in de write-back.
  • Tijdens het onboarden van nieuwe medewerkers in Employee Central zijn zakelijke e-mail en telefoonnummer mogelijk niet beschikbaar. Als het instellen van zakelijke e-mail en zakelijke telefoon als primair verplicht is tijdens de onboarding, kunt u een dummywaarde instellen voor zakelijke telefoon en e-mail tijdens het maken van nieuwe medewerkers. Na enige tijd werkt de write-back-app de waarde bij.

Writeback inschakelen met UserID

De SuccessFactors Writeback-app gebruikt de volgende logica om de kenmerken van het gebruikersobject bij te werken:

  • Als eerste stap zoekt het naar het kenmerk userId in de wijzigingenset. Als deze aanwezig is, wordt 'UserId' gebruikt voor het maken van de SuccessFactors-API-aanroep.
  • Als userId niet wordt gevonden, wordt standaard de waarde van het kenmerk personIdExternal gebruikt.

Meestal komt de kenmerkwaarde personIdExternal in SuccessFactors overeen met de waarde van het userId-kenmerk . In scenario's zoals rehiring en werkrolconversie kan een werknemer in SuccessFactors echter twee arbeidsrecords hebben, één actief en één inactief. In dergelijke scenario's, om ervoor te zorgen dat write-back het actieve gebruikersprofiel bijwerkt, werkt u de configuratie van de successFactors-inrichtings-apps bij zoals beschreven. Deze configuratie zorgt ervoor dat userId altijd aanwezig is in de wijzigingenset die zichtbaar is voor de connector en wordt gebruikt in de Aanroep van de SuccessFactors-API.

  1. Open de SuccessFactors-app voor het inrichten van gebruikers in Microsoft Entra of SuccessFactors voor on-premises AD-gebruikersinrichtingsapp.
  2. Zorg ervoor dat extensionAttribute[1-15] in Microsoft Entra ID altijd de userId actieve arbeidsrecord van elke werknemer wordt opgeslagen. De record wijst het kenmerk SuccessFactors userId toe aan extensionAttribute[1-15] in Microsoft Entra ID.

    Toewijzing van inkomende gebruikers-id-kenmerken

  3. Raadpleeg voor richtlijnen met betrekking tot JSONPath-instellingen de sectie Werkrolconversie en -rehiring-scenario's om ervoor te zorgen dat de userId-waarde van de actieve werkgelegenheidsrecord naar Microsoft Entra-id stroomt.
  4. Sla de toewijzing op.
  5. Voer de inrichtingstaak uit om ervoor te zorgen dat de userId-waarden naar Microsoft Entra-id stromen.

    Notitie

    Als u SuccessFactors gebruikt voor het inrichten van on-premises Active Directory-gebruikers, configureert u Microsoft Entra Connect om de waarde van het kenmerk userId van on-premises Active Directory te synchroniseren met Microsoft Entra ID.

  6. Open de SuccessFactors Writeback-app in Azure Portal.
  7. Wijs de gewenste extensionAttribute die de userId-waarde bevat toe aan het kenmerk SuccessFactors userId .

    Kenmerktoewijzing UserID terugschrijven

  8. Sla de toewijzing op.
  9. Ga naar Kenmerktoewijzing -> Geavanceerd -> Schema controleren om de JSON-schema-editor te openen.
  10. Download een kopie van het schema als back-up.
  11. Druk in de schema-editor op Ctrl-F en zoek naar het JSON-knooppunt met de toewijzing van de userId, waar het is toegewezen aan een bronkenmerk van Microsoft Entra.
  12. Werk het kenmerk flowBehavior bij van FlowWhenChanged naar FlowAlways, zoals wordt weergegeven.

    Update van toewijzingsstroomgedrag

  13. Sla de toewijzing op en test het write-back-scenario met provisioning-on-demand.

Niet-ondersteunde scenario's voor terugschrijven van telefoon en e-mail

  • In Employee Central wordt tijdens het onboarden van persoonlijke e-mail en persoonlijke telefoon ingesteld als primair. De write-back-app kan deze instelling niet wijzigen en zakelijke e-mail en zakelijke telefoon instellen als primair.
  • In Employee Central wordt de zakelijke telefoon ingesteld als primair. De write-back-app kan dit niet wijzigen en mobiele telefoon instellen als primair.
  • De write-back-app kan de huidige primaire vlaginstellingen niet lezen en dezelfde waarden gebruiken voor de schrijfbewerking. De vlagwaarden die in de kenmerktoewijzing zijn geconfigureerd, worden altijd gebruikt.

Volgende stappen