SAP Knowledge Base Article - Public

2825052 - Assignment ID

Symptom

Assignment ID is an identifier assigned to a person to define the relationship between the person and a company. You can use it to identify users and change it if needed.

IMPORTANT NOTE: Currently, assignment ID is NOT supported in some SAP SuccessFactors areas, for example, Learning, Compensation, Onboarding, Recruiting Management, and data protection and privacy features. This might cause display inconsistencies across the suite. For further details on this see Important Notes about Assignment ID

"Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental."

Environment

SAP SuccessFactors HCM Suite

Resolution

Warning : Assignment ID a new unique identifier we don’t recommend changing this frequently or for non support areas for example Learning, Compensation, Onboarding, Recruiting Management for further details on this see Important Notes about Assignment ID - If you wish to proceed to change assignment ID in non supported areas outlined on the Important notes section before making any changes, we recommend that you contact SAP Professional Services to evaluate the risks associated with the inconsistencies.

From 1908, You will see an additional column called ASSIGNMENT_ID_EXTERNAL in the user data file of import and export tools. By default, the user data template contains the Assignment ID column, the Assignment ID is the same as the UserID.

Note, in the Employee Central-enabled instances, if you have used a business rule to generate assignment IDs, the system then creates assignment IDs based on the rule and the assignment IDs might be different from the user IDs. When you create new users using the user management tools such as Employee Import, Manage Users, or OData APIs, assignment IDs for these users are also added to the system.

If you don't want to include assignment ID in the user data file, select Exclude Assignment ID Column from the User Data Template in Admin Center  Platform Feature Settings. There is no impact excluding the assignment ID as the field will default to Userid see below:

ass.png


Importing and exporting Assignment ID.

When you add or update user data using Employee Import, user ID is required while assignment ID is optional in the template. Note that assignment ID is in the last column. If you don’t input a value in the Assignment ID column, the system will populate the value from user ID to assignment ID after the import job completes.

If you provide assignment ID for new users in the import file, make sure that assignment ID and user ID be the same. Otherwise, an error message occurs and the user won’t be imported.

For more details see Assignment ID in User Management SAP Help Guide.

Note: Assignment ID's can only be changed through the "convertAssignmentIdExternal" function import see more details 2820644 - [1908 Feature] API-12250: Add new attribute assignmentIdExternal in User OData API


What is the difference between Assignment ID and User ID?

Assignment ID (assignment-id-external) can be changed whereas a User ID (users-sys-id) cannot be changed in the system.

Read the following table to find the differences and relationships between person ID, UUID, user ID, and assignment ID see SAP Help Link - Differentiating Between Person ID, UUID, User ID, and Assignment ID


How can I change the Assignment ID?

To ensure system stability, you should not change assignment ID frequently or randomly. Overly frequent changes to assignment ID can create an unnecessary burden on the system.

It is only possible to change the assignment ID through the "convertAssignmentIdExternal" function import see more details 2820644 - [1908 Feature] API-12250: Add new attribute assignmentIdExternal in User OData API

To Grant permission to allow you to change assignment ID through convertAssignment External go to under manager user -> Change Assignment ID

Permission.png

If your requirement is to change assignment ID this can only be achieved through the "convertAssignmentIdExternal" function import see more details 2820644 - [1908 Feature] API-12250: Add new attribute assignmentIdExternal in User OData API and SAP Help ConvertAssignmentIdExternal if you have questions relating to the import please engage with Integrations under the component LOD-SF-INT via an incident or chat.

Keywords

Assignment ID , ASSIGNMENT_ID_EXTERNAL , Assignment ID , convertAssignmentIdExternal , UserId conversion , change assignment ID , field in user data file , KBA , LOD-SF-PLT , Platform Foundational Capabilities , Problem

Product

SAP SuccessFactors HCM Suite all versions