Oracle Fusion Cloud Applications共通機能のためのREST API

ユーザー情報の更新

Eメール・アドレスやユーザー名などのユーザー詳細は、Oracle Applications Cloudの外部にある外部アイデンティティ管理(アイデンティティM)システムで保守される場合があります。ユーザーがOracle Applications Cloudにオンボーディングされる場合、アプリケーション・データの一部として電子メール・アドレスおよびユーザー名を内部的に使用可能にする必要があります。特に、電子メール・アドレスまたはユーザー名に基づいてシングル・サインオン(SSO)を設定する場合に便利です。次の項では、電子メール・アドレスおよびユーザー名をOracle Applications Cloudのユーザー・レコードに関連付けるプロセスを詳しく説明します。

ユーザーの電子メール・アドレスの更新

このシナリオでは、新規に雇用された従業員レコードがOracle Applications Cloudに作成されているとします。ただし、ユーザーの電子メール・アドレスは外部IDMで生成されます。外部IDMからEメール・アドレスを取得し、Oracle Applications Cloudの特定のユーザーに追加する必要があります。

「ユーザーの検索」:ユーザーの一意のIDを取得し、それを使用して電子メール・アドレスを更新します。ユーザー名CUST_CONTRACT_MRG_OPERATIONSが例として使用されます。

問合せを行うには、cURLおよびeqフィルタ・パラメータをusernameフィールドとともに使用します。
```
curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users?filter=username eq "CUST_CONTRACT_MGR_OPERATIONS"
```
問合せによって返されるユーザーIDは3DEC63ED61FD0863E050F00A081B15FFです。

ユーザー・リソースでPATCHリクエストを発行して、問合せ対象ユーザーに電子メール・アドレスを割り当てます。

curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X PATCH -d <payload>   https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users/3DEC63ED61FD0863E050F00A081B15FF

サンプル・リクエスト・ペイロード

{
 "schemas":[
  "urn:scim:schemas:core:2.0:User"
 ],
 "emails": [
    {
      "value": "John.Smith@oracle.com",
      "type": "W",
      "primary": true
    }
  ]
}

ユーザー3DEC63ED61FD0863E050F00A081B15FFは、電子メール・アドレスJohn.Smith@oracle.comで更新されます。

ユーザーのユーザー名の更新

このシナリオでは、新規に雇用された従業員レコードがOracle Applications Cloudに作成されているとします。ただし、ユーザーのユーザー名は外部IDMで生成されます。外部IDMからユーザー名を取得し、Oracle Applications Cloudの特定のユーザーに追加する必要があります。

「ユーザーの検索」:ユーザーの一意のIDを取得し、それを使用してユーザー名を更新します。ユーザー名CUST_CONTRACT_MGR_OPERATIONSが例として使用されます。

問合せを行うには、cURLおよびeqフィルタ・パラメータをusernameフィールドとともに使用します。
```
curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users?filter=username eq "CUST_CONTRACT_MGR_OPERATIONS"
```
問合せによって返されるユーザーIDは3DEC63ED61FD0863E050F00A081B15FFです。
ユーザー・リソースでPATCHリクエストを発行して、問合せ対象ユーザーにユーザー名を割り当てます。
```
curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X PATCH -d <payload>   https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users/3DEC63ED61FD0863E050F00A081B15FF
```
サンプル・リクエスト・ペイロード
```
{
 "schemas":[
  "urn:scim:schemas:core:2.0:User"
 ],
 "userName":"JOHN.SMITH"
}
```
ユーザー3DEC63ED61FD0863E050F00A081B15FFは、ユーザー名JOHN.SMITHで更新されます。