データをインポートする方法を教えてください。
テキスト・ファイルからデータをインポートするには、「ツール」作業領域の「インポート管理」を使用します。 このトピックは、データをインポートするためのガイドです。 インポートによって、レコードを作成、更新または削除できます。
インポート・オプションとその他の詳細は、インポートするデータのタイプによって異なります。 インポートする前に、ファイル内のデータがOracle Applications Cloudの属性にどのようにマップされるか、およびインポート・ファイルにどのような値が想定されるかを理解してください。 CSVソース・ファイル内のデータ・レコードは、リストされた順序で処理されない場合があります。 インポートのステータスをモニターする方法を学習するには、「関連トピック」セクションの「インポート・アクティビティのモニター方法」のトピックを参照してください。
関連トピックに示されているサンプルのインポート・オブジェクト・テンプレートを使用すると、すぐに始めることができます。
ファイルからのデータのインポート
データをインポートするには:
-
をクリックします。
-
「インポートの管理」ページで、「インポート・アクティビティの作成」ボタンをクリックします。
-
「インポート・オプションの入力」ページで、次の表に示すように各フィールドの値を指定します。
フィールド
値の説明
Name
インポートの名前。
オブジェクト
インポートするオブジェクト。
オブジェクトが見つからない場合は、「検索」リンクをクリックして検索します。 「検索と選択」ダイアログ・ボックスで、「オブジェクト」テキスト・ボックスにオブジェクト名を入力し、「検索」ボタンをクリックします。 結果リストからオブジェクトを選択し、「OK」をクリックします。
「拡張」ボタンをクリックして、拡張検索オプションを使用することもできます。 ここでは、オブジェクト名、サポートされている添付、作成日などの様々なフィルタ基準に基づいて検索できます。
インポートするオブジェクトがリストされていない場合は、オブジェクトのインポートに必要なロールおよび権限があるかどうかを確認してください。 ロールの詳細は、「関連トピック」の項で参照されている「インポートおよびエクスポート管理に必要なロール」のトピックを参照してください。
添付オブジェクト
データベース内の既存のオブジェクト・レコードの添付をインポートするには、「オブジェクト」ドロップダウン・リストから添付オブジェクトを選択します。 次に、添付オブジェクト・ドロップダウン・リストからオブジェクトを選択します。
添付のインポートの詳細は、「添付のインポート」のトピックを参照してください。
ファイル名
CSV形式のテキスト・ファイルを参照して選択します。 ソース・ファイルの最初の行はヘッダー行として扱われます。 40文字以内のファイル名を指定してください。
ノート: ソース・ファイルが50,000レコードを超える場合は、それぞれ50,000レコード未満の複数の小さいファイルに手動で分割する必要があります。 ファイル・インポート・ページでは、インポート・ジョブごとに50,000レコードのみが許可されます。 または、50,000レコードを超えるファイルを受け入れることができるExternal Cloud Data Loader Clientを使用することもできます。 このツールの詳細は、My Oracle Support (support.oracle.com)のドキュメント『External Data Loader Client』(ドキュメントID 2325249.1)を参照してください。オブジェクト階層のインポート
子オブジェクトや孫オブジェクトなどのオブジェクトの階層をインポートするには、親オブジェクトのソース・ファイルをアップロードした後、「オブジェクト階層のインポート」リンクをクリックします。 次に、インポートする子オブジェクトの「使用可能」チェック・ボックスを選択し、関連するソース・ファイルを選択します。
-
必要に応じて追加のインポート構成を設定する場合は、「拡張オプション」セクションをクリックします。 ここでは、「ソース・ファイル」、「インポート・オプション」または「スケジュールの作成」セクションで設定を構成できます。
-
「ソース・ファイル」および「インポート・オプション」領域では、インポートするオブジェクトによって次の表のオプションのいくつかを使用できない場合があります。
オプション
摘要
インポート・モード
レコードを作成および更新するか、または更新のみを行うかを指定できます。
-
レコードの更新および作成 - 一致するレコードが見つからない場合は、新規レコードが作成されます。 これはデフォルト・オプションです。
-
レコードの作成: ファイル内のすべてのレコードは作成する必要がある新規レコードです。 一致する既存のレコードがある場合、それらのレコードはエラーとしてマークされます。
-
レコードの削除: ファイル内のすべてのレコードは削除されます。
大量インポート使用可能
大量インポート・モードは、何百万ものレコードを一度にインポートするように設計されています。 このモードでは、アプリケーション・コンポーザを使用して構成されたカスタム・ロジックはトリガーされません。 サポートされているオブジェクトのリストは、「データ・インポート・オプション」のトピックを参照してください。
デフォルトでは、サポートされているオブジェクトに対して、このモードが有効になります。ノート: ZCA_FILE_IMPORT_ENABLE_CUSTOM_BUSINESS_LOGICが「はい」に設定されている場合、大量インポートは使用できません。生存使用可能
更新時の存続は、アカウント、組織、担当者および個人に使用できます。 オブジェクトに対して属性生存が構成されている場合、このチェック・ボックスが表示されます。 大量インポート・モードを使用できるのは、生存構成でソース確度のみを使用している場合のみです。 データ品質ルールが有効な場合、大量インポート・モードは使用できません。
通知Eメール
インポート処理通知を受け取る個人のEメール。 インポートを発行するユーザーはEメール通知を自動的に受け取ります。 複数のEメール受信者を設定する場合は、Eメール・アドレスをセミコロンで区切ります。 通知を受け取らない場合は、ユーザー・レベルでプロファイル・オプションORA_ZCA_IMPEXP_ENABLE_EMAIL_NOTIFYを「N」に設定します。
カスタム・ビジネス・ロジック使用可能
このチェック・ボックスを選択すると、オブジェクトに構成されているカスタムのトリガーおよび検証が有効になります。 これは、構成のため、インポートのパフォーマンスに影響する場合があります。 したがって、パフォーマンス向上のためにこのオプションを無効にします。
このチェック・ボックスをデフォルトで有効にするには、「管理者プロファイル値の管理」タスクに移動して、プロファイル・オプションZCA_FILE_IMPORT_ENABLE_CUSTOM_BUSINESS_LOGICを「はい」に設定します。ノート: ZCA_FILE_IMPORT_ENABLE_CUSTOM_BUSINESS_LOGICが「はい」に設定されている場合、大量インポートは使用できません。ノート: この選択は、イベントおよびオブジェクト・ワークフローには影響せず、トリガーと検証にのみ該当します。デリミタ
ファイルで値の区切りにカンマを使用しない場合は、「デリミタ」ドロップダウン・リストで適切なデリミタを選択します。 可能な値は次のとおりです。
-
カレット記号
-
右中カッコ
-
右カッコ
-
右大カッコ
-
コロン
-
カンマ
-
感嘆符
-
マイナス
-
左中カッコ
-
左カッコ
-
左大カッコ
-
パイプ記号
-
プラス
-
疑問符
-
セミコロン
-
星記号
-
チルド記号
小数点記号
インポート・ファイルに使用されている小数点記号。
日付書式
ファイルの日付フィールドの書式。
タイムスタンプ書式
ファイルの時刻フィールドの書式。
ファイル・エンコーディング
ソース・ファイルがエンコードされている形式。 有効な値は次のとおりです。- 簡体字中国語 - GB、CP936
- 繁体字中国語 - CP950
- 東ヨーロッパ言語 - Win、CP1250
- ギリシャ語 - MS Windows、CP932
- 日本語 - Shift- JIS、CP932
- Unicode - UTF-16
- Unicode- UTF-16BE、Mac、Unix
- Unicode - UTF-16LE、MS Windows
- Unicode - UTF-8
- 西ヨーロッパ言語 - Win、CP1252ノート:前述のエンコーディング形式のみがサポートされています。 ANSIなどの他の形式のファイルをインポートすると、予期しない文字がインポートされます。
-
-
「スケジュールの作成」領域で、インポートを即時実行または後日実行にスケジュールします。 将来の日付を選択した場合は、インポートを開始する日付と時刻を指定します。
UIの「拡張オプションの保存」リンクをクリックして、後で再利用できるように拡張オプションを保存できます。 「リセット」リンクをクリックし、オプションをアプリケーションのデフォルトにリセットするまで、オプションは保持されます。
ノート: 「インポート・モード」、「カスタム・ビジネス・ロジック使用可能」、「大量インポート使用可能」、「生存ロジック使用可能」、「スケジュール・モード」および「スケジュール開始時間」以外のフィールドはすべて保存されます。 -
-
「次」をクリックします。 「フィールドのマップ」ページに、ソース・ファイルのデータの最初の行が表示されます。 デフォルトでは、各ソース・ファイル列を適切なターゲット・オブジェクト属性に自動的にマップすることが試みられます。 ファイル内のいくつかの列がマップされない場合は、「ソース・ファイル」領域で「属性表示名」列にターゲット属性をドラッグします。
マップされていない列のデータはインポートされません。
インポート・マップを保存するには、「インポート・アクティビティの作成」ページで「別名保存」をクリックします。 保存したマップを将来のインポートに使用できます。 保存したマップを表示するには、「インポート・アクティビティの作成」ページの「インポート・マッピング」ドロップダウンをクリックします。
また、「インポート・オブジェクト」ページで、特定のオブジェクトの保存済マップを選択して編集できます。
-
「インポート・マッピング」ドロップダウン・リストで使用可能なマッピングのリストから、事前定義済マッピングを選択します。 インポート・マッピングを再使用する場合は、ソース列とターゲット列の両方に、すでに値が移入されています。
インポートしない列の「属性表示名」フィールドは、空白のままにします。
フィールド・マッピングをチェックするには、「データの検証」をクリックします。
-
階層インポートの場合、後続のタブで子オブジェクトのマッピング情報を参照できます。 これらのオブジェクトに対してはデータ検証は行われません。
-
「次」をクリックします。 「レビューおよび発行」ページで、インポート・アクティビティ構成をレビューします。 「フィールドのマップ」ページで事前検証を実行しなかった場合は、検証プロセスを実行するよう通知メッセージが表示されます。 このページでは、親オブジェクトまたは子オブジェクトのマップされていない列を表示できます。
-
「データの検証」をクリックして、ソース・ファイルのデータをチェックします。 検証エラーがある場合は、「マッピング検証」画面に表示されます。 マップされていない列に関する警告が表示された場合は、それらの列を無視し、インポートの発行ジョブを続行できます。 検証は情報提供を目的としており、少量のインポートにのみ適用されます。
ノート: 単一のCSV階層レコードを含むインポート・アクティビティでは、マッピングUIからの明示的な検証はサポートされていません。 たとえば、営業テリトリ・オブジェクトのインポート時に、属性ParentUniqueTerritoryNumberおよびUniqueTerritoryNumberに一致する値がある場合、検証はサポートされません。ノート: 「マッピング」ページでのインポート検証プロセス中に、次のカスタム・トリガーはサポートされていません。- InValidateより前
- 削除前
- データベースでの挿入の前
- データベースでの更新の前
- データベースでの削除の前
- データベースでのロールバック前
- データベースへの変更のポストの後
-
「発行」をクリックしてインポートをキューに入れます。
ビジネス・イベントは、インポート管理を使用するときには起動されないことに注意してください。
インポート・ジョブの自動化およびスケジューリング
インポートRESTサービスを使用して、インポート・ジョブを自動化できます。 インポートRESTサービスを使用すると、インポート・アクティビティの管理、アクティビティ・マップの管理およびオブジェクト・メタデータのエクスポートを行うことができます。 これらのRESTサービスを使用する外部スケジューラを使用して、繰返しインポート・ジョブの実行、インポート・アクティビティの作成と実行、マップの管理およびオブジェクト・メタデータの確認を行うことができます。
Oracle WebCenter Content文書転送ユーティリティを使用して、スケジューラで使用されるインポート・ファイルを管理できます。 Oracle WebCenter Content文書転送ユーティリティをダウンロードするには、My Oracle Support (support.oracle.com)ドキュメント、Oracle WebCenter Content文書転送ユーティリティReadme (ドキュメントID 1624063.1)に移動します。 ダウンロード後は、抽出後にridcフォルダに移動することでツールを実行できます。
REST APIを使用したファイル・インポートの自動化とスケジューリングの詳細な手順は、My Oracle Support (support.oracle.com)のOracle CX Sales and Fusion Service: REST APIを使用したファイル・インポート・アクティビティの自動化およびスケジューリング(ドキュメントID 2308691.1)の記事を参照してください。
リソースのイベント通知の設定
ファイル・ベース・データ・インポートでは、SendCredentialsEmailFlag
属性により、インポートで各従業員リソースの通知設定を指定できました。 これは、インポート管理で「ユーザー・カテゴリ」オプションを使用して実行できますが、これは単一のインポートのすべてのリソースに適用されます。
すべてのイベントの通知を設定するには:
-
ホーム・ページで に移動します。
-
「ユーザー・カテゴリ」タブをクリックします。
-
「DEFAULT」をクリックします。 「通知」タブをクリックします。
-
「編集」ボタンをクリックします。 すべての通知をオンにする場合は、「通知プリファレンス」見出しの下の「通知使用可能」チェック・ボックスを選択します。
-
「保存」ボタンをクリックします。
-
「完了」ボタンをクリックします。
特定のイベントの通知を設定するには:
-
ホーム・ページで に移動します。
-
「ユーザー・カテゴリ」タブをクリックします。
-
「DEFAULT」をクリックします。 「通知」タブをクリックします。
-
「編集」ボタンをクリックします。
-
特定のイベント通知をオンにする場合は、目的のイベントのテンプレートをクリックします。
-
「テンプレート情報」ページで、「有効」チェック・ボックスを選択し、「保存してクローズ」をクリックします。
-
「保存」ボタンをクリックします。
-
「完了」ボタンをクリックします。
FCLおよびDCLのインポート
FCLフィールド値の設定
インポート管理を使用してFCLフィールドを設定するには、参照コードを渡す必要があります。
FCLおよびDCLフィールドをNullに設定
インポート管理を使用してFCLの値を無効化するには、FCLフィールドの#NULL値を渡す必要があります。
次に、TargetGlobalPJDetailFlag1_cフィールドを無効化する例を示します。
PartyId |
TargetGlobalPJDetailFlag1_c |
---|---|
100000001527765 |
#NULL |