You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/active-directory/app-provisioning/sap-successfactors-integration-reference.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -150,13 +150,13 @@ The next section provides a list of common scenarios for editing the JSONPath va
150
150
151
151
JSONPath is a query language for JSON that is similar to XPath for XML. Like XPath, JSONPath allows for the extraction and filtration of data out of a JSON payload.
152
152
153
-
By using JSONPath transformation, you can customize the behavior of the Azure AD provisioning app to retrieve custom attributes and handle scenarios such as rehire, worker conversion and global assignment.
153
+
By using JSONPath transformation, you can customize the behavior of the Azure AD provisioning app to retrieve custom attributes and handle scenarios such as rehiring, worker conversion and global assignment.
154
154
155
155
This section covers how you can customize the provisioning app for the following HR scenarios:
156
156
*[Retrieving more attributes](#retrieving-more-attributes)
*[Mapping employment status to account status](#mapping-employment-status-to-account-status)
159
-
*[Handling worker conversion and rehire scenario](#handling-worker-conversion-and-rehire-scenario)
159
+
*[Handling worker conversion and rehiring scenarios](#handling-worker-conversion-and-rehiring-scenarios)
160
160
*[Retrieving current active employment record](#retrieving-current-active-employment-record)
161
161
*[Handling global assignment scenario](#handling-global-assignment-scenario)
162
162
*[Handling concurrent jobs scenario](#handling-concurrent-jobs-scenario)
@@ -188,7 +188,7 @@ To add more SuccessFactors attributes to the provisioning schema, use the steps
188
188
* If the attribute is part of *User* entity, then look for the attribute under *employmentNav/userNav* node.
189
189
* If the attribute is part of *EmpJob* entity, then look for the attribute under *employmentNav/jobInfoNav* node.
190
190
1. Construct the JSON Path associated with the attribute and add this new attribute to the list of SuccessFactors attributes.
191
-
* Example 1: Let's say you want to add the attribute *okToRehire*, which is part of *employmentNav* entity, then use the JSONPath `$.employmentNav.results[0].okToRehire`
191
+
* Example 1: Let's say you want to add the attribute `okToRehire`, which is part of `employmentNav` entity, then use the JSONPath `$.employmentNav.results[0].okToRehire`
192
192
* Example 2: Let's say you want to add the attribute *timeZone*, which is part of *userNav* entity, then use the JSONPath `$.employmentNav.results[0].userNav.timeZone`
193
193
* Example 3: Let's say you want to add the attribute *flsaStatus*, which is part of *jobInfoNav* entity, then use the JSONPath `$.employmentNav.results[0].jobInfoNav.results[0].flsaStatus`
194
194
1. Save the schema.
@@ -249,11 +249,11 @@ Use the steps to update your mapping to retrieve these codes.
249
249
1. After confirming that sync works as expected, restart the provisioning job.
250
250
251
251
252
-
### Handling worker conversion and rehire scenario
252
+
### Handling worker conversion and rehiring scenarios
253
253
254
254
**About worker conversion scenario:** Worker conversion is the process of converting an existing full-time employee to a contractor or a contractor to full-time. In this scenario, Employee Central adds a new *EmpEmployment* entity along with a new *User* entity for the same *Person* entity. The *User* entity nested under the previous *EmpEmployment* entity is set to null.
255
255
256
-
**About rehire scenario:** In SuccessFactors, there are two options to process rehires:
256
+
**About rehiring scenarios:** In SuccessFactors, there are two options to process rehiring employees:
257
257
* Option 1: Create a new person profile in Employee Central
258
258
* Option 2: Reuse existing person profile in Employee Central
259
259
@@ -290,7 +290,7 @@ To handle both these scenarios so that the new employment data shows up when a c
290
290
291
291
Using the JSONPath root of `$.employmentNav.results[0]` or `$.employmentNav.results[-1:]` to fetch employment records works in most scenarios and keeps the configuration simple. However, depending on how your SuccessFactors instance is configured, there may be a need to update this configuration to ensure that the connector always fetches the latest active employment record.
292
292
293
-
This section describes how you can update the JSONPath settings to definitely retrieve the current active employment record of the user. It also handles worker conversion and rehire scenarios.
293
+
This section describes how you can update the JSONPath settings to definitely retrieve the current active employment record of the user. It also handles worker conversion and rehiring scenarios.
294
294
295
295
1. Open the attribute-mapping blade of your SuccessFactors provisioning app.
296
296
1. Scroll down and click **Show advanced options**.
@@ -424,13 +424,13 @@ The SuccessFactors Writeback app uses the following logic to update the User obj
424
424
* As a first step, it looks for *userId* attribute in the change set. If it is present, then it uses "UserId" for making the SuccessFactors API call.
425
425
* If *userId* is not found, then it defaults to using the *personIdExternal* attribute value.
426
426
427
-
Usually the *personIdExternal* attribute value in SuccessFactors matches the *userId* attribute value. However, in scenarios such as rehire and worker conversion, an employee in SuccessFactors may have two employment records, one active and one inactive. In such scenarios, to ensure that write-back updates the active user profile, please update the configuration of the SuccessFactors provisioning apps as described. This configuration ensures that *userId* is always present in the change set visible to the connector and is used in the SuccessFactors API call.
427
+
Usually the *personIdExternal* attribute value in SuccessFactors matches the *userId* attribute value. However, in scenarios such as rehiring and worker conversion, an employee in SuccessFactors may have two employment records, one active and one inactive. In such scenarios, to ensure that write-back updates the active user profile, please update the configuration of the SuccessFactors provisioning apps as described. This configuration ensures that *userId* is always present in the change set visible to the connector and is used in the SuccessFactors API call.
428
428
429
429
1. Open the SuccessFactors to Azure AD user provisioning app or SuccessFactors to on-premises AD user provisioning app.
430
430
1. Ensure that an extensionAttribute *(extensionAttribute1-15)* in Azure AD always stores the *userId* of every worker's active employment record. This can be achieved by mapping SuccessFactors *userId* attribute to an extensionAttribute in Azure AD.
1. For guidance regarding JSONPath settings, refer to the section [Handling worker conversion and rehire scenario](#handling-worker-conversion-and-rehire-scenario) to ensure the *userId* value of the active employment record flows into Azure AD.
433
+
1. For guidance regarding JSONPath settings, refer to the section [Handling worker conversion and rehiring scenarios](#handling-worker-conversion-and-rehiring-scenarios) to ensure the *userId* value of the active employment record flows into Azure AD.
434
434
1. Save the mapping.
435
435
1. Run the provisioning job to ensure that the *userId* values flow into Azure AD.
0 commit comments