アクティビティ割当先データのインポート

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

ターゲットのOracle Applications Cloudオブジェクト属性にマップされているソース・データを含むCSVファイルから、アクティビティ割当て先データをOracle Applications Cloudにインポートします。

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

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

少数のレコードのみをインポートする場合は、すべてのアクティビティ割当先属性に対して単一のCSVファイルを作成できます。ただし、大量のレコードをインポートする場合は、アクティビティ割当先の子オブジェクトごとに1つずつ、複数のCSVファイルを作成することに決定できます。子オブジェクトのCSVファイルをインポートする前に、アクティビティ割当先オブジェクトのCSVファイルを正常にインポートしておく必要があります。これらの子オブジェクトをそれぞれインポートする方法については、別のヘルプ・トピックで説明しています。詳細は、関連トピックを参照してください。

開始する前に

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

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

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

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

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

アクティビティ割当先オブジェクトの必須属性および検証

Oracle Applications Cloudにデータを正常にインポートするには、CSVファイルに必須属性が含まれている必要があります。これらの属性に有効な値を指定して、インポート検証がアプリケーションに渡されるようにしてください。

次の表に、アクティビティ割当先レコード、前提条件の設定タスクおよび特定の検証(ある場合)の必須属性を示します:

属性	摘要	前提条件の設定タスクやインポート検証	アクティビティ割当先レコードの作成	既存のアクティビティ割当先レコードの更新
ActivityId	割当先が関連付けられているアクティビティの内部識別子。	新規アクティビティ・レコードを作成する場合は、インポート・プロセスによって自動的に生成されます。	オプション	既存のアクティビティを更新しており、アクティビティ・レコードを識別するための他の値を指定していない場合は、値が必要です。既存のアクティビティを更新するには、次のオプションのいずれかを選択してレコードを識別します: レコードの一意のID (ActivityId) アクティビティ番号(ActivityNumber) ソース・システムのコードおよび参照(OrigEntityNumberおよびOrigEntityCode)
ActivityNumber	割当先が関連付けられているアクティビティの公開一意識別子	新規アクティビティの作成時に値を指定する場合、値は一意である必要があります。更新のために、アクティビティ・オブジェクトをエクスポートすることで、オブジェクトの既存の一意の値を決定できます。「設定および保守」作業領域で次のようにナビゲートします。オファリング: 営業機能領域: データのインポートおよびエクスポートタスク: エクスポート・プロセスのスケジュール列ACTIVITY_NUMBERを持つ表ZMM_ACTY_ACTIVITIESには、既存の値が保持されます。	新規アクティビティを作成する場合、値は必須です。	既存のアクティビティを更新しており、アクティビティ・レコードを識別するための他の値を指定していない場合は、値が必要です。既存のアクティビティを更新するには、次のオプションのいずれかを選択してレコードを識別します: レコードの一意のID (ActivityId) アクティビティ番号(ActivityNumber) ソース・システムのコードおよび参照(OrigEntityNumberおよびOrigEntityCode)
AssigneeId	PARTY_USAGEがリソースであるHZ_PARTYレコードの内部識別子。	値が指定されていない場合は、割当先生産表からの対応する値が使用されます。	新規割当先をアクティビティに関連付ける場合は、値が必要です。割当先の作成中に、次のいずれかを指定する必要があります: AssigneeId AssigneeResourceNumber AssigneeOrigSystemとOsrAssigneeIdの組合せ	既存のアクティビティ割当先を更新または削除するには、次のオプションのいずれかを選択してレコードを識別する必要があります: レコードの一意のID (ActivityId、AssigneeId) アクティビティ番号(ActivityNumber,AssigneeId) ソース・システムのコードおよび参照(OrigEntityNumberおよびOrigEntityCode)
AssigneeOrigSystem	割当済リソース組織へのソース・システム参照。	なし	新規割当先をアクティビティに関連付ける場合は、値が必要です。割当先の作成中に、次のいずれかを指定する必要があります: AssigneeId AssigneeResourceNumber AssigneeOrigSystemとOsrAssigneeIdの組合せ	不要
AssigneeResourceNumber	割当先に関連付けられたリソース番号。	なし	新規割当先をアクティビティに関連付ける場合は、値が必要です。割当先の作成中に、次のいずれかを指定する必要があります: AssigneeId AssigneeResourceNumber AssigneeOrigSystemとOsrAssigneeIdの組合せ	不要
OrigEntityCode	割当先が関連付けられているアクティビティの元のソースを示すコード。	アップグレードされたレコードの有効な値は、TASK、APPOINTMENTまたはINTERACTIONです。レコードがアクティビティ管理コンポーネントで作成された場合、値はACTIVITYです。	アップグレードされたレコードの有効な値は、TASK、APPOINTMENTまたはINTERACTIONです。レコードがアクティビティ管理コンポーネントで作成された場合、値はACTIVITYです。	既存のアクティビティを更新または削除する場合で、アクティビティ・レコードを識別するための他の値を指定していない場合は、値が必要です。既存のアクティビティを更新または削除するには、次のオプションのいずれかを選択してレコードを指定する必要があります: レコードの一意のID (ActivityId) アクティビティ番号(ActivityNumber) ソース・システムのコードおよび参照(OrigEntityNumberおよびOrigEntityCode)
OrigEntityNumber	ソース・システム内の既存のタスク、アポイントメントまたは顧客対応の当初の一意識別子。	内部アクション・コードがINSERTで、OrigEntityNumberおよびActivityNumberがNULLの場合、指定された値にデフォルト設定されます。値が指定されていない場合は、割当先生産表からの対応する値が使用されます。	内部アクション・コードがINSERTで、OrigEntityNumberおよびActivityNumberがNULLの場合、値はユーザーが指定した値に設定されます。値が指定されていない場合は、割当先生産表から対応する値が使用されます。	既存のアクティビティを更新または削除する場合で、アクティビティ・レコードを識別するための他の値を指定していない場合は、値が必要です。既存のアクティビティを更新または削除するには、次のオプションのいずれかを選択してレコードを指定する必要があります: レコードの一意のID (ActivityId) アクティビティ番号(ActivityNumber) ソース・システムのコードおよび参照(OrigEntityNumberおよびOrigEntityCode)
OsrAssigneeId	割当先のソース・システム参照。	パーティが存在する必要があります。パーティ・オブジェクトをエクスポートすることで、パーティのオリジナル・システム参照を決定できます。「設定および保守」作業領域で次のようにナビゲートします。オファリング: 営業機能領域: データのインポートおよびエクスポートタスク: エクスポート・プロセスのスケジュール	新規割当先をアクティビティに関連付ける場合は、値が必要です。割当先の作成中に、次のいずれかを指定する必要があります: AssigneeId AssigneeResourceNumber AssigneeOrigSystemとOsrAssigneeIdの組合せ	不要

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

ソースCSVファイルの作成

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

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

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

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

ノート:

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

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

CSVファイルの準備が整ったら、インポート・アクティビティを作成してアクティビティ割当先情報をインポートします。インポート・アクティビティを作成するには:

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

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

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

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