ソース・システム参照データのインポート

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

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

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

ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
前提条件の設定が実行されていることを確認します(該当する場合)。
レコードを一意に識別するためのオプションを理解します。
子レコードをインポートする前に、親レコードが存在することを確認します。
正常にインポートするためにCSVファイルに必要なターゲット・オブジェクト属性を識別します。

開始する前に

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

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

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

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

オブジェクト・レコードを一意に識別するための推奨オプションは、次のとおりです。

内部ID: Oracle Applications Cloudにすでに存在するレコードを識別する場合は、レコードの内部IDを使用できます。属性名に「id」が含まれるシステム生成の一意識別子属性は、通常、内部IDです。このオプションは、ソース・システム参照を更新する場合にのみ使用します。レコードの内部IDは、Oracle Applications Cloudオブジェクト・データをエクスポートするか、トランザクション・データベース問合せを実行することで確認できます。通常、内部IDを使用すると、パフォーマンスが向上し、インポート期間が短縮されます。ソース・システム参照オブジェクトの場合、属性はSourceSystemReferenceIdおよびPartyIdです。
公開一意識別子: 新しいレコードを作成する場合は、わかりやすい公開一意識別子を指定できます(属性は番号で示され、通常はビジネス・オブジェクトのUIに表示されます)。以前に番号属性を指定したレコード、または番号属性がオブジェクトのUIに表示されるレコードを更新する場合は、番号属性を使用してレコードを識別できます。ソース・システム参照オブジェクトの場合、属性はPartyNumberです。

ソース・システム参照オブジェクトの必須属性および検証

Oracle Applications Cloudにデータを正常にインポートするには、CSVファイルに必須属性が含まれている必要があります。属性に有効な値が指定されていることを確認します。次の表に、新規ソース・システム参照レコードのインポートに必要な属性、ソース・システム参照レコードの更新に必要な属性、属性の前提条件設定タスク、およびソース・システム参照インポートの特定の検証(ある場合)を示します:

属性	説明	データ型	データ長	前提条件の設定タスクやインポート検証	ソース・システム参照レコードの作成	既存のソース・システム参照レコードの更新
SourceSystemReferenceId	ソース・システム参照識別子。これは主キーです。	数値	18	検証なし	不要	既存のソース・システム参照をエクスポートできる場合は、この主キーを指定して、更新するレコードを識別します。
SourceSystem	元のソース・システム名	Varchar	30	ステータスがAのHZ_ORIG_SYSTEMS_Bである必要があります。	有効な値を指定してください。	不要
SourceSystemReferenceValue	元のソース・システムの識別子。	Varchar	255	検証なし	有効な値を指定してください。	不要
ステータス	ACTIVEまたはINACTIVEのいずれかを示します	Varchar	1	検証なし	不要	不要
StartDate	ソース・システム内のソース・システム参照の開始日。	Date		検証なし	値を指定しない場合、デフォルトで現在の日付になります。	不要
EndDate	ソース・システムのソース・システム参照の終了日。	Date		検証なし	値を指定しない場合、デフォルトで12/31/4712に設定されます。	不要
PartyId	ソース・システム参照が関連付けられているパーティ識別子	数値	18	検証なし	次のいずれかを指定します : PartyId パーティ番号パーティ・ソース・システムとパーティ・ソース・システム参照値の組合せ	不要
PartyNumber	ソース・システム参照が関連付けられているパーティのPUID	Varchar	30	検証なし	次のいずれかを指定します : PartyId パーティ番号パーティ・ソース・システムとパーティ・ソース・システム参照値の組合せ	不要
パーティ・ソース・システム	パーティの元のソース・システムを指定	Varchar	30	検証なし	次のいずれかを指定します : PartyId パーティ番号パーティ・ソース・システムとパーティ・ソース・システム参照値の組合せ	不要
パーティ・ソース・システム参照値	元のソース・システムでのパーティのソース・システム参照を指定	Varchar	255	検証なし	次のいずれかを指定します : PartyId パーティ番号パーティ・ソース・システムとパーティ・ソース・システム参照値の組合せ	不要

インポート管理フローの「インポート・オブジェクトの管理」ページで、ソース・システム参照オブジェクトとそのすべての子オブジェクトおよび属性を表示できます。タイプ、長さ、説明などの属性情報をこのページで確認できます。

ノート: SourceSystemReferenceValueフィールドを直接更新するには、SourceSystemReferenceIdをレコード識別子として使用する必要があります。

ソースCSVファイルの作成

Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。

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

「ナビゲータ」→「ツール」→「インポート管理」→「インポート・オブジェクト」に移動します。
表内の「ソース・システム参照」オブジェクトを選択し、「ダウンロード」をクリックします。

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

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

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

CSVファイルの準備が完了したら、インポート・アクティビティを作成して情報をインポートします。インポート・アクティビティを作成するには:

「ナビゲータ」→「ツール」→「インポート管理」→「インポート・キュー」に移動します。
「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストからソース・システム参照を選択します。
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。必要に応じてマッピングをレビューおよび編集します。
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。「次」をクリックします。
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。

次のステップを使用して、ソース・システム参照オブジェクトのオリジン・システムおよびオリジン・システム参照を非アクティブ化できます:

属性SourceSystem、SourceSystemReferenceValueおよびSourceSystemReferenceIdの値を含むソースCSVファイルを作成します。これらの属性の値は、エクスポート管理を使用してソース・システム参照オブジェクト・レコードをエクスポートすることで検索できます。
オブジェクト・ソース・システムおよびインポート・モード・レコードの削除を使用して、インポート・アクティビティを作成します。
必要に応じて、「フィールドのマップ」ページで属性をマップし、インポート・アクティビティを発行します。

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

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

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