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

ユーザーのロールの削除

ユーザーが特定のロールに関連付けられたタスクを実行する必要がなくなった場合は、そのユーザーのそのロールを削除できます。このユース・ケースでは、特定のロールを検索してユーザーのロールを削除する方法について学習します。

まず、削除するロールを識別し、そのロールを割り当てられているユーザーを識別します。

問合せを行うには、cURLおよびeqフィルタ・パラメータをnameフィールドとともに使用します。この例では、問合せ対象のロール名はORA_PER_HUMAN_RESOURCE_ANALYST_JOBです。問合せによって返されるロールIDは55361929311C580B560EB8BA5C4C1886です。

curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X GET -d <payload> https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Roles?filter=name eq "ORA_PER_HUMAN_RESOURCE_ANALYST_JOB"

応答ペイロードのサンプル

{
  "itemsPerPage": 1,
  "startIndex": 1,
  "Resources": [
    {
      "id": "55361929311C580B560EB8BA5C4C1886",
      "meta": {
        "created": "2009-05-12 11:27:39.226",
        "lastModified": "2016-11-17 17:00:46.000",
        "location": "https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Roles/55361929311C580B560EB8BA5C4C1886"
      },
      "schemas": [
        "urn:oracle:apps:scim:schemas:fa:1.0:Role"
      ],
      "name": "ORA_PER_HUMAN_RESOURCE_ANALYST_JOB",
      "displayName": "Human Resource Analyst",
      "description": "Performs duties of a human resources analyst.",
      "category": "JOB",
      "members": [
        {
          "value": "258D2199A0BB1AA3E050F00A185B018E"
        },
        {
          "value": "6424EF8136C0C20F12466257D3540E9C"
        }
      ]
    }
  ]
}

これでロールIDが作成されました。ユーザーの一意の識別子を検索して取得します。問合せを行うには、cURLおよびeqフィルタ・パラメータをusernameフィールドとともに使用します。この例では、問い合せたユーザー名はCUST_CONTRACT_MGR_OPERATIONSです。問合せによって返されるユーザーIDは5A25572D96277A00C0547E3A715EF682です。

curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users?filter=username eq "CUST_CONTRACT_MGR_OPERATIONS"

応答ペイロードのサンプル

{
  "itemsPerPage": 1,
  "startIndex": 1,
  "Resources": [
    {
      "id": "5A25572D96277A00C0547E3A715EF682",
      "meta": {
        "created": "2009-05-25 00:00:00.000",
        "lastModified": "2015-12-14 10:15:48.291",
        "location": "https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Users/5A25572D96277A00C0547E3A715EF682"
      },
      "schemas": [
        "urn:scim:schemas:core:2.0:User"
      ],
      "userName": "CUST_CONTRACT_MGR_OPERATIONS",
      "name": {
        "familyName": "Black",
        "givenName": "Sophie"
      },
      "displayName": "Sophie Black",
      "emails": [
        {
          "value": "CUST_CONTRACT_MGR_OPERATIONS@dummy.oracle.com",
          "type": "W",
          "primary": true
        }
      ],
      "roles": [
        {
          "id": "4EB6B72643872425B6BE573B531ABC6B",
          "value": "OKC_CUSTOMER_CONTRACT_MANAGER_VISION_OPERATIONS_DATA",
          "displayName": "Customer Contract Manager - Vision Operations",
          "description": "Customer Contract Manager for Vision Operations"
        },
        {
          "id": "40C4AE052EC2582286A6A0FB1514656C",
          "value": "ORA_PER_EMPLOYEE_ABSTRACT",
          "displayName": "Employee",
          "description": "Identifies the person as an employee."
        },
        {
          "id": "05E9F3576995F83E74EB3818FDCA8639",
          "value": "ORA_PER_LINE_MANAGER_ABSTRACT",
          "displayName": "Line Manager",
          "description": "Identifies the person as a line manager."
        }
      ],
      "active": true
    }
  ]
}

cURLを使用して、PATCHリクエストのREMOVE操作を発行し、ユーザーのロールを削除します。この例では、ユーザーID 5A25572D96277A00C0547E3A715EF682のロールID 55361929311C580B560EB8BA5C4C1886を削除します。
```
curl -i -u "<username>:<password>"  -H "Content-Type: application/json"  -X PATCH  
-d {
"schemas": [
"urn:oracle:apps:scim:schemas:fa:1.0:Role"
],
          "members":[{"value":"5A25572D96277A00C0547E3A715EF682", "operation":"REMOVE"}]
}
https://servername.fa.us2.oraclecloud.com/hcmRestApi/scim/Roles/55361929311C580B560EB8BA5C4C1886
```
55361929311C580B560EB8BA5C4C1886ロールIDが5A25572D96277A00C0547E3A715EF682ユーザーIDから削除されます。
応答ペイロードのサンプル
```
204 - No content
```