関係データのインポート

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

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

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

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

開始する前に

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

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

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

すべてのレコードはアプリケーション内で一意である必要があります。次のいずれかを使用してレコードを識別できます。

公開一意識別子: レコードを作成する場合、理解しやすい公開一意識別子を指定できます。これらは通常、数値で示され、ビジネス・オブジェクトのUIに表示されます。 PUID属性の名前は通常、<object>番号です。番号属性を持つレコードを更新する場合は、番号属性を使用してレコードを識別します。公開一意識別子の詳細は、「関連項目」の「レコードのインポートに代替キーを使用する方法」のトピックを参照してください。
ソース・システムとソース・システム参照: ソース・システムは外部システムの識別子であり、ソース・システム参照は外部システム内で一意の識別子です。新規関係をインポートする場合、またはソース・システム参照データを持つ関係を更新する場合は、ソース・システムおよびソース・システム参照値を指定します。

関係オブジェクトの必須属性および検証

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

次の表に、関係レコード、前提条件の設定タスクおよび特定の検証(ある場合)に必要な属性を示します:

属性	摘要	前提条件の設定タスクやインポート検証	関係レコードの作成	既存の関係レコードの更新
RelationshipRecId	宛先表の既存の関係レコードの一意のID。	なし	値を指定しないでください。	条件付きで必要 RelationshipRecId、またはRelationshipSourceSystemとRelationshipSourceSystemReferenceValueの組合せが必要です。
SubjectPartyId	この関係のサブジェクトの主キー識別子。	パーティが存在する必要があります。	SubjectPartyId、SubjectPartyNumber、およびSubjectSourceSystemとSubjectSourceSystemReferenceValueの組合せのいずれかを使用して、関係のサブジェクト・パーティを識別します。	オプション SubjectPartyId、SubjectPartyNumber、およびSubjectSourceSystemとSubjectSourceSystemReferenceValueの組合せのいずれかを使用して、関係のサブジェクト・パーティを識別します。
RelationshipType	関係タイプ名。たとえば、CUSTOMER_SUPPLIERです。有効な関係タイプのリストは、参照HZ_RELATIONSHIP_TYPEで定義されます。宛先表の既存の顧客パーティ・レコードの一意のID。	パーティが存在する必要があります。	必須	不要
RelationshipCode	これがフォワード関係コードかバック・ワード関係コードかを示します。	有効な関係コードのリストは、参照PARTY_RELATIONS_TYPEで定義されます。	必須	不要
StartDate	関係が作成された日付。	これは有効な日付である必要があります。	オプション現在の日付にデフォルト設定	不要
EndDate	関係が終了する日付。	これは有効な日付である必要があります。	オプション	オプション
SubjectType	関係タイプのサブジェクト・タイプ。	これは有効なパーティ・タイプである必要があります。	オプション	不要
ObjectType	関係タイプのオブジェクト・タイプ。	これは有効なパーティ・タイプである必要があります。	オプション	不要
ObjectPartyId	この関係にあるオブジェクトの主キー識別子。	パーティが存在する必要があります。	ObjectPartyId、ObjectPartyNumber、およびObjectSourceSystemとObjectSourceSystemReferenceValueの組合せのいずれかを使用して、関係のオブジェクト・パーティを識別します。	オプション ObjectPartyId、ObjectPartyNumber、およびObjectSourceSystemとObjectSourceSystemReferenceValueの組合せのいずれかを使用して、関係のオブジェクト・パーティを識別します。
SubjectPartyNumber	関係の件名の一意の識別番号	検証なし	SubjectPartyIdまたはSubjectPartyNumberのいずれかが必要です。	SubjectPartyIdまたはSubjectPartyNumber、またはSubjectSourceSystemとSubjectSourceSystemReferenceValueの組合せが必要です。
ObjectPartyNumber	関係のオブジェクトの一意の識別番号	パーティが存在する必要があります。	ObjectPartyId、ObjectPartyNumber、およびObjectSourceSystemとObjectSourceSystemReferenceValueの組合せのいずれかを使用して、関係のオブジェクト・パーティを識別します。	オプション ObjectPartyId、ObjectPartyNumber、およびObjectSourceSystemとObjectSourceSystemReferenceValueの組合せのいずれかを使用して、関係のオブジェクト・パーティを識別します。
SubjectSourceSystem	関係の件名に対する元のシステムID	ソース・システムが存在する必要があります。ソース・システムは、ソース・システムの管理タスクから管理できます。	条件付きで必要	条件付きで必要
SubjectSourceSystemReferenceValue	関係の件名に対するオリジナル・システム参照	検証なし	条件付きで必要データのソースがサード・パーティまたは外部システムである場合で、かつ、同じシステムから以前にインポートしたレコードに更新をインポートする場合は、元のソース・システムの値とソース・システム参照値を指定します。	条件付きで必要
ObjectSourceSystem	関係のオブジェクトの元のシステムID	検証なし	条件付きで必要	条件付きで必要
ObjectSourceSystemReferenceValue	関係のオブジェクトのオリジナル・システム参照	検証なし	条件付きで必要	条件付きで必要
RelationshipSourceSystem	この関係の元のシステム	パーティが存在する必要があります。	オプションデータのソースがサード・パーティまたは外部システムである場合で、かつ、同じシステムから以前にインポートしたレコードに更新をインポートする場合は、元のソース・システムの値とソース・システム参照値を指定します。	条件付きで必要 RelationshipRecId、またはRelationshipSourceSystemとRelationshipSourceSystemReferenceValueの組合せが必要です。
RelationshipSourceSystemReferenceValue	この関係のオリジナル・システム参照	ソース・システムの一意の値である必要があります。	オプションデータのソースがサード・パーティまたは外部システムである場合で、かつ、同じシステムから以前にインポートしたレコードに更新をインポートする場合は、元のソース・システムの値とソース・システム参照値を指定します。	条件付きで必要 RelationshipRecId、またはRelationshipSourceSystemとRelationshipSourceSystemReferenceValueの組合せが必要です。

「ナビゲータ」>「ツール」>「インポート管理」>「オブジェクトのインポート」に移動して、関係オブジェクトのすべての属性を表示します。このページには、タイプ、長さ、説明などの属性情報も表示されます。

ソースCSVファイルの作成

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

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

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

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

ノート:

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

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

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

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

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

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

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