Integration der Microsoft Entra-Bereitstellung mit SAP SuccessFactors

Der Microsoft Entra-Benutzerbereitstellungsdienst ist in SAP SuccessFactors Employee Central integriert, um den Identitätslebenszyklus von Benutzern zu verwalten. Microsoft Entra ID bietet drei vorbereitete Integrationen:

• SuccessFactors für die lokale Active Directory-Benutzerbereitstellung
• SuccessFactors für die Microsoft Entra-Benutzerbereitstellung
• SuccessFactors-Rückmeldung

In diesem Artikel wird erläutert, wie die Integration funktioniert und wie Sie das Bereitstellungsverhalten für verschiedene HR-Szenarien anpassen können.

Microsoft Entra unterstützt auch einmaliges Anmelden bei SuccessFactors. Weitere Informationen finden Sie unter Microsoft Entra Single Sign-On (SSO)-Integration in SuccessFactors.

Herstellen von Verbindungen

Der Microsoft Entra-Bereitstellungsdienst verwendet für das Erstellen einer Verbindung mit den OData-API-Endpunkten von Employee Central die Standardauthentifizierung. Verwenden Sie beim Einrichten der SuccessFactors-Bereitstellungs-App den Parameter "Mandanten-URL " im Abschnitt " Administratoranmeldeinformationen ", um die API-Rechenzentrums-URL zu konfigurieren.

Um die Konnektivität zwischen dem Microsoft Entra-Bereitstellungsdienst und SuccessFactors besser zu schützen, fügen Sie die Microsoft Entra-IP-Adressbereiche der Liste der zugelassenen IP-Adressen von SuccessFactors hinzu:

1. Laden Sie die neuesten IP-Bereiche für die azure Public Cloud herunter.
2. Öffnen Sie die Datei und suchen Sie nach dem Tag AzureActiveDirectory.
3. Kopieren Sie alle ip-Adressbereiche, die innerhalb der ElementadressePrefixes aufgeführt sind, und verwenden Sie den Bereich, um Ihre IP-Adresseinschränkungsliste zu erstellen.
4. Übersetzen Sie die CIDR-Werte in IP-Adressbereiche.
5. Melden Sie sich beim SuccessFactors-Administratorportal an, um der Positivliste IP-Adressbereiche hinzuzufügen. Siehe SAP-Supporthinweis 2253200. Sie können jetzt IP-Bereiche in dieses Tool eingeben.

Unterstützte Entitäten

Der Microsoft Entra-Bereitstellungsdienst ruft für jeden Benutzer in SuccessFactors die folgenden Entitäten ab. Jede Entität wird mit der OData-API $expand Abfrageparameter erweitert, wie in der Spalte " Abrufregel " beschrieben. Einige Entitäten werden standardmäßig erweitert, während andere Entitäten nur erweitert werden, wenn ein bestimmtes Attribut in der Zuordnung vorhanden ist.

#	SuccessFactors-Entität	OData-Knoten	Abrufregel
1	PerPerson	*root node*	Immer
2	PerPersonal	personalInfoNav	Immer
3	PerPhone	phoneNav	Immer
4	PerEmail	emailNav	Immer
5	EmpEmployment	employmentNav	Immer
6	User	employmentNav/userNav	Immer
7	EmpJob	employmentNav/jobInfoNav	Immer
8	EmpEmploymentTermination	activeEmploymentsCount	Immer
9	User's manager	employmentNav/userNav/manager/empInfo	Immer
10	FOCompany	employmentNav/jobInfoNav/companyNav	Nur, wenn eines der Attribute company oder companyId zugeordnet ist
11	FODepartment	employmentNav/jobInfoNav/departmentNav	Nur, wenn eines der Attribute department oder departmentId zugeordnet ist
12	FOBusinessUnit	employmentNav/jobInfoNav/businessUnitNav	Nur, wenn eines der Attribute businessUnit oder businessUnitId zugeordnet ist
13	FOCostCenter	employmentNav/jobInfoNav/costCenterNav	Nur, wenn eines der Attribute costCenter oder costCenterId zugeordnet ist
14	FODivision	employmentNav/jobInfoNav/divisionNav	Nur, wenn eines der Attribute division oder divisionId zugeordnet ist
15	FOJobCode	employmentNav/jobInfoNav/jobCodeNav	Nur, wenn eines der Attribute jobCode oder jobCodeId zugeordnet ist
16	FOPayGrade	employmentNav/jobInfoNav/payGradeNav	Nur, wenn das Attribut payGrade zugeordnet ist
17	FOLocation	employmentNav/jobInfoNav/locationNav	Nur, wenn das Attribut location zugeordnet ist
18	FOCorporateAddressDEFLT	employmentNav/jobInfoNav/addressNavDEFLT	Wenn die Zuordnung eines der folgenden Attribute enthält: officeLocationAddress, officeLocationCity, officeLocationZipCode
19	FOEventReason	employmentNav/jobInfoNav/eventReasonNav	Nur, wenn das Attribut eventReason zugeordnet ist
20	EmpGlobalAssignment	employmentNav/empGlobalAssignmentNav	Nur, wenn assignmentType zugeordnet ist
21	EmploymentType Picklist	employmentNav/jobInfoNav/employmentTypeNav	Nur, wenn employmentType zugeordnet ist
22	EmployeeClass Picklist	employmentNav/jobInfoNav/employeeClassNav	Nur, wenn employeeClass zugeordnet ist
23	EmplStatus Picklist	employmentNav/jobInfoNav/emplStatusNav	Nur, wenn emplStatus zugeordnet ist
24	AssignmentType Picklist	employmentNav/empGlobalAssignmentNav/assignmentTypeNav	Nur, wenn assignmentType zugeordnet ist
25	Position	employmentNav/jobInfoNav/positionNav	Nur, wenn positioNav zugeordnet ist
26	Manager User	employmentNav/jobInfoNav/managerUserNav	Nur, wenn managerUserNav zugeordnet ist

Funktionsweise der vollständigen Synchronisierung

Basierend auf der Attributzuordnung sendet der Microsoft Entra-Bereitstellungsdienst während der vollständigen Synchronisierung die folgende „GET“-Abfrage der OData-API, um die tatsächlichen Daten aller aktiven und ausgeschiedenen Arbeitnehmer abzurufen.

