機械翻訳について
  1. Oracle Fusion Cloud Customer ExperienceのOracle CX SalesおよびB2B Service REST API for Sales and Fusion ServiceのREST API
  2. ユースケース
  3. サービス・リソース・ライフ・サイクルの管理

サービス・リソース・ライフ・サイクルの管理

John SmithはVision Corporationのサービス・マネージャです。 組織には、内部リソースである複数の顧客サービス担当者がいます - 従業員または派遣就業者のいずれかである個人。 Vision Corporationは、サードパーティの人事管理システム(HRMS)、First SoftwareとともにOracle CX Sales and Fusion Serviceを使用します。 採用、昇格昇進、降格、異動、ロール変更など、Johnのチーム・ライフ・サイクルの様々なステージをシームレスに管理するために、2つのシステムをどのように統合しますか。

従業員が最初のソフトウェアで作成されるリソースは、Oracle CX Sales and Fusion Serviceを最初のソフトウェアと定期的に同期する必要があります。 REST APIは、最初のソフトウェアからOracle CX Sales and Fusion Serviceに情報を取り込む最適な方法です。 これらを使用すると、インポートと比較して、Oracle CX Sales and Fusion Serviceの情報を簡単に更新できます。 リソース・ユーザーAPIを使用して、Sales and Fusion Serviceの情報を更新できます。 ただし、APIを使用してHCM関連のトランザクションを実行することはできません。

ノート:

電話番号を持つユーザー・レコードを作成する場合は、正しい国コードを指定する必要があります。
この例では、「リソース・ユーザー」 REST APIを使用して、Johnのチーム・ライフサイクルの様々なステージを次のように管理できます:

ノート:

現在、これらのAPIメソッドは内部リソースのみをサポートしています。 内部リソースは、組織に属する従業員または派遣就業者です。

Oracle CX Sales and Fusion Serviceを他のOracle Applications Cloudモジュールとともに使用している場合は、このAPIを使用して内部リソースのみを管理し、HRの個人または就業者に関連するワークフローを管理しません。 人材Management Cloudには、監査およびビジネス・ワークフローをサポートするREST APIが含まれています。

「リソース・ユーザー」 REST APIは、次を必要とするOracle Applications Cloudの他のモジュールがある場合には使用できません:
  • 追加属性(リソース・ユーザーREST APIでサポートされている属性以外)のサポート。
  • リソースのHR属性が変更されたときに監査します。 REST APIでは、個人の属性の管理のみがサポートされ、更新や監査はサポートされません。

リソースの作成または更新後に、次のESSジョブを実行する必要があります:

  • レポート階層生成: このジョブは、内部リソースまたはパートナ組織階層の変更に従って、レポート階層を更新します。 このESSジョブを実行しないかぎり、リソースのレポート・マネージャが更新されます。

  • 個人検索キーワードの更新: このジョブは、元のレコードからPER_KEYWORDS表にキーワード値を自動的にコピーし、そこで検索のパフォーマンスを向上させます。

  • 保留中のLDAPリクエストの送信: このジョブは、保留中のLDAPリクエストを処理して、ユーザー・アカウントおよびロールをプロビジョニングまたはプロビジョニング解除します。 このジョブでは、パラメータ・ユーザー・タイプおよびバッチ・サイズを指定できます。 ユーザー・タイプを指定(通常はすべてを選択)する必要があります。空白のままにすると、このプロセスではリクエストは処理されません。 バッチ・サイズを設定しない場合、デフォルトは自動のAで、合計リクエスト数の1/10です。 バッチ・サイズの数値を指定して、単一バッチ・プロセスに対してその数のリクエストをグループ化するようにプロセスに指示できます。 プロセスで前回の実行からFAULTEDリクエストを取得する場合は、バッチ・サイズをAFとして設定できます。

内部リソースの作成

新しい顧客サービス担当であるJane DoeがJohn Smithの組織(JSmithOrg)に参加するとします。 これを内部リソースとして作成するには:
  1. 「リソース・ユーザーの作成」操作のリクエストURLを作成します。
  2. Janeの詳細を使用してリクエスト本文を作成します。 Janeに一意のユーザー名およびEメールを指定する必要があります。
  3. POSTコールを実行するには、適切なREST APIクライアントまたはcURLコマンドライン・ユーティリティを使用します。

