取込みジョブの作成

ビデオをみて、さらに学習します。

次のステップに従って、Oracle Unityデータ・モデルにデータをインポートします。

データを正常にインポートできるように、ソース・ファイルおよび取込みジョブの正しいフォーマットについてさらに学習します。

  • Oracle UnityCSVファイル標準およびサポートされるCSVパーサーをレビューして、ソース・ファイルが正しくフォーマットされていることを確認します。

  • Oracle Unityデータ・モデルの空またはnullデータのインポート方法および空/nullデータの制限事項を確認してください。

取込みジョブの作成

取込みジョブを作成するには:

  1. 右下隅にあるOracleアイコンアプリケーション・ナビゲーション・ボタンのイメージ。Oracle Unityの様々な部分へのアクセスに使用します。をクリックして、ナビゲーション・メニューを開きます。
  2. 「データ・フィード」を選択します。
  3. 右上隅の「データ・フィードの作成」をクリックし、「取込みジョブ」を選択します。

「取込みジョブの作成」ページが表示されます。

ノート: ページ上の様々なセクションを開いたり閉じたりするには、矢印矢印ボタンのイメージ。ページ上のセクションを開いたり閉じたりする場合に使用します。またはセクション見出しの任意の場所をクリックします。

ステップ1: ジョブ詳細の定義

ジョブ詳細セクションでは、Oracle Unityで取込みジョブを表示する方法を定義できます。また、Oracle Unityで使用するデータのソースも選択する必要があります。

ジョブ詳細を定義するには:

  1. 取込みジョブの詳細を入力します。
    • 名前: 名前を入力します。名前は1文字以上50文字以内である必要があります。アンダースコア(_)とハイフン(-)以外の特殊文字は使用できません。先頭の文字にスペースは使用できません。言語設定でサポートされているすべての言語の文字を使用できます。
    • ジョブID: ジョブの一意のシステム識別子。ジョブを作成した後はこの値を変更できません。

      • ジョブ名に英字が使用されている場合、「ジョブID」フィールドには、ユーザーが入力したジョブ名が自動入力されます。この値は、ジョブを作成する前に変更できます。
      • ジョブ名に言語設定でサポートされている別の言語の文字が使用されている場合、「ジョブID」フィールドは空白のままになります。英字を使用して名前を入力する必要があります。
    • 摘要: 摘要を入力します。このフィールドはオプションですが、作成するすべてのエンティティに対して摘要を追加することをお薦めします。これは、他のユーザーがOracle Unityを使用したり操作するときに、追加の情報を得るのに役立ちます。説明には最大512文字を使用でき、使用する文字に制限はありません。言語設定でサポートされているすべての言語の文字を使用できます。
    • ソース: これは、Oracle Unityに取り込むデータのソースです。ドロップダウン・リストを使用して、作成されたすべてのソースを表示して選択します。ソースを選択すると、ソースの詳細が表示されます。詳細を確認し、これらが正確で最新であることを確認します。また、新しいソースを作成するには、「ソースの作成」をクリックします。ソースの作成についてさらに学習します。
  2. 詳細が正しく構成されていることを確認したら、「続行」をクリックします。

ジョブ詳細セクションのイメージ

ステップ2: フィールド・マッピング

フィールド・マッピングでは、ソース・ファイルのフィールドをデータ・モデルの属性にマップする方法を定義できます。

取込みジョブのフィールド・マッピングをロードした後、次の手順を実行する必要があります。

  • 構成を確認し、必要に応じて変更します。
  • Oracle Unityに取り込まれるデータをフォーマットする方法を定義します。

選択したソース・タイプに基づいて、宛先の特定の詳細を入力する必要があります。

フィールド・マッピングのロード

自動または手動のどちらのフィールド・マッピングを使用するかを選択します。

自動化フィールド・マッピング

手動フィールド・マッピング

手動フィールド・マッピングを設定するには、次の手順を実行する必要があります。

  • ソース・オブジェクトの作成
  • ソース・フィールドのサンプル・ファイルの追加

ソース・オブジェクトを作成するには:

  1. 「手動」の下の「ソース・オブジェクトの作成」をクリックします。
  2. 「ソース・オブジェクトの作成」ボタンのイメージ

  3. ソース・オブジェクトの名前を入力します。名前は1文字以上50文字以内である必要があります。アンダースコア(_)とハイフン(-)以外の特殊文字は使用できません。先頭の文字は有効な英字である必要があります。言語設定でサポートされているすべての言語の文字を使用できます。
  4. 「ソース・オブジェクトの追加」ダイアログのイメージ

    重要: ソース・オブジェクトに指定する名前によって、ジョブの実行時に処理されるファイルが決まります。たとえば、住所データをインポートするには、ソース・オブジェクト名に"address"を含めて、ファイル名に"address"が含まれるすべてのファイルがインポート対象として識別されるようにします。ソースの構成時に「自動」ファイル名パターンを選択すると、Oracle Unityはソース・オブジェクト名を使用してファイル名パターンを作成します。Oracle Unityでは、ファイルの照合およびインポート時に、圧縮されたファイルと、接頭辞または接尾辞が付いたファイルが含まれます。定義するソース・オブジェクト名では大/小文字が区別されることに注意してください。