Parameter	BESCHREIBUNG
OData-API-Host	Fügt https an die Mandanten-URL an. Beispiel: https://api4.successfactors.com
OData-API-Endpoint	/odata/v2/PerPerson
OData-Abfrageparameter $format	json
OData-Abfrageparameter $filter	(personEmpTerminationInfoNav/activeEmploymentsCount ne null) and (lastModifiedDateTime le <CurrentExecutionTime>)
OData-Abfrageparameter $expand	Dieser Parameterwert hängt von den zugeordneten Attributen ab. Beispiel: employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,phoneNav,emailNav,employmentNav/jobInfoNav/companyNav/countryOfRegistrationNav,employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav
OData-Abfrageparameter customPageSize	100

Hinweis

Während der vollständigen anfänglichen Synchronisierung werden sowohl aktive als auch ausgetretene Mitarbeiter von SAP SuccessFactors abgerufen.

Für jeden SuccessFactors-Benutzer sucht der Bereitstellungsdienst mithilfe des in der Zuordnung definierten zugehörigen Attributs nach einem Konto im Ziel (Microsoft Entra ID/lokales Active Directory). Beispiel: Wenn "personIdExternal" "employeeId" zugeordnet ist und als übereinstimmende Attribut festgelegt wird, verwendet der Bereitstellungsdienst den wert "personIdExternal", um nach dem Benutzer mit dem EmployeeId-Filter zu suchen. Wenn ein übereinstimmender Benutzer gefunden wird, aktualisiert er die Zielattribute. Wenn keine Übereinstimmung gefunden wird, erstellt er am Ziel einen neuen Eintrag.

Um die von Ihrem OData-API-Endpunkt zurückgegebenen Daten für ein bestimmtes personIdExternal zu validieren, aktualisieren Sie den SuccessFactorsAPIEndpoint in der API-Abfrage mit der URL Ihres API-Rechenzentrum-Servers und verwenden Sie ein Tool wie cURL oder Graph-Tester, um die Abfrage aufzurufen. Wenn der Filter „in“ nicht funktioniert, können Sie den Filter „gleich“ ausprobieren.

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

Funktionsweise der inkrementellen Synchronisierung

Nach der vollständigen Synchronisierung verwaltet der Microsoft Entra-Bereitstellungsdienst einen LastExecutionTimestamp und verwendet diesen zum Erstellen von Deltaabfragen für das Abrufen inkrementeller Änderungen. Die Zeitstempelattribute, die in jeder SuccessFactors-Entität enthalten sind (z. B. lastModifiedDateTime, startDate, endDate oder latestTerminationDate), werden ausgewertet, um festzustellen, ob die Änderung zwischen dem LastExecutionTimestamp und der CurrentExecutionTime liegt. Falls dies zutrifft, gilt die Änderung des Eintrags als wirksam und wird für die Synchronisierung verarbeitet.

Hier sehen Sie die OData-API-Anforderungsvorlage, die Microsoft Entra ID zum Abfragen von inkrementellen Änderungen bei SuccessFactors verwendet. Sie können die Variablen SuccessFactorsAPIEndpoint, LastExecutionTimestamp und CurrentExecutionTime in der Anforderungsvorlage aktualisieren und ein Tool wie cURL oder Graph-Tester verwenden, um zu prüfen, welche Daten zurückgegeben werden. Alternativ können Sie auch die tatsächliche Anforderungsnutzlast von SuccessFactors abrufen, indem Sie OData-API-Überwachungsprotokolle aktivieren.

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

Funktionsweise der Verarbeitung von Mitarbeitern vor der Einstellung

In diesem Abschnitt wird erläutert, wie der SAP SuccessFactors-Connector Datensätze von Mitarbeitern vor der Einstellung verarbeitet (Mitarbeiter mit Einstellungsdatum/Startdatum in der Zukunft). Angenommen, es gibt einen Mitarbeiter vor der Einstellung mit der employeeId „1234“ in SuccessFactors Employee Central mit dem Startdatum 1. Juni 2023. Nehmen wir weiter an, dass dieser Datensatz des Mitarbeiters vor der Einstellung zuerst entweder in Employee Central oder im Onboarding-Modul am 15. Mai 2023 erstellt wurde. Wenn der Bereitstellungsdienst diesen Datensatz am 15 Mai 2023 (entweder als Teil der vollständigen Synchronisierung oder im Rahmen der inkrementellen Synchronisierung) zum ersten Mal beobachtet, befindet sich dieser Datensatz immer noch im Status vor der Einstellung. Aus diesem Grund sendet SuccessFactors dem Bereitstellungsdienst nicht alle Attribute (Beispiel: userNav/username), die dem Benutzer zugeordnet sind. Nur minimale Daten über den Benutzer wie companyName, personIdExternal, firstname, lastname und startDate sind verfügbar. Um Mitarbeiter vor der Einstellung erfolgreich zu bearbeiten, müssen die folgenden Voraussetzungen erfüllt sein:

1. Das Attribut personIdExternal muss als primär übereinstimmender Bezeichner (Verknüpfungseigenschaft) festgelegt werden. Wenn Sie ein anderes Attribut (Beispiel: userName) als Verknüpfungseigenschaft konfigurieren, kann der Bereitstellungsdienst die Informationen von Mitarbeitern vor der Einstellung nicht abrufen.
2. Das Attribut startDate muss verfügbar sein, und sein JSONPath muss auf $.employmentNav.results[0].startDate oder $.employmentNav.results[-1:].startDate festgelegt werden.
3. Der Datensatz von Mitarbeitern vor der Einstellung muss sich in Employee Central in einem der folgenden Status befinden: „active“ (t), „inactive“ (f) oder „active_external_suite“ (e). Ausführliche Informationen zu diesen Zuständen finden Sie im SAP-Supporthinweis 2736579.

Hinweis

Für einen Mitarbeiter vor der Einstellung, der keine Vorgeschichte mit der Organisation hat, funktionieren sowohl der Index [0] als auch [-1:] für startDate. Für einen Mitarbeiter vor der Einstellung, bei dem es sich um einen wieder eingestellten oder konvertierten Mitarbeiter handelt, können wir die Reihenfolge nicht deterministisch angeben, und dies kann dazu führen, dass bestimmte wieder eingestellte/konvertierte Mitarbeiter zu ihrem tatsächlichen Startdatum verarbeitet werden. Dies ist eine bekannte Einschränkung im Connector.