ノート:

内部リソースの作成時に、既存の電子メールまたはユーザー名は使用できません。 既存のユーザー名またはリソースを入力すると、レスポンスに次のエラーが表示されます。

Please provide a unique combination such that a single resource is identified.

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers

cURLコマンド

curl --user sales_cloud_user -X POST -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers

要求ペイロード

JSON形式のリクエスト本文の例を次に示します。

{
    "FirstName":"Jane",
    "LastName":"Doe",
    "ResourceEmail":"jane.doe@dnd.vision.com",
    "HireDate":"2018-08-20",
    "LegalEntity":"Vision Corporation",
    "BusinessUnit":"Vision Corporation Enterprise",
    "HRManagerEmailAddress" : "hrmanger@dnd.vision.com",
    "Username" : "jdoe",
    "ResourceOrgRoleCode":" SERVICE_REPRESENTATIVE",
    "ResourceParentOrganizationName" : "NA Support",
    "ResourceOrganizationName" : "JSmithOrg",
    "RawWorkPhoneNumber" : "6504461212",
    "AddressLine1" : "100 Oracle Parkway",
    "City" : "Redwood City",
    "State" : "CA",
    "PostalCode" : "944065",
    "Country" : "US",
}

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
 "PartyName": "Jane Doe",
 "ResourceType": "INDIVIDUAL",
 "FormattedAddress": "100 Oracle Parkway,REDWOOD CITY, CA 944065",
 "Username": "jdoe",
 "City": "Redwood City",
 "Country": "US",
 "PostalCode": "944065",
 "FirstName": "Jane",
 "LastName": "Doe",
 "ResourcePartyNumber": "Conta765976",
 "State": "CA",
 "ResourceEmail": "jane.doe@dnd.vision.com",
 "RawWorkPhoneNumber": "6504461212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "100 Oracle Parkway",
 "ResourceOrganizationName": "JSmithOrg",
 "ResourceOrganizationUsage": " SERVICE_RESOURCE_ORGANIZATION ",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":" SERVICE_REPRESENTATIVE ",
 "ResourceParentOrganizationName" : "NA Support",
 "ResourceManagerFirstName": "John",
 "ResourceManagerLastName": "Smith",
 "HRManagerEmailAddress": "hrmanger@dnd.vision.com",
 "HireDate": "2018-08-20",
 "ResourceOrgMemRoleStartDate": "2018-08-20",
 "ResourceManagerPartyNumber": "100010034246635",
 "ResourceManagerPartyId": 100010034246635,
 "PersonNumber": "300100159661235",
 "BusinessUnit": "Vision Corporation Enterprise",
 "LegalEntity": "Vision Corporation",
 "UserStatus": "A",
 "PersonType": "EMP",
 "CreateUserAccountFlag": null,
...
}

ユーザー・アカウントのない内部リソースの作成

Katty Smithは、Johnの組織の新しい内部リソースです。 ただし、マネージャがユーザーのユーザー・アカウントを作成することは望ましくありません。 リクエスト・ペイロードでCreateUserAccountFlagフラグをNに設定すると、Katty Smithのレコードを作成できます。 他のすべてのステップは、「内部リソースの作成」の手順と同じです。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers

cURLコマンド

curl --user sales_cloud_user -X POST -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers

要求ペイロード

JSON形式のリクエスト本文の例を次に示します。

