機械翻訳について
  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":"SALES_REPRESENTATIVE",
    "ResourceParentOrganizationName" : "NA Sales",
    "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": "6505061212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "100 Oracle Parkway",
 "ResourceOrganizationName": "JSmithOrg",
 "ResourceOrganizationUsage": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "NA Sales",
 "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,
...
}

ノート:

ユーザー・パスワードを変更するには、Oracle HCM CloudガイドのREST APIを参照してください。

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

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-08-20",
    "LegalEntity":"Vision Corporation",
    "BusinessUnit":"Vision Corporation Enterprise",
    "HRManagerEmailAddress" : "HR.Manager@dnd.vision.com",
    "ResourceOrgRoleCode":"SALES_MANAGER",
    "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": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_MANAGER",
 "ResourceParentOrganizationName" : "HRManager_Org",
 "ResourceManagerFirstName": "Phil",
 "ResourceManagerLastName": "Gioco",
 "HRManagerEmailAddress": "HR.Manager@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": "N",
...
}

既存の従業員からリソースへの変換

リソース・ユーザーREST APIを使用して、既存の従業員をリソースに変換できます。 従業員をリソースとして識別するまでは、従業員にタスクを割り当てることはできません。 このシナリオでは、HarryはAPAC組織を持つ既存の従業員であり、Harryをリソースに変換します。 Harryをリソースに変換する前に、Harryが既存の従業員であることを確認してください(「リソース・ユーザーの作成」を参照)。

次のようにcURLを使用して、RESTリソースに対するPATCHリクエストを発行することで、Harryをリソースとして変換できます:

cURLコマンド

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

リクエスト本文

{     
      
      "ResourceParentOrganizationName" : "APAC",
      "ResourceOrgRoleCode" : "SALES_REPRESENTATIVE"
 
}

ノート:

ResourceOrganizationName属性は、非管理リソースでは無視されます。

レスポンス本文

{
    "ResourceProfileId": 300100213482812,
    "PartyName": "Harry Joel",
    "LastUpdateDate": "2020-12-30T07:23:44.036+00:00",
    "LastUpdatedBy": "SALES_ADMIN",
    "CreationDate": "2020-12-30T07:22:37.001+00:00",
    "CreatedBy": "SALES_ADMIN",
    "ResourceType": "INDIVIDUAL",
    "FormattedAddress": null,
    "TimezoneCode": null,
    "Username": "Harry.joel@oracle.com",
    "City": null,
    "Country": null,
    "PostalCode": null,
    "UpdateFlag": "true",
    "DeleteFlag": "false",
    "ResourceOrgRoleCode": "SALES_REPRESENTATIVE",
    "ResourceOrgRoleName": null,
    "FirstName": "Harry",
    "LastName": "Joel",
    "MiddleName": null,
    "Title": "MR.",
    "ResourcePartyNumber": "CDRM_914847",
    "State": null,
    "ResourceEmail": "Harry.joel@oracle.com",
    "WorkPhoneCountryCode": null,
    "RawWorkPhoneNumber": null,
    "MobilePhoneCountryCode": null,
    "RawMobilePhoneNumber": null,
    "FaxCountryCode": null,
    "RawFaxNumber": null,
    "AddressLine1": null,
    "AddressLine2": null,
    "ResourceStartDate": "2007-05-01",
    "ResourceEndDate": "4712-12-31",
    "ResourcePartyId": 300100213482813,
    "ResourceOrganizationName": null,
    "ResourceOrganizationUsage": null,
    "ResourceOrgMemRoleEndDate": null,
    "ResourceParentOrganizationName": "APAC",
    "ResourceOrgManagerEmail": null,
    "ResourceManagerName": null,
    "ResourceManagerFirstName": null,
    "ResourceManagerLastName": null,
    "HRManagerEmailAddress": null,
    "HireDate": "2007-05-01",
    "ResourceOrgMemRoleStartDate": null,
    "IndividualRoleCode": null,
    "IndividualRoleStartDate": null,
    "IndividualRoleEndDate": null,
    "ResourceManagerPartyNumber": null,
    "County": null,
    "Province": null,
    "ResourceManagerPartyId": null,
    "TopResourceFlag": null,
    "PersonNumber": "955160008192779",
    "BusinessUnit": "Vision Corporation Enterprise",
    "LegalEntity": "Vision Corporation",
    "JobCode": null,
    "JobTitle": null,
    "UserStatus": null,
    "PersonType": "EMP",
    "CreateUserAccountFlag": null,
...
}

