機械翻訳について

テリトリのルールの作成

post

/crmRestApi/resources/11.13.18.05/territories/{TerritoryVersionId}/child/TerritoryRule

リクエスト

パス・パラメータ
ヘッダー・パラメータ
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
  • 次のいずれかの値が含まれます: trueまたはfalse。 trueの場合、サーバーは作成操作ではなくアップサート操作を実行します。 アップサート操作中、サーバーはペイロードに一致する既存のリソースを検索しようとします。 一致が見つかった場合、サーバーは、新しいリソースを作成するのではなく、既存のリソースを更新します。 見つからないかfalse (デフォルト)の場合、サーバーは作成操作を実行します。 アップサート操作は、有効日RESTリソースではサポートされていないことに注意してください。
サポートされるメディア・タイプ
リクエスト本文 - application/json ()
次の表では、このタスクのリクエストの本文パラメータについて説明します。
ルート・スキーマ : スキーマ
タイプ: object
ソースを表示
  • タイトル: Coverage Number
    テリトリのカバレッジ番号。
  • タイトル: Customer Coverage Code
    最大長: 30
    デフォルト値: INCLUSION
    カバレッジがテリトリの管轄に対して追加または削除されるかどうかを識別するためのコード。 使用可能な値は次のとおりです: EXCLUSION (ルール・タイプEXCLUSIONおよびPARTNER_EXCLUSIONの場合)およびINCLUSION (REGULAR、INCLUSION、PARTNER_REGULAR、PARTNER_INCLUSION、INHERITANCE_OVERRIDEなど、他のすべてのルール・タイプの場合)。
  • タイトル: Coverage
    最大長: 30
    デフォルト値: REGULAR
    テリトリ・カバレッジ・タイプのコード。 テリトリ・カバレッジ・モデルが販売アカウント中心の場合、受け入れられる値は次のとおりです: -REGULAR (販売アカウント・ディメンションまたは指定アカウントに基づくカバレッジの場合) -INCLUSION (手動で包含されたアカウント・カバレッジの場合) -EXCLUSION (手動で除外されたアカウント・カバレッジの場合)テリトリ・カバレッジ・モデルがパートナ中心の場合、許容値は次のとおりです: -PARTNER_REGULAR (パートナ・ディメンションに基づくカバレッジの場合) -PARTNER_INCLUSION (手動で包含されたパートナ・カバレッジの場合) -PARTNER_EXCLUSION (手動で除外されたパートナ・カバレッジの場合)継承の場合、カバレッジが受信者テリトリの場合、許容値はINHERITANCE_OVERRIDEで、カバレッジが継承されたディメンションの一部を上書きすることを示します。
  • Rule Boundaries
    タイトル: Rule Boundaries
    ルール境界リソースは、営業テリトリに関連付けられたルール境界を表示するために使用されます。 ルール境界の同等の機能用語はカバレッジ・ディメンションです。 ルール境界オブジェクトには、特定のテリトリ・カバレッジに定義されている各ディメンションのレコードが含まれます。
  • タイトル: Territory Number
    テリトリ・バージョンの一意の識別子。
  • タイトル: Coverage ID
    テリトリ・ルールの一意の識別子。
ネストされたスキーマ : ルール境界
タイプ: array
タイトル: Rule Boundaries
ルール境界リソースは、営業テリトリに関連付けられたルール境界を表示するために使用されます。 ルール境界の同等の機能用語はカバレッジ・ディメンションです。 ルール境界オブジェクトには、特定のテリトリ・カバレッジに定義されている各ディメンションのレコードが含まれます。
ソースを表示
ネストされたスキーマ : territories-TerritoryRule-TerritoryRuleBoundary1-item-post-request
タイプ: object
ソースを表示
  • タイトル: Dimension
    最大長: 5
    地理ディメンションの地理、製品ディメンションの製品など、テリトリ・ディメンションを示すコード。
  • Rule Boundary Values
    タイトル: Rule Boundary Values
    ルール境界値リソースは、営業テリトリに関連付けられたルール境界値を表示するために使用されます。 ルール境界値の同等の機能期間は、カバレッジ・ディメンション・メンバーです。 ルール境界値オブジェクトには、各カバレッジ・ディメンションのディメンション・メンバーのレコードが含まれます。
  • タイトル: Territory Dimension ID
    テリトリ・ルール境界の一意の識別子。
  • タイトル: Territory Number
    テリトリ・ルールの識別子。
ネストされたスキーマ : ルール境界値
タイプ: array
タイトル: Rule Boundary Values
ルール境界値リソースは、営業テリトリに関連付けられたルール境界値を表示するために使用されます。 ルール境界値の同等の機能期間は、カバレッジ・ディメンション・メンバーです。 ルール境界値オブジェクトには、各カバレッジ・ディメンションのディメンション・メンバーのレコードが含まれます。
ソースを表示
ネストされたスキーマ : スキーマ
タイプ: object
ソースを表示
トップに戻る