{
    "FirstName":"Katty",
    "LastName":"Smith",
    "ResourceEmail":"katty.smith@dnd.vision.com",
    "HireDate": "2018-12-05",
    "LegalEntity": "Vision Corporation",
    "BusinessUnit": "Vision Corporation Enterprise",
    "HRManagerEmailAddress" : "HR.Manager@dnd.vision.com",
    "ResourceOrgRoleCode": "SERVICE_REPRESENTATIVE ",
    "ResourceParentOrganizationName" : "HRManager_Org",
    "ResourceOrganizationName" : "kSmithOrg",
    "RawWorkPhoneNumber" : "6504461212",
    "AddressLine1" : "100 Oracle Parkway",
    "City" : "Redwood City",
    "State" : "CA",
    "PostalCode" : "944065",
    "Country" : "US",
    "ResourceStartDate" : "2018-12-05",
    "CreateUserAccountFlag" : "N"
}

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
 "PartyName": "Katty Smith",
 "ResourceType": "INDIVIDUAL",
 "FormattedAddress": "100 Oracle Parkway,REDWOOD CITY, CA 944065",
 "City": "Redwood City",
 "Country": "US",
 "PostalCode": "944065",
 "FirstName": "Katty",
 "LastName": "Smith",
 "ResourcePartyNumber": "Conta855676",
 "State": "CA",
 "ResourceEmail": "katty.smith@dnd.vision.com",
 "RawWorkPhoneNumber": "6504461212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "100 Oracle Parkway",
 "ResourceOrganizationName": "KSmithOrg",
 "ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SERVICE_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "HRManager_Org",
 "ResourceManagerFirstName": "John",
 "ResourceManagerLastName": "Smith",
 "HRManagerEmailAddress": "HR.Manager@dnd.vision.com",
 "HireDate": "2018-12-05",
 "ResourceOrgMemRoleStartDate": "2018-08-20",
 "ResourceManagerPartyNumber": "100010034246635",
 "ResourceManagerPartyId": 100010034246635,
 "PersonNumber": "300100159661235",
 "BusinessUnit": "Vision Corporation Enterprise",
 "LegalEntity": "Vision Corporation",
 "UserStatus": "A",
 "PersonType": "EMP",
 "CreateUserAccountFlag": "N",
...
}

内部リソースの取得

内部リソースを取得する必要がある状況がいくつかあります。 たとえば、John Smithは直属部下のリストを取得して、自分の学歴情報を確認することによって、研修ニーズを判断できます。

1つ以上の内部リソースとその情報を取得するには:
  1. 適切なGET操作のリクエストURLを作成します:
  2. 適切なREST APIクライアントまたはcURLコマンドライン・ユーティリティを使用して、GETコールを行います。
また、ファインダを使用して特定の内部リソースを取得することもできます。 このユースケースでは、次の方法について説明します:

サポートされているファインダの完全なリストについては、「リソース・ユーザー」 APIのドキュメントを参照してください。

Eメールによる内部リソースの取得

この例では、ResourceEmailファインダで電子メールIDを指定することで、内部リソースを取得するステップを検索できます。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers?q=ResourceEmail='john.smith@dnd.vision.com'

cURLコマンド

curl --user sales_cloud_user -X GET -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers?q=ResourceEmail='john.smith@dnd.vision.com'

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
 "PartyName": "John Smith",
 "ResourceType": "INDIVIDUAL",
 "FormattedAddress": "500 Oracle Parkway,REDWOOD CITY, CA 944065",
 "Username": "jsmith439906587",
 "City": "Redwood City",
 "Country": "US",
 "PostalCode": "944065",
 "FirstName": "John",
 "LastName": "Smith",
 "ResourcePartyNumber": "Conta504976",
 "State": "CA",
 "ResourceEmail": "john.smith@dnd.vision.com",
 "RawWorkPhoneNumber": "6505061212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "500 Oracle Parkway",
 "ResourceOrganizationName": "JSmithOrg",
 "ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SERVICE_MANAGER",
 "ResourceParentOrganizationName" : "NA Support",
 "ResourceManagerFirstName": "Phil",
 "ResourceManagerLastName": "Gioco",
 "HRManagerEmailAddress": "hrMan247134917@vision.com",
 "HireDate": "2018-08-20",
 "ResourceOrgMemRoleStartDate": "2018-08-20",
 "ResourceManagerPartyNumber": "100010034246635",
 "ResourceManagerPartyId": 100010034246635,
 "PersonNumber": "300100159661235",
 "BusinessUnit": "Vision Corporation Enterprise",
 "LegalEntity": "Vision Corporation",
 "UserStatus": "A",
 "PersonType": "EMP",
 "CreateUserAccountFlag": null,
