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:
- SuccessFactors voor het inrichten van on-premises Active Directory-gebruikers
- SuccessFactors voor microsoft Entra-inrichting van gebruikers
- SuccessFactors Writeback
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:
- Download de nieuwste IP-bereiken voor de openbare Azure-cloud.
- Open het bestand en zoek naar tag
AzureActiveDirectory
. - Kopieer alle IP-adresbereiken die worden vermeld in de element addressPrefixes en gebruik het bereik om uw IP-adresbeperkingslijst te maken.
- Vertaal de CIDR-waarden naar IP-bereiken.
- 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 | Beschrijving |
---|---|
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
, endDate
startDate
, 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 SuccessFactorsAPIEndpoint
LastExecutionTimestamp
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
, personIdExternal
en startDate
firstname
lastname
is beschikbaar. Om pre-hires succesvol te kunnen verwerken, moet aan de volgende vereisten worden voldaan:
- 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. - Het
startDate
kenmerk moet beschikbaar zijn en het JSONPath moet zijn ingesteld op of$.employmentNav.results[0].startDate
$.employmentNav.results[-1:].startDate
. - 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:
Blader naar de bedrijfstoepassingen ->SuccessFactors-app ->Provisioning ->Edit Provisioning ->attribute-mapping page.
Schuif omlaag en klik op Geavanceerde opties weergeven.
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.
In de kolom API-expressie in deze weergave worden de JSONPath-expressies weergegeven die door de connector worden gebruikt.
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
- Aangepaste kenmerken ophalen
- De status van de werkgelegenheid toewijzen aan de accountstatus
- Scenario's voor het verwerken van werkrollenconversie en -herbezetting
- Huidige actieve arbeidsrecord ophalen
- Globale toewijzingsscenario verwerken
- Scenario voor gelijktijdige taken verwerken
- Positiedetails ophalen
- Gebruikers inrichten in de onboarding-module
- Auditlogboeken voor OData-API inschakelen in SuccessFactors
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:
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
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 .
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
okToRehire
wilt toevoegen, dat deel uitmaakt vanemploymentNav
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
- Voorbeeld 1: Stel dat u het kenmerk
Sla het schema op.
Start de inrichting opnieuw.
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:
- Bewerk de lijst met SuccessFactors-kenmerken om een nieuw kenmerk toe te voegen met de naam empJobNavCustomString35.
- Stel de JSONPath API-expressie voor dit kenmerk in als:
$.employmentNav.results[0].jobInfoNav.results[0].customString35
- Sla de toewijzingswijziging op en laad deze opnieuw in het Microsoft Entra-beheercentrum.
- Wijs op de blade kenmerktoewijzing empJobNavCustomString35 toe aan physicalDeliveryOfficeName.
- 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.
- 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.
- Als het
PersonEmpTerminationInfo
object wordt ingesteld op null, werkt het uitschakelen van AD-accounts niet, omdat de inrichtingsengine records filtert waarin hetpersonEmpTerminationInfoNav
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.externalCode
te 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.
Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.
Klik onder Geavanceerde opties weergeven op De kenmerkenlijst SuccessFactors bewerken.
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.Sla de wijzigingen op.
Werk op de blade kenmerktoewijzing de expressietoewijzing voor de vlag accountstatus bij.
Inrichtingstaak Accountstatuskenmerk Toewijzingsexpressie SuccessFactors voor 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")
Sla de wijzigingen op.
Test de configuratie met behulp van inrichting op aanvraag.
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:
Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.
Schuif omlaag en klik op Geavanceerde opties weergeven.
Klik op de koppeling Controleer uw schema hier om de schema-editor te openen.
Klik op de koppeling Downloaden om een kopie van het schema op te slaan voordat u het bewerkt.
Druk in de schema-editor op Ctrl-H om het besturingselement zoeken en vervangen te openen.
Kopieer en plak de waarde in het tekstvak Zoeken
$.employmentNav.results[0]
Kopieer en plak de waarde
$.employmentNav.results[-1:]
in het tekstvak Vervangen. Deze JSONPath-expressie retourneert de meest recente EmpEmployment-record .Klik op de optie Alles vervangen om het schema bij te werken.
Sla het schema op.
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
- Oud JSONPath:
Test de configuratie met behulp van inrichting op aanvraag.
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.
Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.
Schuif omlaag en klik op Geavanceerde opties weergeven.
Klik op de koppeling Controleer uw schema hier om de schema-editor te openen.
Klik op de koppeling Downloaden om een kopie van het schema op te slaan voordat u het bewerkt.
Druk in de schema-editor op Ctrl-H om het besturingselement zoeken en vervangen te openen.
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. Sla het schema op.
Met het bovenstaande proces worden alle JSONPath-expressies bijgewerkt.
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 kenmerkstartDate
en stel het in op de waarde$.employmentNav.results[-1:].startDate
Sla het schema op.
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 voor 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")
Sla uw wijzigingen op. 1.
Test de configuratie met behulp van inrichting op aanvraag.
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:
Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.
Schuif omlaag en klik op Geavanceerde opties weergeven.
Klik op de koppeling Controleer uw schema hier om de schema-editor te openen.
Klik op de koppeling Downloaden om een kopie van het schema op te slaan voordat u het bewerkt.
Druk in de schema-editor op Ctrl-H om het besturingselement zoeken en vervangen te openen.
Kopieer en plak de waarde in het tekstvak Zoeken
$.employmentNav.results[0]
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.Klik op de optie Alles vervangen om het schema bij te werken.
Sla het schema op.
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
- Oud JSONPath:
Laad de blade kenmerktoewijzing van de app opnieuw.
Schuif omlaag en klik op Geavanceerde opties weergeven.
Klik op Kenmerkenlijst bewerken voor SuccessFactors.
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
.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])
Sla de toewijzing op.
Test de configuratie met behulp van inrichting op aanvraag.
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:
- Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.
- Schuif omlaag en klik op Geavanceerde opties weergeven.
- Klik op Kenmerkenlijst bewerken voor SuccessFactors.
- 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
- U kunt nu beide afdelingswaarden naar Active Directory-kenmerken laten stromen of selectief een waarde laten stromen met behulp van expressietoewijzing.
- Sla de toewijzing op.
- Test de configuratie met behulp van inrichting op aanvraag.
- 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_suite
inactive
. 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:
- Open de blade kenmerktoewijzing van uw SuccessFactors-inrichtings-app.
- Bewerk onder Geavanceerde opties de lijst met SuccessFactors-kenmerken om een nieuw kenmerk toe te voegen met de naam
userStatus
. - Stel de JSONPath API-expressie voor dit kenmerk in als:
$.employmentNav.results[0].userNav.status
- Sla het schema op om terug te keren naar de blade kenmerktoewijzing.
- Het bereik bronobject bewerken om een bereikfilter toe te passen
userStatus NOT EQUALS
- 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 kartering |
Mobieltje kartering |
---|---|---|---|---|---|---|
1 | * Stel alleen zakelijke e-mail in als primair. * Stel geen telefoonnummers in. |
waar | waar | vals | [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. |
waar | waar | vals | telephoneNumber | mobiel |
3 | * In SuccessFactors is zakelijke e-mail en mobiele telefoon primair * Flow Microsoft Entra phone to business phone and mobile to cell phone |
waar | vals | waar | telephoneNumber | mobiel |
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. |
waar | Expressietoewijzing gebruiken: IIF(IsPresent([telephoneNumber]), IIF(IsPresent([mobile]),"false", "true"), "false") |
Expressietoewijzing gebruiken: IIF(IsPresent([mobile]),"false", "true") |
telephoneNumber | mobiel |
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. |
waar | waar | vals | 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.
- Open de SuccessFactors-app voor het inrichten van gebruikers in Microsoft Entra of SuccessFactors voor on-premises AD-gebruikersinrichtingsapp.
- Zorg ervoor dat
extensionAttribute[1-15]
in Microsoft Entra ID altijd deuserId
actieve arbeidsrecord van elke werknemer wordt opgeslagen. De record wijst het kenmerk SuccessFactorsuserId
toe aanextensionAttribute[1-15]
in Microsoft Entra ID. - 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.
- Sla de toewijzing op.
- 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.
- Open de SuccessFactors Writeback-app in Azure Portal.
- Wijs de gewenste extensionAttribute die de userId-waarde bevat toe aan het kenmerk SuccessFactors userId .
- Sla de toewijzing op.
- Ga naar Kenmerktoewijzing -> Geavanceerd -> Schema controleren om de JSON-schema-editor te openen.
- Download een kopie van het schema als back-up.
- 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.
- Werk het kenmerk flowBehavior bij van FlowWhenChanged naar FlowAlways, zoals wordt weergegeven.
- 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.