パートナ・データのインポート

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

パートナ・データを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を使用すると、パフォーマンスが向上し、インポート期間が短縮されます。 Partnerオブジェクトの場合、この属性はPartyIdです:
公開一意識別子: 新しいレコードを作成する場合は、わかりやすい公開一意識別子を指定できます(属性は番号で示され、通常はビジネス・オブジェクトのUIに表示されます)。以前に番号属性を指定したレコード、または番号属性がオブジェクトのUIに表示されるレコードを更新する場合は、番号属性を使用してレコードを識別できます。パートナ・オブジェクトの場合、属性はCompanyNumberです。

パートナ・オブジェクトの必須属性および検証

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

パートナのステータスを更新するには、CSVファイルの属性PartyId、StatusおよびCompanyNumberの値を指定してインポートを作成します。

次の表に、新規パートナ・レコードのインポートに必要な属性、パートナ・レコードの更新に必要な属性、属性の前提条件設定タスク、およびパートナ・インポートの特定の検証(ある場合)を示します:

属性	摘要	データ型	データ長	前提条件の設定タスクやインポート検証	パートナ・レコードの作成	既存のパートナ・レコードの更新
OrganizationName	組織の名前	テキスト	360	新規組織を作成する場合、値は必須です。	必須	不要
AddressLineOne	郵送先住所の最初の行	テキスト	240	検証なし	必須	不要
国	郵送先住所の国コード	テキスト	2	値を指定する場合、値はFND_TERRITORIES_B表に存在する必要があります。有効な国コードを表示できます。「設定および保守」作業領域で次のようにナビゲートします。オファリング: 営業機能領域: データのインポートおよびエクスポートタスク: 地域の管理	必須	不要
PartyId	宛先表の既存のパートナ組織のパーティ・レコードの一意のID	数値	18	パートナ・プロファイル・オブジェクトをエクスポートして、既存のパートナ・パーティのPARTY_IDを識別します。「設定および保守」作業領域で次のようにナビゲートします。オファリング: 営業機能領域: データのインポートおよびエクスポートタスク: バルク・データ・エクスポートの管理、エクスポート・プロセスのスケジュール	不要	PartyIdまたはCompanyNumberに値が必要です。
CompanyNumber	パートナの会社番号。	テキスト	30	値を指定し、この証明と同じインポート・バッチで新しいパーティをインポートする場合、その値はZPM_IMP_PARTNER表で一意である必要があります。既存のパーティに値を指定する場合は、ZPM_PARTNER_PROFILES表の列COMPANY_NUMBERに値が存在する必要があります。	不要	CompanyNumberまたはPartyIdに値が必要です。

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

ソースCSVファイルの作成

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

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

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

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

パートナの最初のパートナ担当者を作成するときに、必要なロールを指定できます。また、最初のパートナ担当者が作成されたら、このパートナ担当者のロールを更新できます。

ノート:

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

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

Oracle Applications Cloudにデータをインポートするには、インポート・アクティビティを作成し、アクティビティへの入力としてCSVファイルを指定する必要があります。

インポート・アクティビティを作成するには、次の手順を実行します。

「ナビゲータ」で、「ツール」の下の「インポート管理」をクリックします。
「インポートの管理」ページで、「インポート・アクティビティの作成」をクリックします。
「インポート・アクティビティの作成: インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから「パートナ」を選択します。
「ファイル名」で、必要な.CSVファイルを参照してアップロードし、「次」をクリックします。
「インポート・アクティビティの作成: フィールドのマップ」ページで、必要に応じて属性マッピングを編集し、「次」をクリックします。

ノート:
「データの検証」をクリックして、マップされていない列のソース・ファイルのマッピングを検証し、データ形式の問題をチェックします。
「インポート・アクティビティの作成: レビューおよび発行」ページで、「発行」をクリックします。

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

インポート結果をレビューするには、「インポート・アクティビティの管理」ページでインポート・アクティビティをチェックします。ファイル・インポート・アクティビティは、ステータスが「完了」と表示されたときに成功したと考えられます。インポート・アクティビティのステータスをチェックするには、次の手順を実行します。

「ナビゲータ」で、「ツール」の下の「インポート管理」をクリックします。
「インポートの管理」ページで、ステータス、名前、オブジェクトなどのいずれかの検索基準を使用して、作成したインポート・アクティビティを検索します。
インポート・アクティビティの「ステータス」列をチェックします。ステータスが「完了」と表示された場合、インポートは成功です。インポート・アクティビティ・ステータスの他の有効な値は、「インポートのキューに配置済」、「データのインポートを準備しています」、「データをインポートしています」、「エラーありで完了」および「失敗」です。

ノート:

このページでは、発行されたすべてのアクティブなインポート、完了したインポートおよび失敗したインポートの数とステータスをすばやく表示することもできます。