...
}

ユーザー名による内部リソースの取得

この例では、ユーザー名ファインダでユーザー名を指定することによって、内部リソースを取得するステップを検索できます。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers?q=Username='jdoe439906587'

cURLコマンド

curl --user sales_cloud_user -X GET -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers?q=Username='jdoe439906587'

応答ペイロード

{
 "PartyName": "Jane Doe",
 "ResourceType": "INDIVIDUAL",
 "FormattedAddress": "500 Oracle Parkway,REDWOOD CITY, CA 944065",
 "Username": "jdoe439906587",
 "City": "Redwood City",
 "Country": "US",
 "PostalCode": "944065",
 "FirstName": "John",
 "LastName": "Smith",
 "ResourcePartyNumber": "Conta765976",
 "State": "CA",
 "ResourceEmail": "jane.doe@dnd.vision.com",
 "RawWorkPhoneNumber": "6505061212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "500 Oracle Parkway",
 "ResourceOrganizationName": "JSmithOrg",
 "ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SERVICE_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "NA Support",
 "ResourceManagerFirstName": "Phil",
 "ResourceManagerLastName": "Gioco", 
 "HRManagerEmailAddress": "hrMan247134917@vision.com",
 "HireDate": "2018-08-20",
 "ResourceOrgMemRoleStartDate": "2018-08-20",
 "ResourceManagerPartyNumber": "100010034246635",
 "ResourceManagerPartyId": 100010034246635,
 "PersonNumber": "300100159661235",
 "BusinessUnit": "Vision Corporation Enterprise",
 "LegalEntity": "Vision Corporation",
 "UserStatus": "A",
 "PersonType": "EMP",
 "CreateUserAccountFlag": null,
...
}

内部リソースの促進または後退

多くの場合、組織内の内部リソースのロールをプロモート、後退または変更する必要があります。 PATCHメソッドでは、内部リソースのロールを変更できます。 内部リソースを昇格または降格すると、その現在のロールは終了し、新しいロールを持つ新しいメンバーシップが開始されます。

ノート:

リソース・ユーザーAPIを使用して、Sales and Fusion Serviceでのみリソースをプロモートまたは後退できます。 APIを使用してHCM関連トランザクションを実行することはできません。 この例を続行するには、John Smithがサービス・マネージャのロールに昇格したとします。 次に、ロールの変更方法を説明します:
この例を続行するには、John Smithがサービス・マネージャのロールに昇格したとします。 次に、ロールの変更方法を示します:
  1. 「リソース・ユーザーの更新」操作のリクエストURLを作成します。
  2. 必要なリクエスト・パラメータとその値を指定して、リクエスト本文を作成します。 内部リソースをプロモートまたは後退させる場合は、ロール・プロビジョニングを変更します。
  3. REST APIクライアントまたはcURLコマンドライン・ユーティリティを使用して、PATCHコールを行います。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta504976

cURLコマンド

curl --user sales_cloud_user -X PATCH -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta504976

要求ペイロード

JSON形式のリクエスト本文の例を次に示します。

{
    "ResourceOrgRoleCode":"SERVICE_MANAGER"
}

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
 "PartyName": "John Smith",
 "ResourceType": "INDIVIDUAL",
 "FormattedAddress": "500 Oracle Parkway,REDWOOD CITY, CA 944065",
 "Username": "jsmith439906587",
 "City": "Redwood City",
 "Country": "US",
 "PostalCode": "944065",
 "FirstName": "John",
 "LastName": "Smith",
 "ResourcePartyNumber": "Conta504976",
 "State": "CA",
 "ResourceEmail": "john.smith@dnd.vision.com",
 "RawWorkPhoneNumber": "6505061212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "500 Oracle Parkway",
 "ResourceOrganizationName": "JSmithOrg",
 "ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SERVICE_MANAGER",
 "ResourceParentOrganizationName" : "NA Support",
 "ResourceManagerFirstName": "Phil",
 "ResourceManagerLastName": "Gioco",
 "HRManagerEmailAddress": "hrMan247134917@vision.com",
 "HireDate": "2018-08-20",
 "ResourceOrgMemRoleStartDate": "2018-08-20",
 "ResourceManagerPartyNumber": "100010034246635",
 "ResourceManagerPartyId": 100010034246635,
 "PersonNumber": "300100159661235",
 "BusinessUnit": "Vision Corporation Enterprise",
 "LegalEntity": "Vision Corporation",
 "UserStatus": "A",
 "PersonType": "EMP",
 "CreateUserAccountFlag": null,
