パートナ担当者データのインポート

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

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

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

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

属性	摘要	データ型	データ長	前提条件の設定タスクやインポート検証	パートナ担当者レコードの作成	既存のパートナ担当者レコードの更新
FirstName	個人の名	テキスト	150	新規個人パーティを作成する場合は、値が必要です。	必須	不要
LastName	個人の姓	テキスト	150	新規個人パーティを作成する場合は、値が必要です。	必須	不要
EmailAddress	パートナ担当者の電子メール・アドレス	テキスト	320	`createUserAccountFlag`属性が'Y'に設定されているパートナ担当者をインポートする際に、`username`値は一意である必要があります。 `username`属性が設定されていない場合、電子メール・アドレスの値は一意である必要があります。	必須	不要
CompanyNumber	パートナの会社番号	テキスト	30	値は、ZPM_PARTNER_PROFILES表のCOMPANY_MUMBER列に存在する必要があります。パートナ・プロファイル・オブジェクトをエクスポートして、既存のパートナのCOMPANY_NUMBERを識別します。「設定および保守」作業領域で次のようにナビゲートします。オファリング: 営業機能領域: データのインポートおよびエクスポートタスク: バルク・データ・エクスポートの管理、エクスポート・プロセスのスケジュール	CompanyNumberまたはPartnerPartyIdに値が必要です。	不要
PartyNumber	担当者のパーティ番号	テキスト	30	PartyNumberは、新規レコードを作成する場合、および既存のレコードを更新する場合、有効なパートナ担当者のレコードと同じ値である必要があります。	レコードの作成時には、オプションで値が必要です。	レコードの更新時に、PartyNumberまたはPartyIdのいずれかの値が必要です。
PartnerPartyId	宛先表の既存のパートナ組織のパーティ・レコードの一意のID	数値	18	パートナ・プロファイル・オブジェクトをエクスポートして、既存のパートナ・パーティのPARTY_IDを識別します。「設定および保守」作業領域で次のようにナビゲートします。オファリング: 営業機能領域: データのインポートおよびエクスポートタスク: バルク・データ・エクスポートの管理、エクスポート・プロセスのスケジュール	レコードの作成時に、CompanyNumberまたはPartnerPartyIDのいずれかの値が必要です。	不要
PrimaryFlag	パートナ担当者がプライマリ担当者であるかどうかを示します	文字列	1	対応するパートナにプライマリ担当者がいない場合、パートナ担当者にこの属性を設定します。これはYまたはNのいずれかです。	必須	不要

ノート: パートナ担当者をインポートする場合は、CompanyNumber属性を使用します。 PartnerCompanyNumber属性は使用しないでください。

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

ソースCSVファイルの作成

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

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

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

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

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

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

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

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

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

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

ノート: パートナ担当者のインポート・アクティビティにアクセスして発行するには、チャネル・オペレーション・マネージャのジョブ・ロールがユーザーに割り当てられている必要があります。

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

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

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