階層メンバー・データをインポートするにはどうすればよいですか。

インポート機能を使用して、階層メンバー・レコードを作成または更新できます。

階層メンバー・レコードをインポートするには、次のタスクを実行します:

ソース・データをOracle Applications Cloudオブジェクト属性にマップします。
インポート用のソース・カンマ区切り値(.csv)ファイルを作成します。
インポート・アクティビティを作成します。
インポート結果をレビューします。

ソース・データのターゲット・オブジェクト属性へのマップ方法

階層メンバー・データをOracle Applications Cloudにインポートするには、CSVファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。

データ・インポート用の.CSVファイルを作成する前に、次の手順を実行する必要があります。

ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
オブジェクトのインポートに必要な属性を理解するなど、前提となるステップが完了していることを確認します。
レコードを一意に識別するためのオプションを理解します。
子レコードをインポートする前に、親レコードが存在することを確認します。
正常にインポートするために.CSVファイルに必要なターゲット・オブジェクト属性を識別します。

開始する前に

インポートを開始する前に、いくつかの基本チェックを行う必要があります。たとえば、次のことを確認してください。

ソース・データの各属性のインポートの前提条件がすべて完了している。
子レコードをインポートする前に、すべての親レコードを配置しておく。

レコードに対する一意の識別子の選択

Oracle Applications Cloudにデータをインポートするには、インポート・プロセスがレコードを一意に識別するための特定の属性がCSVファイルに含まれている必要があります。ファイル・インポート・プロセスは、属性値を使用して、ソース・データをOracle Applications Cloudのターゲット・オブジェクト属性に自動的にマップします。

オブジェクト・レコードを一意に識別するための優先オプションは、パブリック一意識別子を使用することです。新しいレコードを作成する場合は、わかりやすい公開一意識別子(数値で示され、通常はビジネス・オブジェクトのUIに表示される属性)を指定できます。以前に番号属性を指定したレコード、または番号属性がオブジェクトのUIに表示されるレコードを更新する場合は、番号属性を使用してレコードを識別できます。階層メンバー・オブジェクトの場合、属性は次のとおりです:

TreeStructureCode
TreeCode
PartyNumber
ParentPartyNumber
AsofDate

階層メンバー・オブジェクトの必須属性および検証

Oracle Applications Cloudにデータを正常にインポートするには、.CSVファイルに必須属性が含まれている必要があります。属性に有効な値が指定されていることを確認します。

次の表に、新規階層メンバー・レコードのインポートに必要な属性、階層メンバー・レコードの更新に必要な属性、属性の前提条件設定タスク、および階層メンバー・インポートの特定の検証(ある場合)を示します:

属性	摘要	データ型	データ長	前提条件の設定タスクやインポート検証	階層メンバー・レコードの作成	既存の階層メンバー・レコードの更新
TreeStructureCode	ツリー構造の一意の識別子。	Varchar2	30	シード済データが存在する必要があります。	必須	必須
TreeCode	ツリー・コードのユーザー定義識別子です。	Varchar2	30	検証なし	必須	必須
PartySourceSystem	パーティの当初システムID。			アカウントが存在する必要があります。	必須	必須
PartySourceSystemReference	パーティのオリジナル・システム参照。			アカウントが存在する必要があります。	必須	オプション
PartyId	パーティの一意のID。	数値	18	アカウントが存在する必要があります。	必須	必須
ParentPartyId	親パーティの一意のID。	数値	18	アカウントが存在する必要があります。	必須	必須
ParentPartySourceSystem	親パーティの当初システムID。	Varchar2	30	アカウントが存在する必要があります。	必須	オプション
ParentPartySourceSystemReference	親パーティの当初システムID。	Varchar2	240	アカウントが存在する必要があります。	必須	オプション
LabelShortName	子に対するツリー階層内の位置に基づくラベル名。	Varchar2	80	シード・データが存在する必要があります。	必須	オプション
PartyNumber	このパーティの一意の識別番号。	Varchar2	30	アカウントが存在する必要があります。	必須	オプション
ParentPartyNumber	この親パーティの一意の識別番号。	Varchar2	30	アカウントが存在する必要があります。	必須	オプション

階層メンバー・オブジェクトは、「インポート管理」フローの「インポート・オブジェクトの管理」ページで、そのすべての子オブジェクトおよび属性とともに表示できます。タイプ、長さ、説明などの属性情報をこのページで確認できます。

ソースCSVファイルの作成

.CSV ファイルは、ファイルベース・データ・インポート・プロセスに入力として指定します。 .CSVファイルには、Oracle Applications Cloudにインポートするデータを入力する必要があります。

「インポート・オブジェクト」UIページで使用可能なテンプレートを使用して、ソースCSVファイルを作成できます。テンプレートをダウンロードするには:

「ナビゲータ」→「ツール」→「インポート管理」→「インポート・オブジェクト」に移動します。
表内の「階層メンバー」オブジェクトを選択し、「ダウンロード」をクリックします。

テンプレートCSVファイルを編集し、必須属性に有効な値を指定する必要があります。様々なタイプのファイルを添付して、各ファイルに特定の説明を付けることができます。

これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。

ノート:

CSVファイルの移入および値の入力に関する問題を回避するには、「関連トピック」の項でExcelを使用してCSVファイルを開く場合の潜在的な問題に関するトピックを参照してください。

インポート・アクティビティの作成

Oracle Applications Cloudにデータをインポートするには、インポート・アクティビティを作成し、アクティビティへの入力としてCSVファイルを指定する必要があります。

インポート・アクティビティを作成するには、次の手順を実行します。

「ナビゲータ」で、「ツール」の下の「インポート管理」をクリックします。
「インポートの管理」ページで、「インポート・アクティビティの作成」をクリックします。
「インポート・アクティビティの作成: インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから「階層メンバー」を選択します。
「ファイル名」で、必要な.CSVファイルを参照してアップロードし、「次」をクリックします。
「インポート・アクティビティの作成: フィールドのマップ」ページで、必要に応じて属性マッピングを編集し、「次」をクリックします。

ノート:
「データの検証」をクリックして、マップされていない列のソース・ファイルのマッピングを検証し、データ形式の問題をチェックします。
「インポート・アクティビティの作成: レビューおよび発行」ページで、「発行」をクリックします。
ノート:
ツリー・フラット化サービスを手動で開始します。次のいずれかを実行します。
- ナビゲータから「スケジュール済プロセス」を選択します。「新規プロセスのスケジュール」ダイアログで、「パーティ階層生成」を検索し、「OK」をクリックします。
- 「設定および保守」から、取引先コミュニティ・パーティ階層生成タスクを検索して実行します。

インポート結果のレビュー

「インポートの管理」ページでインポートが成功したかどうかを確認します。このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。インポート・アクティビティのステータスをチェックするには:

「ナビゲータ」→「ツール」→「インポート管理」→「インポート・キュー」に移動します。
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
インポート・アクティビティの「ステータス」列をチェックします。ステータスが「完了」と表示された場合、インポートは成功です。インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。