データ・ロードの自動化の概要
HCMデータ・ローダー・プロセスを自動化して、Oracle HCM Cloudにデータをロードし、ステータスおよびエラー情報を抽出できます。 このトピックでは、自動化プロセスについて説明します。
自動化できるプロセスは次のとおりです。
-
.zipおよび.csvファイルのOracle WebCenter Contentサーバーへの配信
-
WebCenterコンテンツ・サーバー上のファイルを処理するためのHCMデータ・ローダーまたはHCMスプレッドシート・データ・ローダーの開始
-
「HCMデータ・ローダー・データ・セット要約」抽出の開始およびその出力の取得
追加の手順は、My Oracle Supportの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 | データ・セット内のビジネス・オブジェクトのロードまたはロールバックを送信します。 |
HDL RESTリソースへのアクセス権の付与
| ロール名 | ロール・コード |
|---|---|
| RESTサービスの使用 - データ・ロード・データセット | ORA_HRC_REST_SERVICE_ACCESS_DATA_LOAD_DATA_SETS |
Oracle WebCenterにファイルをアップロードするには、HCMデータ・ローダー・インポート・アカウントへのアクセス権も必要です。 このロールを割り当てます:
| ロール名 | ロール・コード |
|---|---|
| 人材管理ファイル・ベース・インポートのデータのアップロード | HCM_DATALOADER_IMPORT_RWD |
誰がデータ・セットを作成したかに関係なく、プロセスを開始してすべてのデータ・セットをモニターするためのアクセスを可能にするには、次のロール階層が必要です:
| ロール名 | ロール・コード |
|---|---|
| データ・ロード・データ・セットRESTサービスを使用したすべてのデータ・セットのロード | ORA_HRC_LOAD_ALL_DATA_SETS_USING_REST |
HCMデータ・ローダーへのアクセスの構成チュートリアルにリストされているステップを使用して、HCMデータ・ローダーREST APIへのアクセスを設定します。
REST APIカスタム・アクションを実行するには、「HCMデータ・ローダーREST APIの使用」チュートリアルを参照してください。
「HCMデータ・ローダー・データ・セット要約」抽出の自動開始
HCM抽出は、レポートおよびアウトバウンド統合のためのツールです。 HCM抽出を統合済プロセスの一部として使用する場合は、自動化フローから自動的に開始できます。 給与フロー・エンジンは、この目的に使用する汎用処理エンジンです。
事前定義済の「HCMデータ・ローダー・データ・セット要約」抽出のコピーを保存する場合は、タイプ「抽出」の給与フローも作成します。 この給与フローは、FlowActionsServiceを使用して開始でき、これを使用して抽出を自動化および監視します。 抽出出力をダウンロードするには、payrollProcessingActionService.fetchExtractOutputメソッドを使用します。 この抽出がBIテンプレートに関連付けられている場合は、給与フローにより、BIレポートが生成され、BIサーバーに書き込まれます。