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

ユーザー情報の同期

通常、ユーザー情報はOracle Applications Cloudで作成および保守されます。ただし、Oracle Applications Cloudで作成または更新される場合がありますが、外部のアイデンティティ管理システムで保守される場合があります。この場合、Oracle Applications Cloudと外部アイデンティティ管理システムの間でユーザー情報を同期する必要があります。このようなシナリオでは、Oracle Applications Cloudは、ターゲット外部システムにインポートする必要があるユーザー情報のソースになります。情報の同期プロセスは調整と呼ばれます。このユースケースでは、突合せの2つの異なる例を見てみましょう。

オンボーディング・ユーザーの初期突合せプロセス: Oracle Applications Cloudでユーザーが作成されるとき。
オンボーディング・ユーザーの増分調整プロセス: 外部アイデンティティ管理システムにすでに存在するユーザーの情報がOracle Applications Cloudで更新された場合。

オンボーディング・ユーザーの初期突合せプロセス

このプロセスを使用して、Oracle Applications Cloudにユーザーを作成し、そのユーザー情報を外部アイデンティティ管理システムと同期します。

ユーザー名生成ルールを使用して、Oracle Applications Cloudにユーザーを作成します。新しいユーザーごとにusernameが生成されます。「ユーザー名生成ルール」を参照してください。

日付フィルタ・パラメータとともにcURLを使用し、userRequests AtomフィードにGETリクエストを送信して、新しく作成されたユーザーを取得します。

日付範囲を指定して、特定の日付(2016-11-28T07:50:00.000Z)より後に別の日付(2016-11-28T07:55:00.000Z)より前に作成されたユーザーを取得できます。

curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests?updated-min=2016-11-28T07:50:00.000Z&updated-max=2016-11-28T07:55:00.000Z

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

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns="http://www.w3.org/2005/Atom">
    <link href="https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests/userRequests300100089891619" rel="edit"></link>
    <id>atomservlet:userRequests:userRequests300100089891619</id>
    <title type="text">SOD.User 64102016Nov28_0848 User CREATE</title>
    <updated>2016-11-28T07:52:27.000Z</updated>
    <author>
        <name>FAAdmin</name>
    </author>
    <summary type="text"></summary>
    <published>2016-11-28T07:52:27.000Z</published>
    <content type="text">{"id":"300100089888912","schemas":["urn:oracle:apps:scim:schemas:fa:1.0:userRequest"],"employeeNumber":"955160008185297","user":{"id":"41C78D2719753027E050F50A5A0B07CE","name":{"familyName":"User 64102016Nov28_0848","givenName":"SOD"},"active":true,"userName":"SODUser64102016Nov28_0848","emails":[{"primary":true,"value":"anjali.gandhi@oracle.com","type":"work"}],"displayName":"SOD User 64102016Nov28_0848","preferredLanguage":"en"},"meta":{"lastModified":"2016-11-28T07:49:46Z","created":"2016-11-28T07:49:46Z"},"userType":"EMP","userRequestType":"CREATE"}</content>
    <source>
        <id>atomserver:userRequests:feed</id>
        <title type="text">User Requests</title>
        <link href="https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests/userRequests300100089891619" rel="self"></link>
        <updated>2014-08-11T17:15:57.000Z</updated>
    </source>
</entry>

外部アイデンティティ管理システムのインポート手順に従い、特定のユーザーをそのシステムにインポートして同期プロセスを完了します。

オンボーディング・ユーザーの増分調整プロセス

このプロセスは、Oracle Applications Cloudの既存のユーザーの詳細を更新した後、外部アイデンティティ管理システムの既存の情報と同期する必要がある場合に使用します。

例1

この例では、姓などの属性に対する更新の同期について説明します。

日付フィルタ・パラメータとともにcURLを使用し、userRequests AtomフィードにGETリクエストを送信して、特定の期間中にユーザーに対して行われた更新の詳細を取得します。

curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests?updated-min=2016-11-29T16:20:00.000Z&updated-max=2016-11-29T16:25:00.000Z

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

<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>atomserver:serRequests:feed</id>
    <title type="text">User Requests</title>
    <link href="https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests?updated-min=2016-11-29T16:20:00.000Z&amp;updated-max=2016-11-29T16:25:00.000Z" rel="self"></link>
    <updated>2014-08-11T17:15:57.000Z</updated>
    <entry>
        <link href="https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests/userRequests300100089902022" rel="edit"></link>
        <id>atomservlet:userRequests:userRequests300100089902022</id>
        <title type="text">Matt.Hooper User UPDATE</title>
        <updated>2016-11-29T16:23:38.000Z</updated>
        <author>
            <name>MHoope</name>
        </author>
        <summary type="text"></summary>
        <published>2016-11-29T16:23:38.000Z</published>
        <content type="text">{"id":"300100089909847","schemas":["urn:oracle:apps:scim:schemas:fa:1.0:UserRequest"],"employeeNumber":"10037454104","user":{"id":"352E980CE9686C4EF1E2CD35987EF86C","name":{"familyName":"Hooper","givenName":"Matt"},"active":true,"userName":"MHoope","emails":[{"primary":true,"value":"sendmail-test-discard@oracle.com","type":"work"}],"displayName":"Matt Hooper"},"meta":{"lastModified":"2016-11-29T16:20:46Z","created":"2016-11-29T16:20:46Z"},"userType":"EMP","userRequestType":"UPDATE"}</content>
    </entry>
</feed>

外部アイデンティティ管理システムのインポート手順に従い、取得した情報をインポートして同期プロセスを完了します。

例2

この例では、従業員がOracle Applications Cloudで終了とマークされている場合のユーザー情報の同期について説明します。

curl -i -u "<username>:<password>" -X GET https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests?updated-min=2016-12-01T17:55:00.000Z&updated-max=2016-12-01T18:00:00.000Z

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

<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:app="http://www.w3.org/2007/app">
    <author>
        <name>SEED_DATA_FROM_APPLICATION</name>
    </author>
    <subtitle type="text">User Requests</subtitle>
    <title type="text">User Requests</title>
    <id>urn:uuid:336512d57b735708e053f000f40a4a93</id>
    <updated>2016-12-01T17:56:54.994Z</updated>
    <link rel="self" href="https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests?updated-min=2016-12-01T17:55:00.000Z&amp;updated-max=2016-12-01T18:00:00.000Z"></link>
    <entry>
        <title type="text">Chlastname User UPDATE</title>
        <content type="text">{"id":"300100124192067","schemas":["urn:oracle:apps:scim:schemas:fa:1.0:UserRequest"],"employeeNumber":"955160008187808","user":{"id":"42537B10A2845CC7E050F00A79D327A1","name":{"familyName":"Chlastname"},"active":false,"userName":"Chlastname","displayName":"Chlastname","preferredLanguage":"en"},"meta":{"lastModified":"2016-12-01T17:56:54Z","created":"2016-12-01T17:56:54Z"},"userType":"EMP","userRequestType":"UPDATE"}</content>
        <author>
            <name>FUSION_APPS_HCM_SOA_APPID</name>
        </author>
        <updated>2016-12-01T17:56:54.994Z</updated>
        <id>urn:uuid:4294F549498C24A9E05379D3F00A3B16</id>
        <published>2016-12-01T17:56:54.000Z</published>
        <link rel="self" href="https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests/4294F549498C24A9E05379D3F00A3B16"></link>
        <link rel="edit" href="https://servername.fa.us2.oraclecloud.com/hcmRestApi/atomservlet/user/userRequests/4294F549498C24A9E05379D3F00A3B16"></link>
    </entry>
</feed>

外部アイデンティティ管理システムのインポート手順に従い、取得した情報をインポートして同期プロセスを完了します。