HCMデータ・ローダー(HDL)によるビジネス・オブジェクトのインポート

HCMデータ・ローダーを使用してビジネス・オブジェクトをインポートする統合を設計できます。このユースケースでは、概要を説明します。

Oracle HCM Cloud情報を含むFTPサーバーにステージングされたソース・ファイルを読み取るオーケストレートされた統合を作成します。たとえば、ソース・ファイル情報は、Oracle Taleo Enterprise EditionのCSVファイルの新規採用情報で構成できます。
Oracle HCM Cloudから取得したビジネス・オブジェクト・テンプレート・ファイルを使用して、ワーカー区切りデータ・ファイルを生成するステージ・ファイル・アクションを統合に追加します。
1. 「操作の構成」ページで、「ファイルの書込み」操作を選択し、ファイル名としてWorker.datを指定し、出力ディレクトリとしてWorkerOutputを指定します。
  
  「図hdl_stage_file_action.pngの説明」
2. 「スキーマ・オプション」ページで「XMLスキーマ(XSD)ドキュメント」を選択します。ビジネス・オブジェクト・テンプレート・ファイルは次のステップで指定します。
  
  「図hdl_stage_file_action2.pngの説明」
3. 「ブラウズ」をクリックし、Oracle HCM Cloudから取得したビジネス・オブジェクト・テンプレート・ファイルをアップロードします。
4. 「フォーマット定義」ページで、WorkerFileDataスキーマ要素を選択します。これは、区切りデータ・ファイルのメイン要素です。
  
  「図hdl_stage_file_action3.pngの説明」
5. サマリー・ページで、「完了」をクリックしてステージ・ファイル・アクションを保存します。
ソースCSVファイルの要素をビジネス・オブジェクト・テンプレート・ファイルにマップします。マッパーを使用して、ソース・ファイル要素をスキーマに示されているターゲット要素にマップします。
「ソース」ツリーには、このマッピングで使用可能なすべての値およびフィールドが表示されます。「ターゲット」ツリーに書込み階層が表示されます。これは、Worker.datファイルの基本構造を表したものです。
1. 「ターゲット」ツリーのフィールド・ラベルに、対応するヘッダー・タイトルを入力します。たとえば、WorkerLabelの親の下では、EffectiveStartDateLabelの値はEffectiveStartDateです。これらの値は、生成された最終DATファイル内のヘッダー列に対応します。
2. 「ターゲット」ツリーのデータ・セクションでは、「ソース」ツリーから値をマップするか、デフォルト値を入力します。
3. 繰返し要素のrecordName値を親固有のセクション値の繰返し要素にマップします。この例では、NewHiresに、「作業員」、PersonLegislativeData、PersonNameなどの親データ・セクションとのマッピングが必要です。
  
  「図hdl_mapping.pngの説明」
「ZIPファイル」操作を使用して別のステージ・ファイル・アクションを作成し、「HDLジョブの発行」操作に送信するZIPファイルを生成します。
アダプタ・エンドポイント構成ウィザードで、「HCMデータ・ローダー・ジョブの発行」操作を使用するように「Oracle HCM Cloudアダプタ」を構成します。
1. 「HCMデータ・ローダー(HDL)を使用したバルク・データのインポート」アクションを選択します。
  
  「図hdl_adapter_wizard.pngの説明」
2. 「HCMデータ・ローダー・ジョブの発行」操作を選択します。
  
  「図hdl_adapter_wizard2.pngの説明」
3. Oracle HDLジョブを発行するためのセキュリティ・グループおよびドキュメント・アカウント構成パラメータを選択します。
  
  「図hdl_adapter_wizard3.pngの説明」
4. ファイル参照をマップします。 importAndLoad操作に追加のパラメータを送信する場合は、「パラメータ」要素を使用します。
  
  「図hdl_mapping2.pngの説明」
アダプタ・エンドポイント構成ウィザードで、「HCMデータ・ローダー・ジョブ(HDL)のステータスの問合せ」操作を使用するための別の「Oracle HCM Cloudアダプタ」を構成します。このアクションは、HDLジョブ・ステータスが開始済または必要なその他のステータスとして識別されるまで、ループ内で実行できます。
1. 「HCMデータ・ローダー・ジョブ(HDL)のステータスの問合せ」を選択します。
  
  「図hdl_adapter_wizard4.pngの説明」
2. 「プロセスID」を「getStatusリクエスト(Oracle HCM Cloud)」>「プロセスID」にマップします。
  
  「図hdl_mapping3.pngの説明」

「HCMデータ・ローダー・ジョブ(HDL)のステータスの問合せ」操作からのレスポンスをマップします。

Oracle Integrationは、様々な状態(ジョブ、ロード、インポート状態など)にステータス情報を含めることで、ジョブ・ステータスを広範囲に可視化します。ビジネス要件に従ってジョブのステータスを比較します。全体的なステータスは、次のいずれかの値になります:

ステータス	意味	コメント
NOT STARTED	プロセスはまだ開始されていません。待機中または準備ができています。	この値が返された場合は、しばらく待ってから再度ポーリングします。
DATA_SET_UNPROCESSED	プロセスは実行中ですが、データ・セットはまだ処理されていません。	この値が返された場合は、しばらく待ってから再度ポーリングします。
IN_PROGRESS	プロセスは実行中です。	この値が返された場合は、しばらく待ってから再度ポーリングします。
COMPLETED	データ・セットは正常に完了しました。	ジョブが完了しました。出力をフェッチできます。
CANCELLED	データ・セット・ロードまたはデータ・セット・インポートが取り消されました。	ジョブが取り消されました。