住所データのインポート

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

ターゲットのOracle Applications Cloudオブジェクト属性にマップされているソース・データを含むCSVファイルから、アドレス・データをOracle Applications Cloudにインポートします。

ソース・データ・ファイルを作成する前に、次のことを実行する必要があります。

ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。ソース・ファイルの各列をアドレス・インポート・オブジェクトの属性と照合します。
オブジェクトのインポートに必要な属性の理解など、すべての前提条件ステップを終了します。
レコードを一意に識別する方法を理解します。
正常にインポートするには、CSVファイルに必要なターゲット・オブジェクト属性をチェックします。
重複データを避けるために、重複した住所をインポート中に挿入しないようにします。

少数のレコードのみをインポートする場合は、すべての住所属性に対して単一のCSVファイルを作成できます。ただし、大量のレコードをインポートする場合は、住所の子オブジェクトごとに1つずつ、複数のCSVファイルを作成することもできます。子オブジェクトのCSVファイルをインポートしようとする前に、アドレス・オブジェクトのCSVファイルを正常にインポートしておく必要があります。これらの子オブジェクトをそれぞれインポートする方法については、別のヘルプ・トピックで説明しています。

開始する前に

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

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

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

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

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

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

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

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

属性	摘要	前提条件の設定タスクやインポート検証	住所レコードの作成	既存の住所レコードの更新
PartyId	住所が所属するパーティ(アカウント、担当者、世帯、法的エンティティ)の内部ID	アカウント、担当者などの関連パーティ・オブジェクトをエクスポートして、パーティID値を識別します。	条件付きで必要既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference (ソース・システム・コードおよびソース・システム参照値)。パーティ番号(組織プロファイルの公開一意識別子)。これは、住所のPARTY_SITE_NUMBERです	条件付きで必要既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference (ソース・システム・コードおよびソース・システム参照値)。パーティ番号(組織プロファイルの公開一意識別子)。これは、住所のPARTY_SITE_NUMBERです
PartyNumber	住所が所属するパーティ(アカウント、担当者、世帯、法的エンティティ)のソース・システムを表すコード。	アカウント、担当者などの関連パーティ・オブジェクトをエクスポートして、パーティID値を識別します。	条件付きで必要既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference (ソース・システム・コードおよびソース・システム参照値)。パーティ番号(組織プロファイルの公開一意識別子)。これは、住所のPARTY_SITE_NUMBERです	条件付きで必要既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference (ソース・システム・コードおよびソース・システム参照値)。パーティ番号(組織プロファイルの公開一意識別子)。これは、住所のPARTY_SITE_NUMBERです
PartySourceSystem	住所が所属するパーティ(アカウント、担当者、世帯、法的エンティティ)のソース・システムを表すコード。	以前のバッチでパーティをインポートしたときに使用されたソース・システム・コードを識別したり、この住所と同じバッチでパーティをインポートするときに使用するソース・システム・コードを識別します	条件付きで必要既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference (ソース・システム・コードおよびソース・システム参照値)。パーティ番号(組織プロファイルの公開一意識別子)。これは、住所のPARTY_SITE_NUMBERです	条件付きで必要既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference (ソース・システム・コードおよびソース・システム参照値)。パーティ番号(組織プロファイルの公開一意識別子)。これは、住所のPARTY_SITE_NUMBERです
PartySourceSystemReferenceValue	住所の所属先であるパーティ(アカウント、担当者、世帯、法的エンティティ)のソース・システムの一意のIDを表す参照番号またはテキスト。	以前のバッチでパーティをインポートしたときに使用されたソース・システムの参照値を識別したり、この住所と同じバッチでパーティをインポートするときに使用するソース・システム参照を識別します。	条件付きで必要既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (Sales and Fusion Serviceの内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference (ソース・システム・コードおよびソース・システム参照値)。パーティ番号(組織プロファイルの公開一意識別子)。これは、住所のPARTY_SITE_NUMBERです	条件付きで必要既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (Sales and Fusion Serviceの内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference (ソース・システム・コードおよびソース・システム参照値)。パーティ番号(組織プロファイルの公開一意識別子)。これは、住所のPARTY_SITE_NUMBERです
PrimaryFlag	親パーティ・レコードのプライマリ住所を識別します。	1つの子レコードのみをプライマリにできます。	オプション	オプションプライマリを設定するにはYを、既存のプライマリ・レコードをリセットするにはNを渡します。
ステータス	住所レコードの現在のステータスを示します。	不要デフォルトはA (アクティブ)です	不要デフォルトはA (アクティブ)です	オプション Aを渡してステータスをアクティブに設定し、Iを渡してステータスを非アクティブに設定します。
AddressId	主キーとしての住所レコードの一意の識別子。	検証なし	不要	オプション AddressIdまたはAddressNumberのいずれかを渡すことができます。
国	郵送先住所の国コード・コンポーネント。	有効な国コードを識別します。	必須	不要
LocationId	宛先表に含まれる既存の事業所レコードに対する一意のID。	事業所オブジェクトをエクスポートして、既存の事業所のLOCATION_IDを識別します。	オプション	オプション
StartDateActive	住所が有効になる日付。	検証なし	これは住所のPUIDです。値が渡されると、インポートされます。それ以外の場合は、自動生成されます。	住所レコードは、住所番号を渡すことで更新できます。
AddressNumber	住所の作成時に内部的に生成される住所内部一意識別子	なし	これは住所のPUIDです。値が渡されると、インポートされます。それ以外の場合は、自動生成されます。	住所レコードは、住所番号を渡すことで更新できます。
SourceSystem	住所が関連付けられているアカウント、担当者または世帯の外部ソース・システムの名前。	ソース・システムが存在する必要があります。ソース・システムは、ソース・システムの管理タスクから管理できます。	オプションデータのソースがサード・パーティまたは外部システムである場合で、かつ、同じシステムから以前にインポートしたレコードに更新をインポートする場合は、元のソース・システムの値とソース・システム参照値を指定します。	不要
SourceSystemReferenceValue	元のソース・システムの識別子を指定	ソース・システムとソース・システム参照値の組合せは一意である必要があります。	オプションデータのソースがサード・パーティまたは外部システムである場合で、かつ、同じシステムから以前にインポートしたレコードに更新をインポートする場合は、元のソース・システムの値とソース・システム参照値を指定します。	不要
DoNotValidateFlag	特定の事業所が住所検証に適格でないことを示すオプション	検証なし値はY、Nまたは空白です。	オプション値を渡さない場合は、いいえに設定します。	オプション
DunsNumberC	Dun and Bradstreetによってビジネス・エンティティに割り当てられた一意の9桁の識別番号	検証なし	不要	不要
PartySiteName	サイトのユーザー定義名	検証なし	不要	不要

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

ソースCSVファイルの作成

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

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

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

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

インポートCSVファイルに郵便番号および国コードの値を指定しても、「都道府県」、「郡」または「市区町村」フィールドには自動的に移入されません。これらのフィールドの値は、インポート・ファイルで個別に指定する必要があります。

ノート:

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

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

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

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

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

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

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

ノート:

データを正常にインポートした後、次のスケジュール済プロセスを実行する必要があります:

マスター地理に対する住所の地理の検証: このジョブは、マスター地理データに対して住所を検証し、地理命名参照を生成するのに役立ちます。「マスター地理に対する住所地理の検証」後処理ジョブの詳細は、Understanding Scheduled Processesガイドの「マスター地理に対する住所地理の検証」の項を参照してください。
事業所の緯度および経度情報の移入: このジョブは、新しく作成または更新された住所を定期的に選択してジオコードするのに役立ちます。事業所の緯度および経度情報の移入後処理ジョブの詳細は、Understanding Scheduled Processesガイドの事業所の緯度および経度情報の移入に関する項を参照してください。