リソース組織での営業マネージャの作成

営業マネージャを作成し、それらをリソース階層に追加できます。 この例では、Tom Johnsonをリソース親組織のGlobal HQでリソース組織のNorth American Salesのマネージャとして作成します。 この例のステップを実行する前に、次の前提条件がすでに設定されていることを確認してください:

  • 「ビジネス・ユニットの管理」タスクを使用して、適切なビジネス・ユニットが設定されています。
  • 「法的エンティティの管理」タスクを使用して、適切な法的エンティティが設定されています。
  • EメールIDとユーザー・アカウントは一意です。
このシナリオでは、Tom Johnsonは、SALES_MANAGERロールを持つ従業員リソースとして作成されます。 営業マネージャ・リソースとして作成するには:
  1. リソース・ユーザーの作成操作のリクエストURLを作成します。
  2. Tomの詳細を使用してリクエスト本文を作成します。
  3. POSTコールを実行するには、適切なREST APIクライアントまたはcURLコマンドライン・ユーティリティを使用します。

リクエスト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":"Tom",
    "LastName":"Johnson",
    "ResourceEmail":"tom.johnson@vision.com",
    "HireDate":"2018-08-20",
    "LegalEntity":"Vision Corporation",
    "BusinessUnit":"Vision Corporation Enterprise",
    "ResourceOrgManagerEmail": "resmanager@dnd.vision.com",
    "Username": " TOM.JOHNSON@VISION.COM",
    "ResourceOrgRoleCode":" SALES_MANAGER",
    "ResourceParentOrganizationName": "Global HQ",
    "ResourceOrganizationName": " North American Sales",
    "RawWorkPhoneNumber" : "6504461212",
    "AddressLine1" : "100 Oracle Parkway",
    "City" : "Redwood City",
    "State" : "CA",
    "PostalCode" : "944065",
    "Country" : "US",
}

ノート:

属性ResourceOrgManagerEmailまたはResourceParentOrganizationNameのいずれかが必要です。 これらのいずれも指定されていない場合、ルート・リソース組織はリソース親組織としてデフォルト設定されます。

応答ペイロード

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

{
 "PartyName": "Tom Johnson",
 "ResourceType": "INDIVIDUAL",
 "FormattedAddress": "100 Oracle Parkway,REDWOOD CITY, CA 944065",
 "Username": "jdoe",
 "City": "Redwood City",
 "Country": "US",
 "PostalCode": "944065",
 "FirstName": "Tom",
 "LastName": "Johnson" ,
 "ResourcePartyNumber": "CDRM_765976",
 "State": "CA",
 "ResourceEmail": "tom.johnson@vision.com",
 "RawWorkPhoneNumber": "6505061212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "100 Oracle Parkway",
 "ResourceOrganizationName": "North American Sales",
 "ResourceOrganizationUsage": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_MANAGER",
 "ResourceParentOrganizationName": "Global HQ",
 "ResourceManagerFirstName": "Tom",
 "ResourceManagerLastName": "Johnson",
 "ResourceOrgManagerEmail": "resmanager@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,
...
}

リソース組織での営業担当の作成

営業担当リソースを作成して、リソース階層に追加できます。 スタンドアロン・リソースとして営業担当を作成するために必要な属性とともに、リソース組織のマネージャEメール・アドレスや親組織名などの追加情報を指定する必要があります。 この例では、リソース組織に営業担当を作成するステップを確認できます。 この例のステップを実行する前に、次の前提条件がすでに設定されていることを確認してください:

  • 「ビジネス・ユニットの管理」タスクを使用して、適切なビジネス・ユニットが設定されています。
  • 「法的エンティティの管理」タスクを使用して、適切な法的エンティティが設定されています。
  • EメールIDとユーザー名は一意です。
新しい営業担当であるJane DoeがJohn Smithの組織(JSmithOrg)に参加するとします。 営業担当リソースとして作成する手順は、次のとおりです:
  1. リソース・ユーザーの作成操作のリクエストURLを作成します。
  2. Janeの詳細を使用してリクエスト本文を作成します。 ユーザー名の指定はオプションです。 ユーザー名を指定しない場合、アプリケーションによってデフォルトでユーザー名が生成されます。 ResourceManagerEmailまたはResourceParentOrganizationName属性に値を指定します。
  3. POSTコールを実行するには、適切なREST APIクライアントまたはcURLコマンドライン・ユーティリティを使用します。

