機械翻訳について

解決リクエストの作成

post

/crmRestApi/resources/11.13.18.05/resolutionRequests

リクエスト

ヘッダー・パラメータ
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
サポートされるメディア・タイプ
リクエスト本文 - application/json ()
次の表では、このタスクのリクエストの本文パラメータについて説明します。
ルート・スキーマ : スキーマ
タイプ: object
ソースを表示
  • Duplicate Parties
    タイトル: Duplicate Parties
    重複パーティ・リソースは、解決リクエストで重複パーティを表示および作成するために使用されます。 重複パーティ・リソースには、名前や識別子など、重複パーティの詳細が含まれます。
  • 最大長: 500
    リクエストの名前。
  • Resolution Details
    タイトル: Resolution Details
    解決詳細リソースは、重複レコードの解決後に残存エンティティのマスター・レコードを表示および作成するために使用します。
  • 最大長: 30
    デフォルト値: MERGE
    解決リクエストのタイプ。
ネストされたスキーマ : 重複パーティ
タイプ: array
タイトル: Duplicate Parties
重複パーティ・リソースは、解決リクエストで重複パーティを表示および作成するために使用されます。 重複パーティ・リソースには、名前や識別子など、重複パーティの詳細が含まれます。
ソースを表示
ネストされたスキーマ : 解決詳細
タイプ: array
タイトル: Resolution Details
解決詳細リソースは、重複レコードの解決後に残存エンティティのマスター・レコードを表示および作成するために使用します。
ソースを表示
ネストされたスキーマ : resolutionRequests-DuplicateParty-item-post-request
タイプ: object
ソースを表示
ネストされたスキーマ : ソース・システム参照
タイプ: array
タイトル: Source System References
ソース・システム参照リソースは、ソース・システム内の重複レコードの一意の識別子を表示するために使用されます。 ソース・システムは、発生した重複レコードのシステムです。
ソースを表示
ネストされたスキーマ : resolutionRequests-DuplicateParty-SourceSystemReference-item-post-request
タイプ: object
ソースを表示
ネストされたスキーマ : resolutionRequests-ResolutionDetail-item-post-request
タイプ: object
ソースを表示
  • レコードに関連付けられた論理ビジネス・エンティティの一意の識別子。
  • エンティティHZ_PARTY_SITESおよびHZ_CUST_ACCOUNTSのレコードの一意の代替識別子。
  • 最大長: 30
    レコードに関連付けられた論理ビジネス・エンティティの名前。
  • マスター・レコードの一意の識別子。
  • エンティティHZ_PARTY_SITESおよびHZ_CUST_ACCOUNTSのマスター・レコードの一意の代替識別子。
トップに戻る

応答

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

デフォルトのレスポンス

次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
本文( )
ルート・スキーマ : resolutionRequests-item-response
タイプ: object
ソースを表示
ネストされたスキーマ : 重複パーティ
タイプ: array
タイトル: Duplicate Parties
重複パーティ・リソースは、解決リクエストで重複パーティを表示および作成するために使用されます。 重複パーティ・リソースには、名前や識別子など、重複パーティの詳細が含まれます。
ソースを表示
ネストされたスキーマ : 解決詳細
タイプ: array
タイトル: Resolution Details
解決詳細リソースは、重複レコードの解決後に残存エンティティのマスター・レコードを表示および作成するために使用します。
ソースを表示
ネストされたスキーマ : resolutionRequests-DuplicateParty-item-response
タイプ: object
ソースを表示
  • Links
  • 最大長: 1
    重複パーティがマスターかどうかを示します。 デフォルト値はfalseです。
  • 重複パーティの一意の内部識別子。 重複パーティを一意に識別するには、PartyId、PartyNumberまたはSourceSystemキーとSourceSystemReferenceValueキーのいずれかが必要です。
  • 読取り専用: true
    重複パーティの名前。
  • 最大長: 30
    重複パーティの一意のプライマリ識別子。
  • 読取り専用: true
    重複パーティのタイプ(ORGANIZATIONやPERSONなど)。
  • パーティの元のシステム。
  • Source System References
    タイトル: Source System References
    ソース・システム参照リソースは、ソース・システム内の重複レコードの一意の識別子を表示するために使用されます。 ソース・システムは、発生した重複レコードのシステムです。
  • このパーティの元のシステム参照。