応答

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

デフォルトのレスポンス

次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
本文( )
ルート・スキーマ : territories-TerritoryRule-item-response
タイプ: object
ソースを表示
  • タイトル: Created By
    読取り専用: true
    最大長: 255
    テリトリ・ルールを作成したユーザー。
  • タイトル: Creation Date
    読取り専用: true
    テリトリ・ルールが作成された日付。
  • タイトル: Last Updated Date
    読取り専用: true
    テリトリ・ルールが最後に更新された日付。
  • タイトル: Last Updated By
    読取り専用: true
    最大長: 255
    テリトリ・ルールを最後に更新したユーザー。
  • タイトル: Last Update Login
    読取り専用: true
    最大長: 255
    テリトリ・ルールを最後に更新したユーザーのログイン。
  • Links
  • タイトル: Coverage Number
    テリトリのカバレッジ番号。
  • タイトル: Customer Coverage Code
    最大長: 30
    デフォルト値: INCLUSION
    カバレッジがテリトリの管轄に対して追加または削除されるかどうかを識別するためのコード。 使用可能な値は次のとおりです: EXCLUSION (ルール・タイプEXCLUSIONおよびPARTNER_EXCLUSIONの場合)およびINCLUSION (REGULAR、INCLUSION、PARTNER_REGULAR、PARTNER_INCLUSION、INHERITANCE_OVERRIDEなど、他のすべてのルール・タイプの場合)。
  • タイトル: Coverage
    最大長: 30
    デフォルト値: REGULAR
    テリトリ・カバレッジ・タイプのコード。 テリトリ・カバレッジ・モデルが販売アカウント中心の場合、受け入れられる値は次のとおりです: -REGULAR (販売アカウント・ディメンションまたは指定アカウントに基づくカバレッジの場合) -INCLUSION (手動で包含されたアカウント・カバレッジの場合) -EXCLUSION (手動で除外されたアカウント・カバレッジの場合)テリトリ・カバレッジ・モデルがパートナ中心の場合、許容値は次のとおりです: -PARTNER_REGULAR (パートナ・ディメンションに基づくカバレッジの場合) -PARTNER_INCLUSION (手動で包含されたパートナ・カバレッジの場合) -PARTNER_EXCLUSION (手動で除外されたパートナ・カバレッジの場合)継承の場合、カバレッジが受信者テリトリの場合、許容値はINHERITANCE_OVERRIDEで、カバレッジが継承されたディメンションの一部を上書きすることを示します。
  • Rule Boundaries
    タイトル: Rule Boundaries
    ルール境界リソースは、営業テリトリに関連付けられたルール境界を表示するために使用されます。 ルール境界の同等の機能用語はカバレッジ・ディメンションです。 ルール境界オブジェクトには、特定のテリトリ・カバレッジに定義されている各ディメンションのレコードが含まれます。
  • タイトル: Territory Number
    テリトリ・バージョンの一意の識別子。
  • タイトル: Coverage ID
    テリトリ・ルールの一意の識別子。
ネストされたスキーマ : ルール境界
タイプ: array
タイトル: Rule Boundaries
ルール境界リソースは、営業テリトリに関連付けられたルール境界を表示するために使用されます。 ルール境界の同等の機能用語はカバレッジ・ディメンションです。 ルール境界オブジェクトには、特定のテリトリ・カバレッジに定義されている各ディメンションのレコードが含まれます。
ソースを表示
ネストされたスキーマ : territories-TerritoryRule-TerritoryRuleBoundary1-item-response
タイプ: object
ソースを表示
  • タイトル: Created By
    読取り専用: true
    最大長: 64
    テリトリ・ルール境界を作成したユーザー。
  • タイトル: Creation Date
    読取り専用: true
    テリトリ・ルール境界が作成された日付。
  • タイトル: Dimension
    読取り専用: true
    最大長: 60
    ディメンションの名前。
  • タイトル: Last Updated Date
    読取り専用: true
    テリトリ・ルール境界が最後に更新された日付。
  • タイトル: Last Updated By
    読取り専用: true
    最大長: 64
    テリトリ・ルール境界を最後に更新したユーザー。
  • タイトル: Last Update Login
    読取り専用: true
    最大長: 32
    テリトリ・ルール境界を最後に更新したユーザーのログイン。
  • Links
  • タイトル: Dimension
    最大長: 5
    地理ディメンションの地理、製品ディメンションの製品など、テリトリ・ディメンションを示すコード。
  • Rule Boundary Values
    タイトル: Rule Boundary Values
    ルール境界値リソースは、営業テリトリに関連付けられたルール境界値を表示するために使用されます。 ルール境界値の同等の機能期間は、カバレッジ・ディメンション・メンバーです。 ルール境界値オブジェクトには、各カバレッジ・ディメンションのディメンション・メンバーのレコードが含まれます。
  • タイトル: Territory Dimension ID
    テリトリ・ルール境界の一意の識別子。
  • タイトル: Territory Number
    テリトリ・ルールの識別子。
