担当者データをインポートするにはどうすればよいですか。
インポート管理を使用して、担当者レコードを作成、更新または削除できます。 担当者を使用して、電子メール、電話番号、インスタント・メッセンジャ・アドレス、web URLなどの顧客担当者情報をインポートできます。
担当者レコードをインポートするには、次のタスクを実行します:
-
ソース・データをOracle Applications Cloudオブジェクト属性にマップします。
-
インポート用のソース・カンマ区切り値(CSV)ファイルを作成します。
-
インポート・アクティビティを作成します。
-
インポート結果をレビューします。
ソース・データのターゲット・オブジェクト属性へのマップ方法
担当者データをOracle Applications Cloudにインポートするには、CSVファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。
データ・インポート用のCSVファイルを作成する前に、次の手順を実行する必要があります。
-
ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
-
前提条件の設定が実行されていることを確認します(該当する場合)。
-
レコードを一意に識別するためのオプションを理解します。
-
子レコードをインポートする前に、親レコードが存在することを確認します。
-
正常にインポートするためにCSVファイルに必要なターゲット・オブジェクト属性を識別します。
-
重複データを避けるために、重複した住所をインポート中に挿入しないようにします。
開始する前に
インポートを開始する前に、いくつかの基本チェックを行う必要があります。 たとえば、次のことを確認してください。
-
ソース・データの各属性のインポートの前提条件がすべて完了している。
-
子レコードをインポートする前に、すべての親レコードを配置しておく。
レコードに対する一意の識別子の選択
すべてのレコードはアプリケーション内で一意である必要があります。 次のいずれかを使用してレコードを識別できます。
-
公開一意識別子: レコードを作成する場合、理解しやすい公開一意識別子を指定できます。 これらは通常、数値で示され、ビジネス・オブジェクトのUIに表示されます。 PUID属性の名前は通常、<object>番号です。 番号属性を持つレコードを更新する場合は、番号属性を使用してレコードを識別します。 公開一意識別子の詳細は、「関連項目」の「レコードのインポートに代替キーを使用する方法」のトピックを参照してください。
-
ソース・システムとソース・システム参照: ソース・システムは外部システムの識別子であり、ソース・システム参照は外部システム内で一意の識別子です。 新しい担当者をインポートするか、ソース・システム参照データがある担当者を更新する場合は、ソース・システムおよびソース・システム参照値を指定します。
担当者オブジェクトの必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、CSVファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。 次の表に、新規担当者レコードのインポートに必要な属性、担当者レコードの更新に必要な属性、属性の前提条件設定タスク、および担当者インポートの特定の検証(ある場合)を示します:
|
属性 |
摘要 |
前提条件の設定タスクやインポート検証 |
担当者レコードの作成 |
既存の担当者レコードの更新 |
|---|---|---|---|---|
|
ContactPointType |
インポートまたは更新された担当者のタイプ |
これは、lookup_typeがCOMMUNICATION_TYPEであるHZ_LOOKUPSのlookup_codeである必要があります |
次のいずれかの値を指定します:
|
不要 |
|
PartyId |
担当者が属するパーティの内部ID |
検証なし |
次のいずれかを指定します :
|
不要 |
|
PartyNumber |
パーティのPUIDを指定 |
検証なし |
次のいずれかを指定します :
|
不要 |
|
PartySourceSystem |
パーティの元のソース・システムを指定 |
ステータスがAのHZ_ORIG_SYSTEMS_Bである必要があります。 |
次のいずれかを指定します :
|
不要 |
|
PartySourceSystemReferenceValue |
元のソース・システムでのパーティのソース・システム参照を指定 |
検証なし |
次のいずれかを指定します :
|
不要 |
|
SourceSystem |
オリジナル・ソース・システム名を指定します。 |
ステータスがAのHZ_ORIG_SYSTEMS_Bである必要があります。 |
有効な値を指定してください。 |
不要 |
|
SourceSystemReferenceValue |
元のソース・システムの識別子を指定 |
検証なし |
有効な値を指定してください。 |
不要 |
|
ContactPointId |
システム生成の一意の識別子。 これは主キーです。 |
検証なし |
不要 |
既存の担当者をエクスポートできる場合は、この主キーを指定して、更新するレコードを識別します。 |
|
ステータス |
担当者のステータス。 |
不要 作成時のデフォルトはYです。 |
不要 |
既存のアクティブな担当者レコードを無効にするには、インポート・モードを「レコードの削除」に設定して担当者IDを渡す必要があります。 担当者ソース・システムまたは担当者ソース・システム参照。 |
|
DoContactPreferenceFlag |
担当者、アカウントまたは世帯の担当者でEメールまたは電話を受信する担当者のプリファレンスを追加または更新します。 この属性は、担当者が担当者を選択したかどうかを識別します。 |
この属性とDoNotContactPreferenceFlagの両方を同時にYに設定しないでください。 この属性またはDoNotContactPreferenceFlagを"Y"に設定します。 これらは必須でない値です。 ただし、この属性とDoNotContactPreferenceFlagの両方をNに設定できます。 |
不要 |
不要 |
|
DoNotContactPreferenceFlag |
担当者、アカウントまたは世帯の担当者で電子メールまたは電話を受信しないように、担当者のプリファレンスを追加または更新します。 この属性は、担当者が担当者を選択していないかどうかを識別します。 |
この属性とDoContactPreferenceFlagの両方をYに同時に設定しないでください。 この属性またはDoContactPreferenceFlagを"Y"に設定します。 これらは必須でない値です。 ただし、この属性とDoContactPreferenceFlagの両方をNに設定できます。 |
不要 |
不要 |
|
DoNotContactReason |
担当者、アカウントまたは世帯の担当者で電子メールまたは電話を受信しない理由を追加または更新します。 |
これは、DoNotContactPreferenceFlagに使用されます。 これは必須フィールドではありません。 |
不要 |
不要 |
インポート管理フローの「インポート・オブジェクトの管理」ページで、担当者オブジェクトとそのすべての子オブジェクトおよび属性を表示できます。 タイプ、長さ、説明などの属性情報をこのページで確認できます。
ソースCSVファイルの作成
Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。
「インポート・オブジェクト」UIページで使用可能なテンプレートを使用して、ソースCSVファイルを作成できます。 テンプレートをダウンロードするには:
-
に移動します。
-
表内の「担当者」オブジェクトを選択し、「ダウンロード」をクリックします。
これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。
CSVファイルの移入および値の入力に関する問題を回避するには、「関連トピック」の項でExcelを使用してCSVファイルを開く場合の潜在的な問題に関するトピックを参照してください。
インポート・アクティビティの作成
CSVファイルの準備が完了したら、インポート・アクティビティを作成して情報をインポートします。 インポート・アクティビティを作成するには:
-
に移動します。
-
「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
-
「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストから担当者を選択します。
-
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
-
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。 必要に応じてマッピングをレビューおよび編集します。
-
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
-
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
-
に移動します。
-
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。