プログラム登録データのインポート
インポート管理を使用して、プログラム登録レコードを作成または更新できます。
プログラム登録レコードをインポートするには、次のタスクを実行します:
-
ソース・データを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を使用すると、パフォーマンスが向上し、インポート期間が短縮されます。 プログラム登録オブジェクトの場合、この属性はProgramEnrollmentIdです。
-
公開一意識別子: 新しいレコードを作成する場合は、わかりやすい公開一意識別子を指定できます(属性は番号で示され、通常はビジネス・オブジェクトのUIに表示されます)。 以前に番号属性を指定したレコード、または番号属性がオブジェクトのUIに表示されるレコードを更新する場合は、番号属性を使用してレコードを識別できます。 プログラム登録オブジェクトの場合、属性はEnrollmentNumberです。
プログラム登録オブジェクトの必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、.CSVファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。
次の表は、新規プログラム登録レコードのインポートに必要な属性、プログラム登録レコードの更新に必要な属性、属性の前提条件設定タスク、およびプログラム登録インポートの特定の検証(ある場合)を示しています:
|
属性 |
摘要 |
前提条件の設定タスクやインポート検証 |
プログラム登録レコードの作成 |
既存のプログラム登録レコードの更新 |
|---|---|---|---|---|
|
ProgramEnrollmentId |
既存のプログラム登録レコードの一意のID。 |
なし。 |
不要 |
登録番号が指定されていない場合、値は必須です。 |
|
PartnerPartyId |
パートナを識別するための内部ID |
パートナはパースペクティブまたは否認済ステータスにはできません。 |
パートナ会社番号が指定されていない場合、値は必須です。 |
不要 |
|
PartnerProgramId |
プログラムを識別するための内部ID |
プログラムは公開済ステータスである必要があります。 |
プログラム番号が指定されていない場合、値は必須です。 |
不要 |
|
ProgramNumber |
プログラムを識別するための公開一意識別子 |
プログラムは公開済ステータスである必要があります。 |
パートナ・プログラムIDが指定されていない場合は、値が必要です。 |
不要 |
|
PartnerCompanyNumber |
パートナを識別するための公開一意識別子 |
パートナはパースペクティブまたは否認済ステータスにはできません。 |
パートナ・パーティIDが指定されていない場合は、値が必要です。 |
不要 |
|
EnrollmentNumber |
登録を識別するための公開一意識別子 |
なし |
不要 |
プログラム登録IDが指定されていない場合、値は必須です。 |
「インポート管理」フローの「インポート・オブジェクトの管理」ページで、プログラム登録オブジェクトとそのすべての子オブジェクトおよび属性を表示できます。 タイプ、長さ、説明などの属性情報をこのページで確認できます。
ソースCSVファイルの作成
Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。
「インポート・オブジェクト」UIページで使用可能なテンプレートを使用して、ソースCSVファイルを作成できます。 テンプレートをダウンロードするには:
-
に移動します。
-
表内の「プログラム登録」オブジェクトを選択し、「ダウンロード」をクリックします。
これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。
CSVファイルの移入および値の入力に関する問題を回避するには、「関連トピック」の項でExcelを使用してCSVファイルを開く場合の潜在的な問題に関するトピックを参照してください。
インポート・アクティビティの作成
Oracle Applications Cloudにデータをインポートするには、インポート・アクティビティを作成し、アクティビティへの入力としてCSVファイルを指定する必要があります。
インポート・アクティビティを作成するには、次の手順を実行します。
-
に移動します。
-
「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
-
「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストからプログラム登録を選択します。
-
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
-
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。 必要に応じてマッピングをレビューおよび編集します。
-
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
-
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
-
に移動します。
-
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。