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.

1. Use cURL and eq filter parameter with the username 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.

2. 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": "[e-mail]",
         "type": "W",
         "primary": true
       }
     ]
   }
   

   The user 3DEC63ED61FD0863E050F00A081B15FFis updated with the email address [e-mail].

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.

1. Use cURL and eq filter parameter with the username 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.

2. 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 3DEC63ED61FD0863E050F00A081B15FFis updated with the user name JOHN.SMITH.

To learn more about updating user information, see Fusion Cloud HCM Integration with External Entitlement Management Systems.