住所目的データのインポート
インポート機能を使用して、住所目的レコードを作成または更新できます。
次のステップを使用して、住所目的レコードをインポートできます:
-
ソース・データをOracle Applications Cloudオブジェクト属性にマップします。 これにより、インポート・プロセスは各情報ビットの挿入場所を把握できます。
-
インポートする住所目的データを含むソースCSVファイルを作成します。
-
インポート・アクティビティを開始します。
-
インポートが正常に実行されたかどうかを確認します。
ソース・データのターゲット・オブジェクト属性へのマップ方法
ターゲットのOracle Applications Cloudオブジェクト属性にマップされているソース・データを含むCSVファイルから、アドレス目的データをOracle Applications Cloudにインポートします。
ソース・データ・ファイルを作成する前に、次のことを実行する必要があります。
-
ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。 ソース・ファイルの各列を、住所目的インポート・オブジェクトの属性と照合します。
-
オブジェクトのインポートに必要な属性の理解など、すべての前提条件ステップを終了します。
-
レコードを一意に識別する方法を理解します。
-
正常にインポートするには、CSVファイルに必要なターゲット・オブジェクト属性をチェックします。
-
冗長データを回避するために、インポート中に重複する住所目的を挿入しないでください。
少数のレコードのみをインポートする場合は、すべての住所目的属性に対して単一のCSVファイルを作成できます。 ただし、大量のレコードをインポートする場合は、住所目的の子オブジェクトごとに1つずつ、複数のCSVファイルを作成できます。 子オブジェクトのCSVファイルをインポートしようとする前に、住所目的オブジェクトのCSVファイルを正常にインポートしておく必要があります。 これらの子オブジェクトをそれぞれインポートする方法については、別のヘルプ・トピックで説明しています。
開始する前に
インポートを開始する前に、いくつかの基本チェックを行う必要があります。 たとえば、次のことを確認してください。
-
ソース・データの各属性のインポートの前提条件がすべて完了している。
-
子レコードをインポートする前に、すべての親レコードを配置しておく。
レコードに対する一意の識別子の選択
すべてのレコードはアプリケーション内で一意である必要があります。 次のいずれかを使用してレコードを識別できます。
-
公開一意識別子: レコードを作成する場合、理解しやすい公開一意識別子を指定できます。 これらは通常、数値で示され、ビジネス・オブジェクトのUIに表示されます。 PUID属性の名前は通常、<object>番号です。 番号属性を持つレコードを更新する場合は、番号属性を使用してレコードを識別します。 公開一意識別子の詳細は、「関連項目」の「レコードのインポートに代替キーを使用する方法」のトピックを参照してください。
-
ソース・システムとソース・システム参照: ソース・システムは外部システムの識別子であり、ソース・システム参照は外部システム内で一意の識別子です。 新しい住所目的をインポートする場合、またはソース・システム参照データを持つ住所目的レコードを更新する場合は、ソース・システムおよびソース・システム参照値を指定します。
住所目的オブジェクトの必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、.CSVファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。
この表は、住所目的レコード、前提条件の設定タスクおよび特定の検証(ある場合)の必須属性を示しています:
|
属性 |
摘要 |
前提条件の設定タスクやインポート検証 |
住所目的レコードの作成 |
既存の住所目的レコードの更新 |
|---|---|---|---|---|
|
SiteSourceSystem |
住所目的が関連付けられている住所レコードの外部ソース・システムの名前。 |
すでにインポートされている有効なSiteSourceSystemとSiteSourceSystemReferenceValueの組合せ |
AddressId、アドレス番号、またはSiteSourceSystemとSiteSourceSystemReferenceValueの組合せのいずれかが必要です。 |
不要 |
|
SiteSourceSystemReferenceValue |
住所目的が関連付けられている住所レコードのソース・システムの識別子。 |
すでにインポートされている有効なSiteSourceSystemとSiteSourceSystemReferenceValueの組合せ |
AddressId、アドレス番号、またはSiteSourceSystemとSiteSourceSystemReferenceValueの組合せのいずれかが必要です。 |
不要 |
|
PrimaryPerType |
これは、サイト使用タイプの主キーとしてインポートされるレコードを指定します。 指定したサイト使用タイプを主キーとして設定するレコードにYを指定します。 |
Y、NまたはNULL YまたはNを入力します。 または、値を入力しないでください。 デフォルト値はNです。 |
不要 |
不要 |
|
AddressPurposeId |
住所目的レコードの主キー |
検証なし |
不要 |
条件付きで必要 住所目的レコードを識別するには、次のいずれかを使用します:
|
|
使途 |
住所目的を識別するSHIP_TOやBILL_TOなどのサイト・コード |
値は、サイト使用コードの参照値に対して検証されます。 |
必須 |
不要 |
|
StartDate |
住所目的の開始日 |
日付は住所開始日より前にはできません。 |
不要 |
不要 |
|
EndDate |
住所目的の終了日 |
この日付は、住所終了日より後にはできません。 |
不要 |
不要 |
|
AddressId |
住所レコードの主キー |
検証なし |
AddressId、アドレス番号、またはSiteSourceSystemとSiteSourceSystemReferenceValueの組合せのいずれかが必要です。 |
不要 |
|
AddressNumber |
住所の公開一意識別子 |
有効な住所番号(パーティ・サイト番号) |
AddressId、アドレス番号、またはSiteSourceSystemとSiteSourceSystemReferenceValueの組合せのいずれかが必要です。 |
不要 |
|
SourceSystem |
アカウント、担当者または世帯に関連付けられている住所の目的の外部ソース・システムの名前。 |
ソース・システムが存在する必要があります。 ソース・システムは、ソース・システムの管理タスクから管理できます。 |
オプション データ・ソース・データがサード・パーティまたは外部システムであり、以前にインポートしたレコードの更新を同じシステムからインポートする場合は、元のソース・システムおよびソース・システム参照値を指定します。 |
条件付きで必要 住所目的レコードを識別するには、次のいずれかを使用します:
|
|
SourceSystemReferenceValue |
住所目的レコードの元のソース・システムの識別子を指定します。 |
ソース・システムとソース・システム参照値の組合せは一意である必要があります。 |
オプション データ・ソースがサード・パーティまたは外部システムであり、以前にインポートしたレコードに対する更新を同じシステムからインポートする場合は、元のソース・システムおよびソース・システム参照値を指定します。 |
条件付きで必要 住所目的レコードを識別するには、次のいずれかを使用します:
|
住所目的オブジェクトのすべての属性を表示するには、に移動します。 このページには、タイプ、長さ、説明などの属性情報も表示されます。
ソースCSVファイルの作成
Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。
「インポート・オブジェクト」UIページで使用可能なテンプレートを使用して、ソースCSVファイルを作成できます。 テンプレートをダウンロードするには:
-
に移動します。
-
表の住所目的オブジェクトを選択し、ダウンロードをクリックします。
これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。
CSVファイルの移入および値の入力に関する問題を回避するには、「関連トピック」の項でExcelを使用してCSVファイルを開く場合の潜在的な問題に関するトピックを参照してください。
インポート・アクティビティの作成
CSVファイルの準備が完了したら、インポート・アクティビティを作成して住所目的情報をインポートします。 インポート・アクティビティを作成するには:
-
に移動します。
-
「インポートの管理」ページで、「インポート・アクティビティの作成」をクリックします。
-
「インポート・アクティビティの作成: インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから「住所目的」を選択します。
-
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
-
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。 必要に応じてマッピングをレビューおよび編集します。
-
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
-
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
-
に移動します。
-
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。