メッセージ・データのインポート

インポート管理を使用して、サービス・リクエスト・メッセージ・レコードを作成、更新、または削除できます。

次のステップを使用して、メッセージ・レコードをインポートできます:

ソース・メッセージ・データをOracle Applications Cloudオブジェクト属性にマップします。これにより、インポート・プロセスは各情報ビットの挿入場所を把握できます。
インポートするメッセージ・データを含むソースCSVファイルを作成します。
インポート・アクティビティを開始します。
インポートが正常に実行されたかどうかを確認します。

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

メッセージ・データをOracle Applications Cloudにインポートするには、.csvファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。

データ・インポート用の.csvファイルを作成する前に、次の手順を実行する必要があります。

ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
オブジェクトのインポートに必要な属性を理解するなど、前提となるステップが完了していることを確認します。
レコードを一意に識別するためのオプションを理解します。
子レコードをインポートする前に、親レコードが存在することを確認します。
正常にインポートするために.csvファイルに必要なターゲット・オブジェクト属性を識別します。

開始する前に

インポートを開始する前に、いくつかの基本チェックを行う必要があります。たとえば、次のことを確認してください。

ソース・データの各属性のインポートの前提条件がすべて完了している。
子レコードをインポートする前に、すべての親レコードを配置しておく。

レコードに対する一意の識別子の選択

すべてのレコードはアプリケーション内で一意である必要があります。次のいずれかを使用してレコードを識別できます。

公開一意識別子: レコードを作成する場合、理解しやすい公開一意識別子を指定できます。これらは通常、数値で示され、ビジネス・オブジェクトのUIに表示されます。 PUID属性の名前は通常、<object>番号です。番号属性を持つレコードを更新する場合は、番号属性を使用してレコードを識別します。公開一意識別子の詳細は、「関連項目」の「レコードのインポートに代替キーを使用する方法」のトピックを参照してください。
ソース・システムとソース・システム参照: ソース・システムは外部システムの識別子であり、ソース・システム参照は外部システム内で一意の識別子です。新しいメッセージをインポートする場合、またはソース・システム参照データを持つメッセージを更新する場合は、ソース・システムおよびソース・システム参照値を指定します。

メッセージ・オブジェクトの必須属性および検証

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

次の表に、メッセージ・レコードに必要な属性、前提条件の設定タスク、および特定の検証(ある場合)を示します:

属性	摘要	前提条件の設定タスクやインポート検証	メッセージ・レコードの作成	既存のメッセージ・レコードの更新
メッセージ・コンテンツ	添付でないメッセージのコンテンツ。	なし	必須	必須
メッセージ・タイプ・コード	メッセージのタイプを示します。値を指定する場合、次のいずれかである必要があります: ORA_SVC_CUSTOMER_ENTRY ORA_SVC_RESPONSE ORA_SVC_INTERNAL_NOTE ORA_SVC_SYSTEM_NOTE	値を指定する場合、次のいずれかである必要があります: ORA_SVC_CUSTOMER_ENTRY ORA_SVC_FORWARD ORA_SVC_CHAT_TRANSCRIPT ORA_SVC_INTERNAL_NOTE ORA_SVC_RESPONSE ORA_SVC_SYSTEM_NOTE ORA_SVC_SYSTEM_RESPONSE ORA_SVC_WRAP_UP	必須	必須
オブジェクトID	サービス・リクエストを参照しているか、サービス・リクエストによって参照されているオブジェクトのID (ノート、欠陥、その他のSRなど)。	検証なし	メッセージ・タイプ・コードがORA_SVC_INTERNAL_NOTEの場合は、渡さないでください	メッセージ・タイプ・コードがORA_SVC_INTERNAL_NOTEの場合は、渡さないでください
オブジェクト・タイプ・コード	OBJECT_ID表に基づくオブジェクト・タイプを示す参照コード(SVC_SR_MESSAGESなど)。	検証なし	メッセージ・タイプ・コードがORA_SVC_INTERNAL_NOTEの場合は、渡さないでください	メッセージ・タイプ・コードがORA_SVC_INTERNAL_NOTEの場合は、渡さないでください
転記者ID	メッセージをポストした個人のパーティID。この個人は、内部リソースまたは顧客担当です。	検証なし	不要	条件付きで必要既存の転記者IDを更新しており、表HZ_IMP_PARTIES_Tから取得したパーティIDを指定していない場合は、値が必要です。
サービス・リクエストID	メッセージが属するサービス・リクエストを指定します。	検証なし	不要	条件付きで必要既存のレコードを更新しており、SRNumberを指定していない場合は、値が必要です。
SR番号	サービス・リクエストの識別に使用される一意の番号。サービス・リクエスト番号は、組織の要件に最適な形式に構成できます。	検証なし	条件付きで必要既存のレコードを更新しており、サービス・リクエストIDを指定していない場合は、値が必要です。	条件付きで必要既存のレコードを更新しており、サービス・リクエストIDを指定していない場合は、値が必要です。
ステータス・コード	メッセージのステータス(DRAFT、COMMITTED、CORRECTEDなど)を示します。	値を指定する場合、次のいずれかである必要があります: ORA_SVC_DRAFT ORA_SVC_COMMITTED ORA_SVC_CORRECTED	必須	必須
通知処理ステータス・コード	通知処理ステータス・コード。	検証なし	メッセージ・タイプ・コードがORA_SVC_INTERNAL_NOTEの場合は、渡さないでください	メッセージ・タイプ・コードがORA_SVC_INTERNAL_NOTEの場合は、渡さないでください
通知再試行回数	通知の再試行回数。	検証なし	メッセージ・タイプ・コードがORA_SVC_INTERNAL_NOTEの場合は、渡さないでください	メッセージ・タイプ・コードがORA_SVC_INTERNAL_NOTEの場合は、渡さないでください

「ナビゲータ」>「ツール」>「インポート管理」>「オブジェクトのインポート」に移動して、メッセージ・オブジェクトのすべての属性を表示します。このページには、タイプ、長さ、説明などの属性情報も表示されます。

ソースCSVファイルの作成

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

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

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

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

ノート:

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

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

CSVファイルの準備が完了したら、インポート・アクティビティを作成してメッセージ情報をインポートします。インポート・アクティビティを作成するには:

「ナビゲータ」→「ツール」→「インポート管理」→「インポート・キュー」に移動します。
「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストからメッセージを選択します。
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。必要に応じてマッピングをレビューおよび編集します。
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。「次」をクリックします。
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。

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

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

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