Update User Information
Sometimes, user details such as the email address or the user name may be maintained in an external Identity Management (IDM) system, outside of Oracle Applications Cloud. When users are onboarded to Oracle Applications Cloud, their email address and user name must be made available internally as part of the application data. It's useful especially when you want to set up Single Sign-On (SSO) based on the email address or the user name. The following sections elaborate the process for associating the email address and the user name with the user record in Oracle Applications Cloud.
Update Email Address for a User
In this scenario, assume that a newly hired employee record is created in Oracle Applications Cloud. However, the email address for the user is generated in an external IDM. You must get the email address from the external IDM and add it to the specific user in Oracle Applications Cloud.
Search the user to get the unique ID of the user and then use it to update the email
address. The user name CUST_CONTRACT_MRG_OPERATIONS
is used as an example.
- Use cURL and
eq
filter parameter with theusername
field to query.curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users?filter=username eq "CUST_CONTRACT_MGR_OPERATIONS"
The user ID returned by the query is
3DEC63ED61FD0863E050F00A081B15FF
. - Submit a PATCH request on the Users resource
to assign the email address to the queried user.
curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X PATCH -d <payload> https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users/3DEC63ED61FD0863E050F00A081B15FF
Sample Request Payload
{ "schemas":[ "urn:scim:schemas:core:2.0:User" ], "emails": [ { "value": "John.Smith@oracle.com", "type": "W", "primary": true } ] }
The user
3DEC63ED61FD0863E050F00A081B15FF
is updated with the email addressJohn.Smith@oracle.com
.
Update User Name for a User
In this scenario, assume that a newly hired employee record is created in Oracle Applications Cloud. However, the user name for the user is generated in an external IDM. You must get the user name from the external IDM and add it to the specific user in Oracle Applications Cloud.
Search the user to get the unique ID of the user and then use it to update the user
name. The user name CUST_CONTRACT_MGR_OPERATIONS
is used as an example.
- Use cURL and
eq
filter parameter with theusername
field to query.curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users?filter=username eq "CUST_CONTRACT_MGR_OPERATIONS"
The user ID returned by the query is
3DEC63ED61FD0863E050F00A081B15FF
. - Submit a PATCH
request on the Users resource to assign the user name to the queried
user.
curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X PATCH -d <payload> https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users/3DEC63ED61FD0863E050F00A081B15FF
Sample Request Payload
{ "schemas":[ "urn:scim:schemas:core:2.0:User" ], "userName":"JOHN.SMITH" }
The user
3DEC63ED61FD0863E050F00A081B15FF
is updated with the user nameJOHN.SMITH
.
To learn more about updating user information, see Fusion Cloud HCM Integration with External Entitlement Management Systems.