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

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

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

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

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

開始する前に

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

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

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

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

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

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

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

属性	摘要	前提条件の設定タスクやインポート検証	ハブ・ソース・システム参照レコードの作成	既存のハブ・ソース・システム参照レコードの更新
OwnerEntityId	OSC表に存在するレコードの内部識別子または主キー	指定する場合は、OwnerEntityObject用に指定された表名からアクティブな主キー値を指定する必要があります。	OwnerEntityObjectに用意されているOSC表からデータをエクスポートする場合は、主キー・データをこの属性に指定します。このデータを指定できない場合は、ExistingSourceSystemとExistingSourceSystemReferenceValueの組合せに対して有効な値を指定します。	不要
StartDateActive	ハブ・ソース・システム参照が有効になる日付。	指定する場合、この日付は終了日より前である必要があります。日付を指定しない場合、デフォルトで現在の日付になります。	オプション	オプション
EndDateActive	ハブ・ソース・システム参照が有効でなくなる日付。	指定する場合、この日付は開始日より後である必要があります。日付を指定しない場合、このデフォルトは12/31/4712になります。	オプション	オプション
SourceSystem	オリジナル・ソース・システム名を指定します。	これは、HZ_ORIG_SYSTEMS_B表にステータス「A」で存在する必要があります。	有効な値を指定してください。	条件付きで必要。次のいずれかを指定します。 SourceSystemReferenceId SourceSystem、SourceSystemReferenceおよびOwnerEntityObjectの組合せ
SourceSystemReferenceValue	オリジナル・ソース・システムのオリジナル・ソース・システム参照テキストまたは番号を指定します。	検証なし	有効な値を指定してください。	条件付きで必要。次のいずれかを指定します。 SourceSystemReferenceId SourceSystem、SourceSystemReferenceおよびOwnerEntityObjectの組合せ
OwnerEntityObject	レコードが存在するOSC表を指定します。	これは、ORA_ZCH_OWNER_ENTITY_OBJECT参照タイプの有効な参照コードである必要があります。	有効な値を指定してください。	条件付きで必要。次のいずれかを指定します。 SourceSystemReferenceId SourceSystem、SourceSystemReferenceおよびOwnerEntityObjectの組合せ
SourceSystemReferenceId	ソース・システム参照識別子を指定します。これは主キーです。	指定する場合、これは表HZ_ORIG_SYS_REFERENCESのアクティブな主キー値である必要があります。	不要	条件付きで必要。次のいずれかを指定します。 SourceSystemReferenceId SourceSystem、SourceSystemReferenceおよびOwnerEntityObjectの組合せ
ExistingSourceSystem	Oracle Engagement Cloudに存在するデータのオリジナル・ソース・システム名を指定します。	これは、HZ_ORIG_SYSTEMS_B表にステータス「A」で存在する必要があります。	OwnerEntityIDを指定できない場合は、ExistingSourceSystemとExistingSourceSystemReferenceValueの値の組合せを指定します。この値を取得するには、ソース・システム参照リポジトリをエクスポートします。	不要
ExistingSourceSystemReferenceValue	Oracle Engagement Cloudに存在するデータのオリジナル・ソース・システム参照を指定します。	検証なし	OwnerEntityIDを指定できない場合は、ExistingSourceSystemとExistingSourceSystemReferenceValueの値の組合せを指定します。この値を取得するには、ソース・システム参照リポジトリをエクスポートします。	不要

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

ノート:

参照タイプORA_ZCH_OWNER_ENTITY_OBJECTが使用可能になりました。 CSVインポート・ファイルに入力データを指定する際に、基礎となる物理表を指定せずにこの参照を使用できるようになりました。ファイル・ベース・データ・インポートから最適化またはインポート管理に移行すると、基礎となる物理表は外部パーティに対して保護されます。

ソースCSVファイルの作成

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

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

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

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

ノート:

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

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

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

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

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

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

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