Wenn der Bereitstellungsdienst während der vollständigen oder inkrementellen Synchronisierung oder bei der bedarfsgesteuerten Bereitstellung auf einen Datensatz von Mitarbeitern vor der Einstellung stößt, sendet er die folgende OData-Abfrage an SuccessFactors, wobei der „asOfDate“-Filter auf das „startDate“ des Benutzers festgelegt ist (z. B. asOfDate=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/

Wenn Sie Probleme bei der Verarbeitung von Mitarbeitern vor der Einstellung feststellen, können Sie das obige OData-Anforderungsformat verwenden, um Ihre SuccessFactors-Instanz abzufragen, indem Sie den API-Endpunkt, den personIdExternal- und asOfDate-Filter durch Werte ersetzen, die Ihrem Testszenario entsprechen.

Lesen von Attributdaten

Wenn der Microsoft Entra-Bereitstellungsdienst SuccessFactors abfragt, ruft er ein JSON-Resultset ab. Das JSON-Resultset enthält viele Attribute, die in Employee Central gespeichert sind. Das Bereitstellungsschema ist standardmäßig so konfiguriert, dass nur eine Teilmenge dieser Attribute abgerufen wird.

Führen Sie die aufgeführten Schritte aus, um weitere Attribute abzurufen:

1. Navigieren Sie zur Seite "Enterprise Applications>SuccessFactors App>Provisioning>Edit Provisioning>Attribute-Mapping".

2. Scrollen Sie nach unten, und klicken Sie auf "Erweiterte Optionen anzeigen".

3. Klicken Sie auf " Attributliste bearbeiten" für SuccessFactors.

   Hinweis

   Wenn die Option "Attributliste bearbeiten" für SuccessFactors im Microsoft Entra Admin Center nicht angezeigt wird, verwenden Sie die URL https://portal.azure.com/?Microsoft_AAD_IAM_forceSchemaEditorEnabled=true , um auf die Seite zuzugreifen.

4. In der Spalte "API-Ausdruck " in dieser Ansicht werden die JSONPath-Ausdrücke angezeigt, die vom Connector verwendet werden.

   

5. Sie können einen vorhandenen JSONPath-Wert bearbeiten oder dem Schema ein neues Attribut mit einem gültigen JSONPath-Ausdruck hinzufügen.

Der nächste Abschnitt enthält eine Liste häufiger Szenarien, in denen JSONPath-Werte bearbeitet werden.

Umgang mit verschiedenen HR-Szenarien

JSONPath ist eine Abfragesprache für JSON, die XPath für XML ähnelt. Wie XPath ermöglicht auch JSONPath das Extrahieren und Filtern von Daten aus der JSON-Nutzlast.

Mithilfe einer JSONPath-Transformation können Sie das Verhalten der Microsoft Entra-Bereitstellungs-App anpassen, um benutzerdefinierte Attribute abzurufen und Szenarien wie eine Wiedereinstellung, einen Wechsel des Arbeitnehmerstatus oder eine globalen Zuweisung zu verarbeiten.

In diesem Abschnitt wird erläutert, wie Sie die Bereitstellungs-App für die folgenden Szenarien zur Personalverwaltung anpassen können:

• Abrufen weiterer Attribute
• Abrufen von benutzerdefinierten Attributen
• Zuordnen des Beschäftigungsstatus zum Kontostatus
• Behandeln von Arbeitskonvertierungs- und Rehiringszenarien
• Abrufen des aktuellen aktiven Beschäftigungsdatensatzes
• Behandeln eines globalen Zuordnungsszenarios
• Szenario für gleichzeitige Aufträge
• Abrufen von Positionsdetails
• Bereitstellen von Benutzern im Onboarding-Modul
• Aktivieren von OData-API-Überwachungsprotokollen in SuccessFactors

Abrufen weiterer Attribute

Das standardmäßige Microsoft Entra SuccessFactors-Bereitstellungs-App-Schema enthält 90+ vordefinierte Attribute. Führen Sie die aufgeführten Schritte aus, um dem Bereitstellungsschema weitere SuccessFactors-Attribute hinzuzufügen:

1. Rufen Sie mithilfe der OData-Abfrage Daten für einen gültigen Testbenutzer von Employee Central ab.

    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. Ermitteln der dem Attribut zugeordneten Employee Central-Entität

   • Wenn das Attribut Teil der EmpEmployment-Entität ist, suchen Sie nach dem Attribut unter "employmentNav ".If the attribute is part of EmpEmployment entity, then look for the attribute under employmentNav node.
   • Wenn das Attribut Teil der Benutzerentität ist, suchen Sie unter "employmentNav/userNav " nach dem Attribut.
   • Wenn das Attribut Teil der EmpJob-Entität ist, suchen Sie unter "employmentNav/jobInfoNav "-Knoten nach dem Attribut.

3. Erstellen Sie den JSON-Pfad, der dem-Attribut zugeordnet ist, und fügen Sie dieses neue Attribut der Liste der SuccessFactors-Attribute hinzu.

   • Beispiel 1: Angenommen, Sie möchten das Attribut okToRehire hinzufügen, das Teil der Entität employmentNav ist, und dann den JSONPath $.employmentNav.results[0].okToRehire verwenden.
   • Beispiel 2: Angenommen, Sie möchten das Attribut timeZone hinzufügen, das Teil der userNav-Entität ist, und dann den JSONPath verwenden. $.employmentNav.results[0].userNav.timeZone
   • Beispiel 3: Angenommen, Sie möchten das Attribut flsaStatus hinzufügen, das Teil der entität jobInfoNav ist, und dann den JSONPath verwenden $.employmentNav.results[0].jobInfoNav.results[0].flsaStatus

4. Speichern Sie das Schema.

5. Starten Sie die Bereitstellung erneut.

Abrufen benutzerdefinierter Attribute

Standardmäßig sind die folgenden benutzerdefinierten Attribute in der Microsoft Entra-Bereitstellungs-App für SuccessFactors vordefiniert:

• custom01-custom15 aus der Benutzerentität (userNav)
• customString1-customString15 aus der EmpEmployment (employmentNav)-Entität namens empNavCustomString1-empNavCustomString15
• customString1-customString15 aus der EmpJobInfo (jobInfoNav)-Entität namens empJobNavCustomString1-empNavJobCustomString15

Angenommen, in Ihrer Zentralen Employee Central-Instanz speichert das customString35-Attribut in EmpJobInfo die Standortbeschreibung. Sie möchten diesen Wert in das Active Directory-Attribut "physicalDeliveryOfficeName " fließen. Führen Sie diese Schritte aus, um die Attributzuordnung für dieses Szenario zu konfigurieren:

1. Bearbeiten Sie die SuccessFactors-Attributliste, um ein neues Attribut namens empJobNavCustomString35 hinzuzufügen.
2. Legen Sie den JSONPath-API-Ausdruck für dieses Attribut wie folgt fest: $.employmentNav.results[0].jobInfoNav.results[0].customString35
3. Speichern Sie die Zuordnungsänderung und laden Sie diese erneut in das Microsoft Entra Admin Center.
4. Ordnen Sie im Blatt "Attributzuordnung" empJobNavCustomString35 " physicalDeliveryOfficeName" zu.
5. Speichern Sie die Zuordnung.

Erweitern dieses Szenarios:

• Wenn Sie das custom35-Attribut der Benutzerentität zuordnen möchten, verwenden Sie den JSONPath $.employmentNav.results[0].userNav.custom35
• Wenn Sie das customString35-Attribut der EmpEmployment-Entität zuordnen möchten, verwenden Sie den JSONPath $.employmentNav.results[0].customString35

Zuordnen des Beschäftigungsstatus zum Kontostatus

Standardmäßig verwendet der Microsoft Entra-Connector für SuccessFactors das activeEmploymentsCount-Feld des PersonEmpTerminationInfo-Objekts, um den Kontostatus festzulegen. Möglicherweise tritt beim Verwenden dieses Attributs eines der folgenden Probleme auf.

1. Es gibt ein bekanntes Problem, bei dem der Connector das Konto eines austretenden Mitarbeiters möglicherweise einen Tag vor dem letzten Arbeitstag deaktiviert.
2. Wenn das Objekt PersonEmpTerminationInfo beim Austritt auf Null festgelegt wird, funktioniert das Deaktivieren des AD-Kontos nicht, weil das Bereitstellungsmodul Datensätze herausfiltert, in denen das Objekt personEmpTerminationInfoNav auf Null festgelegt ist.

Wenn eines dieser Probleme bei Ihnen auftritt oder Sie den Beschäftigungsstatus dem Kontostatus zuordnen möchten, können Sie die Zuordnung so aktualisieren, dass das Feld emplStatus erweitert und der im Feld emplStatus.externalCode vorhandene Beschäftigungsstatuscode verwendet wird. Basierend auf dem SAP-Supporthinweis 2505526 finden Sie hier eine Liste der Beschäftigungsstatuscodes, die Sie in der Bereitstellungs-App abrufen können.

• A = Aktiv
• D = Inaktiv
• U = Unbezahlter Urlaub
• P = Bezahlter Urlaub
• S = Ausgesetzt
• F = Beurlaubt
• O = Ausgemustert
• R = Ruhestand
• T = Ausgeschieden/Gekündigt

Führen Sie diese Schritte aus, um Ihre Zuordnung zu aktualisieren, damit diese Codes abgerufen werden.

1. Öffnen Sie das Blatt „Attributzuordnung“ Ihrer SuccessFactors-Bereitstellungs-App.

2. Klicken Sie unter "Erweiterte Optionen anzeigen" auf die Attributliste "SuccessFactors bearbeiten".

3. Suchen Sie das Attribut emplStatus, und aktualisieren Sie den JSONPath auf $.employmentNav.results[0].jobInfoNav.results[0].emplStatusNav.externalCode. Das Update bewirkt, dass der Connector die Beschäftigungsstatuscodes in der Tabelle abruft.

4. Speichern Sie die Änderungen.

5. Aktualisieren Sie auf dem Blatt „Attributzuordnung“ die Ausdruckszuordnung für das Kontostatusflag.

   Bereitstellungsauftrag	Kontostatusattribut	Zuordnungsausdruck
   Benutzerbereitstellung von SuccessFactors in Active Directory	accountDisabled	Switch([emplStatus], "True", "A", "False", "U", "False", "P", "False")
   SuccessFactors zu Microsoft Entra-Benutzerbereitstellung	accountEnabled	Switch([emplStatus], "False", "A", "True", "U", "True", "P", "True")

6. Speichern Sie die Änderungen.

7. Testen Sie die Konfiguration mithilfe der Bereitstellung bei Bedarf.

8. Nach der Bestätigung, dass die Synchronisierung wie erwartet funktioniert, starten Sie den Bereitstellungsauftrag neu.

Handhaben von Szenarien zur Mitarbeiterstatusumwandlung und Wiedereinstellung

Informationen zum Szenario für die Arbeitskonvertierung: Die Umwandlung des Arbeitnehmers ist der Prozess der Umwandlung eines vorhandenen Vollzeitmitarbeiters in einen Auftragnehmer oder einen Auftragnehmer in einen Vollzeitmitarbeiter. In diesem Szenario fügt Employee Central eine neue EmpEmployment-Entität zusammen mit einer neuen Benutzerentität für dieselbe Person-Entität hinzu. Die unter der vorherigen EmpEmployment-Entität geschachtelte Benutzerentität ist auf NULL festgelegt.

Informationen zu Rehiringszenarien: In SuccessFactors gibt es zwei Möglichkeiten zum Neuhirnen von Mitarbeitern:

• Option 1: Erstellen eines neuen Personalprofils in Employee Central
• Option 2: Wiederverwenden eines vorhandenen Personalprofils in Employee Central

Wenn Ihre Personalabteilung Option 1 verwendet, sind keine Änderungen am Bereitstellungsschema erforderlich. Wenn Ihr HR-Prozess Option 2 verwendet, fügt Employee Central eine neue EmpEmployment-Entität zusammen mit einer neuen Benutzerentität für dieselbe Person-Entität hinzu.

Sie können beide Szenarien behandeln, sodass die neuen Beschäftigungsdaten angezeigt werden, wenn eine Konvertierung oder eine erneute Einstellung erfolgt. Massenaktualisierung des Bereitstellungs-App-Schemas mithilfe der aufgeführten Schritte:

1. Öffnen Sie das Blatt „Attributzuordnung“ Ihrer SuccessFactors-Bereitstellungs-App.

2. Scrollen Sie nach unten, und klicken Sie auf "Erweiterte Optionen anzeigen".

3. Klicken Sie hier auf den Link " Überprüfen Sie Ihr Schema ", um den Schema-Editor zu öffnen.

   

4. Klicken Sie auf den Link " Herunterladen ", um eine Kopie des Schemas vor der Bearbeitung zu speichern.

   

5. Drücken Sie im Schema-Editor die Tastenkombination STRG+H, um das Steuerelement für das Suchen und Ersetzen zu öffnen.

6. Kopieren Sie den Wert von $.employmentNav.results[0], und fügen Sie ihn im Textfeld für die Suche ein.

7. Kopieren Sie den Wert von $.employmentNav.results[-1:], und fügen Sie ihn im Textfeld für das Ersetzen ein. Dieser JSONPath-Ausdruck gibt den neuesten EmpEmployment-Datensatz zurück.

   

8. Klicken Sie auf die Option „Alle ersetzen“, um das Schema zu aktualisieren.

9. Speichern Sie das Schema.

10. Durch den oben beschriebenen Prozess werden alle JSONPath-Ausdrücke wie folgt aktualisiert:

    • Alter JSONPath: $.employmentNav.results[0].jobInfoNav.results[0].departmentNav.name_localized
    • Neuer JSONPath: $.employmentNav.results[-1:].jobInfoNav.results[0].departmentNav.name_localized

11. Testen Sie die Konfiguration mithilfe der Bereitstellung bei Bedarf.

12. Nach der Bestätigung, dass die Synchronisierung wie erwartet funktioniert, starten Sie den Bereitstellungsauftrag neu.

Hinweis

Der oben beschriebene Ansatz funktioniert nur, wenn SAP SuccessFactors die Arbeitsobjekte in aufsteigender Reihenfolge zurückgibt, wobei der neueste Beschäftigungsdatensatz immer der letzte Datensatz im Array "employmentNav "-Ergebnisse ist. Die Reihenfolge, in der mehrere Beschäftigungsdatensätze zurückgegeben werden, wird von SuccessFactors nicht garantiert. Wenn Ihre SuccessFactors-Instanz mehrere Beschäftigungsdatensätze aufweist, die einem Mitarbeiter entsprechen, und Sie immer Attribute abrufen möchten, die dem aktiven Beschäftigungsdatensatz zugeordnet sind, verwenden Sie die im nächsten Abschnitt beschriebenen Schritte.

Abrufen des aktuellen aktiven Beschäftigungsdatensatzes

Die Verwendung des JSONPath-Stamms oder von $.employmentNav.results[0] oder $.employmentNav.results[-1:] zum Abrufen der Beschäftigungsdatensätze funktioniert in den meisten Szenarien und hält die Konfiguration einfach. Je nachdem, wie Ihre SuccessFactors-Instanz konfiguriert ist, muss diese Konfiguration jedoch möglicherweise aktualisiert werden, um sicherzustellen, dass der Connector immer den neuesten aktiven Beschäftigungsdatensatz abruft.

In diesem Abschnitt wird beschrieben, wie Sie die JSONPath-Einstellungen aktualisieren können, damit definitiv der aktuelle aktive Beschäftigungsdatensatz des Benutzers abgerufen wird. Dabei werden auch Szenarien zur Mitarbeiterstatusumwandlung und Wiedereinstellung behandelt.

1. Öffnen Sie das Blatt „Attributzuordnung“ Ihrer SuccessFactors-Bereitstellungs-App.

2. Scrollen Sie nach unten, und klicken Sie auf "Erweiterte Optionen anzeigen".

3. Klicken Sie hier auf den Link " Überprüfen Sie Ihr Schema ", um den Schema-Editor zu öffnen.

4. Klicken Sie auf den Link " Herunterladen ", um eine Kopie des Schemas vor der Bearbeitung zu speichern.

5. Drücken Sie im Schema-Editor die Tastenkombination STRG+H, um das Steuerelement für das Suchen und Ersetzen zu öffnen.

6. Führen Sie die folgenden Suchen/Ersetzen-Vorgänge aus. Stellen Sie sicher, dass beim Ausführen der Suchen-Ersetzen-Vorgänge keine führenden oder nachgestellten Leerzeichen vorhanden sind. Wenn Sie den Index anstelle von [-1:]"Index" verwenden[0], aktualisieren Sie das Zeichenfolgenfeld entsprechend.

   Zu suchende Zeichenfolge	Zur Ersetzung zu verwendende Zeichenfolge	Zweck
   $.employmentNav.results[0].jobInfoNav.results[0].emplStatus	$.employmentNav..jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P' )].emplStatusNav.externalCode	Mit diesem Suchen-Ersetzen-Vorgang fügen wir die Möglichkeit hinzu, das OData-Objekt „emplStatusNav“ zu erweitern.
   $.employmentNav.results[0].jobInfoNav.results[0]	$.employmentNav..jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P')]	Durch dieses Suchen/Ersetzen (find-replace) weisen wir den Connector an, immer Attribute abzurufen, die dem aktiven SuccessFactors-Datensatz „EmpJobInfo“ zugeordnet sind. Attribute, die mit beendeten/inaktiven Datensätzen in SuccessFactors verknüpft sind, werden ignoriert.
   $.employmentNav.results[0]	$.employmentNav..results[?(@.jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P')])]	Durch dieses Suchen/Ersetzen (find-replace) weisen wir den Connector an, immer Attribute abzurufen, die dem aktiven SuccessFactors-Datensatz „Employment“ (Beschäftigung) zugeordnet sind. Attribute, die mit beendeten/inaktiven Datensätzen in SuccessFactors verknüpft sind, werden ignoriert.

7. Speichern Sie das Schema.

8. Der oben beschriebene Prozess aktualisiert alle JSONPath-Ausdrücke.

9. Damit die Verarbeitung von Mitarbeitern vor der Einstellung funktioniert, muss der mit dem Attribut startDate verknüpfte JSONPath entweder den Index [0] oder den Index [-1:] verwenden. Klicken Sie unter "Erweiterte Optionen anzeigen" auf die Attributliste "SuccessFactors bearbeiten". Suchen Sie das Attribut startDate, und legen Sie es auf den Wert $.employmentNav.results[-1:].startDate fest.

10. Speichern Sie das Schema.

11. Um sicherzustellen, dass Ausscheiden/Kündigungen wie erwartet verarbeitet werden, können Sie eine der folgenden Einstellungen im Abschnitt mit den Attributzuordnungen verwenden.

    Bereitstellungsauftrag	Kontostatusattribut	Zu verwendender Ausdruck, wenn der Kontostatus auf „activeEmploymentsCount“ basiert.	Zu verwendender Ausdruck, wenn der Kontostatus auf dem Wert „emplStatus“ basiert.
    Benutzerbereitstellung von SuccessFactors in Active Directory	accountDisabled	Switch([activeEmploymentsCount], "False", "0", "True")	Switch([emplStatus], "True", "A", "False", "U", "False", "P", "False")
    SuccessFactors zu Microsoft Entra-Benutzerbereitstellung	accountEnabled	Switch([activeEmploymentsCount], "True", "0", "False")	Switch([emplStatus], "False", "A", "True", "U", "True", "P", "True")

12. Speichern Sie die Änderungen. 1.

13. Testen Sie die Konfiguration mithilfe der Bereitstellung bei Bedarf.

14. Nach der Bestätigung, dass die Synchronisierung wie erwartet funktioniert, starten Sie den Bereitstellungsauftrag neu.

Globale Zuweisung

Wenn ein Benutzer in Employee Central für die globale Zuordnung verarbeitet wird, fügt SuccessFactors eine neue EmpEmployment-Entität hinzu und legt die assignmentClass auf "GA" fest. Außerdem wird eine neue Benutzerentität erstellt. Daher verfügt der Benutzer nun über Folgendes:

• Eine EmpEmployment-Benutzerentität + , die der Heimzuweisung entspricht, wobeiassignmentClass auf "ST" festgelegt ist und
• Eine andere EmpEmployment + User-Entität , die der globalen Zuordnung entspricht, wobei assignmentClass auf "GA" festgelegt ist

Führen Sie die aufgeführten Schritte aus, um Attribute abzurufen, die zum Benutzerprofil für die Standardzuweisung und für die globale Zuweisung gehören:

1. Öffnen Sie das Blatt „Attributzuordnung“ Ihrer SuccessFactors-Bereitstellungs-App.

2. Scrollen Sie nach unten, und klicken Sie auf "Erweiterte Optionen anzeigen".

3. Klicken Sie hier auf den Link " Überprüfen Sie Ihr Schema ", um den Schema-Editor zu öffnen.

4. Klicken Sie auf den Link " Herunterladen ", um eine Kopie des Schemas vor der Bearbeitung zu speichern.

5. Drücken Sie im Schema-Editor die Tastenkombination STRG+H, um das Steuerelement für das Suchen und Ersetzen zu öffnen.

6. Kopieren Sie den Wert von $.employmentNav.results[0], und fügen Sie ihn im Textfeld für die Suche ein.

7. Kopieren Sie den Wert von $.employmentNav.results[?(@.assignmentClass == 'ST')], und fügen Sie ihn im Textfeld für das Ersetzen ein. Beachten Sie den Leerraum um den Operator ==. Dieser ist für die erfolgreiche Verarbeitung des JSONPath-Ausdrucks wichtig.

8. Klicken Sie auf die Option „Alle ersetzen“, um das Schema zu aktualisieren.

9. Speichern Sie das Schema.

10. Durch den oben beschriebenen Prozess werden alle JSONPath-Ausdrücke wie folgt aktualisiert:

    • Alter JSONPath: $.employmentNav.results[0].jobInfoNav.results[0].departmentNav.name_localized
    • Neuer JSONPath: $.employmentNav.results[?(@.assignmentClass == 'ST')].jobInfoNav.results[0].departmentNav.name_localized

11. Laden Sie das Blatt „Attributzuordnung“ der App erneut.

12. Scrollen Sie nach unten, und klicken Sie auf "Erweiterte Optionen anzeigen".

13. Klicken Sie auf " Attributliste bearbeiten" für SuccessFactors.

14. Fügen Sie neue Attribute hinzu, um Daten zur globalen Zuweisung abzurufen. Beispiel: Wenn Sie den Abteilungsnamen abrufen möchten, der einem globalen Zuordnungsprofil zugeordnet ist, können Sie das Attribut "globalAssignmentDepartment " mit dem JSONPath-Ausdruckssatz hinzufügen $.employmentNav.results[?(@.assignmentClass == 'GA')].jobInfoNav.results[0].departmentNav.name_localized.

15. Sie können nun beide Abteilungswerte in Active Directory-Attribute oder selektiv einen Wert mithilfe einer Ausdruckszuordnung übertragen. Beispiel: Der Ausdruck legt den Wert des AD-Abteilungsattributs auf "globalAssignmentDepartment " fest. Andernfalls wird der Wert auf die Abteilung festgelegt, die der Standardzuweisung zugeordnet ist.

    • IIF(IsPresent([globalAssignmentDepartment]),[globalAssignmentDepartment],[department])

16. Speichern Sie die Zuordnung.

17. Testen Sie die Konfiguration mithilfe der Bereitstellung bei Bedarf.

18. Nach der Bestätigung, dass die Synchronisierung wie erwartet funktioniert, starten Sie den Bereitstellungsauftrag neu.

Umgang mit gleichzeitigen Aufträgen

Wenn ein Benutzer in Employee Central über gleichzeitige/mehrere Aufträge verfügt, gibt es zwei EmpEmployment - und Benutzerentitäten , für die "assignmentClass " auf "ST" festgelegt ist. Gehen Sie anhand der aufgeführten Schritte vor, um Attribute abzurufen, die zu beiden Aufträgen gehören:

1. Öffnen Sie das Blatt „Attributzuordnung“ Ihrer SuccessFactors-Bereitstellungs-App.
2. Scrollen Sie nach unten, und klicken Sie auf "Erweiterte Optionen anzeigen".
3. Klicken Sie auf " Attributliste bearbeiten" für SuccessFactors.
4. Angenommen, Sie möchten die Abteilung pullen, die job 1 und job 2 zugeordnet ist. Die vordefinierte Attributabteilung ruft bereits den Wert der Abteilung für den ersten Auftrag ab. Sie können ein neues Attribut namens secondJobDepartment definieren und den JSONPath-Ausdruck auf $.employmentNav.results[1].jobInfoNav.results[0].departmentNav.name_localized
5. Sie können nun beide Abteilungswerte in Active Directory-Attribute oder selektiv einen Wert mithilfe einer Ausdruckszuordnung übertragen.
6. Speichern Sie die Zuordnung.
7. Testen Sie die Konfiguration mithilfe der Bereitstellung bei Bedarf.
8. Nach der Bestätigung, dass die Synchronisierung wie erwartet funktioniert, starten Sie den Bereitstellungsauftrag neu.

Abrufen von Positionsdetails

Der SuccessFactors-Connector unterstützt die Erweiterung des Positionsobjekts. Um Positionsobjektattribute wie Tätigkeitsstufen oder Positionsbezeichnungen in einer bestimmten Sprache zu erweitern und abzurufen, können Sie JSONPath-Ausdrücke (wie dargestellt) verwenden.

Attributname	JSONPath-Ausdruck
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

Bereitstellen von Benutzern im Onboarding-Modul

Die eingehende Benutzerbereitstellung aus SAP SuccessFactors in ein lokales Active Directory und Microsoft Entra ID unterstützt jetzt die Vorabbereitstellung von Voreinstellungen, die im SAP SuccessFactors Onboarding 2.0-Modul vorhanden sind. Wenn der Microsoft Entra-Bereitstellungsdienst ein neues Arbeitnehmerprofil mit einem zukünftigem Startdatum erkennt, wird er SAP SuccessFactors abfragen, um neue Arbeitnehmer mit einem der folgenden Statuscodes abzurufen: active, inactive, active_external_suite. Der Statuscode active_external_suite entspricht den im Modul SAP SuccessFactors Onboarding 2.0 vorhandenen Mitarbeitern vor der Einstellung. Eine Beschreibung dieser Statuscodes finden Sie im SAP-Supporthinweis 2736579.

Das Standardverhalten des Bereitstellungsdiensts ist die Verarbeitung von Mitarbeitern vor der Einstellung im Onboarding-Modul.

Wenn Sie die Verarbeitung von Mitarbeitern vor der Einstellung im Onboarding-Modul ausschließen möchten, aktualisieren Sie die Konfiguration Ihres Bereitstellungsauftrags wie folgt:

1. Öffnen Sie das Blatt „Attributzuordnung“ Ihrer SuccessFactors-Bereitstellungs-App.
2. Bearbeiten Sie die SuccessFactors-Attributliste, um das neue Attribut userStatus hinzuzufügen.
3. Legen Sie den JSONPath-API-Ausdruck für dieses Attribut wie folgt fest: $.employmentNav.results[0].userNav.status
4. Speichern Sie das Schema, um zum Blatt für die Attributzuordnung zurückzukehren.
5. Bearbeiten des Quellobjektbereichs zum Anwenden eines Bereichsfilters userStatus NOT EQUALS
6. Speichern Sie die Zuordnung, und überprüfen Sie, ob der Bereichsfilter mithilfe der Bedarfsbereitstellung funktioniert.

Aktivieren von OData-API-Überwachungsprotokollen in SuccessFactors

Der Microsoft Entra-Connector für SuccessFactors verwendet die SuccessFactors OData-API, um Änderungen abzurufen und Benutzer bereitzustellen. Wenn Sie Probleme mit dem Bereitstellungsdienst feststellen und bestätigen möchten, welche Daten von SuccessFactors abgerufen wurden, können Sie OData-API-Überwachungsprotokolle in SuccessFactors aktivieren. Rufen Sie die von Microsoft Entra ID gesendeten Anforderungsnutzdaten aus den Überwachungsprotokollen ab. Zur Problembehandlung können Sie diese Anforderungs-Nutzdaten in ein Tool wie cURL oder Graph-Tester kopieren, es so einrichten, dass es denselben API-Benutzenden verwendet, der auch vom Connector verwendet wird, und sehen, ob es die gewünschten Änderungen von SuccessFactors zurückgibt.

Szenarien für das Rückschreiben

In diesem Abschnitt werden verschiedene Szenarien für das Rückschreiben behandelt. Er enthält Empfehlungen für Konfigurationsansätze, die darauf basieren, wie E-Mail-Adressen und Telefonnummern in SuccessFactors eingerichtet sind.

Unterstützte Szenarien für das Rückschreiben von Telefonnummern und E-Mail-Adressen

#	Szenarioanforderung	Primäre E-Mail-Adresse Flagwert	Telefon (geschäftlich) primärer Flagwert	Mobiltelefon primärer Flagwert	Telefon (geschäftlich) Kartierung	Mobiltelefon Kartierung
1	* Legen Sie nur geschäftliche E-Mail-Adressen als primär fest. * Legen Sie keine Telefonnummern fest.	Wahr	Wahr	Falsch	[Nicht festgelegt]	[Nicht festgelegt]
2	* In SuccessFactors sind die geschäftliche E-Mail-Adresse und die geschäftliche Telefonnummer primär. * Übertragen Sie immer die Microsoft Entra-Telefonnummer als geschäftliche Telefonnummer und die Handynummer als Mobiltelefon.	Wahr	Wahr	Falsch	Telefonnummer	mobil
3	* In SuccessFactors sind die geschäftliche E-Mail-Adresse und Telefonnummer primär. * Übertragen Sie immer die Microsoft Entra-Telefonnummer als geschäftliche Telefonnummer und die Handynummer als Mobiltelefon	Wahr	Falsch	Wahr	Telefonnummer	mobil
4	* In SuccessFactors ist die geschäftliche E-Mail-Adresse primär. * Überprüfen Sie in Microsoft Entra ID, ob die geschäftliche Telefonnummer vorhanden ist, falls ja, überprüfen Sie, ob auch die Mobiltelefonnummer vorhanden ist. Markieren Sie die geschäftliche Telefonnummer nur dann als primäre Telefonnummer, wenn keine Mobiltelefonnummer vorhanden ist.	Wahr	Verwenden Sie die Ausdruckszuordnung: IIF(IsPresent([telephoneNumber]), IIF(IsPresent([mobile]),"false", "true"), "false")	Verwenden Sie die Ausdruckszuordnung: IIF(IsPresent([mobile]),"false", "true")	Telefonnummer	mobil
5	* In SuccessFactors sind die geschäftliche E-Mail-Adresse und die geschäftliche Telefonnummer primär. * Wenn in Microsoft Entra ID eine Mobiltelefonnummer verfügbar ist, legen Sie diese als geschäftliche Telefonnummer fest, oder verwenden Sie andernfalls telephoneNumber.	Wahr	Wahr	Falsch	IIF(IsPresent([mobile]), [mobile], [telephoneNumber])	[Nicht festgelegt]

• Wenn in der Attributzuordnung für das Rückschreiben keine Zuordnung für die Telefonnummer enthalten ist, wird nur die E-Mail-Adresse in den Rückschreibvorgang eingeschlossen.
• Während des Onboardings einer Neueinstellung in Employee Central sind die geschäftliche E-Mail-Adresse und Telefonnummer möglicherweise noch nicht verfügbar. Wenn das Festlegen der geschäftlichen E-Mail-Adresse und Telefonnummer als primär während des Onboardings obligatorisch ist, können Sie bei der Erstellung des neu eingestellten Mitarbeiters Platzhalterwerte für geschäftliche Telefonnummer und E-Mail-Adresse festlegen. Nach einiger Zeit aktualisiert die Rückschreiben-App den Wert.

Aktivieren des Rückschreibens mit UserID

Die Writeback-App von SuccessFactors verwendet die folgende Logik, um Benutzerobjektattribute zu aktualisieren:

• Im ersten Schritt wird im Changeset nach userId-Attribut gesucht. Wenn dies vorhanden ist, wird „UserId“ zum Durchführen des SuccessFactors-API-Aufrufs verwendet.
• Wenn "userId " nicht gefunden wird, wird standardmäßig der Wert des attributs "personIdExternal " verwendet.

Normalerweise entspricht der Wert des attributs "personIdExternal " in SuccessFactors dem Attributwert "userId ". In Szenarien wie Wiedereinstellung und Mitarbeiterstatusumwandlung verfügen einzelne Mitarbeiter*innen in SuccessFactors möglicherweise über zwei Mitarbeiterdatensätze: einen aktiven und einen inaktiven. Aktualisieren Sie in solchen Szenarien die Konfiguration der SuccessFactors-Bereitstellungs-Apps wie beschrieben, um sicherzustellen, dass durch das Rückschreiben das aktive Benutzerprofil aktualisiert wird. Diese Konfiguration stellt sicher, dass userId immer im Changeset vorhanden ist, das für den Connector sichtbar ist und im SuccessFactors-API-Aufruf verwendet wird.

1. Öffnen Sie die App für die SuccessFactors zu Microsoft Entra-Benutzerbereitstellung oder die App für die SuccessFactors zu lokaler AD-Benutzerbereitstellung.
2. Stellen Sie sicher, dass extensionAttribute[1-15] in Microsoft Entra ID immer den Wert userId aus dem aktiven Beschäftigungsdatensatz jedes Arbeitnehmers speichert. Der Datensatz bildet das SuccessFactors-Attribut userId auf extensionAttribute[1-15] in Microsoft Entra ID ab.

   

3. Anleitungen zu JSONPath-Einstellungen finden Sie im Abschnitt "Behandeln von Arbeitsumwandlungen und Rehiringszenarien ", um sicherzustellen, dass der UserId-Wert des aktiven Beschäftigungsdatensatzes in die Microsoft Entra-ID fließt.
4. Speichern Sie die Zuordnung.
5. Führen Sie den Bereitstellungsauftrag aus, um sicherzustellen, dass die Benutzer-ID-Werte in die Microsoft Entra-ID fließen.

   Hinweis

   Wenn Sie SuccessFactors für die lokale Active Directory-Benutzerbereitstellung verwenden, konfigurieren Sie Microsoft Entra Connect, um den UserId-Attributwert von lokalem Active Directory mit Microsoft Entra-ID zu synchronisieren.

6. Öffnen Sie die SuccessFactors-Writeback-App im Azure-Portal.
7. Ordnen Sie das gewünschte extensionAttribute , das den UserId-Wert enthält, dem Attribut SuccessFactors userId zu.

   

8. Speichern Sie die Zuordnung.
9. Wechseln Sie zu Attributzuordnung –> Erweitert –> Schema überprüfen , um den JSON-Schema-Editor zu öffnen.
10. Laden Sie eine Kopie des Schemas als Sicherung herunter.
11. Drücken Sie im Schema-Editor STRG+F, und suchen Sie nach dem JSON-Knoten, der die userId-Zuordnung zu einem Microsoft Entra-Quellattribut enthält.
12. Aktualisieren Sie das Attribut „flowBehavior“ von „FlowWhenChanged“ in „FlowAlways“, wie dargestellt.

    

13. Speichern Sie die Zuordnung, und testen Sie das Rückschreibeszenario mit einer bedarfsorientierten Bereitstellung.

Nicht unterstützte Szenarien für das Rückschreiben von Telefonnummern und E-Mail-Adressen

• In Employee Central werden während des Onboardings die persönliche E-Mail-Adresse und die persönliche Telefonnummer als primär festgelegt. Die Rückschreiben-App kann diese Einstellung nicht umkehren, um die geschäftliche E-Mail-Adresse und die geschäftliche Telefonnummer als primär festzulegen.
• In Employee Central ist die geschäftliche Telefonnummer als primär festgelegt. Die Rückschreiben-App kann dies nicht ändern und stattdessen die Mobiltelefonnummer als primär festlegen.
• Die Rückschreiben-App kann die aktuellen primären Flageinstellungen nicht lesen und die gleichen Werte für den Schreibvorgang verwenden. Es werden immer die in der Attributzuordnung konfigurierten Flagwerte verwendet.

Nächste Schritte

• Erfahren Sie, wie Sie SuccessFactors für die Active Directory-Bereitstellung konfigurieren.
• Erfahren Sie, wie Sie das Zurückschreiben auf SuccessFactors konfigurieren.
• Weitere Informationen zu unterstützten SuccessFactors-Attributen für die eingehende Bereitstellung