関係の更新
patch
/crmRestApi/resources/11.13.18.05/accounts/{PartyNumber}/child/Relationship/{RelationshipRecId}
リクエスト
パス・パラメータ
- PartyNumber(required): string
アカウント・パーティの一意の代替識別子。 プロファイル・オプションHZ_GENERATE_PARTY_NUMBERがTrueに設定されている場合、値を更新できます。 デフォルト値は、プロファイル・オプションZCA_PUID_PREFIXで指定された値と一意のシステム生成順序番号を連結した値です。 非アクティブなレコードは更新できません。
- RelationshipRecId(required): integer(int64)
関係レコードの一意の識別子。
ヘッダー・パラメータ
- Metadata-Context:
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version:
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
サポートされるメディア・タイプ
- application/json
次の表では、このタスクのリクエストの本文パラメータについて説明します。
ルート・スキーマ : スキーマ
タイプ:
ソースを表示
object
-
Comments: string
タイトル:
Comments
最大長:2000
関係に対するユーザー指定のコメント。 -
ConflictId: integer (int64)
デフォルト値:
0
競合の一意の識別子。 この番号は、webサービスを消費するモバイル・アプリケーションまたはポータブル・アプリケーションで使用されます。 -
DependentFlag: string
タイトル:
Dependent Indicator
最大長:1
デフォルト値:N
1つのパーティが別のパーティに依存しているかどうかを示します。 -
EndDate: 文字列(日付)
タイトル:
To Date
関係が終了する日付。 -
HeadOfHouseholdFlag: string
タイトル:
Head of Household Indicator
最大長:1
デフォルト値:N
個人が所属する世帯主であるかどうかを示します。 -
InfluenceLevel: string
タイトル:
Influence Level
販売担当者が購買関係に与える影響。 サンプル値は、内部円、政治構造、なしです。 -
JobDefinitionName: string
最大長:
100
ジョブ名の定義。 -
JobDefinitionPackage: string
最大長:
900
ジョブ・パッケージの定義。 -
ObjectPartyId: integer (int64)
この関係のオブジェクト・パーティの一意の識別子。
-
ObjectPartyNumber: string
タイトル:
Object Registry ID
最大長:30
関係のオブジェクト・パーティの代替キー識別子。 -
ObjectSourceSystem: string
タイトル:
Object Source System
関係のオブジェクト・パーティの外部ソース・システムの名前。 -
ObjectSourceSystemReferenceValue: string
タイトル:
Object Source System Reference
外部ソース・システムからの関係におけるオブジェクト・パーティの識別子。 -
ObjectVersionNumber: 整数(int32)
ロックの実装に使用される番号。 この番号は、行を更新するたびに増分されます。 この数値は、トランザクションの開始時と終了時に比較され、別のセッションがその行を更新したかどうかが判断されます。
-
PercentageOwnership: number
タイトル:
Ownership Percentage
親エンティティが所有する子エンティティのパーセンテージ。 -
PreferredContactFlag: boolean
最大長:
10
デフォルト値:false
この担当者個人が顧客のプライマリ担当者であるかどうかを示します。 受け入れられる値はYおよびNです。 デフォルト値はNです。 -
PrimaryCustomerFlag: boolean
最大長:
10
デフォルト値:false
この顧客が担当者のプライマリ顧客かどうかを示します。 受け入れられる値はYおよびNです。 デフォルト値はNです。 -
RelationshipSourceSystem: string
関係のインポート元の外部ソース・システムの名前。 設定タスク取引先コミュニティ・ソース・システムで構成された値。
-
RelationshipSourceSystemReferenceValue: string
属性RelationshipSourceSystemで指定された外部ソース・システムからの関係の一意の識別子。
-
RequestId: integer (int64)
要求トの一意の識別子。
-
SubjectPartyId: integer (int64)
この関係のサブジェクト・パーティの一意の識別子。
-
SubjectPartyNumber: string
タイトル:
Subject Registry ID
最大長:30
関係のサブジェクト・パーティの代替キー識別子。 -
SubjectSourceSystem: string
タイトル:
Subject Source System
関係のサブジェクト・パーティの外部ソース・システムの名前。 -
SubjectSourceSystemReferenceValue: string
タイトル:
Subject Source System Reference
外部ソース・システムからの関係のサブジェクト・パーティの識別子。
応答
サポートされるメディア・タイプ
- application/json
デフォルトのレスポンス
次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
- Metadata-Context(required):
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version(required):
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
ルート・スキーマ : accounts-Relationship-item-response
タイプ:
ソースを表示
object
-
BackwardRole: string
タイトル:
Backward Role
読取り専用:true
関係の記述に使用されるバック・ワード関係コード。 たとえば、SUPPLIER_OFです。 -
Comments: string
タイトル:
Comments
最大長:2000
関係に対するユーザー指定のコメント。 -
ConflictId: integer (int64)
デフォルト値:
0
競合の一意の識別子。 この番号は、webサービスを消費するモバイル・アプリケーションまたはポータブル・アプリケーションで使用されます。 -
CreatedBy: string
タイトル:
Created By
読取り専用:true
最大長:64
レコードを作成したユーザー。 -
CreatedByModule: string
タイトル:
Created by Application
最大長:30
デフォルト値:HZ_WS
関係レコードを作成したアプリケーション・モジュール。 すべてのwebサービス・ベースの作成では、デフォルトで値HZ_WSに設定されます。 有効な証明レベル・コードのリストは、参照HZ_CREATED_BY_MODULESで定義されます。 設定およびメンテナンス・タスクの取引先コミュニティ共通参照の管理を使用して、コードをレビューおよび更新できます。 -
CreationDate: string (date-time)
タイトル:
Creation Date
読取り専用:true
レコードが作成された日付。 -
DependentFlag: string
タイトル:
Dependent Indicator
最大長:1
デフォルト値:N
1つのパーティが別のパーティに依存しているかどうかを示します。 -
DirectionCode: string
読取り専用:
true
最大長:30
DIRECTION_CODE参照タイプによって検証されたレコード。 親の場合はP、子の場合はC、方向でない場合はN。 -
EndDate: 文字列(日付)
タイトル:
To Date
関係が終了する日付。 -
HeadOfHouseholdFlag: string
タイトル:
Head of Household Indicator
最大長:1
デフォルト値:N
個人が所属する世帯主であるかどうかを示します。 -
InfluenceLevel: string
タイトル:
Influence Level
販売担当者が購買関係に与える影響。 サンプル値は、内部円、政治構造、なしです。 -
JobDefinitionName: string
最大長:
100
ジョブ名の定義。 -
JobDefinitionPackage: string
最大長:
900
ジョブ・パッケージの定義。 -
LastUpdateDate: string (date-time)
タイトル:
Last Updated Date
読取り専用:true
レコードが最後に更新された日付。 -
LastUpdatedBy: string
タイトル:
Last Updated By
読取り専用:true
最大長:64
レコードを最後に更新したユーザー。 -
LastUpdateLogin: string
タイトル:
Last Update Login
読取り専用:true
最大長:32
レコードを最後に更新したユーザーのログイン。 -
links: array Links
タイトル:
Links
リソース・インスタンスに関連付けられたリンク関係。 -
ObjectPartyId: integer (int64)
この関係のオブジェクト・パーティの一意の識別子。
-
ObjectPartyName: string
タイトル:
Object Party Name
読取り専用:true
最大長:360
関係のオブジェクト・パーティの名前。 -
ObjectPartyNumber: string
タイトル:
Object Registry ID
最大長:30
関係のオブジェクト・パーティの代替キー識別子。 -
ObjectSourceSystem: string
タイトル:
Object Source System
関係のオブジェクト・パーティの外部ソース・システムの名前。 -
ObjectSourceSystemReferenceValue: string
タイトル:
Object Source System Reference
外部ソース・システムからの関係におけるオブジェクト・パーティの識別子。 -
ObjectTableName: string
最大長:
30
この関係のオブジェクト・パーティのソース表名。 -
ObjectType: string
最大長:
30
担当者のオブジェクト・タイプ。 -
ObjectUsageCode: string
最大長:
30
関係におけるオブジェクト・パーティの使用コード。 -
ObjectVersionNumber: 整数(int32)
ロックの実装に使用される番号。 この番号は、行を更新するたびに増分されます。 この数値は、トランザクションの開始時と終了時に比較され、別のセッションがその行を更新したかどうかが判断されます。
-
ObjectVersionNumber1: 整数(int32)
読取り専用:
true
この属性は、オプティミスティック・ロックの実装に使用されます。 この番号は、行を更新するたびに増分されます。 この数値は、トランザクションの開始時と終了時に比較され、最後の問合せ以降に別のセッションによって行が更新されたかどうかが検出されます。 -
ObjectVersionNumber2: 整数(int32)
読取り専用:
true
オプティミスティック・ロックを実装する数。 この番号は、行を更新するたびに増分されます。 問合せされてから別のセッションによって行が更新されたかどうかを検出するために、トランザクションの開始時と終了時の番号が比較されます。 -
PartyId: integer (int64)
読取り専用:
true
パーティの一意識別子 -
PartyId1: integer (int64)
読取り専用:
true
パーティの代替一意識別子。 -
PercentageOwnership: number
タイトル:
Ownership Percentage
親エンティティが所有する子エンティティのパーセンテージ。 -
PreferredContactFlag: boolean
最大長:
10
デフォルト値:false
この担当者個人が顧客のプライマリ担当者であるかどうかを示します。 受け入れられる値はYおよびNです。 デフォルト値はNです。 -
PrimaryCustomerFlag: boolean
最大長:
10
デフォルト値:false
この顧客が担当者のプライマリ顧客かどうかを示します。 受け入れられる値はYおよびNです。 デフォルト値はNです。 -
RelationshipCode: string
タイトル:
Relationship Code
最大長:30
これがフォワード関係コードかバック・ワード関係コードかを指定する関係のコード。 有効な関係コードのリストは、参照PARTY_RELATIONS_TYPEで定義されます。 設定およびメンテナンス・タスクの関係参照の管理を使用して、コードをレビューおよび更新します。 -
RelationshipId: integer (int64)
読取り専用:
true
関係の一意の識別子。 -
RelationshipRecId: integer (int64)
関係レコードの一意の識別子。
-
RelationshipSourceSystem: string
関係のインポート元の外部ソース・システムの名前。 設定タスク取引先コミュニティ・ソース・システムで構成された値。
-
RelationshipSourceSystemReferenceValue: string
属性RelationshipSourceSystemで指定された外部ソース・システムからの関係の一意の識別子。
-
RelationshipType: string
タイトル:
Relationship Type
最大長:30
CUSTOMER_SUPPLIERなどの関係タイプ。 有効な関係タイプのリストは、参照HZ_RELATIONSHIP_TYPEで定義されます。 設定およびメンテナンス・タスクの関係参照の管理を使用して、コードをレビューおよび更新します。 -
RequestId: integer (int64)
要求トの一意の識別子。
-
Role: string
タイトル:
Role
サブジェクト・パーティとオブジェクト・パーティ間のロール。 -
SSROwnerTableName: string
読取り専用:
true
最大長:255
デフォルト値:HZ_PARTIES
レコード・データを保持し、ソース・システム参照を管理するために参照される表の名前。 -
StartDate: 文字列(日付)
タイトル:
From Date
関係が作成された日付。 -
Status: string
読取り専用:
true
最大長:1
デフォルト値:A
関係がアクティブか非アクティブかを示します。たとえば、アクティブの場合はA、非アクティブの場合はIです。 有効な値のリストは、参照HZ_STATUSで定義されます。 「設定および保守」作業領域の「標準参照の管理」タスクを使用して、コードを確認、更新します。 -
SubjectPartyId: integer (int64)
この関係のサブジェクト・パーティの一意の識別子。
-
SubjectPartyName: string
タイトル:
Subject Party Name
読取り専用:true
最大長:360
件名パーティの名前。 -
SubjectPartyNumber: string
タイトル:
Subject Registry ID
最大長:30
関係のサブジェクト・パーティの代替キー識別子。 -
SubjectSourceSystem: string
タイトル:
Subject Source System
関係のサブジェクト・パーティの外部ソース・システムの名前。 -
SubjectSourceSystemReferenceValue: string
タイトル:
Subject Source System Reference
外部ソース・システムからの関係のサブジェクト・パーティの識別子。 -
SubjectTableName: string
最大長:
30
件名のソース表。 -
SubjectType: string
最大長:
30
担当者の件名タイプ。 -
SubjectUsageCode: string
最大長:
30
担当者のサブジェクト・パーティの使用コード。
ネストされたスキーマ : リンク
タイプ:
ソースを表示
object
-
href: string
タイトル:
hyperlink reference
関連リソースへのURI。 -
kind: string
タイトル:
kind
許可された値:[ "collection", "item", "describe", "other" ]
関連リソースの種類。 -
name: string
タイトル:
name
関連リソースへのリンクの名前。 -
properties: object properties
-
rel: string
タイトル:
relation
許可された値:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
リソース・インスタンスとの関係の名前。 例: self.
ネストされたスキーマ : properties
タイプ:
ソースを表示
object
-
changeIndicator: string
リソース・インスタンスのインジケータまたはETag値を変更します。
リンク
- BackwardRoleLOV
-
パラメータ:
- ファインダ:
RoleForSubjectObjectFinder%3BbindObjectType%3D{SubjectType}%2CbindSubjectType%3D{ObjectType}
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: BackwardRole;ターゲット属性: ロール
- 表示属性: 説明
- ファインダ:
- InfluenceLevelLookupLOV
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BLookupType%3DHZ_SLS_CNTCT_INFLUENCE_LVL_CD
関係内のオブジェクト・パーティの影響レベルを示す値リスト。
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: InfluenceLevel;ターゲット属性: LookupCode
- 表示属性: LookupCode
- ファインダ:
- RelationshipCodeLookupLOV
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BLookupType%3DPARTY_RELATIONS_TYPE
関連および関連会社など、関係の記述に使用されるフレーズを示す値リスト。
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: RelationshipCode;ターゲット属性: LookupCode
- 表示属性: 意味
- ファインダ:
- RelationshipTypeLookupLOV
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BLookupType%3DHZ_RELATIONSHIP_TYPE
関連または競合相手など、関係のタイプを示す値リスト。
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: RelationshipType;ターゲット属性: LookupCode
- 表示属性: 意味
- ファインダ:
- RoleLOV
-
パラメータ:
- ファインダ:
RoleForSubjectObjectFinder%3BbindObjectType%3D{ObjectType}%2CbindSubjectType%3D{SubjectType}
関係のサブジェクト・パーティとオブジェクト・パーティ間のロールを示す値リスト。
LOVリンク関連では、次のプロパティが定義されます:- ソース属性: ロール、ターゲット属性: ロール
- 表示属性: 説明
- ファインダ:
例:
次の例は、cURLを使用してRESTリソースに対してPATCHリクエストを発行することによって、関係を更新する方法を示しています。
cURLコマンド
curl -u <username:password> \ -X POST -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/accounts/CDRM_2310/child/Relationship/300100090818648
リクエスト本文の例
次に、JSON形式のリクエスト本文の例を示します。
{ "Comments": "null" }
レスポンス本文の例
次の例は、JSON形式のレスポンス本文のコンテンツを示しています。
{ "RelationshipId": 300100090818649, "RelationshipRecId": 300100090818648, "ObjectVersionNumber": 5, "RelationshipSourceSystem": null, "RelationshipSourceSystemReferenceValue": null, "ObjectPartyId": 300100010638186, "SubjectPartyId": 300100010649305, "RelationshipType": "CONTACT", "RelationshipCode": "CONTACT_OF", "StartDate": "2016-12-19", "EndDate": "4712-12-31", "CreatedByModule": "HZ_WS", "Comments": "null", "Status": "A", "CreatedBy": "MHoope", "CreationDate": "2016-12-19T03:08:18-08:00", "LastUpdateDate": "2016-12-19T03:18:46-08:00", "LastUpdateLogin": "4401194542482278E053B80AF40ABC9C", "LastUpdatedBy": "MHoope", "DirectionCode": "P", "DependentFlag": "N", "PercentageOwnership": 50, "SubjectPartyNumber": "CDRM_2336", "PartyId": 300100010649305, "ObjectVersionNumber1": 2, "SubjectSourceSystem": null, "SubjectSourceSystemReferenceValue": null, "ObjectSourceSystem": null, "ObjectSourceSystemReferenceValue": null, "ObjectPartyNumber": "CDRM_2310", "PartyId1": 300100010638186, "ObjectVersionNumber2": 2, "SubjectTableName": "HZ_PARTIES", "SubjectType": "PERSON", "SubjectUsageCode": null, "ObjectTableName": "HZ_PARTIES", "ObjectType": "ORGANIZATION", "ObjectUsageCode": null, "HeadOfHouseholdFlag": "N", "RequestId": null, "JobDefinitionName": null, "JobDefinitionPackage": null, "SSROwnerTableName": "HZ_PARTIES", "SubjectPartyName": "Consumer First Name :53020121541410142 Consumer Second Name :53020121541410142", "ObjectPartyName": "WS_SA530201205237378312", "Role": "CONTACTORG", "InfluenceLevel": null, "BackwardRole": "ORGWITHCONTACT", ... }