氏名データのインポート
このトピックを使用して、追加名データをOracle Applications Cloudにインポートします。 インポート機能を使用して、追加名レコードを作成、更新または削除できます。
追加名レコードをインポートするには、次のタスクを実行します:
-
ソース・データをOracle Applications Cloudオブジェクト属性にマップします。
-
インポート用のソース・カンマ区切り値(CSV)ファイルを作成します。
-
インポート・アクティビティを作成します。
-
インポート結果をレビューします。
ソース・データのオブジェクト属性へのマップ方法
追加名データをOracle Applications Cloudにインポートするには、.csvファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。
データ・インポート用のCSVファイルを作成する前に、次の手順を実行する必要があります。
-
ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
-
前提条件の設定が実行されていることを確認します(該当する場合)。
-
レコードを一意に識別するためのオプションを理解します。
-
子レコードをインポートする前に、親レコードが存在することを確認します。
-
正常にインポートするためにCSVファイルに必要なターゲット・オブジェクト属性を識別します。
開始する前に
移入する前に、アプリケーションの一部の属性に対して特定のオプションを設定する必要があります。 子レコードをインポートする場合は、その親レコードがデータベースに存在することを確認します。
レコードに対する一意の識別子の選択
Oracle Applications Cloudにデータをインポートするには、インポート・プロセスがレコードを一意に識別するための特定の属性がCSVファイルに含まれている必要があります。 ファイル・インポート・プロセスは、属性値を使用して、ソース・データをOracle Applications Cloudのターゲット・オブジェクト属性に自動的にマップします。
オブジェクト・レコードを一意に識別するための優先オプションは、内部IDを使用することです。 Oracle Applications Cloudにすでに存在するレコードを識別する場合は、レコードの内部IDを使用できます。属性名に"ID"を含むシステム生成の一意の識別子属性は、通常、内部IDです。 レコードの内部IDは、Oracle Applications Cloudオブジェクト・データをエクスポートするか、トランザクション・データベース問合せを実行することで確認できます。 通常、内部IDを使用すると、パフォーマンスが向上し、インポート期間が短縮されます。 追加名オブジェクトの場合、属性はNameIDおよびRegistryIDです。
必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、CSVファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。 次の表に、新しい追加名レコードのインポートに必要な属性、追加名レコードの更新に必要な属性、属性の前提条件設定タスク、および追加名インポートの特定の検証(ある場合)を示します:
属性 |
摘要 |
前提条件の設定タスクやインポート検証 |
追加名レコードの作成 |
既存の追加名レコードの更新 |
---|---|---|---|---|
NameId |
主キーとしての住所レコードの一意識別子 |
検証なし |
不要 |
オプション NameId、またはソース・システムとソース・システム参照の組合せのいずれかを渡すことができます。 |
StatusFlag |
追加名のステータス |
作成時のデフォルトはYです。 |
不要 |
既存のアクティブな追加名レコードを非アクティブ化するには、値をNとして指定します。 |
NameType |
追加名タイプ |
これは有効な名前タイプである必要があります。 名前タイプは名前タイプの管理で管理できます。 |
必須 |
主キーを指定しない場合は、既存の追加の名前タイプを指定します。 |
PartyNumber |
追加名が関連付けられているパーティ・レコードの公開一意識別子。 |
パーティ番号が存在する必要があります。 |
条件付きで必要 既存のパーティを識別するための参照情報を指定します。 この参照情報として次のものが可能です。
|
不要 |
PartySourceSystem |
追加名が属するパーティ(アカウント、担当者、世帯または法的エンティティ)のソース・システムを表すコード。 |
前のバッチでパーティをインポートしたときに使用されたソース・システム・コードを識別するか、この追加名と同じバッチでパーティをインポートするときに使用するソース・システム・コードを識別します。 |
条件付きで必要 次のいずれかを指定します :
|
不要 |
PartySourceSystemReferenceValue |
追加名が属するパーティ(アカウント、担当者、世帯または法的エンティティ)のソース・システムの一意のIDを表す参照番号またはテキスト。 |
前のバッチでパーティをインポートしたときに使用されたソース・システムの参照値を識別するか、この追加名と同じバッチでパーティをインポートするときに使用するソース・システム参照を識別します。 |
条件付きで必要 次のいずれかを指定します :
|
不要 |
PartyId |
追加名が関連付けられているパーティ・レコードの主キーとしての一意識別子。 |
アカウント、担当者などの関連パーティ・オブジェクトをエクスポートして、パーティID値を識別します。 |
条件付きで必要 次のいずれかを指定します :
|
不要 |
SourceSystem |
住所が関連付けられているアカウント、担当者または世帯の外部ソース・システムの名前。 |
ソース・システムが存在する必要があります。 ソース・システムは、ソース・システムの管理タスクから管理できます。 |
オプション データのソースがサード・パーティまたは外部システムである場合で、かつ、同じシステムから以前にインポートしたレコードに更新をインポートする場合は、元のソース・システムの値とソース・システム参照値を指定します。 |
不要 |
SourceSystemReferenceValue |
元のソース・システムの識別子を指定 |
検証なし |
有効な値を指定してください。 |
不要 |
インポート管理フローの「インポート・オブジェクトの管理」ページで、Additional Nameオブジェクトおよび属性を表示できます。 タイプ、長さ、説明などの属性情報をこのページで確認できます。
ソースCSVファイルの作成
CSVファイルは、ファイルベースのデータ・インポート・プロセスへの入力として提供されます。 CSVファイルには、Oracle Applications Cloudにインポートするデータを入力する必要があります。
CSVファイルは、独自に作成するか、既存のマッピングで使用可能なテンプレートを使用できます。 テンプレートをダウンロードするには、次の手順を実行します。
-
「ナビゲータ」で、「ツール」の下の「インポート管理」をクリックします。
-
「Import Objectsをクリック」タブ: 「インポート・オブジェクト詳細」ページを開きます。
-
「インポート・オブジェクト詳細」ページに関心のあるオブジェクトを選択し、そのオブジェクト名の横にあるダウンロード・アイコンをクリックします。
-
デスクトップ上の任意の場所にテンプレートCSVを保存します。
テンプレートCSVファイルを編集し、必須属性に有効な値を指定する必要があります。 様々なタイプのファイルを添付して、各ファイルに特定の説明を付けることができます。
PartyNumber |
NameType |
AdditionalName |
---|---|---|
RN_PTY_06_MAR_19_A1 |
LEGAL |
Test_Addname_A1 |
RN_PTY_06_MAR_19_A2 |
LEGAL |
Test_Addname_A2 |
RN_PTY_06_MAR_19_A3 |
LEGAL |
Test_Addname_A3 |
RN_PTY_06_MAR_19_A4 |
LEGAL |
Test_Addname_A4 |
RN_PTY_06_MAR_19_A5 |
LEGAL |
Test_Addname_A5 |
インポート・アクティビティの作成
Oracle Applications Cloudにデータをインポートするには、インポート・アクティビティを作成し、アクティビティへの入力としてCSVファイルを指定する必要があります。
インポート・アクティビティを作成するには、次の手順を実行します。
-
「ナビゲータ」で、「ツール」の下の「インポート管理」をクリックします。
-
「インポートの管理」ページで、「インポート・アクティビティの作成」をクリックします。
-
「インポート・アクティビティの作成: インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから「追加名」を選択します。
-
「ファイル名」で、必要な.CSVファイルを参照してアップロードし、「次」をクリックします。
-
「インポート・アクティビティの作成: フィールドのマップ」ページで、必要に応じて属性マッピングを編集し、「次」をクリックします。
ノート: 未マップ列についてソース・ファイルのマッピングを検証し、データ形式の問題をチェックするには、「データの検証」をクリックします。 -
「インポート・アクティビティの作成: レビューおよび発行」ページで、「発行」をクリックします。
インポート結果のレビュー
インポート結果をレビューするには、「インポート・アクティビティの管理」ページでインポート・アクティビティをチェックします。 ファイル・インポート・アクティビティは、ステータスが「完了」と表示されたときに成功したと考えられます。 インポート・アクティビティのステータスをチェックするには、次の手順を実行します。
-
「ナビゲータ」で、「ツール」の下の「インポート管理」をクリックします。
-
「インポートの管理」ページで、ステータス、名前、オブジェクトなどのいずれかの検索基準を使用して、作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティ・ステータスの他の有効な値は、「インポートのキューに配置済」、「データのインポートを準備しています」、「データをインポートしています」、「エラーありで完了」および「失敗」です。