必要に応じて、ソース・オブジェクトを編集または削除できます。ソース・オブジェクトを削除すると、ソース・オブジェクトに対して構成されたすべてのフィールド・マッピングも削除されます。

ソース・オブジェクトを編集または削除するには:

  1. ソース・オブジェクト名の横にある「アクション」メニュー(アクション・メニュー・ボタンのイメージカスタム・データ・オブジェクトを編集する場合に使用します。)をクリックします。
  2. ソース・オブジェクトのアクション・メニューのイメージ

  3. 「編集」または「削除」を選択します。

手動フィールド・マッピングを完了するには、次の要件を満たすサンプル・ファイルを準備します。

  • サンプル・ファイルはCSVまたはTXT形式です。
  • ソース・ファイルのカスタム正規表現で定義されている区切り文字は、サンプル・ファイルの区切り文字と一致します。
  • サンプル・ファイルは100MB未満です。

サンプル・ファイルを追加するには:

  1. サンプル・ファイルをサンプル・ファイル・セクションにドラッグするか、「参照」をクリックしてコンピュータ上のファイルを選択します。サンプル値をフィールドに追加することもできます。
  2. サンプル・ファイルを追加する場所を示すイメージ

  3. 「マッピングの開始」をクリックします。
  4. サンプル・ファイルを追加したら、「マッピングの開始」をクリックします。

  5. 次のステップに従って、ソース・オブジェクト・フィールドとデータ・モデル属性のマッピングを開始します。

ソース・オブジェクト・フィールドとデータ・モデル属性のマッピング

ノート: フィールド・マッピングの非表示のデータ・オブジェクトおよび属性にアクセスしたり、検索することはできません。取込みジョブの非表示データ・モデル・アイテムについてさらに学習します。

ソース・オブジェクト・フィールドをデータ・モデル属性にマップするには:

  1. マップされたソース・フィールドごとに、「編集」編集ボタンのイメージ。取込みジョブのフィールド・マッピングを完了する場合に使用します。 をクリックして、データ・モデルの属性の追加を開始します。
  2. 鉛筆アイコンをクリックして属性の追加を開始します

  3. 追加する際に推奨属性のリストが表示される場合があります。検索フィールドを使用して、追加する属性を検索することもできます。データ・オブジェクト名、属性名または属性説明で検索できます。
  4. 推奨属性および検索フィールドを示すイメージ

  5. 現在データ・モデルの一部ではない属性を追加する必要がある場合は、「属性の作成」をクリックします。作成する属性は、取込みジョブの実行前に公開する必要があります。「未公開属性の表示」チェック・ボックスを選択すると、公開する必要がある属性を確認できます。属性の作成および変更の公開についてさらに学習します。
  6. 「属性の作成」ボタンおよび未公開属性を表示するためのチェック・ボックスを示すイメージ

  7. 属性を追加するには、チェックマークチェックマーク・ボタンのイメージ。取込みジョブのフィールド・マッピングを確認する場合に使用します。をクリックします。
  8. 属性に変換を追加するには、「変換」をクリックします。
  9. データ変換リンクを示すイメージ

    使用可能な様々な変換についてさらに学習します。

  10. 別のソース・オブジェクトをマップに追加するには、「ソース・オブジェクトの追加」をクリックします。

フィールド・マッピングの構成に関する重要な注意事項

  • 1つのソース・フィールドを1つ以上のデータ・モデル属性にマップできます。逆に、1つ以上のソース・フィールドを1つのデータ・モデル属性にマップすることもできます。複数のソース・フィールドを1つのデータ・モデル属性にマップする場合は、Oracle Unityでその1つのデータ・モデル属性に複数の値を格納するようにします。このため、Oracle Unityでこれらの複数の値を正しく結合できるように、適切な変換を選択する必要があります。

  • マッピングで使用されるデータ・オブジェクトの中に、そのソースが入力フィールドにマップされていないものがある場合は、通知が表示されます。すべてのソース・データ・オブジェクトIDをマップすると、システムに保存する前に重複データが確実に削除されます。フィールド・マッピングを完了する前に、「ソース・データ・オブジェクトIDがマップされていません」通知を確認してください。通知では、マップされていない各データ・オブジェクトが色で識別されます。
  •  マップされていないソース・データ・オブジェクトIDの通知を示すイメージ

    • 赤い円は、マップされていないソース・データ・オブジェクトID (SourceXID属性) により、取込みジョブが正常に完了しても、取込みジョブでデータが正常にインポートされないことを示します。これは、データ・オブジェクトの「受信レコード・フラグ」「いいえ」(insertOnlyパラメータがfalse)に設定されているためです。受信レコード・フラグについてさらに学習します。
    • : Customerデータ・オブジェクトのFirst name属性をサンプル・ファイルのFirstNameソース・フィールドにマップします。データを正常にインポートできるように、Customerデータ・オブジェクトの対応するSourceCustomerID属性をサンプル・ファイルのソース・フィールドにマップする必要もあります。これは、Customerデータ・オブジェクトの「受信レコード・フラグ」「いいえ」に設定されているためです。

    • 黄色の円は、ソース・データ・オブジェクトID (SourceXID属性)がマップされていませんが、取込みジョブでデータが正常にインポートされることを示します。これは、データ・オブジェクトの「受信レコード・フラグ」「はい」(insertOnlyパラメータがtrue)に設定されているためです。SourceXID属性がマップされていない場合、データがインポートされると、Oracle UnityによってSourceXID属性に一意の識別子が自動的に追加されます。受信レコード・フラグについてさらに学習します。
    • : Eventデータ・オブジェクトのOrder Total属性をサンプル・ファイルのOrderTotalソース・フィールドにマップしますが、SourceEventID属性はソース・フィールドにマップしません。ソース・データ・オブジェクトIDがマップされていないという警告が表示されますが、取込みジョブでデータを正常にインポートできます。これは、Eventデータ・オブジェクトの「受信レコード・フラグ」「はい」に設定されているためです。