...
}

同様のメソッドに従って内部リソースを格下げできます。 ただし、組織内のメンバーを持つリソースを降格する場合は、すべてのメンバーを新しいマネージャおよびリソース組織で更新する必要があります。

たとえば、サービス・マネージャをサービス担当に降格する場合は、最初に、サービス・マネージャの組織のすべてのメンバーに新しいマネージャと組織を割り当てる必要があります。 マネージャと組織を更新しないと、マネージャの組織の従業員には階層がなくなり、組織の機能に影響を与える可能性があります。

たとえば、サービス・マネージャであるJohn Smithが、チームとともに200万ドル相当の商談を処理するとします。 John Smithがサービス担当に降格され、営業階層が再作成されていない場合、つまり、古い組織のチーム・メンバーに新しいマネージャと組織が割り当てられていない場合、販売レポートに200万ドル相当の商談が正しく反映されないことがあります。

内部リソースの転送

内部リソースは、内部異動または組織変更のために、同じ組織内の他の組織に移動できます。 たとえば、Kattyが北アメリカのサービス組織からグローバル・サービス組織に転送されるとします。 REST APIを使用して、Oracle CX Sales and Fusion Serviceのこの変更をどのように反映しますか。

ResourceParentOrganizationNameは、内部リソースの組織階層を示します。 PATCHを使用して、適切なResourceParentOrganizationName属性値で内部リソースを転送します。 子階層を持つ内部リソースの場合は、最初に子階層を別の内部リソースに移動する必要があります。 子階層を移動しない場合、子内部リソースには階層がありません。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta855676

cURLコマンド

curl --user sales_cloud_user -X PATCH -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta855676

要求ペイロード

JSON形式のリクエスト本文の例を次に示します。

{
    "ResourceParentOrganizationName":"GLOBAL_SERVICE"
}

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
 "PartyName": "Katty Smith",
 "ResourceType": "INDIVIDUAL",
 "FormattedAddress": "500 Oracle Parkway,REDWOOD CITY, CA 944065",
 "City": "Redwood City",
 "Country": "US",
 "PostalCode": "944065",
 "FirstName": "Katty",
 "LastName": "Smith",
 "ResourcePartyNumber": "Conta855676",
 "State": "CA",
 "ResourceEmail": "katty.smith@dnd.vision.com",
 "RawWorkPhoneNumber": "6505061212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "500 Oracle Parkway",
 "ResourceOrganizationName": "KSmithOrg",
 "ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SERVICE_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "GLOBAL_SERVICE",
 "ResourceManagerFirstName": "Phil",
 "ResourceManagerLastName": "Gioco",
 "HRManagerEmailAddress": "hrMan247134917@vision.com",
 "HireDate": "2018-08-20",
 "ResourceOrgMemRoleStartDate": "2018-08-20",
 "ResourceManagerPartyNumber": "100010034246635",
 "ResourceManagerPartyId": 100010034246635,
 "PersonNumber": "300100159661235",
 "BusinessUnit": "Vision Corporation Enterprise",
 "LegalEntity": "Vision Corporation",
 "UserStatus": "A",
 "PersonType": "EMP",
 "CreateUserAccountFlag": null,
...
}

内部リソース情報の更新

内部リソース情報は、リソースのライフサイクル全体で変更できます。 これらの変更は頻繁に行われ、Oracle CX Sales and Fusion Serviceの内部リソース情報を更新して、サードパーティ・アプリケーションとの同期を維持する必要があります。 たとえば、Kattyの勤務先電話番号は、新しい組織への転送後に変更されました。 「リソース・ユーザー」 APIの「リソース・ユーザーの更新」操作(PATCHメソッド)を使用して、情報を更新できます。 前回の更新から変更されたフィールドのみを更新することをお薦めします。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta855676