リクエスト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",
    "ResourceOrgManagerEmail": "resmanager@dnd.vision.com",
    "Username": "jdoe",
    "ResourceOrgRoleCode":"SALES_REPRESENTATIVE",
    "ResourceParentOrganizationName" : "Global HQ",
    "RawWorkPhoneNumber" : "6504461212",
    "AddressLine1" : "100 Oracle Parkway",
    "City" : "Redwood City",
    "State" : "CA",
    "PostalCode" : "944065",
    "Country" : "US",
}

ノート:

属性ResourceOrgManagerEmailまたはResourceParentOrganizationNameのいずれかが必要です。 これらのいずれも指定されていない場合、ルート・リソース組織はリソース親組織としてデフォルト設定されます。

応答ペイロード

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": "CDRM_765976",
 "State": "CA",
 "ResourceEmail": "jane.doe@dnd.vision.com",
 "RawWorkPhoneNumber": "6505061212",
 "RawMobilePhoneNumber": null,
 "RawFaxNumber": null,
 "AddressLine1": "100 Oracle Parkway",
 "ResourceOrganizationName": "JSmithOrg",
 "ResourceOrganizationUsage": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "Global HQ",
 "ResourceManagerFirstName": "John",
 "ResourceManagerLastName": "Smith",
 "ResourceOrgManagerEmail": "resmanager@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,
...
}

組織からのマネージャの削除および組織への別のマネージャの追加

リソース・ユーザーREST APIを使用して、組織のマネージャを置換できます。 マネージャを置き換えるには、既存のマネージャを終了日設定してから、組織に新しい営業マネージャを作成する必要があります。 営業マネージャとして北米販売組織からJemmy Hanksを削除し、別のマネージャを組織に追加するとします。 これを行うには、ResourceOrgMemRoleEndDate属性を使用して組織メンバーシップ・ロールの終了日を指定し、「リソース組織での営業マネージャの作成」を使用します。

ノート:

ノート: 組織に2人のマネージャを同時に設定することはできません。 したがって、新しいマネージャ・リソースを組織に追加する前に、ターゲット組織の既存のマネージャ・リソースの組織ロール・メンバーシップを終了する必要があります。 または、既存のマネージャ・リソースを終了することもできます。 マネージャの組織ロール・メンバーシップの日付範囲は、同じ組織に対して重複できません。 したがって、新しいマネージャが明日までに参加する必要がある場合、既存のマネージャを今日削除または終了する必要があります。 たとえば、新しいマネージャを2021-01-06に追加する必要がある場合、既存のマネージャJemmyのロールは、2021-01-05で終了する必要があります。

cURLを使用してRESTリソースに対してPATCHリクエストを発行することで、Jemmyのロールを終了できます。

cURLコマンド

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

リクエスト本文

{
    "ResourceOrgMemRoleEndDate": "2021-01-05"
}

レスポンス本文

{
    "ResourceProfileId": 300100213939110,
    "PartyName": "Jemmy Hanks",
    "LastUpdateDate": "2021-01-04T14:56:46.656+00:00",
    "LastUpdatedBy": "SALES_ADMIN",
    "CreationDate": "2021-01-04T14:56:36.001+00:00",
    "CreatedBy": "SALES_ADMIN",
    "ResourceType": "INDIVIDUAL",
    "FormattedAddress": null,
    "TimezoneCode": null,
    "Username": "jemmy.hanks@oracle.com",
    "City": null,
    "Country": null,
    "PostalCode": null,
    "UpdateFlag": "true",
    "DeleteFlag": "false",
    "ResourceOrgRoleCode": "SALES_MANAGER",
    "ResourceOrgRoleName": "Sales Manager",
    "FirstName": "Jemmy",
    "LastName": "Hanks",
    "MiddleName": null,
    "Title": "MR.",
    "ResourcePartyNumber": "CDRM_928888",
    "State": null,
    "ResourceEmail": "jemmy.hanks@oracle.com",
    "WorkPhoneCountryCode": null,
    "RawWorkPhoneNumber": null,
    "MobilePhoneCountryCode": null,
    "RawMobilePhoneNumber": null,
    "FaxCountryCode": null,
    "RawFaxNumber": null,
    "AddressLine1": null,
    "AddressLine2": null,
    "ResourceStartDate": "2007-05-01",
    "ResourceEndDate": "4712-12-31",
    "ResourcePartyId": 300100213939111,
    "ResourceOrganizationName": "North American Sales",
    "ResourceOrganizationUsage": "SALES_RESOURCE_ORG",
    "ResourceOrgMemRoleEndDate": "2021-01-05",
    "ResourceParentOrganizationName": "Global HQ",
    "ResourceOrgManagerEmail": "sendmail-test-discard@oracle.com",
    "ResourceManagerName": "Sara   King",
    "ResourceManagerFirstName": "Sara ",
    "ResourceManagerLastName": " King",
    "HRManagerEmailAddress": null,
    "HireDate": "2007-05-01",
    "ResourceOrgMemRoleStartDate": "2007-05-01",
    "IndividualRoleCode": "SALES_MANAGER",
    "IndividualRoleStartDate": "2007-05-01",
    "IndividualRoleEndDate": "4712-12-31",
    "ResourceManagerPartyNumber": "100010025532588",
    "County": null,
    "Province": null,
    "ResourceManagerPartyId": 100010025532588,
    "TopResourceFlag": null,
    "PersonNumber": "955160008192781",
    "BusinessUnit": "Vision Corporation Enterprise",
    "LegalEntity": "Vision Corporation",
    "JobCode": null,
    "JobTitle": null,
    "UserStatus": null,
    "PersonType": "EMP",
    "CreateUserAccountFlag": null,

...
}

