サービス・リクエスト・データをインポートするにはどうすればよいですか。
インポート管理を使用して、サービス・リクエスト・レコードを作成、更新または削除できます。
次のステップを使用して、サービス・リクエスト・レコードをインポートできます:
-
ソース・サービス・リクエスト・データをOracle Applications Cloudオブジェクト属性にマップします。 これにより、インポート・プロセスは各情報ビットの挿入場所を把握できます。
-
インポートするサービス・リクエスト・データを含むソースCSVファイルを作成します。
-
インポート・アクティビティを開始します。
-
インポートが正常に実行されたかどうかを確認します。
ソース・データのターゲット・オブジェクト属性へのマップ方法
サービス・リクエスト・データをOracle Applications Cloudにインポートするには、.csvファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。
データ・インポート用の.csvファイルを作成する前に、次の手順を実行する必要があります。
-
ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
-
オブジェクトのインポートに必要な属性を理解するなど、前提となるステップが完了していることを確認します。
-
レコードを一意に識別するためのオプションを理解します。
-
子レコードをインポートする前に、親レコードが存在することを確認します。
-
正常にインポートするために.csvファイルに必要なターゲット・オブジェクト属性を識別します。
サービス・リクエスト情報をより適切に管理するために、サービス・リクエスト・オブジェクトには次の子オブジェクトがあります:
-
サービス・リクエスト参照
少数のレコードのみをインポートする場合は、すべてのサービス・リクエスト属性に対して単一のCSVファイルを作成できます。 ただし、多数のレコードをインポートする場合は、サービス・リクエストの子オブジェクトごとに1つずつ、複数のCSVファイルを作成することを決定できます。 子オブジェクトのCSVファイルをインポートしようとする前に、サービス・リクエスト・オブジェクトのCSVファイルを正常にインポートしておく必要があります。 これらの子オブジェクトをそれぞれインポートする方法については、別のヘルプ・トピックで説明しています。 詳細は、関連トピックを参照してください。
開始する前に
インポートを開始する前に、いくつかの基本チェックを行う必要があります。 たとえば、次のことを確認してください。
-
ソース・データの各属性のインポートの前提条件がすべて完了している。
-
子レコードをインポートする前に、すべての親レコードを配置しておく。
レコードに対する一意の識別子の選択
すべてのレコードはアプリケーション内で一意である必要があります。 次のいずれかを使用してレコードを識別できます。
-
公開一意識別子: レコードを作成する場合、理解しやすい公開一意識別子を指定できます。 これらは通常、数値で示され、ビジネス・オブジェクトのUIに表示されます。 PUID属性の名前は通常、<object>番号です。 番号属性を持つレコードを更新する場合は、番号属性を使用してレコードを識別します。 公開一意識別子の詳細は、「関連項目」の「レコードのインポートに代替キーを使用する方法」のトピックを参照してください。
-
ソース・システムとソース・システム参照: ソース・システムは外部システムの識別子であり、ソース・システム参照は外部システム内で一意の識別子です。 新規サービス・リクエストをインポートする場合、またはソース・システム参照データを持つサービス・リクエストを更新する場合は、ソース・システムおよびソース・システム参照値を指定します。
サービス・リクエスト・オブジェクトの必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、.csvファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。
次の表に、サービス・リクエスト・レコードに必要な属性、前提条件の設定タスクおよび特定の検証(ある場合)を示します:
|
属性 |
摘要 |
前提条件の設定タスクやインポート検証 |
サービス・リクエスト・レコードの作成 |
既存のサービス・リクエスト・レコードの更新 |
|---|---|---|---|---|
|
アカウントID |
Oracle Fusion宛先表の既存のアカウントIDレコードの一意のID。 |
新規サービス・リクエストを作成する場合は、値を指定しないでください。 既存のサービス・リクエストを更新する場合、値はSVC_SERVICE_REQUESTS表のACCOUNT_PARTY_ID列に存在する必要があります。 |
不要 |
条件付きで必要 既存のアカウントIDを更新する場合は、値が必要です。 |
|
AssetID |
既存のサービス・リクエスト・レコードの一意の内部ID。 |
新規サービス・リクエストを作成する場合は、値を指定しないでください。 既存のサービス・リクエストを更新する場合、値はZCA_ASSET表のASSET_ID列に存在する必要があります。 |
不要 |
条件付きで必要 このサービス・リクエストの既存のサービス・リクエストを更新する場合は、値が必要です。 |
|
ビジネス・ユニット |
サービス・リクエストに関連付けられたビジネス・ユニット名の一意のID。 |
検証なし |
必須 |
必須 |
|
Category ID |
サービス・オブジェクトをグループ化して識別とダウンストリーム・レポートを簡単にできるようにする手段の一意のID。 |
値を指定する場合、値は表SVC_SR_CATEGORIES (CATEGORY_ID)に存在する必要があります。 |
不要 |
条件付きで必要 このサービス・リクエストの既存のカテゴリIDを更新する場合は、値が必要です。 |
|
在庫品目ID |
既存の販売カタログ製品(アイテム)レコードの一意の内部ID。 |
値を指定する場合は、EGP_SYSTEM_ITEMS_B表の列INVENTORY_ITEM_IDに値が存在する必要があります。 識別された製品は、販売カタログ(QSC_PROD_GRP_ITEMS_TREE_Vビュー)に対して定義する必要があります。 既存の製品(アイテム)のInventoryItemIdを取得するには、Product Group Productsオブジェクトをエクスポートします。 「設定および保守」作業領域で次のようにナビゲートします。
販売カタログに製品(アイテム)を追加できます。 「設定および保守」作業領域で次のようにナビゲートします。
|
条件付きで必要 新規品目在庫を作成する場合は、値が必要です。 |
条件付きで必要 品目在庫を更新しており、製品のID (InventoryItemId)を指定していない場合は、値が必要です。 |
|
在庫組織ID |
宛先表内の既存の製品品目組織のレコードの一意の内部ID。 |
値を指定する場合は、EGP_SYSTEM_ITEMS_B表の列ORGANIZATION_IDに値が存在する必要があります。 識別される品目組織は、プロファイルQSC_SALES_PRODUCTS_INVENTORY_ORG_IDに定義されている同じ組織である必要があります。 プロファイル値を表示できます。 「設定および保守」作業領域で次のようにナビゲートします。
既存の製品(アイテム)のInventoryOrgIdを取得するには、Product Group Productsオブジェクトをエクスポートします。 「設定および保守」作業領域で次のようにナビゲートします。
|
条件付きで必要 新規品目在庫を作成する場合は、値が必要です。 |
条件付きで必要 品目在庫を更新しており、製品のID (InventoryItemId)を指定していない場合は、値が必要です。 |
|
パートナ・アカウント・パーティID |
HZ_PARTIES (PARTY_ID)を参照する外部キー。 |
この追加パーティ名と同じインポート・バッチで新規パートナ・アカウントを作成する場合は、値を指定しないでください。 既存のパーティの値を指定する場合は、HZ_PARTIES表の列PARTY_IDに値が存在する必要があります。 パーティ・オブジェクトをエクスポートすることで、既存のパーティのPARTY_IDを取得できます。 「設定および保守」作業領域で次のようにナビゲートします。
|
不要 |
条件付きで必要 このサービス・リクエストの既存のパートナ・アカウントを更新する場合は、値が必要です。 |
|
PartyID |
Oracle Fusion宛先表の既存のパーティ・レコードの一意のID。 |
この追加パーティ名と同じインポート・バッチで新規パーティを作成する場合は、値を指定しないでください。 既存のパーティの値を指定する場合は、HZ_PARTIES表の列PARTY_IDに値が存在する必要があります。 パーティ・オブジェクトをエクスポートすることで、既存のパーティのPARTY_IDを取得できます。 「設定および保守」作業領域で次のようにナビゲートします。
|
不要 |
条件付きで必要 既存のパーティIDを更新しており、パーティIDを指定していない場合は、値が必要です。 |
|
プライマリ担当者ID |
サービス・リクエストの担当者および進行中のプライマリ顧客担当者によって報告された最初のレポート。 |
この追加パーティ名と同じインポート・バッチで新しいプライマリ担当者IDを作成する場合は、値を指定しないでください。 既存のプライマリ担当者の値を指定する場合は、HZ_PARTIES表の列PARTY_IDに値が存在する必要があります。 パーティ・オブジェクトをエクスポートすることで、既存のパーティのPARTY_IDを取得できます。 「設定および保守」作業領域で次のようにナビゲートします。
|
不要 |
条件付きで必要 このサービス・リクエストの既存のプライマリ担当者IDを更新する場合は、値が必要です。 |
|
参照番号 |
サービス・リクエストの識別に使用される一意の番号。 サービス・リクエスト番号は、組織の要件に最適な形式に構成できます。 |
検証なし |
不要 |
条件付きで必要 既存のレポート者レコードを更新しており、サービス・リクエストIDを指定していない場合は、値が必要です。 |
|
サービス・リクエストID |
Oracle Fusion宛先表の既存のサービス・リクエスト・レコードの一意のID。 |
検証なし |
不要 |
条件付きで必要 既存のサービス・リクエストIDを更新しており、サービス・リクエスト番号を指定していない場合は、値が必要です。 |
サービス・リクエスト・オブジェクトのすべての属性を表示するには、に移動します。 このページには、タイプ、長さ、説明などの属性情報も表示されます。
ソースCSVファイルの作成
Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。
「インポート・オブジェクト」UIページで使用可能なテンプレートを使用して、ソースCSVファイルを作成できます。 テンプレートをダウンロードするには:
-
に移動します。
-
表内の「サービス・リクエスト」オブジェクトを選択し、「ダウンロード」をクリックします。
これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。
インポート・アクティビティの作成
CSVファイルの準備が完了したら、インポート・アクティビティを作成してサービス・リクエスト情報をインポートします。 インポート・アクティビティを作成するには:
-
に移動します。
-
「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
-
「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストからサービス・リクエストを選択します。
-
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
-
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。 必要に応じてマッピングをレビューおよび編集します。
-
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
-
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
-
に移動します。
-
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。