cURLコマンド

curl --user sales_cloud_user -X PATCH -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta855676

要求ペイロード

JSON形式のリクエスト本文の例を次に示します。

{
    "RawWorkPhoneNumber": "6505061409"
}

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
 "PartyName": "Katty Smith",
 "ResourceType": "INDIVIDUAL",
 "FormattedAddress": "500 Oracle Parkway,REDWOOD CITY, CA 944065",
 "City": "Redwood City",
 "Country": "US",
 "PostalCode": "944065",
 "FirstName": "Katty",
 "LastName": "Smith",
 "ResourcePartyNumber": "Conta855676",
 "State": "CA",
 "ResourceEmail": "katty.smith@dnd.vision.com",
 "RawWorkPhoneNumber": "6505061409",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "500 Oracle Parkway",
 "ResourceOrganizationName": "KSmithOrg",
 "ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SERVICE_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "GLOBAL_SERVICE",
 "ResourceManagerFirstName": "Phil",
 "ResourceManagerLastName": "Gioco",
 "HRManagerEmailAddress": "hrMan247134917@vision.com",
 "HireDate": "2018-08-20",
 "ResourceOrgMemRoleStartDate": "2018-08-20",
 "ResourceManagerPartyNumber": "100010034246635",
 "ResourceManagerPartyId": 100010034246635,
 "PersonNumber": "300100159661235",
 "BusinessUnit": "Vision Corporation Enterprise",
 "LegalEntity": "Vision Corporation",
 "UserStatus": "A",
 "PersonType": "EMP",
 "CreateUserAccountFlag": null,
...
}

内部リソースの終了日

内部リソースの終了日を設定する必要がある場合があります。 これは、リソースの辞職、契約の失効、またはリソースが非営業組織に転送されたことが原因である可能性があります。

ノート:

契約の失効により、HRトランザクションは起動されません。

2019年6月31日にDiane Choの終了日を設定するとします。 リソースのResourceEndDate属性を日付で更新します。 これにより、内部リソースのレコードは削除されませんが、終了日に使用量が削除されるのみです。 子階層を持つ内部リソースの場合、子階層が終了日より前に別のリソースに移動することを確認する必要があります。 子リソースを移動しない場合、子リソースには階層がなく、エラーになります。 ファインダを使用してリソースを検索することで、リソースのResourcePartyNumberを取得できます。

内部リソースの終了日を設定すると、条件に応じて次の変更が行われる場合があります。
  • リソース終了日以降にユーザーにプロビジョニングされたロールがない場合、内部リソースのユーザー・ログインは一時停止される可能性があります。
  • 内部リソースを終了すると、リソース・ロールにマップされたジョブ・ロールのみが期限切れになります。
  • 内部リソースにリソース・ロールに依存しない他のロールが割り当てられている場合、このようなリソースを終了してもユーザー・アカウントは一時停止されません。
  • 終了日が指定されたリソースは、アカウント、商談などのトランザクション・オブジェクトのメンバーまたは所有者として使用できません。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta765982

cURLコマンド

curl --user sales_cloud_user -X PATCH -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta765982

要求ペイロード

JSON形式のリクエスト本文の例を次に示します。