ソース・フィールドの管理

既存の取込みジョブのフィールド・マッピングを更新する必要がある場合は、新しいソース・フィールドを作成できます。既存のソース・フィールドのリストを検索するには、「ソース・フィールド」の横にある「検索」検索ボタンのイメージ。データ・オブジェクトを検索する場合に使用します。をクリックします。

フィールドの名前を更新したり、取込みジョブに不要になったフィールドを削除する必要がある場合は、既存のソース・フィールドを編集および削除することもできます。ソース・フィールドを削除すると、そのフィールドに構成したフィールド・マッピングも削除されます。

新しいソース・フィールドを作成するには:

  1. 「ソース・フィールド」の横にある「追加」追加ボタンのイメージ。これを使用して新しいソース・フィールドを作成します。をクリックします。
  2. ソース・フィールドの追加アイコンのイメージ

  3. ソース・フィールドの名前を入力します。言語設定でサポートされているすべての言語の文字を使用できます。
  4. チェックマークチェックマーク・ボタンのイメージ。これを使用して新しいソース・フィールドを確認します。をクリックします。
  5. チェックマークをクリックしてソース・フィールドを追加します

  6. 必要に応じて、ソース・フィールドをデータ・モデル属性にマップして更新します。

ソース・フィールドを編集するには:

  1. 更新するソース・フィールド名にマウスのポインタを重ね、「編集」編集アイコンのイメージをクリックします。
  2. 新しいソース・フィールド名を入力し、チェックマークチェックマーク・アイコンのイメージをクリックします。言語設定でサポートされているすべての言語の文字を使用できます。

ソース・フィールドを削除するには:

  1. 削除するソース・フィールド名にマウスのポインタを重ね、「削除」削除アイコンのイメージをクリックします。
  2. 確認メッセージを確認し、「はい」をクリックします。

ステップ3: スケジュールと通知

取込みジョブのスケジュールと通知設定を構成する必要があります。

「スケジュールと通知」セクションのイメージ

取込みジョブをスケジュールして、通知設定を定義するには:

  1. 取込みジョブのスケジュールを構成します。
    • 定期的にジョブを自動的に実行する場合は、「繰返し」をクリックします。次のジョブの実行がスケジュールされているのに、あるジョブがまだ実行されている場合、現在のジョブが完了するまで次のスケジュール済実行は開始しません。同じ取込みジョブの2つのスケジュール済インスタンスは同時に実行できません。
    • 必要に応じてジョブを実行する場合は、「オンデマンド」をクリックします。
  2. ジョブが繰返しの場合は、実行する「頻度」「開始時間」および「日」を選択します。
  3. 「通知」フィールドに、ジョブの実行時に通知を受け取る個人のEメール・アドレスを入力します。言語設定でサポートされているすべての言語の文字を使用できます。複数のEメールを指定する場合は、カンマで区切ります。
  4. 通知Eメールの取込みジョブのメトリックは概算であり、必ずしも100%正確ではないことに注意してください。

  5. ジョブが失敗した場合にのみ通知が必要な場合は、「失敗時のみ通知」チェック・ボックスを選択します。

ステップ4: 取込みジョブの保存と公開

取込みジョブを保存したら、実行する前に変更を公開する必要があります。

取込みジョブを保存および公開するには:

  1. ページ上部にスクロールして、「保存」または「保存してクローズ」をクリックします。
  2. 変更の公開のステップに従います。

公開タスクが完了すると、取込みジョブを実行できます。取込みジョブの管理についてさらに学習します。

さらに学ぶ

取込みジョブの管理

エクスポート・ジョブの作成

エクスポート・ジョブの管理

データ・フィードの管理

ジョブ・ダッシュボードの管理

属性の作成

ジョブの順序付け

変更の公開

取込み, 取込みジョブ, 取込みジョブの作成, ソース, インポート, インポート・ジョブ, インポート・ジョブの作成, データのインポート, データの取込み