営業テリトリ・カバレッジ・データのインポート
インポート管理を使用して、営業テリトリ・カバレッジ・レコードを作成または削除できます。
営業テリトリ・カバレッジ・レコードをインポートするには、次のタスクを実行します:
-
ソース・データをOracle Applications Cloudオブジェクト属性にマップします。
-
インポート用のソース・カンマ区切り値(CSV)ファイルを作成します。
-
インポート・アクティビティを作成します。
-
インポート結果をレビューします。
ソース・データのオブジェクト属性へのマップ方法
営業テリトリ・カバレッジ・データをOracle Applications Cloudにインポートするには、.csvファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。
データ・インポート用のCSVファイルを作成する前に、次の手順を実行する必要があります。
-
ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
-
前提条件の設定が実行されていることを確認します(該当する場合)。
-
レコードを一意に識別するためのオプションを理解します。
-
子レコードをインポートする前に、親レコードが存在することを確認します。
-
テリトリを作成するときは、営業テリトリ・リソース、営業テリトリ・カバレッジまたは営業テリトリ・ライン・オブ・ビジネス・インポート・ファイルをインポートする前に、営業テリトリ・インポート・ファイルをインポートする必要があります。
-
-
正常にインポートするためにCSVファイルに必要なターゲット・オブジェクト属性を識別します。
開始する前に
インポートを開始する前に、いくつかの基本チェックを行う必要があります。 たとえば、次のことを確認してください。
-
ソース・データの各属性のインポートの前提条件がすべて完了している。
-
子レコードをインポートする前に、すべての親レコードを配置しておく。
レコードに対する一意の識別子の選択
Oracle Applications Cloudにデータをインポートするには、インポート・プロセスがレコードを一意に識別するための特定の属性がCSVファイルに含まれている必要があります。 ファイル・インポート・プロセスは、属性値を使用して、ソース・データをOracle Applications Cloudのターゲット・オブジェクト属性に自動的にマップします。
オブジェクト・レコードを一意に識別するための優先オプションは、公開一意識別子を使用することです。 新しいレコードを作成する場合は、適切なユーザー・フレンドリなパブリック一意識別子(数値で示され、通常はビジネス・オブジェクトのUIに表示される属性)を指定できます。 営業テリトリ・カバレッジ・オブジェクトの場合、属性はUniqueTerritoryNumber、CoverageTypeCodeおよびDimensionCodeです。 営業テリトリ・リソース・レコードを削除する場合は、UniqueTerritoryNumber属性とCoverageNumber属性の組合せを使用してレコードを識別できます。 Oracleでは、営業テリトリ・カバレッジ・オブジェクトは更新しないことをお薦めします。 たとえば、Addr
(DimensionCode)カバレージ・レコードのAddressCityを更新するには、レコードを削除し、正しいAddressCity値で新しいレコードを作成します。
営業テリトリ・カバレッジ・オブジェクトの必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、CSVファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。 次の表に、新しい営業テリトリ・カバレッジ・レコードのインポートに必要な属性、営業テリトリ・カバレッジ・レコードの削除に必要な属性、属性の前提条件設定タスク、および営業テリトリ・カバレッジ・インポートの特定の検証(ある場合)を示します:
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
UniqueTerritoryNumber |
テリトリの公開一意識別子番号 |
テキスト |
該当なし |
必須 |
CoverageNumber |
テリトリ・カバレッジの公開一意識別子番号 |
テキスト |
該当なし |
値を指定しないでください。 |
CoverageTypeCode |
テリトリ・カバレッジ・タイプのコード |
テキスト |
該当なし |
必須の値はREGULARとINCLUSION、EXCLUSIONです |
TerrDimensionCode |
ディメンションのコード |
テキスト |
該当なし |
関連ディメンション・メンバー情報を渡す場合は必須です。 値は次のとおりです。
すべてのディメンション・カバレッジを作成する場合(住所を含むすべてのディメンションに対して)は、値を指定しません |
ディメンション・カバレッジによっては、新しい営業テリトリ・カバレッジ・レコードをインポートするための追加の必須属性がある場合があります。 次の表に、新しい営業テリトリ・カバレッジ・レコードのインポートに必要な属性、属性の前提条件設定タスク、および営業テリトリ・カバレッジ・インポートの特定の検証(ある場合)を示します:
DimensionCode = Acct
の場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
RegistryId |
アカウントの公開一意識別子番号 |
テキスト |
該当なし |
RegistryIDまたはOriginalReferenceのいずれかが必要です。 |
OriginalReference |
アカウントの元のシステム / 元のシステム参照。 |
テキスト |
該当なし |
RegistryIDまたはOriginalReferenceのいずれかが必要です。 |
CoverageTypeCode |
テリトリ・カバレッジ・タイプのコード |
テキスト |
該当なし |
必須の値はREGULARとINCLUSION、EXCLUSIONです |
IncludeHierarchyFlag |
アカウント階層が含まれているかどうかを示すインジケータ |
テキスト |
該当なし |
オプション。 適用可能な値はYまたはNです。 |
インポート中に、アプリケーションはRegistryIdを使用してアカウントのルックアップを試みますが、見つからない場合はOriginalReferenceを使用します。 RegistryIDとOriginalReferenceの両方の値が渡された場合、RegistryIDが最初に使用されます。
DimensionCode = Geoの場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
GeographyName |
階層を含む地理名 |
テキスト |
該当なし |
必須 |
GeographyHighName |
階層を含む地理名範囲の上位レベル |
テキスト |
該当なし |
地理ディメンション・メンバーの範囲を定義する場合にのみ必要です |
DimensionCode = Addr
の場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
AddressCountry |
住所国のコード |
テキスト |
該当なし |
必須 |
AddressState |
住所都道府県 |
テキスト |
該当なし |
オプション |
AddressProvince |
住所都道府県 |
テキスト |
該当なし |
オプション |
AddressCounty |
住所郡 |
テキスト |
該当なし |
オプション |
AddressCity |
住所市区町村 |
テキスト |
該当なし |
オプション |
AddressPostalCode |
住所郵便番号 |
テキスト |
該当なし |
オプション |
AddressElementAttribute1 |
追加住所要素1 |
テキスト |
該当なし |
オプション |
AddressElementAttribute2 |
追加住所要素2 |
テキスト |
該当なし |
オプション |
AddressElementAttribute3 |
追加住所要素3 |
テキスト |
該当なし |
オプション |
AddressElementAttribute4 |
追加住所要素4 |
テキスト |
該当なし |
オプション |
AddressElementAttribute5 |
追加住所要素5 |
テキスト |
該当なし |
オプション |
DimensionCode = OrgTpの場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
OrganizationTypeCode |
組織タイプのコード |
テキスト |
該当なし |
必須 |
DimensionCode = Indstの場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
IndustryCode |
産業のコード |
テキスト |
該当なし |
必須 |
DimensionCode = Csize
の場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
CustomerSizeCode |
顧客サイズのコード |
テキスト |
該当なし |
必須 |
DimensionCode = AcTypの場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
AccountTypeCode |
指定されたアカウント・コード |
テキスト |
該当なし |
必須 |
DimensionCodeがProdの場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
ProductGroupNumber |
製品グループの公開一意識別子番号 |
テキスト |
該当なし |
製品グループの営業テリトリ・カバレッジを作成する場合は必須です |
ItemNumber |
品目の公開一意識別子番号 |
テキスト |
該当なし |
品目の営業テリトリ・カバレッジを作成する場合は必須です |
InventoryOrgId |
在庫組織の識別子 |
数値 |
該当なし |
品目の営業テリトリ・カバレッジを作成する際に必須となるのは、プロファイル・オプションQSC_SALES_PRODUCTS_INVENTORY_ORG_IDで指定したデフォルトの在庫組織識別子と値が異なる場合のみです。 |
DimensionCode = BUnit
の場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
BusinessUnitName |
ビジネス・ユニットの名前 |
テキスト |
該当なし |
必須 |
DimensionCode = Aux1の場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
Auxiliary1Code |
補助分類1のコード |
テキスト |
該当なし |
必須 |
DimensionCode = Aux2の場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
Auxiliary2Code |
補助分類2のコード |
テキスト |
該当なし |
必須 |
DimensionCode = Aux3の場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
Auxiliary3Code |
補助分類3のコード |
テキスト |
該当なし |
必須 |
DimensionCode = Schnlの場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
SalesChannelCode |
販売チャネルのコード |
テキスト |
該当なし |
必須 |
SubSalesChannelCode |
サブ販売チャネルのコード |
テキスト |
該当なし |
オプション |
DimensionCode = Prtnrの場合
属性 |
摘要 |
データ型 |
前提条件の設定タスクやインポート検証 |
営業テリトリ・カバレッジ・レコードの作成 |
---|---|---|---|---|
PartnerNumber |
パートナの公開一意識別子番号(または会社番号) |
テキスト |
該当なし |
必須 |
営業テリトリ・カバレッジ・オブジェクトおよび属性は、インポート管理フローの「インポート・オブジェクトの管理」ページで表示できます。 タイプ、長さ、説明などの属性情報をこのページで確認できます。
営業テリトリ・カバレッジ・オブジェクトの削除に必要な属性および検証
営業テリトリ・カバレッジ・レコードは、一意のテリトリ番号、ディメンション・コードおよびその他の属性、または一意のテリトリ番号とカバレッジ番号を使用して削除できます。
属性およびディメンション・コードを使用した営業テリトリ・カバレッジの削除
- 一意のテリトリ番号(UniqueTerritoryNumber): テリトリの公開一意識別子番号
- カバレッジ・タイプ・コード(CoverageTypeCode): カバレッジ・タイプ・コード。 指定可能な値は、REGULAR、INCLUSIONまたはEXCLUSIONです
- ディメンション・コード(TerrDimensionCode) : 次の表に、使用可能な値を示します:
ディメンション | ディメンション・コード | ディメンション・フィールド |
---|---|---|
販売チャネル | SalesChannelCodeまたはSubSalesChannelCode | |
製品 | Prod | ProductGroupNumberまたはProductGroupId、あるいはItemNumberまたはInventoryItemId |
口座タイプ | AccTp | AccountTypeCode |
住所 | Addr | AddressCountryおよび(オプションで)次の1つ以上。
|
Auxiliary 3 | Aux3 | Auiliary3Code |
Auxiliary 1 | Aux1 | Auiliary1Code |
Auxiliary 2 | Aux2 | Auiliary2Code |
ビジネス・ユニット | BUnit | BusinessUnitNameまたはBusinessUnitId |
顧客規模 | CSize | CustomerSizeCode |
地理 | Geo |
GeographyIdまたはGeographyName (フルパスを指定する必要があります。例: >United States>CAまたは~Global~North America) 地理範囲については、次も指定 GeographyHighIdまたはGeoHighName - フル・パスを指定する必要があります(オプション) |
産業 | Indst | IndustryCode |
組織規模 | OrgTp | OrganizationTypeCode |
パートナ | Prtnr | PartnerNumberまたはPartnerId |
アカウント | Acct | RegistryId、OriginalReferenceまたはAccountId |
一意のテリトリ番号およびカバレッジ番号を使用した営業テリトリ・カバレッジの削除
営業テリトリ・カバレッジ・レコードは、一意のテリトリ番号およびカバレッジ番号を使用して削除できます。
属性 | 摘要 | データ型 | 前提条件の設定タスクやインポート検証 | 既存の営業テリトリ・カバレッジ・レコードの削除 |
---|---|---|---|---|
UniqueTerritoryNumber | テリトリの公開一意識別子番号。 | テキスト | 該当なし | 必須 |
CoverageNumber | テリトリ・カバレッジの公開一意識別子番号。 | テキスト | 該当なし | 必須 |
ソースCSVファイルの作成
Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。
「インポート・オブジェクト」UIページで使用可能なテンプレートを使用して、ソースCSVファイルを作成できます。 テンプレートをダウンロードするには:
-
に移動します。
-
表内の「標準テキスト」オブジェクトを選択し、「ダウンロード」をクリックします。
これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。
CSVファイルの移入および値の入力に関する問題を回避するには、「関連トピック」の項でExcelを使用してCSVファイルを開く場合の潜在的な問題に関するトピックを参照してください。
インポート・アクティビティの作成
CSVファイルの準備が完了したら、インポート・アクティビティを作成して情報をインポートします。 インポート・アクティビティを作成するには:
-
に移動します。
-
「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
-
「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから営業テリトリ・カバレッジを選択します。
-
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
-
「拡張」オプションの下で、レコードの作成またはレコードの削除として「インポート・モード」を選択します。
-
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。 必要に応じてマッピングをレビューおよび編集します。
-
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
-
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
-
に移動します。
-
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。