{
    "ResourceEndDate": "2019-06-31"
}

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
"ResourceProfileId": 300100159661456,
"PartyName": "Diane Cho",
"LastUpdateDate": "2018-08-20T18:34:56.289+00:00",
"LastUpdatedBy": "SALES_ADMIN",
"CreationDate": "2018-08-20T18:34:29.001+00:00",
"CreatedBy": "SALES_ADMIN",
"ResourceType": "INDIVIDUAL",
"FormattedAddress": "100 Market Street,SAN FRANCISCO, CA 94105",
"TimezoneCode": null,
"Username": "dcho",
"City": "San Francisco",
"Country": "US",
"PostalCode": "94105",
"UpdateFlag": "true",
"DeleteFlag": "false",
"FirstName": "Diane",
"LastName": "Cho",
"MiddleName": null,
"Title": null,
"ResourcePartyNumber": "Conta765982",
"State": "CA",
"ResourceEmail": "diane.cho@dnd.vision.com",
"RawWorkPhoneNumber": "4155551212",
"RawMobilePhoneNumber": null,
"RawFaxNumber": null,
"AddressLine1": "100 Market Street",
"AddressLine2": null,
"ResourceStartDate": "2018-08-20",
"ResourceEndDate": "2019-06-31",
"ResourcePartyId": 300100159661457,
"ResourceOrganizationName": "NA Support",
"ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
"ResourceOrgMemRoleEndDate": "4712-12-31",
"ResourceOrgRoleCode": "SERVICE_REPRESENTATIVE",
"ResourceParentOrganizationName": "NA Support",
"ResourceOrgManagerEmail": "CEO.CRM+TM40@ap6023fems.us.vision.com",
"ResourceManagerName": null,
"ResourceManagerFirstName": "Phil",
"ResourceManagerLastName": "Gioco",
"HRManagerEmailAddress": "hrMan247134917@vision.com",
"HireDate": "2018-08-20",
"ResourceOrgMemRoleStartDate": "2018-08-20",
"ResourceManagerPartyNumber": "100010034246635",
"County": null,
"Province": null,
"ResourceManagerPartyId": 100010034246635,
"PersonNumber": "300100159661466",
"BusinessUnit": "Vision Corporation Enterprise",
"LegalEntity": "Vision Corporation",
"JobCode": null,
"JobTitle": null,
"UserStatus": "I",
"PersonType": "EMP",
...
}

ユーザー・アカウントの一時停止

内部リソース・アカウントを終了するのではなく、一定期間、内部リソース・アカウントを一時停止する必要がある場合があります。 たとえば、Diane Choの契約が期限切れになったため、アカウントは一時的に停止する必要があります。 内部ユーザー・アカウントを一時停止するには、PATCHメソッドを使用してユーザーのUserStatus属性を設定します。 内部リソース・アカウントは、検証エラーがない場合にのみ一時停止できます。リソース・ユーザーREST APIは、アカウントを一時停止する前にリソース・オブジェクト全体を検証するためです。 内部リソースを一時停止すると、ユーザーの現在のロールは変更されませんが、ユーザーはログインできなくなります。

ノート:

内部リソースのアカウントを一時停止し、リソース属性も変更する場合は、次のプロセスを使用します。 リソース属性を変更せずにユーザー・アカウントを単に一時停止する場合は、「ユーザー」 REST APIを使用します。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta765982

cURLコマンド

curl --user sales_cloud_user -X PATCH -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta765982

要求ペイロード

JSON形式のリクエスト本文の例を次に示します。

{
    "UserStatus" : "S"
}

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
"ResourceProfileId": 300100159661456,
"PartyName": "Diane Cho",
"LastUpdateDate": "2018-08-20T18:34:56.289+00:00",
"LastUpdatedBy": "SALES_ADMIN",
"CreationDate": "2018-08-20T18:34:29.001+00:00",
"CreatedBy": "SALES_ADMIN",
"ResourceType": "INDIVIDUAL",
"FormattedAddress": "100 Market Street,SAN FRANCISCO, CA 94105",
"TimezoneCode": null,
"Username": "dcho",
"City": "San Francisco",
"Country": "US",
"PostalCode": "94105",
"UpdateFlag": "true",
"DeleteFlag": "false",
"FirstName": "Diane",
"LastName": "Cho",
"MiddleName": null,
"Title": null,
"ResourcePartyNumber": "Conta765982",
"State": "CA",
"ResourceEmail": "diane.cho@dnd.vision.com",
"RawWorkPhoneNumber": "4155551212",
"RawMobilePhoneNumber": null,
"RawFaxNumber": null,
"AddressLine1": "100 Market Street",
"AddressLine2": null,
"ResourceStartDate": "2018-08-20",
"ResourceEndDate": "2019-01-31",
"ResourcePartyId": 300100159661457,
"ResourceOrganizationName": "NA Support",
"ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
"ResourceOrgMemRoleEndDate": "4712-12-31",
"ResourceOrgRoleCode": "SERVICE_REPRESENTATIVE",
"ResourceParentOrganizationName": "NA Support",
"ResourceOrgManagerEmail": "CEO.CRM+TM40@ap6023fems.us.vision.com",
"ResourceManagerName": null,
"ResourceManagerFirstName": "Phil",
"ResourceManagerLastName": "Gioco",
"HRManagerEmailAddress": "hrMan247134917@vision.com",
"HireDate": "2018-08-20",
"ResourceOrgMemRoleStartDate": "2018-08-20",
"ResourceManagerPartyNumber": "100010034246635",
"County": null,
"Province": null,
"ResourceManagerPartyId": 100010034246635,
"PersonNumber": "300100159661466",
"BusinessUnit": "Vision Corporation Enterprise",
"LegalEntity": "Vision Corporation",
"JobCode": null,
"JobTitle": null,
"UserStatus": "S",
"PersonType": "EMP",
...
}

