1. HCMデータ・ローダー
  2. データ・ロードの自動化の概要
機械翻訳について

データ・ロードの自動化の概要

HCMデータ・ローダー・プロセスを自動化して、Oracle HCM Cloudにデータをロードし、ステータスおよびエラー情報を抽出できます。 このトピックでは、自動化プロセスについて説明します。

自動化できるプロセスは次のとおりです。

  • .zipおよび.csvファイルのOracle WebCenter Contentサーバーへの配信

  • HCMデータ・ローダーまたはHCMスプレッドシート・データ・ローダーによる、WebCenterコンテンツ・サーバーでのファイルの処理および進捗のモニターの開始

  • 「HCMデータ・ローダー・データ・セット要約」抽出の開始およびその出力の取得

その他の手順は、My Oracle SupportのHCMデータ・ローダーの自動化を参照してください:

HCMデータ・ローダーの自動化

Oracle WebCenter Contentへのファイルの自動提供

WebCenter Contentサーバーへの.zipファイルの提供を自動化するには、次を使用できます。

  • WebCenter Content文書転送ユーティリティ。コンテンツのインポートおよびエクスポート機能を提供する、機能豊富なJavaライブラリです

  • WebCenter Content汎用SOAP Webサービス。これにより、ファイル・アップロードなどの様々な操作をサポートするSOAP Webサービス・インタフェース(GenericSoapPort)が公開されます

  • dataLoadDataSets RESTリソースは、小さいBase64エンコード・ファイルをアップロードするためのuploadFileメソッドを提供します。

SOAPを使用したHCMデータ・ローダーの開始

HCMデータ・ローダーを自動的に開始して、HCMデータ・ローダー統合SOAPサービスを使用してOracle WebCenter Contentサーバー上の複数のファイルを処理できます。 このWebサービスでは、次の表に示す2つのメソッドを提供しています。

方法

摘要

importAndLoadData

データ・ファイルの処理を開始します

getDataSetStatus

データ・ファイルの現在のステータスを返します

Webサービスを実行する方法は複数あります。 たとえば、生成されたプロキシ・クラスを使用できます。

HCMデータ・ローダー統合Webサービスの使用方法の詳細は、HCMデータ・ローダー統合Webサービスを参照してください。

REST APIを使用したHCMデータ・ローダーおよびHCMスプレッドシート・データ・ローダーの開始

dataLoadDataSets RESTリソースを使用してHCMデータ・ローダーおよびHCMスプレッドシート・データ・ローダー統合を自動化し、ファイルをOracle WebCenter ContentサーバーにアップロードしてHDLおよびHSDLを開始し、データ・セットの進捗とステータスをモニターできます。

次の表に、REST APIカスタム・アクションを示します:

処理 メソッド 説明
ファイルのアップロード POST Oracle WebCenter Contentサーバー(UCM)のHDLインポート・ディレクトリにファイルをアップロードします。
ノート: ファイルのBase64エンコーディングにより、uploadFileアクションは小さいファイルのアップロードに適しています。
ファイル・データ・セットの作成 POST UCMにプリロードされたファイルのファイル・ベース・データ・セットを作成し、有効なデータをステージング表にインポートします。 オプションで、有効なオブジェクトをアプリケーションにロードします。
スプレッドシート・データ・セットの作成 POST スプレッドシート・ベースのデータ・セットを作成し、指定されたHSDLテンプレート・コードを使用してUCMファイルを転送し、有効なデータをステージング表にインポートします。 オプションで、有効なオブジェクトをアプリケーションにロードします。
すべてのデータ・セットの取得 GET ステージング表で使用可能なHCMデータ・ローダーおよびHCMスプレッドシート・データ・ローダーのデータ・セットの要約情報を提供します。
個々のデータ・セットの取得 GET 指定されたパラメータ値によって識別されたデータ・セットのステージング表データを要求します。
ビジネス・オブジェクト情報の取得 GET データ・セット内のビジネス・オブジェクトの要約情報を提供します。
データ・セット・メッセージの取得 GET 特定のデータ・セットに対して発生したメッセージの詳細を提供します。
データ・セット・プロセス情報の取得 GET 特定のデータ・セットをアップロードするために送信されたプロセスの詳細を提供します。
実行中のデータ・セットの停止 POST データ・セットの処理を停止するように要求します。
データ・セットに対するロードまたはロールバックの送信 POST データ・セットのロードまたはロールバック処理を送信します。
データ・セットのステージング表データの削除 POST 入力パラメータで識別された非処理データ・セットのステージング表データを削除します。
実行中のデータ・セット・ビジネス・オブジェクトの停止 POST 進行中データ・セットの処理を停止します。
データ・セット内のビジネス・オブジェクトに対するロードまたはロールバックの送信 POST データ・セット内のビジネス・オブジェクトのロードまたはロールバックを送信します。
HCMデータ・ローダーによって送信されたサブプロセスの詳細の取得 GET 特定のHCMデータ・ローダー・データ・セット・プロセスによって送信されたサブプロセスの詳細を提供
データ・セットまたはデータ・セット内の個々のビジネス・オブジェクトの失敗した行ファイルの生成を開始 POST エラーのビジネス・オブジェクトの失敗した行およびMETADATAのファイルを生成するプロセスを送信します。

