地理ゾーン・データのインポート
インポート管理を使用して、地理ゾーン・レコードを作成、更新または削除できます。 ゾーンは、ゾーン・タイプの地理的境界です(たとえば、サンノゼ税金ゾーン)。 ゾーンは、マスター参照地理階層データに基づきます。
地理ゾーン・レコードをインポートするには、次のタスクを実行します:
- ソース・データをOracle Applications Cloudオブジェクト属性にマップします。
- インポート用のソース・カンマ区切り値(CSV)ファイルを作成します。
- インポート・アクティビティを作成します。
- インポート結果をレビューします。
ソース・データのターゲット・オブジェクト属性へのマップ方法
地理ゾーン・データをOracle Applications Cloudにインポートするには、CSVファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。
データ・インポート用のCSVファイルを作成する前に、次の手順を実行する必要があります。
- ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
- 前提条件の設定が実行されていることを確認します(該当する場合)。
- レコードを一意に識別するためのオプションを理解します。
- 子レコードをインポートする前に、親レコードが存在することを確認します。
- 正常にインポートするためにCSVファイルに必要なターゲット・オブジェクト属性を識別します。
開始する前に
インポートを開始する前に、いくつかの基本チェックを行う必要があります。 たとえば、次のことを確認してください。
- CSVファイルの準備ができました。
- UIで「地理タイプ」を作成しました。
- ソース・データの各属性のインポートの前提条件がすべて完了している。
- 子レコードをインポートする前に、すべての親レコードを配置しておく。
レコードに対する一意の識別子の選択
すべてのレコードはアプリケーション内で一意である必要があります。 次のいずれかを使用してレコードを識別できます。
- 公開一意識別子: レコードを作成する場合、理解しやすい公開一意識別子を指定できます。 これらは通常、数値で示され、ビジネス・オブジェクトのUIに表示されます。 PUID属性の名前は通常、<object>番号です。 番号属性を持つレコードを更新する場合は、番号属性を使用してレコードを識別します。 公開一意識別子の詳細は、「代替キーを使用したレコードのインポート方法」を参照してください
地理ゾーン・オブジェクトの必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、CSVファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。 この表は、新しい地理ゾーン・レコードのインポートに必要な属性、地理ゾーン・レコードの更新に必要な属性、属性の前提条件設定タスク、および地理ゾーン・インポートの特定の検証(ある場合)を示しています:
| 属性 | 摘要 | 前提条件設定タスク/インポート検証 | 地理ゾーン・レコードの作成 | 地理ゾーン・レコードの更新 | 地理ゾーン・レコードの削除 |
|---|---|---|---|---|---|
| ZoneName | ゾーンの名前。 | NA | 必須 | 条件により必須 ゾーン名またはゾーン地理IDのいずれかを指定する必要があります。 | 条件により必須 ゾーン名またはゾーン地理IDのいずれかを指定する必要があります。 |
| ZoneType | ゾーンのタイプ。 | ゾーン・タイプはインポート前に作成する必要があります。 | 必須 | 必須 | 必須 |
| ZoneCode | ゾーンのコード。 | NA | 必須 | 必須 | 必須 |
| ZoneGeographyUse |
地理ゾーンの使用。 値は参照タイプORA_HZ_GEO_USAGEから取得されます。 サンプル値は、TAX、SHIPPING、ORA_COMPENSATIONおよびORA_SERVICEです。 単一のCSV入力で複数の地理使用を渡すことはできません。 1つのCSVには、1つの使用目的のみのデータが必要です。 単一のCSV入力で複数の地理使用を渡すことはできません。 1つのCSVには、1つの使用目的のみのデータが必要です。 |
NA | 必須 | 必須 | 必須 |
| ZoneGeographyId | ゾーン地理の一意の識別子。 | NA | 不要 | 条件により必須 ゾーン名またはゾーン地理IDのいずれかを指定する必要があります。 | 条件により必須 ゾーン名またはゾーン地理IDのいずれかを指定する必要があります。 |
インポート管理フローの「インポート・オブジェクトの管理」ページで、地理ゾーン・オブジェクトとそのすべての子オブジェクトおよび属性を表示できます。 タイプ、長さ、説明などの属性情報をこのページで確認できます。
- エクスポートできるのは、地理にリンクされている地理ゾーン・データのみです。 地理データがないゾーン・データはエクスポートされません。
- PrimaryRecordNumは内部列であり、地理ゾーンのインポートまたはエクスポートには使用できません。
- 一度削除したデータはリストアできません。 「エクスポート管理」を使用して削除する前に、既存のデータのバックアップを作成することをお薦めします。
ソースCSVファイルの作成
Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。
「インポート・オブジェクトUI」ページで使用可能なCSVテンプレートを使用して、ソースCSVファイルを作成できます。 CSVテンプレートをダウンロードするには:
-
に移動します。
-
表内の「地理ゾーン」オブジェクトを選択し、「ダウンロード」をクリックします。
これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。
インポート・アクティビティの作成
CSVファイルの準備が完了したら、インポート・アクティビティを作成して情報をインポートします。 インポート・アクティビティを作成するには:
-
に移動します。
-
「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
-
「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから「地理ゾーン」を選択します。
-
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
-
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされます。 必要に応じてマッピングをレビューおよび編集します。
-
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
-
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
-
に移動します。
-
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。