世帯データのインポート

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

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

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

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

ノート:

最適化されたインポートでは、属性値をNULLに設定できません(オプション「大量インポートの有効化」が選択された標準インポート)。ただし、レコードを更新する際に、属性値をNOT NULLからNULLに変更できます。

開始する前に

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

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

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

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

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

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

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

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

次の表に、新規世帯レコードのインポートの必須属性、世帯レコードの更新の必須属性、属性に関する前提条件の設定タスクおよび世帯インポートの特定の検証(存在する場合)をリストします。

属性	摘要	データ型	データ長	前提条件の設定タスクやインポート検証	世帯レコードの作成	既存の世帯レコードの更新
SourceSystem	世帯のソース・システムを表すコード	String	30	「取引先コミュニティ・ソース・システムの管理」タスクを使用することにより、またはSource System Referenceインポート・オブジェクトを使用してソース・システム情報をOracle Applications Cloudにインポートすることにより、ソース・システムを識別するか、ソース・システムを構成します。	オプション	必須
SourceSystemReferenceValue	世帯のソース・システムの一意のIDを表す参照番号またはテキスト	String	240	「取引先コミュニティ・ソース・システムの管理」タスクを使用することにより、またはSource System Referenceインポート・オブジェクトを使用してソース・システム情報をOracle Applications Cloudにインポートすることにより、ソース・システムを識別するか、ソース・システムを構成します。	オプション	必須
PartyNumber	パーティの公開一意識別子。	String	30	世帯オブジェクトをエクスポートして、パーティ番号値を識別します。	オプション	必須
PartyId	パーティの公開一意識別子	Long	18	世帯オブジェクトをエクスポートして、パーティ番号値を識別します。	オプション	必須
Name	世帯の名前	String	360	「リソース・ディレクトリ」に移動して、リソースの組織名を識別します。	必須。	条件により必須
OwnerPartyId	世帯の所有者として指定されたリソースのパーティIDを示します	Long	18	なし。	条件により必須。	条件により必須

プロファイル・オプションORA_HZ_IMPORT_MULTI_ADDRESS_TYPEを使用して、住所タイプの入力方法を制御できます。デフォルトでは、このプロファイル・オプションは「はい」に設定されているため、アカウント、担当者および世帯オブジェクトの大量のインポート時に複数の住所タイプを入力できます。このプロファイル・オプションを使用不可にして、インポートのパフォーマンスを向上できます。このプロファイル・オプションを「いいえ」に設定すると、1つの住所タイプのみを入力できます。

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

ソースCSVファイルの作成

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

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

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

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

ノート:

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

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

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

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

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

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

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