内部リソースの取得

内部リソースを取得する必要がある状況がいくつかあります。 たとえば、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": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_MANAGER",
 "ResourceParentOrganizationName" : "NA Sales",
 "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": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "NA Sales",
 "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が営業VPのロールに昇格したとします。 次に、ロールの変更方法を示します:
  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":"SALES_VP"
}

応答ペイロード

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": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_VP",
 "ResourceParentOrganizationName" : "NA Sales",
 "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およびB2B 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_SALES"
}

応答ペイロード

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": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "GLOBAL_SALES",
 "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": "SALES_RESOURCE_ORG",
 "ResourceOrgMemRoleEndDate": "4712-12-31",
 "ResourceOrgRoleCode":"SALES_REPRESENTATIVE",
 "ResourceParentOrganizationName" : "GLOBAL_Sales",
 "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トランザクションは起動されません。

たとえば、Diane Choの終了日を2019年6月31日に設定するとします。 リソースのResourceEndDate属性を日付で更新します。 これにより、内部リソースのレコードは削除されませんが、終了日に使用量が削除されるのみです。

子階層を持つ内部リソースの場合、子階層が終了日より前に別のリソースに移動することを確認する必要があります。 子リソースを移動しない場合、子リソースには階層がなく、エラーになります。 たとえば、Nelon Pascalは、Neya PaliとCarlton Baughという2人の営業担当者が所属している営業マネージャです。 Nelon PascalはVision Corporationから辞職し、そのリソース割当は終了しています。 要員の変更なしにマネージャに終了日を設定すると、そのマネージャの組織内のトランザクションは表示されません。 トランザクションが表示されるようにするには、組織に新しいマネージャを割り当てる必要があります。 Nelonのリソース割当が終了する前に、Oracleでは、自分のレポートをNelonのマネージャであるJane Reiferなどの別のマネージャに移動することをお薦めします。 ファインダを使用してリソースを検索することで、リソースのResourcePartyNumberを取得できます。 トランザクションを所有するリソースを終了する場合、そのリソースのトランザクションを別のアクティブなリソースに転送する必要があります。 他のユーザーへのトランザクションの転送の詳細は、「Salesの実装」ガイドを参照してください。

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

リクエスト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 Sales",
"ResourceOrganizationUsage": "SALES_RESOURCE_ORG",
"ResourceOrgMemRoleEndDate": "4712-12-31",
"ResourceOrgRoleCode": "SALES_REPRESENTATIVE",
"ResourceParentOrganizationName": "NA Sales",
"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 Sales",
"ResourceOrganizationUsage": "SALES_RESOURCE_ORG",
"ResourceOrgMemRoleEndDate": "4712-12-31",
"ResourceOrgRoleCode": "SALES_REPRESENTATIVE",
"ResourceParentOrganizationName": "NA Sales",
"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 Sales",
"ResourceOrganizationUsage": "SALES_RESOURCE_ORG",
"ResourceOrgMemRoleEndDate": "4712-12-31",
"ResourceOrgRoleCode": "SALES_REPRESENTATIVE",
"ResourceParentOrganizationName": "NA Sales",
"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",
...
}