住所データのインポート
インポート機能を使用して、住所レコードを作成、更新または削除できます。
次のステップを使用して住所レコードをインポートできます:
-
ソース・データを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ファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。
次の表に、住所レコードに必要な属性、前提条件の設定タスク、および特定の検証(ある場合)を示します:
|
属性 |
摘要 |
前提条件の設定タスクやインポート検証 |
住所レコードの作成 |
既存の住所レコードの更新 |
|---|---|---|---|---|
|
PartyId |
住所が所属するパーティ(アカウント、担当者、世帯、法的エンティティ)の内部ID |
アカウント、担当者などの関連パーティ・オブジェクトをエクスポートして、パーティID値を識別します。 |
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
|
PartyNumber |
住所が所属するパーティ(アカウント、担当者、世帯、法的エンティティ)のソース・システムを表すコード。 |
アカウント、担当者などの関連パーティ・オブジェクトをエクスポートして、パーティID値を識別します。 |
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
|
PartySourceSystem |
住所が所属するパーティ(アカウント、担当者、世帯、法的エンティティ)のソース・システムを表すコード。 |
以前のバッチでパーティをインポートしたときに使用されたソース・システム・コードを識別したり、この住所と同じバッチでパーティをインポートするときに使用するソース・システム・コードを識別します |
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
|
PartySourceSystemReferenceValue |
住所の所属先であるパーティ(アカウント、担当者、世帯、法的エンティティ)のソース・システムの一意のIDを表す参照番号またはテキスト。 |
以前のバッチでパーティをインポートしたときに使用されたソース・システムの参照値を識別したり、この住所と同じバッチでパーティをインポートするときに使用するソース・システム参照を識別します。 |
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
|
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ファイルの準備が完了したら、住所情報をインポートするインポート・アクティビティを作成します。 インポート・アクティビティを作成するには:
-
に移動します。
-
「インポートの管理」ページで、「インポート・アクティビティの作成」をクリックします。
-
「インポート・アクティビティの作成: インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから「住所」を選択します。
-
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
-
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。 必要に応じてマッピングをレビューおよび編集します。
-
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
-
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
-
に移動します。
-
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。