ネストされたスキーマ : ソース・システム参照
タイプ: array
タイトル: Source System References
ソース・システム参照リソースは、ソース・システム内の重複レコードの一意の識別子を表示するために使用されます。 ソース・システムは、発生した重複レコードのシステムです。
ソースを表示
ネストされたスキーマ : resolutionRequests-DuplicateParty-SourceSystemReference-item-response
タイプ: object
ソースを表示
ネストされたスキーマ : resolutionRequests-ResolutionDetail-item-response
タイプ: object
ソースを表示
  • 読取り専用: true
    最大長: 30
    レコードに対して実行される処理(MERGEやRETAINなど)。
  • レコードに関連付けられた論理ビジネス・エンティティの一意の識別子。
  • エンティティHZ_PARTY_SITESおよびHZ_CUST_ACCOUNTSのレコードの一意の代替識別子。
  • 最大長: 30
    レコードに関連付けられた論理ビジネス・エンティティの名前。
  • Links
  • 読取り専用: true
    最大長: 1
    重複エンティティがマスターかどうかを示します。 デフォルト値はfalseです。
  • マスター・レコードの一意の識別子。
  • エンティティHZ_PARTY_SITESおよびHZ_CUST_ACCOUNTSのマスター・レコードの一意の代替識別子。
  • 読取り専用: true
    親レコードの一意の識別子。
  • 読取り専用: true
    親レコードに関連付けられているマスター・レコードの一意の識別子。
  • 読取り専用: true
    最大長: 255
    親オブジェクトの名前。
トップに戻る

例:

解決する重複パーティの詳細を参照することで、解決リクエストを作成できます。 詳細に応じて、次によってリクエスト・ペイロードを作成できます。
  • パーティ番号の使用
  • パーティIDの使用およびマスター・レコードの指定
  • ソース・システム参照の使用

ノート:

解決リクエストを作成すると、Oracle Fusionデータ品質システムによって処理される重複解決作業アイテムも作成されます。

次の例は、cURLを使用してRESTリソースに対してPOSTリクエストを発行することによって、解決リクエストを作成する方法を示しています。

パーティ番号の使用

cURLコマンド

curl -u <username:password> \ -X POST -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/resolutionRequests

リクエスト本文の例

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

{
"RequestName": "API Merge Request 001",
"ResolutionType": "MERGE",
"DuplicateParty": [
    {"PartyNumber": "CDRM_3102" },
    {"PartyNumber": "CDRM_3109" }
  ]
}

レスポンス本文の例

次の例は、JSON形式のレスポンス本文のコンテンツを示しています。

{
  "RequestId" : 300100177252448,
  "RequestNumber" : "300100177252448",
  "RequestName" : "API Merge Request 001",
  "ResolutionStatus" : "PENDING",
  "ResolutionStatusMessage" : null,
  "ResolutionType" : "MERGE",
  "CreationDate" : "2019-05-02T09:14:10+00:00",
  "CreatedBy" : "MDM_ADMIN_V1",
  "LastUpdateDate" : "2019-05-02T09:14:10.321+00:00",
  "LastUpdatedBy" : "MDM_ADMIN_V1",
  "DuplicateParty" : [ {
    "PartyId" : 300100011634984,
    "PartyType" : "ORGANIZATION",
    "PartyNumber" : "CDRM_3102",
    "PartyName" : "QuickCustomer82820121231262637129",
    "MasterFlag" : true,
    "SourceSystem" : null,
    "SourceSystemReferenceValue" : null,
    "links" : 
  }, {
    "PartyId" : 300100011635048,
    "PartyType" : "ORGANIZATION",
    "PartyNumber" : "CDRM_3109",
    "PartyName" : "QuickCustomer82820121231262637129_01",
    "MasterFlag" : false,
    "SourceSystem" : null,
    "SourceSystemReferenceValue" : null,
    "links" : ...
  } ],
  "links" : ...
}

