サービス・プロファイル・データのインポート
インポート管理を使用して、サービス・プロファイル・レコードの更新または削除を作成できます。
サービス・プロファイル・レコードをインポートするには、次のタスクを実行します:
- ソース・データをOracle Applications Cloudオブジェクト属性にマップします。
- インポート用のソース・カンマ区切り値(CSV)ファイルを作成します。
- インポート・アクティビティを作成します。
- インポート結果をレビューします。
ソース・データのターゲット・オブジェクト属性へのマップ方法
サービス・プロファイル・データをOracle Applications Cloudにインポートするには、CSVファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。
データ・インポート用のCSVファイルを作成する前に、次の手順を実行する必要があります。
- ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
- 前提条件の設定が実行されていることを確認します(該当する場合)。
- レコードを一意に識別するためのオプションを理解します。
- 子レコードをインポートする前に、親レコードが存在することを確認します。
- 正常にインポートするためにCSVファイルに必要なターゲット・オブジェクト属性を識別します。
開始する前に
インポートを開始する前に、いくつかの基本チェックを行う必要があります。 たとえば、次のことを確認してください。
- ソース・データの各属性のインポートの前提条件がすべて完了している。
- 子レコードをインポートする前に、すべての親レコードを配置しておく。
レコードに対する一意の識別子の選択
すべてのレコードはアプリケーション内で一意である必要があります。 次のいずれかを使用してレコードを識別できます。
- 公開一意識別子: レコードを作成する場合、理解しやすい公開一意識別子を指定できます。 これらは通常、数値で示され、ビジネス・オブジェクトのUIに表示されます。 PUID属性の名前は通常、<object>番号です。 番号属性を持つレコードを更新する場合は、番号属性を使用してレコードを識別します。 公開一意識別子の詳細は、「関連項目」の「レコードのインポートに代替キーを使用する方法」のトピックを参照してください。
- ソース・システムとソース・システム参照: ソース・システムは外部システムの識別子であり、ソース・システム参照は外部システム内で一意の識別子です。 新規ケースをインポートする場合、またはソース・システム参照データを持つケースを更新する場合は、ソース・システムおよびソース・システム参照値を指定します。
サービス・プロファイル・オブジェクトの必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、CSVファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。 次の表に、新規サービス・プロファイル・レコードのインポートに必要な属性、サービス・プロファイル・レコードの更新または削除に必要な属性、属性の前提条件設定タスク、およびサービス・プロファイル・インポートの特定の検証(ある場合)を示します:
属性 | 摘要 | 前提条件設定タスク/インポート検証 | サービス・プロファイル・レコードの作成 | サービス・プロファイル・レコードの更新 | サービス・プロファイル・レコードの削除 |
PartySiteId | サービス・プロファイルのサイト・アドレス。 | 値は、HZ_PARTY_SITES表のPARTY_SITE_ID列に存在する必要があります。 PARTY_SITE_IDは、CUSTOMER_PARTY_IDの子レコードである必要があります。 | 必須。 PartySiteIdまたはPartySiteNumberのいずれかが必要です | 不要 | 不要 |
CustomerPartyId | サービス・プロファイルを持つ顧客。 | 値は、HZ_PARTIES表のPARTY_ID列に存在する必要があります。 | 必須。 CustomerPartyIdまたはCustomerPartyNumberのいずれかが必要です | 不要 | 不要 |
ServiceProfileId | サービス・プロファイルの一意の識別子。 | 宛先システムの有効な主キー。 ServiceProfileNumberまたはServiceProfileIdのいずれかを入力する必要があります。 両方が入力されている場合は、ServiceProfileIdが優先されます。 | 不要 | 条件により必須 ServiceProfileNumberが指定されていない場合は値を指定します。 | 条件により必須 ServiceProfileNumberが指定されていない場合は値を指定します。 |
ServiceProfileNumber | サービス・プロファイルのPUID。 | 宛先システムのサービス・プロファイルに有効な一意のPUID。 | 必須。 渡されない場合は、PartySiteIdのPartySiteNumberにデフォルト設定されます | 条件により必須 ServiceProfileIdが指定されていない場合は値を指定します。 | 条件により必須 ServiceProfileIdが指定されていない場合は値を指定します。 |
ServiceProfileName | サービス・プロファイルの名前。 | サービス・プロファイルのユーザー定義名。 | 必須。 渡されない場合は、<Customer Name> (<PartySiteNumber>)にデフォルト設定されます。 | オプション | オプション |
StatusCd | サービス・プロファイルがアクティブかどうかを示します。 | 有効な値が必要です。 | 必須。 渡されない場合は、ORA_SVC_ACTIVEにデフォルト設定されます。 |
オプション ORA_SVC_INACTIVEを渡して、ステータスを「非アクティブ」に設定します。 |
不要 |
StripeCd | サービス・プロファイルのサービス実装のタイプを示します。 たとえば、CRMまたは内部ヘルプ・デスク・サービス・プロファイルです。 | 有効な値が必要です。 | 必須。 渡されない場合、ORA_SVC_CRMにデフォルト設定されます。 | 不要 | 不要 |
TypeCd | サービス・プロファイルのタイプ。 | 有効な値が必要です。 | 必須。 渡されない場合は、ORA_SVC_SITEにデフォルト設定されます。 | 不要 | 不要 |
PartySiteNumber | サービス・プロファイル・サイト・アドレスのPUID。 | 値は、HZ_PARTY_SITES表のPARTY_SITE_NUMBER列に存在する必要があります。 | 必須。 PartySiteIdまたはPartySiteNumberのいずれかが必要です | 不要 | 不要 |
CustomerPartyNumber | サービス・プロファイルの顧客パーティのPUID。 | 値は、HZ_PARTIES表のPARTY_NUMBER列に存在する必要があります。 | 必須。 CustomerPartyIdまたはCustomerPartyNumberのいずれかが必要です | 不要 | 不要 |
BillToCustomerId | サービス・プロファイルに対して実行される作業に対して請求される顧客。 | 値は、HZ_PARTIES表のPARTY_ID列に存在する必要があります。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
BillToCustomerPartyNumber | サービス・プロファイルに対して実行される作業に対して請求される顧客のPUID。 | 値は、HZ_PARTIES表のPARTY_NUMBER列に存在する必要があります。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
BillToCustomerAccountId | サービス・プロファイルに対して実行される作業に対して請求される顧客アカウント。 | BillingCustomerAccountIdの一意の識別子で、BillingAccountに属している必要があります。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
BillToCustomerAccountNumber | サービス・プロファイルに対して実行される作業に対して請求される顧客アカウントのPUID。 | BillingCustomerAccountの公開一意識別子であり、請求アカウントに属している必要があります。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
BillToCustomerAccountSiteId | サービス・プロファイルに対して実行される作業に対して請求される顧客アカウント・サイト。 | BillingCustomerAccountSiteIdの一意の識別子で、BillingCustomerAccountに属している必要があります。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
BillToPartySiteId | サービス・プロファイルに対して実行される作業に対して請求されるパーティ・サイト。 | 請求PartySiteIdの一意の識別子。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
BillToPartySiteNumber | サービス・プロファイルに対して実行される作業に対して請求されるパーティ・サイトのPUID。 | 請求PartySiteNumberの公開一意識別子。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
PrimaryContactPartyId | サービス・プロファイルのプライマリ担当者。 | 値は、Contact PartyType列PARTY_IDのHZ_PARTIES表に存在する必要があります。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
PrimaryContactPartyNumber | サービス・プロファイル・プライマリ担当者のパーティ番号。 | PrimaryContactPartyIdの公開一意識別子。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
条件付きで必要 渡された場合は有効な値が必要です。 |
不要 |
「サービス・プロファイル」オブジェクトおよび属性は、インポート管理フローの「インポート・オブジェクトの管理」ページで表示できます。 タイプ、長さ、説明などの属性情報をこのページで確認できます。
ソースCSVファイルの作成
Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。
「インポート・オブジェクト」UIページで使用可能なテンプレートを使用して、ソースCSVファイルを作成できます。 テンプレートをダウンロードするには:
- に移動します。
- 表内の「サービス・プロファイル」オブジェクトを選択し、「ダウンロード」をクリックします。
これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。
ノート: CSVファイルの移入および値の入力に関する問題を回避するには、「関連トピック」の項でExcelを使用してCSVファイルを開く場合の潜在的な問題に関するトピックを参照してください。
インポート・アクティビティの作成
CSVファイルの準備が完了したら、インポート・アクティビティを作成して情報をインポートします。 インポート・アクティビティを作成するには:
- に移動します。
- 「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
- 「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから「サービス・プロファイル」を選択します。
- 「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします
- ソース属性とターゲット属性は、「フィールドのマップ」ページに自動的にマップされます。 必要に応じてマッピングをレビューおよび編集します。
- 「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
- 「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
- に移動します。
- 「すべてのインポート」をクリックして、前に作成したインポート・アクティビティを検索します。
- インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。