HDL RESTリソースへのアクセス権の付与

アクセスを有効にして処理を開始し、独自のデータ・セットをモニターするには、次のロール階層が必要です:
ロール名 ロール・コード
RESTサービスの使用 - データ・ロード・データセット ORA_HRC_REST_SERVICE_ACCESS_DATA_LOAD_DATA_SETS

事前割当済のHSDLテンプレートにのみアクセスでき、RESTを介してHDLを開始するためのアクセス権も持つには、次の機能セキュリティ権限を追加する必要があります:

ロール名 ロール・コード
RESTサービスを使用したHCMデータ・ローダー・データ・セットの作成 HRC_CREATE_FILE_DATA_SET_USING_REST_PRIV
ノート:
  • この新しい権限が付与されないかぎり、RESTからHDLを開始するためのアクセス権を付与するカスタム・ロールを作成した顧客は機能しなくなります。
  • HDLビジネス・オブジェクトへのロール・アクセスを有効にして構成し、ロールでデータをアップロードできるビジネス・オブジェクトを制御することをお薦めします。 これを行わないと、createFileDataSetカスタム・アクセス・アクションを持つユーザーは、サポートされているすべてのビジネス・オブジェクトのデータをアップロードできます。

Oracle WebCenterにファイルをアップロードするには、HCMデータ・ローダー・インポート・アカウントへのアクセス権も必要です。 このロールを割り当てます:

ロール名 ロール・コード
人材管理ファイル・ベース・インポートのデータのアップロード HCM_DATALOADER_IMPORT_RWD

誰がデータ・セットを作成したかに関係なく、プロセスを開始してすべてのデータ・セットをモニターするためのアクセスを可能にするには、次のロール階層が必要です:

ロール名 ロール・コード
データ・ロード・データ・セットRESTサービスを使用したすべてのデータ・セットのロード ORA_HRC_LOAD_ALL_DATA_SETS_USING_REST

「HCMデータ・ローダー・データ・セット要約」抽出の自動開始

HCM抽出は、レポートおよびアウトバウンド統合のためのツールです。 HCM抽出を統合済プロセスの一部として使用する場合は、自動化フローから自動的に開始できます。 給与フロー・エンジンは、この目的に使用する汎用処理エンジンです。

事前定義済の「HCMデータ・ローダー・データ・セット要約」抽出のコピーを保存する場合は、タイプ「抽出」の給与フローも作成します。 この給与フローは、抽出の自動化およびモニターに使用するFlowActionsServiceを使用して開始できます。 payrollProcessingActionService.fetchExtractOutputメソッドを使用して、抽出出力をダウンロードします。 この抽出がBIテンプレートに関連付けられている場合は、給与フローにより、BIレポートが生成され、BIサーバーに書き込まれます。

関連トピック