ネストされたスキーマ : ルール境界値
タイプ: array
タイトル: Rule Boundary Values
ルール境界値リソースは、営業テリトリに関連付けられたルール境界値を表示するために使用されます。 ルール境界値の同等の機能期間は、カバレッジ・ディメンション・メンバーです。 ルール境界値オブジェクトには、各カバレッジ・ディメンションのディメンション・メンバーのレコードが含まれます。
ソースを表示
ネストされたスキーマ : territories-TerritoryRule-TerritoryRuleBoundary1-TerritoryRuleBndryValue1-item-response
タイプ: object
ソースを表示
  • タイトル: Additional Attribute 1
    最大長: 150
    柔軟な住所書式をサポートするための追加住所要素。
  • タイトル: Additional Attribute 2
    最大長: 150
    柔軟な住所書式をサポートするための追加住所要素。
  • タイトル: Additional Attribute 3
    最大長: 150
    柔軟な住所書式をサポートするための追加住所要素。
  • タイトル: Additional Attribute 4
    最大長: 150
    柔軟な住所書式をサポートするための追加住所要素。
  • タイトル: Additional Attribute 5
    最大長: 150
    柔軟な住所書式をサポートするための追加住所要素。
  • タイトル: City
    最大長: 60
    市区町村
  • タイトル: Country
    最大長: 2
  • タイトル: County
    最大長: 60
    County
  • タイトル: Postal Code
    最大長: 60
    郵便番号
  • タイトル: Province
    最大長: 60
    Province
  • タイトル: State
    最大長: 60
    都道府県。
  • タイトル: Created By
    読取り専用: true
    最大長: 64
    テリトリ・ルール境界値を作成したユーザー。
  • タイトル: Creation Date
    読取り専用: true
    テリトリ・ルール境界値が作成された日付。
  • テリトリ・ディメンション・メンバーの名前。
  • タイトル: Territory Dimension Member High
    読取り専用: true
    最大長: 360
    連番が高いテリトリ・ディメンション・メンバーの名前。
  • タイトル: Include Hierarchy
    最大長: 1
    ディメンション・メンバーが階層とともに含まれているかどうかを示します。 デフォルト値はtrueです。
  • タイトル: Last Updated Date
    読取り専用: true
    テリトリ・ルール境界値が最後に更新された日付。
  • タイトル: Last Updated By
    読取り専用: true
    最大長: 64
    テリトリ・ルール境界値を最後に更新したユーザー。
  • タイトル: Last Update Login
    読取り専用: true
    最大長: 32
    テリトリ・ルール境界値を最後に更新したユーザーのログイン。
  • Links
  • タイトル: Dimension
    最大長: 5
    テリトリ・ディメンションを示すコード。 たとえば、AcTyp、Acct、Aux1、Aux2、Aux3、BUnit、CSize、Geo、Indst、OrgTp、Prod、Prtnr、SChnlなどです。
  • タイトル: Dimension Value Range
    最大長: 80
    順序番号が大きいOracle Business Intelligence (OBI)、テリトリ管理およびキューブの共通メンバーの一意の識別子。
  • タイトル: Dimension Value
    最大長: 80
    Oracle Business Intelligence (OBI)、テリトリ管理およびキューブの共通メンバーの一意の識別子。
  • タイトル: Territory Dimension Member ID
    テリトリ・ルール境界値の一意の識別子。
  • タイトル: Territory Number
    テリトリ・ルール境界の識別子。
トップに戻る

例:

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

cURLコマンド

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

リクエスト本文の例

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

{
 "RuleNumber":"1",
 "RuleOperatorCode":"EXCLUSION",
 "RuleTypeCode":"EXCLUSION",
 "TerritoryRuleBoundary1":[
   {
     "TerrDimensionCode":"Acct",
     "TerritoryRuleBndryValue1":[
        {
          "TerrDimIntgId":"100000020228289",
          "TerrDimensionCode":"Acct"
         }]
   }]
}

レスポンス本文の例

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

{
"TerrRuleId": 300100091635540,
"RuleNumber": 1,
"TerritoryVersionId": 300100091635502,
"RuleOperatorCode": "EXCLUSION",
"RuleTypeCode": "EXCLUSION",
"TerritoryRuleBoundary1":[
{"TerrRuleBoundaryId": 300100091635541, "TerrRuleId": 300100091635540, "Dimension": "Customer", "TerrDimensionCode": "Acct",???}
],
"links":[
{"rel": "self", "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/territories/300100091635502/child/TerritoryRule/300100091635540",???},
{"rel": "canonical", "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/territories/300100091635502/child/TerritoryRule/300100091635540",???},
{"rel": "parent", "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/territories/300100091635502",???}
]
}
「トップに戻る」