イントロダクション
Cloud HCMは、基盤となる新世代のBOSS/Spectraプラットフォームを使用して、HCMからデータを抽出する機能を提供します。
目的
このチュートリアルを完了すると、次のことが理解できるようになります。
- 就業者抽出ビューとそのオブジェクトの階層の問合せ
- 選択した就業者階層データを取得するための抽出ジョブ要求を非同期に発行および追跡します
- 抽出出力ファイルのダウンロード
前提条件
始める前に:
- Oracle CoEに連絡して、RODSデータ・レプリケーションを含むSpectraプラットフォームがポッドにプロビジョニングされていることを確認してください
- 必要なセキュリティー構成を実施すること。これには、以下が含まれます。
- データ・セキュリティの設定
- OAuthクライアント・アプリケーションの設定
Spectra Servicesを使用したHCMからデータを抽出するためのセキュリティの構成チュートリアルを参照してください。
ユース・ケース
この機能により、次のユースケースに対応できます。
完全データ抽出
就業者データの完全抽出は、1回かぎりのアクティビティでも定期的なアクティビティでもかまいません。
オブジェクト階層全体を取得することも、そのサブセットのみを取得することもできます。
完全データ抽出では、フィルタリング基準に一致するすべてのレコードが取得され、出力ファイルが非常に大きい場合があります。
有効日オブジェクトは要求有効日時点で取得され、現在の抽出日がデフォルトとなります。
増分データ抽出
就業者データの増分抽出は、通常、定期的なスケジュール済アクティビティです。
オブジェクト階層全体を取得することも、そのサブセットのみを取得することもできます。
このユースケースでは、最初の抽出実行がベースラインである前回の抽出実行以降に変更されたオブジェクトのみを取得します。これを実現するには、変更検出の対象となる任意のレベルでtimeUpdated属性フィルタを適用する必要があります。
増分データ抽出問合せでは、追加のフィルタリング基準を適用できます。出力ファイルにはデルタのみが含まれるため、通常、完全抽出と比較すると小さくなります。
属性の現在の値のみが取得されます。
有効日オブジェクトは要求有効日時点で取得され、現在の抽出日がデフォルトとなります。
注意:
物理的に削除されたレコードは、timeUpdatedによるフィルタリングを使用して返されません。
タスク1: 抽出ビューの選択
必要なオブジェクトおよび属性に応じて、使用する抽出ビューを選択します。使用可能なビューと、抽出可能なオブジェクトおよび属性のリストを次に示します。
就業者アサイメント抽出
workerAssignmentExtractsを使用して、就業者の雇用アサイメント・データを抽出します。
| ビュー・パス | workerAssignmentExtracts |
|---|
| オブジェクト | 属性 | リレーションシップ・タイプ |
|---|---|---|
| workerAssignmentExtract |
|
なし |
| workerAssignmentExtract.department |
|
1対1 |
| workerAssignmentExtract.legalEmployer |
|
1対1 |
| workerAssignmentExtract.legislation |
|
1対1 |
| workerAssignmentExtract.position |
|
1対1 |
| workerAssignmentExtract.grade |
|
1対1 |
| workerAssignmentExtract.location |
|
1対1 |
| workerAssignmentExtract.location.mainAddress |
|
1対1 |
| workerAssignmentExtract.location.mainAddress.country |
|
1対1 |
| workerAssignmentExtract.job |
|
1対1 |
| workerAssignmentExtract.job.jobFamily |
|
1対1 |
| workerAssignmentExtract.collectiveAgreement |
|
1対1 |
| workerAssignmentExtract.personType |
|
1対1 |
| workerAssignmentExtract.workerUnion |
|
1対1 |
| workerAssignmentExtract.assignmentUserStatus |
|
1対1 |
| workerAssignmentExtract.businessUnit |
|
1対1 |
| workerAssignmentExtract.account |
|
1対1 |
| workerAssignmentExtract.ledger |
|
1対1 |
| workerAssignmentExtract.workRelationship |
|
1対1 |
| workerAssignmentExtract.localName |
|
1対1 |
| workerAssignmentExtract.globalName |
|
1対1 |
| workerAssignmentExtract.personDetail |
|
1対1 |
就業者国別仕様情報抽出
workerLegislativeInfoExtractを使用して、就業者の国別仕様情報データを抽出します。
| ビュー・パス | ワーカー/$views/workerLegislativeInfoExtract |
|---|
| オブジェクト | 属性 | リレーションシップ・タイプ |
|---|---|---|
| ワーカー |
|
なし |
| worker.personDetail |
|
1対1 |
| worker.legislativeInformation |
|
1対1 |
| worker.legislativeInformation.legislation |
|
1対1 |
就業者名抽出
workerNamesExtractを使用して、就業者の氏名データを抽出します。
| ビュー・パス | ワーカー/$views/workerNamesExtract |
|---|
| オブジェクト | 属性 | リレーションシップ・タイプ |
|---|---|---|
| ワーカー |
|
なし |
| worker.personDetail |
|
1対1 |
| worker.names |
|
1対多 |
| worker.names.legislation |
|
1対1 |
| worker.names.language |
|
1対1 |
就業者電話抽出
workerPhonesExtractを使用して、就業者の電話データを抽出します。
| ビュー・パス | ワーカー/$views/workerPhonesExtract |
|---|
| オブジェクト | 属性 | リレーションシップ・タイプ |
|---|---|---|
| ワーカー |
|
なし |
| worker.personDetail |
|
1対1 |
| worker.phones |
|
1対多 |
| worker.phones.legislation |
|
1対1 |
就業者Eメール抽出
workerEmailsExtractを使用して、就業者のEメール・データを抽出します。
| ビュー・パス | ワーカー/$views/workerEmailsExtract |
|---|
| オブジェクト | 属性 | リレーションシップ・タイプ |
|---|---|---|
| ワーカー |
|
なし |
| worker.personDetail |
|
1対1 |
| worker.emails |
|
1対多 |
複数の言語:
翻訳可能属性は、この時点では英語でのみ使用できます。タスク2: 抽出問合せの準備およびテスト
各抽出ビューには、抽出問合せを作成およびテストできる問合せAPIがあります。
| URL | /api/boss/data/objects/ora/hcmHrCore/employment/v1/{{viewPath}}/$query |
|---|---|
| HTTPメソッド | POST |
| 要求テンプレート |
{
"collection": {
"limit": {{limit}},
"offset": {{offset}},
"sortBy": [ {{sortAttributes}} ],
"filter": "{{topLevelFilter}}"
},
"fields": [ {{topLevelAttributes}} ],
"accessors": {
"{{childObject}}": {
"collection": {
"filter": "{{childLevelFilter}}"
},
"fields": [ {{childLevelAttributes}} ],
"accessors": {
{{nestedChildAccessors}}
}
},
...
}
}
|
| 応答テンプレート |
200 OK
{
"items": [
{{items}}
],
"hasMore": {{hasMore}}
}
|
オブジェクトおよび属性
抽出するデータ(含めるオブジェクトおよび属性)を定義します。子オブジェクトを含めるには、アクセッサを追加する必要がありますが、特定のフィールドを含めるには、fields配列にリストする必要があります。完全な例を参照してください。
フィルタリング
データのフィルタ方法を定義します。次の式を使用して、問合せのフィルタを作成できます。
| 目 的 | 正規表現 | 例 |
|---|---|---|
| 等価性テスト | field = value |
ename = 'KING' |
| 不等式テスト | field != value |
activeFlag != true |
| テストより大きい テストより小さい |
field > value |
sal > 1999.99 |
| より大きいテストまたは等しいテスト より小さいテストまたは等しいテスト |
field >= value |
sal >= 1999.99 |
| パターンマッチング | field LIKE 'pattern' |
job LIKE 'SALES%' |
| メンバーシップ・テスト | field IN (value1, ..., valueN) |
deptno IN (10, 20, 40) |
| 大文字と小文字を区別しない比較 | field ~= value |
ename ~= 'king' |
| 存在テスト(1対多関係の場合) | child[expression] |
assignments[startDate = null] |
| 論理積 | expression AND expression |
|
| 論理和 | expression OR expression |
|
| 論理否定 | !(expression) |
1対1関係での子オブジェクトによるフィルタリング:
1対1の関係の場合、他の親オブジェクトの属性(legalEmployer.id in (1001, 1002)など)と同様に、フィルタ句で子オブジェクトとその属性を参照できます。
1対多関係での子オブジェクトのフィルタリング:
1対多関係の場合、前述の表の存在テストでは、基準を満たす少なくとも1つの子を持つ親がフィルタされます。ただし、子レコードが取得されても、自動的にフィルタされるわけではありません。基準を満たす子レコードのみを取得する場合は、子レベルでもフィルタを繰り返す必要があります。たとえば、W1タイプの電話のみを取得する場合は、次のフィルタを適用する必要があります。
{
"collection": {
"filter": "phones[type = 'W1']"
},
"accessors": {
"phones": {
"collection": {
"filter": "type = 'W1'"
},
...
有効日によるフィルタリング:
有効日オブジェクトの場合、デフォルトで現在の日付時点で有効なデータが取得されます。特定の日付時点で有効なデータを取得するには、$effectiveDate HTTP問合せパラメータを使用します。
たとえば、2023-01-01時点で有効なデータを取得する場合は、問合せに次のURLを使用します。
/api/boss/data/objects/ora/hcmHrCore/employment/v1/{{viewPath}}/$query?$effectiveDate=2023-01-01
ソート
データのソート方法を定義します。ソートは、ソート方向(昇順または降順)を含むソート属性の配列で表されます。たとえば:
"sortBy": [
{
"totalAmount": "desc"
},
{
"paidAmount": "asc"
}
]
ページング
データのページ区切り方法を定義します。クライアントは、制限およびオフセット・パラメータを指定してページングを制御できます。たとえば:
"limit": 200, "offset": 400
デフォルトの制限は25で、最大制限は1000です。
デフォルトのオフセットは0で、結果の先頭を示します。
レスポンスの最上位のhasMore属性は、フェッチする結果がさらにあるかどうかを示します。
ページ区切りは、データを抽出する別の方法として使用しないでください。このAPIを問い合せる場合、リクエスト間でデータが変更されないという保証はありません。データ抽出には非同期APIを使用します。
例
次の抽出問合せの例は、雇用主および部門の詳細とともにアサイメント情報を取得するように設計されています。
- プライマリ・アサイメント
- 従業員タイプ
- IDが
10001および10002の雇用主に属しません - 抽出日時点で有効
- 前回の実行以降に更新(または作成)されました
リクエストの例
前の抽出実行のタイムスタンプを持つlimitパラメータおよびtimeUpdated属性条件に注意してください。
POST /api/boss/data/objects/ora/hcmHrCore/employment/v1/workerAssignmentExtracts/$query
{
"collection": {
"limit": 10,
"filter": "primaryFlag = true and timeUpdated > '2025-05-01T00:00:00Z' and assignmentType = 'E' and !(legalEmployer.id in (10001, 10002))"
},
"fields": [ "id", "assignmentType", "assignmentStatusType", "effectiveStartDate", "effectiveEndDate", "businessTitle", "workAtHomeFlag", "assignmentNumber", "timeUpdated" ],
"accessors": {
"personDetail": {
"fields": [ "personNumber" ]
},
"globalName": {
"fields": [ "firstName", "lastName" ]
},
"department": {
"fields": [ "id", "name", "title" ]
},
"legalEmployer": {
"fields": [ "id", "name" ]
},
"workRelationship": {
"fields": [ "id" ]
}
}
}
レスポンスの例
200 OK
{
"items": [
{
"id": "300000795682243",
"assignmentType": "E",
"assignmentStatusType": "ACTIVE",
"effectiveStartDate": "2018-06-14",
"effectiveEndDate": "4712-12-31",
"businessTitle": "Aeronautical Engineer Level-9352",
"workAtHomeFlag": false,
"assignmentNumber": "EHDLWorker_190903_1637",
"timeUpdated": "2025-05-06T11:42:17.821Z",
"$id": "300000795682243",
"$context": {
"etag": "89"
},
"personDetail": {
"personNumber": "HDLWorker_190903_1637",
"$id": "100000329366771",
"$context": {
"etag": ""
}
},
"globalName": {
"firstName": "Raymond-Olivier",
"lastName": "Beer-Tröst",
"$id": "300000795668871",
"$context": {
"etag": ""
}
},
"department": {
"id": "300000044556980",
"name": "South - Venaria DC-GROUP/SFIELESOIT74155",
"title": null,
"$id": "300000044556980",
"$context": {
"etag": "13",
"links": {
"$self": {
"href": "https://example.com/api/boss/data/objects/ora/hcmHrCore/workStructures/v1/departments/300000044556980?$effectiveDate=2025-05-13"
}
}
}
},
"legalEmployer": {
"id": "300000046740247",
"name": "PSR_US_LE_1",
"$id": "300000046740247",
"$context": {
"etag": "15",
"links": {
"$self": {
"href": "https://example.com/api/boss/data/objects/ora/hcmHrCore/workStructures/v1/legalEmployers/300000046740247?$effectiveDate=2025-05-13"
}
}
}
},
"workRelationship": {
"id": "100000329414679",
"$id": "100000329414679",
"$context": {
"etag": "1"
}
}
},
{
"id": "300000795670049",
"assignmentType": "E",
"assignmentStatusType": "ACTIVE",
"effectiveStartDate": "2018-05-28",
"effectiveEndDate": "4712-12-31",
"businessTitle": "Civil Engineer-6864",
"workAtHomeFlag": false,
"assignmentNumber": "EHDLWorker_190903_11128",
"timeUpdated": "2025-05-06T11:42:25.787Z",
"$id": "300000795670049",
"$context": {
"etag": "89"
},
"personDetail": {
"personNumber": "HDLWorker_190903_11128",
"$id": "100000329383875",
"$context": {
"etag": ""
}
},
"globalName": {
"firstName": "Charlotte-Pénélope",
"lastName": "Beer-Tröst",
"$id": "300000795669677",
"$context": {
"etag": ""
}
},
"department": {
"id": "300000044582197",
"name": "Human Resources-GROUP/AT081000101",
"title": null,
"$id": "300000044582197",
"$context": {
"etag": "13",
"links": {
"$self": {
"href": "https://example.com/api/boss/data/objects/ora/hcmHrCore/workStructures/v1/departments/300000044582197?$effectiveDate=2025-05-13"
}
}
}
},
"legalEmployer": {
"id": "300000046740247",
"name": "PSR_US_LE_1",
"$id": "300000046740247",
"$context": {
"etag": "15",
"links": {
"$self": {
"href": "https://example.com/api/boss/data/objects/ora/hcmHrCore/workStructures/v1/legalEmployers/300000046740247?$effectiveDate=2025-05-13"
}
}
}
},
"workRelationship": {
"id": "100000329453488",
"$id": "100000329453488",
"$context": {
"etag": "1"
}
}
},
...
],
"hasMore": true
}
タスク3: 抽出ジョブ要求の発行
問合せを定義したら、ジョブ・スケジューラAPIを使用して抽出ジョブ・リクエストを発行できます。
| URL | /api/saas-batch/jobscheduler/v1/jobRequests |
|---|---|
| HTTPメソッド | POST |
| 要求テンプレート |
{
"jobDefinitionName": "AsyncDataExtraction",
"serviceName": "boss",
"requestParameters": {
"boss.module": "oraHcmHrCoreEmployment",
"boss.resource.name": "workerAssignmentExtracts",
"boss.resource.version": "v1",
"boss.outputFormat": "json",
"boss.request.system.param.effectiveDate": "{{effectiveDate}}",
"boss.advancedQuery": "{{query}}"
}
}
その他のビューの場合: {
"jobDefinitionName": "AsyncDataExtraction",
"serviceName": "boss",
"requestParameters": {
"boss.module": "oraHcmHrCoreEmployment",
"boss.resource.name": "workers",
"boss.resource.version": "v1",
"boss.businessView": "{{viewName}}",
"boss.outputFormat": "json",
"boss.request.system.param.effectiveDate": "{{effectiveDate}}",
"boss.advancedQuery": "{{query}}"
}
}
|
| 応答テンプレート |
正常に発行されると、 202 Accepted
Location: {{jobRequestUrl}}
|
データの抽出時のページング:
ページ区切りコントロール(limitおよびoffsetパラメータ)を使用したことがありますが、問合せを作成およびテストするときに、抽出結果を制約する必要はありません。問合せの発行時に、limitおよびoffsetパラメータの使用方法をすべて削除します。
問合せを渡す:
抽出ジョブ・リクエストの発行時に渡される問合せは、標準のJSON文字列の形式である必要があります。$query APIエンドポイントを使用して準備およびテストした問合せを実行し、次のようにします。
- すべての二重引用符("→\")をエスケープします
- 改行文字を削除します(\n)
- 他の空白(インデントなど)を減らす可能性があります。
全体として、次に例を示します。
{
"collection": {
"limit": 100,
"filter": "totalAmount > 10000"
},
"fields": [ "id", "totalAmount" ]
}
目的:
{\"collection\": {\"filter\": \"totalAmount > 10000\"},\"fields\": [ \"id\", \"totalAmount\" ]}
例
リクエストの例
POST /api/saas-batch/jobscheduler/v1/jobRequests
{
"jobDefinitionName": "AsyncDataExtraction",
"serviceName": "boss",
"requestParameters": {
"boss.module": "oraHcmHrCoreEmployment",
"boss.resource.name": "workerAssignmentExtracts",
"boss.resource.version": "v1",
"boss.outputFormat": "json",
"boss.advancedQuery": "{\"collection\": {\"filter\": \"primaryFlag = true and timeUpdated > '2025-05-01T00:00:00Z' and assignmentType = 'E' and !(legalEmployer.id in (10001, 10002))\"},\"fields\": [ \"id\", \"assignmentType\", \"assignmentStatusType\", \"effectiveStartDate\", \"effectiveEndDate\", \"businessTitle\", \"workAtHomeFlag\", \"assignmentNumber\", \"timeUpdated\" ],\"accessors\": {\"personDetail\": {\"fields\": [ \"personNumber\" ]},\"globalName\": {\"fields\": [ \"firstName\", \"lastName\" ]},\"department\": {\"fields\": [ \"id\", \"name\", \"title\" ]},\"legalEmployer\": {\"fields\": [ \"id\", \"name\" ]},\"workRelationship\": {\"fields\": [ \"id\" ]}}}"
}
}
レスポンスの例
202 Accepted Location: https://example.com/api/saas-batch/jobscheduler/v1/jobRequests/42075
タスク4: ジョブ完了の確認
完了をチェックするには、ジョブ・スケジューラAPIを使用して、ジョブ・リクエストの詳細を定期的にポーリングします(ジョブ・スケジューラAPIが正常に完了するか失敗するまで)。
| URL | /api/saas-batch/jobscheduler/v1/jobRequests/{{jobRequestId}} |
|---|---|
| HTTPメソッド | GET |
正常終了:
ジョブ・リクエストは、次の条件を満たすと正常に完了したとみなされます。| 属性 | 予想値 |
|---|---|
jobDetails.jobProgress.completed |
true |
jobDetails.jobProgress.status |
SUCCEEDED |
完了失敗:
次の条件が満たされると、ジョブ・リクエストは失敗したとみなされます。このような場合、jobDetails.jobProgress.message属性にはエラー・メッセージが含まれます。
| 属性 | 予想値 |
|---|---|
jobDetails.jobProgress.status |
FAILED |
例
リクエストの例
GET /api/saas-batch/jobscheduler/v1/jobRequests/42075
レスポンスの例
次の応答は、発行済ジョブの様々なステージを示します。特に、jobProgress.statusおよびjobProgress.completed属性を参照してください。
受入済/エンキュー済
200 OK
{
"jobDetails": {
"jobRequestId": 42075,
"jobRequest": {
"jobDefinitionName": "AsyncDataExtraction",
"serviceName": "boss",
"systemDerivedVersion": "90",
"jobSubmitter": "TM-MFITZIMMONS",
"requestParameters": {
"boss.module": "oraHcmHrCoreEmployment",
"boss.resource.name": "workerAssignmentExtracts",
"boss.resource.version": "v1",
"boss.outputFormat": "json",
"boss.advancedQuery": "{\"collection\": {\"filter\": \"primaryFlag = true and timeUpdated > '2025-05-01T00:00:00Z' and assignmentType = 'E' and !(legalEmployer.id in (10001, 10002))\"},\"fields\": [ \"id\", \"assignmentType\", \"assignmentStatusType\", \"effectiveStartDate\", \"effectiveEndDate\", \"businessTitle\", \"workAtHomeFlag\", \"assignmentNumber\", \"timeUpdated\" ],\"accessors\": {\"personDetail\": {\"fields\": [ \"personNumber\" ]},\"globalName\": {\"fields\": [ \"firstName\", \"lastName\" ]},\"department\": {\"fields\": [ \"id\", \"name\", \"title\" ]},\"legalEmployer\": {\"fields\": [ \"id\", \"name\" ]},\"workRelationship\": {\"fields\": [ \"id\" ]}}}"
},
"jobRetryNumber": 0,
"timeoutThreshold": 14400
},
"jobStatus": "ENQUEUED",
"jobProgress": {
"status": "ACCEPTED",
"message": "Job is submitted",
"startTime": "2025-05-25T13:39:01Z",
"endTime": "2025-05-25T13:39:15Z",
"completedPercentage": "0",
"completed": false
}
},
"$context": {
"links": {
"$self": {
"href": "https://example.com/api/saas-batch/jobscheduler/v1/jobRequests/42075"
}
}
}
}
Running
200 OK
{
"jobDetails": {
"jobRequestId": 42075,
"jobRequest": {
"jobDefinitionName": "AsyncDataExtraction",
"serviceName": "boss",
"systemDerivedVersion": "90",
"jobSubmitter": "TM-MFITZIMMONS",
"requestParameters": {
"boss.module": "oraHcmHrCoreEmployment",
"boss.resource.name": "workerAssignmentExtracts",
"boss.resource.version": "v1",
"boss.outputFormat": "json",
"boss.advancedQuery": "{\"collection\": {\"filter\": \"primaryFlag = true and timeUpdated > '2025-05-01T00:00:00Z' and assignmentType = 'E' and !(legalEmployer.id in (10001, 10002))\"},\"fields\": [ \"id\", \"assignmentType\", \"assignmentStatusType\", \"effectiveStartDate\", \"effectiveEndDate\", \"businessTitle\", \"workAtHomeFlag\", \"assignmentNumber\", \"timeUpdated\" ],\"accessors\": {\"personDetail\": {\"fields\": [ \"personNumber\" ]},\"globalName\": {\"fields\": [ \"firstName\", \"lastName\" ]},\"department\": {\"fields\": [ \"id\", \"name\", \"title\" ]},\"legalEmployer\": {\"fields\": [ \"id\", \"name\" ]},\"workRelationship\": {\"fields\": [ \"id\" ]}}}"
},
"jobRetryNumber": 0,
"timeoutThreshold": 14400
},
"jobStatus": "RUNNING",
"jobProgress": {
"jobRequestId": 42075,
"status": "RUNNING",
"message": "Job status is changed to RUNNING",
"startTime": "2025-05-25T13:39:27Z",
"endTime": "2025-05-25T13:40:25Z",
"completedPercentage": "50",
"completed": false
}
},
"$context": {
"links": {
"$self": {
"href": "https://example.com/api/saas-batch/jobscheduler/v1/jobRequests/42075"
}
}
}
}
200 OK
{
"jobDetails": {
"jobRequestId": 42075,
"jobRequest": {
"jobDefinitionName": "AsyncDataExtraction",
"serviceName": "boss",
"systemDerivedVersion": "90",
"jobSubmitter": "TM-MFITZIMMONS",
"requestParameters": {
"boss.module": "oraHcmHrCoreEmployment",
"boss.resource.name": "workerAssignmentExtracts",
"boss.resource.version": "v1",
"boss.outputFormat": "json",
"boss.advancedQuery": "{\"collection\": {\"filter\": \"primaryFlag = true and timeUpdated > '2025-05-01T00:00:00Z' and assignmentType = 'E' and !(legalEmployer.id in (10001, 10002))\"},\"fields\": [ \"id\", \"assignmentType\", \"assignmentStatusType\", \"effectiveStartDate\", \"effectiveEndDate\", \"businessTitle\", \"workAtHomeFlag\", \"assignmentNumber\", \"timeUpdated\" ],\"accessors\": {\"personDetail\": {\"fields\": [ \"personNumber\" ]},\"globalName\": {\"fields\": [ \"firstName\", \"lastName\" ]},\"department\": {\"fields\": [ \"id\", \"name\", \"title\" ]},\"legalEmployer\": {\"fields\": [ \"id\", \"name\" ]},\"workRelationship\": {\"fields\": [ \"id\" ]}}}"
},
"jobRetryNumber": 0,
"timeoutThreshold": 14400
},
"jobStatus": "RUNNING",
"jobProgress": {
"jobRequestId": 42075,
"status": "RUNNING",
"message": "Publishing BOSS job progress: JobProgress(jobRequestId=42075, resourcePath=oraHcmHrCoreEmployment/v1/workers, dataDocName=null, deploymentId=null, jobStatus=RUNNING, startTime=2025-05-25T13:40:18Z, endTime=2025-05-25T13:40:38Z, completedPercentage=30, completed=false, error=null)",
"startTime": "2025-05-25T13:40:40Z",
"endTime": "2025-05-25T13:40:40Z",
"completedPercentage": "30",
"completed": false
}
},
"$context": {
"links": {
"$self": {
"href": "https://example.com/api/saas-batch/jobscheduler/v1/jobRequests/42075"
}
}
}
}
正常に終了
200 OK
{
"jobDetails": {
"jobRequestId": 42075,
"jobRequest": {
"jobDefinitionName": "AsyncDataExtraction",
"serviceName": "boss",
"systemDerivedVersion": "90",
"jobSubmitter": "TM-MFITZIMMONS",
"requestParameters": {
"boss.module": "oraHcmHrCoreEmployment",
"boss.resource.name": "workerAssignmentExtracts",
"boss.resource.version": "v1",
"boss.outputFormat": "json",
"boss.advancedQuery": "{\"collection\": {\"filter\": \"primaryFlag = true and timeUpdated > '2025-05-01T00:00:00Z' and assignmentType = 'E' and !(legalEmployer.id in (10001, 10002))\"},\"fields\": [ \"id\", \"assignmentType\", \"assignmentStatusType\", \"effectiveStartDate\", \"effectiveEndDate\", \"businessTitle\", \"workAtHomeFlag\", \"assignmentNumber\", \"timeUpdated\" ],\"accessors\": {\"personDetail\": {\"fields\": [ \"personNumber\" ]},\"globalName\": {\"fields\": [ \"firstName\", \"lastName\" ]},\"department\": {\"fields\": [ \"id\", \"name\", \"title\" ]},\"legalEmployer\": {\"fields\": [ \"id\", \"name\" ]},\"workRelationship\": {\"fields\": [ \"id\" ]}}}"
},
"jobRetryNumber": 0,
"timeoutThreshold": 14400
},
"jobStatus": "SUCCEEDED",
"jobProgress": {
"jobRequestId": 42075,
"status": "SUCCEEDED",
"message": "Job status is changed to SUCCEEDED",
"startTime": "2025-05-25T13:39:27Z",
"endTime": "2025-05-25T13:41:26Z",
"completedPercentage": "100",
"completed": true
}
},
"$context": {
"links": {
"$self": {
"href": "https://example.com/api/saas-batch/jobscheduler/v1/jobRequests/42075"
}
}
}
}
タスク5: 抽出出力詳細のフェッチ
ジョブが正常に完了すると、その出力ファイル情報をフェッチできます。これには、特定の抽出ジョブ・リクエスト・インスタンスに対してジョブ・ファイル・マネージャAPIの使用が含まれます。
出力は圧縮チャンクに格納されます。
| URL | /api/saas-batch/jobfilemanager/v1/jobRequests/{{jobRequestId}}/outputFiles |
|---|---|
| HTTPメソッド | GET |
ファイル・サイズ:
ファイル・サイズは、items.fileSizeレスポンス属性で返され、バイト単位で表されます。
エンクロージャーのリンク:
実際のファイル・コンテンツへのURLは、items.$context.links.enclosureレスポンス属性で返されます。
例
リクエストの例
GET /api/saas-batch/jobfilemanager/v1/jobRequests/42075/outputFiles
レスポンスの例
次の例では、完全な出力が2つの圧縮ファイルに格納されます。
200 OK
{
"items": [
{
"fileName": "result_1_json.zip",
"fileSize": 9390419,
"timeCreated": "2025-04-22T22:04:22.667Z",
"$context": {
"links": {
"enclosure": {
"href": "https://example.com/api/saas-batch/jobfilemanager/v1/jobRequests/40071/outputFiles/result_1_json.zip/content"
},
"$self": {
"href": "https://example.com/api/saas-batch/jobfilemanager/v1/jobRequests/40071/outputFiles/result_1_json.zip"
}
}
}
},
{
"fileName": "result_2_json.zip",
"fileSize": 4462724,
"timeCreated": "2025-04-22T22:04:36.565Z",
"$context": {
"links": {
"enclosure": {
"href": "https://example.com/api/saas-batch/jobfilemanager/v1/jobRequests/40071/outputFiles/result_2_json.zip/content"
},
"$self": {
"href": "https://example.com/api/saas-batch/jobfilemanager/v1/jobRequests/40071/outputFiles/result_2_json.zip"
}
}
}
}
],
"totalItems": 2,
"$context": {
"links": {
"$self": {
"href": "https://example.com/api/saas-batch/jobfilemanager/v1/jobRequests/40071/outputFiles"
}
}
}
}
タスク6: 抽出出力のダウンロード
最後に、抽出出力ファイルは、特定の抽出ジョブ・リクエスト・インスタンスおよび出力ファイルのジョブ・ファイル・マネージャAPIを使用してダウンロードできます。
| URL | /api/saas-batch/jobfilemanager/v1/jobRequests/{{jobRequestId}}/outputFiles/{{fileName}}/content |
|---|---|
| HTTPメソッド | GET |
ヒント :
必要に応じて、次のようにRange HTTPヘッダーを使用してマルチスレッド・ダウンロードを実装することで、大きなファイルをより効率的にダウンロードできます。Range: {{startByte}}-{{endByte}}/{{fileSize}}
例
リクエストの例
GET /api/saas-batch/jobfilemanager/v1/jobRequests/42075/outputFiles/result_42075.json/content
レスポンスの例
実際のレスポンスはバイナリ圧縮ファイルの内容です。圧縮解除すると、抽出問合せの完全または部分的な結果(Rangeヘッダー使用の場合)、フォーマットされていないJSONペイロードになります(ファイル・チャンクの場合)。
完全非圧縮結果の例
{"items": [
{"id":"300008335145001","assignmentType":"E","assignmentStatusType":"ACTIVE","effectiveStartDate":"2025-05-02","effectiveEndDate":"4712-12-31","businessTitle":"E7356262523","workAtHomeFlag":false,"assignmentNumber":"E7356262523","timeUpdated":"2025-05-01T07:53:15.722Z","$id":"300008335145001","$context":{"etag":"1"},"personDetail":{"personNumber":"7356262523","$id":"300008335144985","$context":{"etag":""}},"globalName":{"firstName":null,"lastName":"oracle","$id":"300008335144986","$context":{"etag":""}},"department":null,"legalEmployer":{"id":"300001939234024","name":"AORT Oracle United States","$id":"300001939234024","$context":{"etag":"6","links":{"$self":{"href":"/ora/hcmHrCore/workStructures/v1/$en-US/legalEmployers/300001939234024?$effectiveDate=2025-05-13"}}}},"workRelationship":{"id":"300008335144995","$id":"300008335144995","$context":{"etag":"1"}}},
{"id":"300000310085281","assignmentType":"E","assignmentStatusType":"ACTIVE","effectiveStartDate":"2018-03-04","effectiveEndDate":"4712-12-31","businessTitle":"Medical Technologist Corporate Level-35321","workAtHomeFlag":false,"assignmentNumber":"EHDLWorker_190409_467490","timeUpdated":"2025-05-07T15:29:46.59Z","$id":"300000310085281","$context":{"etag":"90"},"personDetail":{"personNumber":"HDLWorker_190409_467490","$id":"100000127293313","$context":{"etag":""}},"globalName":{"firstName":"Martin-David","lastName":"Oestrovsky-Krein","$id":"300000310075057","$context":{"etag":""}},"department":{"id":"300000041568062","name":"GFIN Global Controlling-GROUP/GFINGC74155","title":null,"$id":"300000041568062","$context":{"etag":"13","links":{"$self":{"href":"/ora/hcmHrCore/workStructures/v1/$en-US/departments/300000041568062?$effectiveDate=2025-05-13"}}}},"legalEmployer":{"id":"300000046740247","name":"PSR_US_LE_1","$id":"300000046740247","$context":{"etag":"15","links":{"$self":{"href":"/ora/hcmHrCore/workStructures/v1/$en-US/legalEmployers/300000046740247?$effectiveDate=2025-05-13"}}}},"workRelationship":{"id":"100000127362395","$id":"100000127362395","$context":{"etag":"1"}}}
]}
その他の学習リソース
docs.oracle.com/learnで他のラボを確認するか、Oracle Learning YouTubeチャネルで無料のラーニング・コンテンツにアクセスしてください。また、education.oracle.com/learning-explorerにアクセスして、Oracle Learning Explorerになります。
製品ドキュメントについては、Oracle Help Centerを参照してください。