分類データのインポート

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

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

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

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

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

開始する前に

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

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

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

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

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

分類オブジェクトの必須属性および検証

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

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

属性	説明	前提条件の設定タスクやインポート検証	分類レコードの作成	既存の分類レコードの更新
PartySourceSystem	分類が属するparty(account, contact, household, or legal entity)のソース・システムを表すコード。	前のバッチでパーティをインポートしたときに使用されたソース・システム・コードを識別するか、この分類と同じバッチでパーティをインポートするときに使用するソース・システム・コードを指定します。	条件により必須次のいずれかを指定します : PartyId (内部ID) 組織プロファイルのインポート時に指定されたPartySourceSystemおよびPartySourceSystemReference(source system code and source system reference values)。	オプション
PartySourceSystemReferenceValue	分類が属するパーティ(アカウント、担当者、世帯または法的エンティティ)のソース・システムの一意のIDを表す参照番号またはテキスト。	前のバッチでパーティをインポートしたときに使用されたソース・システムの参照値を識別するか、この分類と同じバッチでパーティをインポートするときに使用するソース・システム参照を識別します。	条件により必須既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されたPartySourceSystemおよびPartySourceSystemReference(source system code and source system reference values)。パーティ番号(組織プロファイルの公開一意識別子)	オプション
PrimaryFlag	親パーティ・レコードのプライマリ分類を識別します。	1つの子レコードのみをプライマリにできます。	オプション	オプションプライマリを設定するにはYを、既存のプライマリ・レコードをリセットするにはNを渡します。
CodeAssignmentId	顧客分類割当の一意の識別子。	有効な既存の値である必要があります。	不要	コード割当ID、またはソース・システムとソース・システム参照の組合せが必要です。
ClassCategory	分類カテゴリ名	区分カテゴリが存在する必要があります。区分カテゴリは、区分カテゴリの管理タスクから管理できます。	必須新規分類関連レコードを作成する場合は、値が必要です。	必須ではない
ClassCode	パーティに割り当てられた分類カテゴリ内の分類コード。	値は分類カテゴリの有効なコードである必要があります。カテゴリ定義が同じカテゴリ内のパーティへの複数コード割当に対して使用可能になっていない場合、1つのコードのみを割り当てることができます。コード割当は、同じ期間内に存在していない必要があります。分類カテゴリの分類コードを取得できます。	条件により必須新規分類関連レコードを作成する場合は、値が必要です。	必須ではない
StartDateActive	分類が有効になる日付。	これは有効な日付である必要があります。	デフォルトは現在の日付です。	不要
PartyId	住所が所属するパーティ(アカウント、担当者、世帯、法的エンティティ)の内部ID	アカウント、担当者などの関連パーティ・オブジェクトをエクスポートして、パーティID値を識別します。	条件により必須既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されたPartySourceSystemおよびPartySourceSystemReference(source system code and source system reference values)。パーティ番号(組織プロファイルの公開一意識別子)	不要
PartyNumber	分類カテゴリおよび分類コードが関連付けられているパーティ・レコードの公開一意識別子。	パーティ番号が存在する必要があります。	条件により必須既存のパーティを識別するための参照情報を指定します。この参照情報として次のものが可能です。 PartyId (内部ID) 組織プロファイルのインポート時に指定されるPartySourceSystemおよびPartySourceSystemReference(source system code and source system reference values) パーティ番号(組織プロファイルの公開一意識別子)	不要
EndDateActive	分類コードが無効になった日付。	これは有効な日付である必要があります。	オプション	不要
SourceSystem	住所が関連付けられているアカウント、担当者または世帯の外部ソース・システムの名前。	ソース・システムが存在する必要があります。ソース・システムは、ソース・システムの管理タスクから管理できます。	オプションデータのソースがサード・パーティまたは外部システムである場合で、かつ、同じシステムから以前にインポートしたレコードに更新をインポートする場合は、元のソース・システムの値とソース・システム参照値を指定します。	不要
SourceSystemReferenceValue	元のソース・システムの識別子を指定	ソース・システムとソース・システム参照値の組合せは一意である必要があります。	オプションデータのソースがサード・パーティまたは外部システムである場合で、かつ、同じシステムから以前にインポートしたレコードに更新をインポートする場合は、元のソース・システムの値とソース・システム参照値を指定します。	不要

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

ソースCSVファイルの作成

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

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

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

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

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

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

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

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

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

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

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