機械翻訳について

リソース・ユーザーの作成

post

/crmRestApi/resources/11.13.18.05/resourceUsers

リクエスト

ヘッダー・パラメータ
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
  • 次のいずれかの値が含まれます: trueまたはfalse。 trueの場合、サーバーは作成操作ではなくアップサート操作を実行します。 アップサート操作中、サーバーはペイロードに一致する既存のリソースを検索しようとします。 一致が見つかった場合、サーバーは、新しいリソースを作成するのではなく、既存のリソースを更新します。 見つからないかfalse (デフォルト)の場合、サーバーは作成操作を実行します。 アップサート操作は、有効日RESTリソースではサポートされていないことに注意してください。
サポートされるメディア・タイプ
リクエスト本文 - application/json ()
次の表では、このタスクのリクエストの本文パラメータについて説明します。
ルート・スキーマ : スキーマ
タイプ: object
ソースを表示
ネストされたスキーマ : リソース・ロール割当
タイプ: array
タイトル: Resource Role Assignments
リソース・ロール割当リソースは、リソースに割り当てられたロール(実装者、再販業者など)を表示するために使用されます。
ソースを表示
ネストされたスキーマ : resourceUsers-ResourceRoleAssign-item-post-request
タイプ: object
ソースを表示
トップに戻る

応答

サポートされるメディア・タイプ

デフォルトのレスポンス

次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
本文( )
ルート・スキーマ : resourceUsers-item-response
タイプ: object
ソースを表示
ネストされたスキーマ : リソース・ロール割当
タイプ: array
タイトル: Resource Role Assignments
リソース・ロール割当リソースは、リソースに割り当てられたロール(実装者、再販業者など)を表示するために使用されます。
ソースを表示
ネストされたスキーマ : resourceUsers-ResourceRoleAssign-item-response
タイプ: object
ソースを表示
トップに戻る

例:

次の例は、cURLを使用してRESTリソースに対するPOSTリクエストを発行して、リソース・ユーザーを作成する方法を示しています。

ノート:

開始日が指定されていないリソースにロールを追加すると、開始日はリソースの採用日に設定されます。

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/

リクエスト本文の例

次の例は、JSON形式のリクエスト本文のコンテンツを示しています。

{
    "LegalEntity": "Vision Corporation",
    "BusinessUnit": "Vision Corporation Enterprise",
    "FirstName": "ABC",
    "LastName": "20200717_1706",
    "Title":"MR.",
    "ResourceEmail": "ABC_20200717_1706@oracle.com",
    "PersonType": "EMP",
    "HireDate": "2007-05-01",
    "ResourceStartDate": "2007-05-01",
    "Username": "ABC_20200717_1706@oracle.com",
    "IndividualRoleCode": "SALES_MANAGER"
}

レスポンス本文の例

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

{
  "ResourceProfileId": 300100185303175,
  "PartyName": "ABC 20200717_1706",
  "LastUpdateDate": "2020-07-20T07:31:31.019+00:00",
  "LastUpdatedBy": "sales_admin",
  "CreationDate": "2020-07-20T07:31:27.001+00:00",
  "CreatedBy": "sales_admin",
  "ResourceType": null,
  "FormattedAddress": null,
  "TimezoneCode": null,
  "Username": "ABC_20200717_1706@oracle.com",
  "City": null,
  "Country": null,
  "PostalCode": null,
  "UpdateFlag": "true",
  "DeleteFlag": "false",
  "ResourceOrgRoleCode": null,
  "ResourceOrgRoleName": null,
  "FirstName": "ABC",
  "LastName": "20200717_1706",
  "MiddleName": null,
  "Title": "MR.",
  "ResourcePartyNumber": "CDRM_885912",
  "State": null,
  "ResourceEmail": "ABC_20200717_1706@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": 300100185303176,
  "ResourceOrganizationName": null,
  "ResourceOrganizationUsage": null,
  "ResourceOrgMemRoleEndDate": null,
  "ResourceParentOrganizationName": null,
  "ResourceOrgManagerEmail": null,
  "ResourceManagerName": null,
  "ResourceManagerFirstName": null,
  "ResourceManagerLastName": null,
  "HRManagerEmailAddress": null,
  "HireDate": "2007-05-01",
  "ResourceOrgMemRoleStartDate": null,
  "IndividualRoleCode": "SALES_MANAGER",
  "IndividualRoleStartDate": null,
  "IndividualRoleEndDate": null,
  "ResourceManagerPartyNumber": null,
  "County": null,
  "Province": null,
  "ResourceManagerPartyId": null,
  "TopResourceFlag": false,
  "PersonNumber": null,
  "BusinessUnit": "Vision Corporation Enterprise",
  "LegalEntity": "Vision Corporation",
  "JobCode": null,
  "JobTitle": null,
  "UserStatus": null,
  "PersonType": "EMP",
  "CreateUserAccountFlag": true,
  "__ORACO__DistributionCentre_Id_c": null,
  "__ORACO__DistributionCentre_c": null,
  "__ORACO__Segment_c": null,
  "links": [
    {
      "rel": "self",
      "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/resourceUsers/CDRM_885912",
      "name": "resourceUsers",
      "kind": "item",
      "properties": {
        "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000009770400000009737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B0200007870000000017371007E0002000000017371007E0002000000027372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C71007E000871007E00087371007E00020000000171007E000871007E000878"
      }
    },...
}

ノート:

新しいリソース・ユーザーを作成すると、CreateUserAccountFlagによってリソースのユーザー・アカウントの作成が制御されます。 CreateUserAccountFlagのデフォルト値はYです。 フラグがNに設定されている場合、ロール・プロビジョニングは抑制されます。

ノート:

UserStatusのデフォルト値はAです。 ポスト・ペイロードに含めないでください。 ユーザーを一時停止するには、PATCHを使用してUserStatusをSに更新します。

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

次の例は、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、ユーザー・アカウントなしで内部リソースを作成する方法を示しています。 そのような例は、「営業リソース・ライフサイクルの管理」を参照してください。

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",
...
}
「トップに戻る」