パーティIDの使用およびマスター・レコードの指定

cURLコマンド

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

リクエスト本文の例

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

{
"RequestName": "API Merge Request 002",
"ResolutionType": "MERGE",
"DuplicateParty": [
    {"PartyId": "300100011634984", "MasterFlag":true },
    {"PartyId": "300100011635048", "MasterFlag":false }
  ]
}

レスポンス本文の例

次の例は、JSON形式のレスポンス本文のコンテンツを示しています。

{
  "RequestId" : 300100177252459,
  "RequestNumber" : "300100177252459",
  "RequestName" : "API Merge Request 002",
  "ResolutionStatus" : "PENDING",
  "ResolutionStatusMessage" : null,
  "ResolutionType" : "MERGE",
  "CreationDate" : "2019-05-02T09:19:20+00:00",
  "CreatedBy" : "MDM_ADMIN_V1",
  "LastUpdateDate" : "2019-05-02T09:19:20.050+00:00",
  "LastUpdatedBy" : "MDM_ADMIN_V1",
  "DuplicateParty" : [ {
    "PartyId" : 300100011634984,
    "PartyType" : "ORGANIZATION",
    "PartyNumber" : "CDRM_3102",
    "PartyName" : "QuickCustomer82820121231262637129",
    "MasterFlag" : true,
    "SourceSystem" : null,
    "SourceSystemReferenceValue" : null,
    "links" : 
  }, {
    "PartyId" : 300100011635048,
    "PartyType" : "ORGANIZATION",
    "PartyNumber" : "CDRM_3109",
    "PartyName" : "QuickCustomer82820121231262637129_01",
    "MasterFlag" : false,
    "SourceSystem" : null,
    "SourceSystemReferenceValue" : null,
    "links" : ... 
  } ],
  "links" : ...
}

ソース・システム参照の使用

cURLコマンド

curl -u <username:password> \ -X POST -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/resolutionRequests

リクエスト本文の例

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

{
"RequestName": "API Merge Request 003",
"ResolutionType": "MERGE",
"DuplicateParty": [
    {"SourceSystem": "Vision", "SourceSystemReferenceValue": "432432" },
    { "SourceSystem": "Vision", "SourceSystemReferenceValue": "321321"  }
  ]
}

レスポンス本文の例

次の例は、JSON形式のレスポンス本文のコンテンツを示しています。

{
  "RequestId" : 300100177252470,
  "RequestNumber" : "300100177252470",
  "RequestName" : "API Merge Request 002",
  "ResolutionStatus" : "PENDING",
  "ResolutionStatusMessage" : null,
  "ResolutionType" : "MERGE",
  "CreationDate" : "2019-05-02T09:19:20+00:00",
  "CreatedBy" : "MDM_ADMIN_V1",
  "LastUpdateDate" : "2019-05-02T09:19:20.050+00:00",
  "LastUpdatedBy" : "MDM_ADMIN_V1",
  "DuplicateParty" : [ {
    "PartyId" : 300100011634984,
    "PartyType" : "ORGANIZATION",
    "PartyNumber" : "CDRM_3102",
    "PartyName" : "QuickCustomer82820121231262637129",
    "MasterFlag" : true,
    "SourceSystem" : "Vision",
    "SourceSystemReferenceValue" : "432432",
    "links" : 
  }, {
    "PartyId" : 300100011635048,
    "PartyType" : "ORGANIZATION",
    "PartyNumber" : "CDRM_3109",
    "PartyName" : "QuickCustomer82820121231262637129_01",
    "MasterFlag" : false,
    "SourceSystem" : "Vision",
    "SourceSystemReferenceValue" : "321321",
    "links" : 
  } ],
  "links" : 
}
「トップに戻る」