ユーザー・アカウントの再アクティブ化

UserStatus属性をAに設定するだけで、一時停止しているユーザー・アカウントを再アクティブ化できます。 たとえば、Diane Choのユーザー・アカウントを契約の更新後に再アクティブ化する場合です。

リクエストURLの例

このリソースURL形式を使用します。

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta765982

cURLコマンド

curl --user sales_cloud_user -X PATCH -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.19.01/resourceUsers/Conta765982

要求ペイロード

JSON形式のリクエスト本文の例を次に示します。

{
    "UserStatus" : "A"
}

応答ペイロード

JSON形式のレスポンス本文の例を次に示します。

{
"ResourceProfileId": 300100159661456,
"PartyName": "Diane Cho",
"LastUpdateDate": "2018-08-20T18:34:56.289+00:00",
"LastUpdatedBy": "SALES_ADMIN",
"CreationDate": "2018-08-20T18:34:29.001+00:00",
"CreatedBy": "SALES_ADMIN",
"ResourceType": "INDIVIDUAL",
"FormattedAddress": "100 Market Street,SAN FRANCISCO, CA 94105",
"TimezoneCode": null,
"Username": "dcho",
"City": "San Francisco",
"Country": "US",
"PostalCode": "94105",
"UpdateFlag": "true",
"DeleteFlag": "false",
"FirstName": "Diane",
"LastName": "Cho",
"MiddleName": null,
"Title": null,
"ResourcePartyNumber": "Conta765982",
"State": "CA",
"ResourceEmail": "diane.cho@dnd.vision.com",
"RawWorkPhoneNumber": "4155551212",
"RawMobilePhoneNumber": null,
"RawFaxNumber": null,
"AddressLine1": "100 Market Street",
"AddressLine2": null,
"ResourceStartDate": "2018-08-20",
"ResourceEndDate": "2019-01-31",
"ResourcePartyId": 300100159661457,
"ResourceOrganizationName": "NA Support",
"ResourceOrganizationUsage": "SERVICE_RESOURCE_ORGANIZATION",
"ResourceOrgMemRoleEndDate": "4712-12-31",
"ResourceOrgRoleCode": "SERVICE_REPRESENTATIVE",
"ResourceParentOrganizationName": "NA Support",
"ResourceOrgManagerEmail": "CEO.CRM+TM40@ap6023fems.us.vision.com",
"ResourceManagerName": null,
"ResourceManagerFirstName": "Phil",
"ResourceManagerLastName": "Gioco",
"HRManagerEmailAddress": "hrMan247134917@vision.com",
"HireDate": "2018-08-20",
"ResourceOrgMemRoleStartDate": "2018-08-20",
"ResourceManagerPartyNumber": "100010034246635",
"County": null,
"Province": null,
"ResourceManagerPartyId": 100010034246635,
"PersonNumber": "300100159661466",
"BusinessUnit": "Vision Corporation Enterprise",
"LegalEntity": "Vision Corporation",
"JobCode": null,
"JobTitle": null,
"UserStatus": "A",
"PersonType": "EMP",
...
}