소개
dataLoadDataSets REST API를 사용하여 HCM 데이터 로더(HDL) 및 HCM 스프레드시트 데이터 로더(HSDL) 통합을 자동화합니다.
목표
이 자습서에서는 다음 작업을 수행합니다.
- Oracle WebCenter Content 서버에 파일을 업로드하는 방법을 이해합니다.
- HCM 데이터 로더 및 HCM 스프레드시트 데이터 로더를 시작합니다.
- 데이터 세트 및 비즈니스 객체 상태를 모니터링하고 메시지 및 프로세스 정보를 검색합니다.
필요 조건
이 자습서의 단계를 완료하려면 다음이 필요합니다.
- HDL REST API 사용에 액세스합니다.
- REST를 통해 HSDL을 시작하는 단계를 완료하려면 ORA_PER_JOB HSDL 템플리트 또는 HSDL을 시작할 템플리트에 롤을 지정해야 합니다.
- Base 64 인코딩으로 파일을 인코딩하는 기능입니다.
- Postman은 REST API 호출을 제출합니다.
- REST를 사용하여 실패한 라인 파일을 생성하는 기능을 사용하려면 오류 파일에 대한 Oracle WebCenter 콘텐츠 액세스를 사용으로 설정해야 합니다.
- 설정 및 유지 관리에서 HCM 데이터 로더 기능별 영역을 찾고 HCM 데이터 로더 구성을 누릅니다.
- 오류 파일에 대한 Oracle WebCenter Content 액세스 사용 매개변수를 검색하고 [아니요] 이외의 값으로 대체로 설정합니다.
- 저장 후 닫기.
HDL(HCM 데이터 로더) 접근 및 이해 HDL 보안 옵션 구성 자습서의 REST 접근 단계에 따라 태스크 2를 완료하기 위해 REST 서비스를 사용하여 HCM 데이터 로더 데이터 세트 생성 권한에 대한 접근 권한을 부여합니다.
HCM 스프레드시트 데이터 로더 실행을 위한 접근 권한 부여 자습서의 역할의 데이터 세트 접근 권한 지정 단계를 따릅니다.
이 자습서의 예제에서는 Postman 변수를 사용하여 환경 및 변경되는 기타 값을 참조합니다.
| 변수 | 설명 |
|---|---|
| {{env}} | 환경 경로입니다. |
| {{user}} | 사용자 이름. |
| {{RequestId}} | 데이터 세트를 고유하게 식별하는 데 사용되는 값입니다. |
| {{DataSetBusObjId}} | 데이터 세트 내에서 비즈니스 객체 레코드를 고유하게 식별하는 데 사용되는 값입니다. |
| {{ProcessId}} | 데이터 세트에 대해 제출된 프로세스를 고유하게 식별하는 데 사용되는 값입니다. |
주:
REST 호출 본문에서 변경해야 하는 다른 값은 파란색으로 표시됩니다. 예를 들어, <file_name>입니다.
작업 1: Oracle WebCenter Content Server에 데이터 파일 업로드
Oracle WebCenter Content 서버에 파일을 업로드하는 방법은 여러 가지가 있으며, 이 태스크는 HCM 데이터 로더 dataLoadDataSets 리소스에서 사용할 수 있는 uploadFile 사용자정의 작업과 Oracle WebCenter REST 리소스의 두 가지 다른 REST 옵션을 제공합니다.
다음 단계를 완료하려면 다음 파일을 다운로드하고 사용할 수 있습니다.
- HCM 데이터 로더의 경우 새 등급 및 Jobs.zip
- HCM 스프레드시트 데이터 로더의 경우 Jobs.csv.
HCM 데이터 로더 uploadFile 작업
- Postman을 열고 이 URL에 대한 새 POST 요청을 만듭니다.
- 다음 JSON 본문을 지정합니다.
- 요청에 대한 권한 부여를 구성합니다. 사용자에게 Human Capital Management 파일 기반 임포트에 대한 데이터 업로드 역할 계층이 있어야 합니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 전송을 누릅니다.
- 응답을 검토하고 콘텐츠 ID를 기록해 둡니다. HDL 및 HSDL을 시작할 때 파일을 식별해야 합니다.
- Base64는 Jobs.csv 파일을 인코딩하고 다음 단계에 따라 csv 파일을 업로드합니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/uploadFile
{
"content" : "UEsDBBQAAAAIAJF+Qle0P8ZqHgEAAAQFAAAJAAAAR3JhZGUuZGF0ldPNaoQwEAfw+4LvsG+wmhhKDz2ERGyg2S269LqkGovQKqRxT3n4xu6Hxj3IQECZTH4h/BmZHSmnR+pyo2rtsqbRlW3PurTKWK7srJR19Vi4dLLed5fa+u+1slc/2tHbYTv8urIfTKUL3cRx8vLfsx3bo43Mijy73pg8k2QXj8ulTwna+YUT98rfTnnBT9KX2UHKw95J1akvbbaJo/NtmIaWGgo0BNPwUsOBhmFautTSQEthGllqJNBItIF4gt1zEF3dntt6UN8+zc6a9nOw/SWWqRsUi2BoBUcBDkpJMLyC4wAHhSZYuoKnAQ7KUDCygpMAB0bKp9HirdHVMkQOmy0eowcOzTnYcPEYB9w9qGkf9tyP95vn/+isHG3+AFBLAwQUAAAACAAbSlJXX/ch5FMCAAC9CgAABwAAAEpvYi5kYXTNldFumzAYhe8r9R14g5Fut7uwwElYY0LBq7SryCNOZI1AZUy1SH74GQdDnJCY9mpSpIjkP+ezzzGAIAYhwED+qH5LuNvRXLB3mgnCRUgElRkVQbWl7d/6OyYHfTEnB1Yc9U/ASERTy3lTFIkSY6bmUrpvCsIxPbxVnPCjFjalmq9KLUWkJHvKV/SdFjKrGp7TlO58f/ZdTXrtyOMDgukC6uU9+b7/xZ+pjwzWCK1juQxXmwysYLYJ1nHWXnoZKWitpGXdFIKUwhuGJJDzn6vVBkcIylTKC/kEVJxe4WjJKn5FdUEto/8ZrGfRIj3LtivNJmGFQCAGCzmzhVMZYXTOCBlXJ7HiN7dzYj3ZBm4WSp/xkCEi/A8VrNxfBohA+gxxFC9GQ+xN3Lw2b5vZ9fZJtOXnxutR096APG/wFu+8TGMzEWiqHIBWnfeJT5aPm5ik61CtDcVYMxNebZtcdFs80C5VM4VHUx083Ly2gQtmV+mn0LadGz/M9r1ec62Cb/DhwqrY9v3QOkzdI+uwb+P27F7ncF677epexWuiya8spwpPa7Y1qd+Ffe3EbgDsCPAvzZv2Nfdh1jfj44a9BBsMMwxPcb40pGDi2D4fBK8KD9NaqEpHT1GvnAQxB+eSYE6NBAG++Sw46d2cCG9AiCJ94UXYA9sDK1ktOGnPw+gujMRtvlRvsQQG2nuZetkbzZnaSy3GjbvxSb7DopXxhEUbySRzc6so6/7WuOU66QZIwK8hiYQcVY2FMw4jmmY/BGL8J6TSC6cx+kdIR7gfTqd4fPgHUEsBAhQAFAAAAAgAkX5CV7Q/xmoeAQAABAUAAAkAJAAAAAAAAAAgAAAAAAAAAEdyYWRlLmRhdAoAIAAAAAAAAQAYANn4TRNA9dkBAAAAAAAAAAAAAAAAAAAAAFBLAQIUABQAAAAIABtKUldf9yHkUwIAAL0KAAAHACQAAAAAAAEAIAAAAEUBAABKb2IuZGF0CgAgAAAAAAABABgAjuYejz/12QEAAAAAAAAAAAAAAAAAAAAAUEsFBgAAAAACAAIAtAAAAL0DAAAAAA==",
"fileName" : "Grades and Jobs.zip"
}
주:
"content"의 값은 New Grades and Jobs.zip 파일의 Base64 인코딩 버전입니다.콘텐츠 및 fileName 매개변수가 필요합니다. uploadFile 사용자 정의 작업에 사용할 수 있는 매개변수는 다음과 같습니다.
| 매개변수 | 설명 |
|---|---|
| content | 로드할 Base64 인코딩 파일입니다. |
| fileName | 파일의 이름입니다. |
| contentId | Oracle WebCenter Content Server에 있는 파일의 고유 식별자입니다. 제공되지 않은 경우 자동으로 생성됩니다. |
응답의 형식은 다음과 같습니다.
{
"result": {
"Status": "SUCCESS",
"ContentId": "UCMFA00078879"
}
}
Oracle WebCenter REST
Oracle WebCenter REST 리소스의 장점은 먼저 파일을 인코딩할 필요가 없으므로 이 REST 서비스는 더 큰 소스 파일을 로드할 수 있다는 것입니다. 그러나 사용하는 것이 조금 더 복잡합니다.
HCM 데이터 로더 uploadFile 작업은 Oracle WebCenter의 HCM 데이터 로더 임포트 계정에만 파일을 업로드합니다. 이 API를 사용하면 사용자가 액세스할 수 있는 모든 Oracle WebCenter 계정에 업로드할 수 있습니다.
요청을 생성합니다.
- Postman을 열고 이 URL에 대한 새 POST 요청을 만듭니다.
- 본문에 다음 form-data를 지정합니다.
- primaryFile 키 위로 마우스를 가져가면 텍스트/파일 선택 목록이 표시되고 값을 파일로 설정합니다.
- 요청에 대한 권한 부여를 구성합니다. 사용자에게 Human Capital Management 파일 기반 임포트에 대한 데이터 업로드 역할 계층이 있어야 합니다.
- 요청을 저장합니다. 이제 파일을 업로드할 수 있습니다.
https://{{env}}/documents/files/data
| 핵심 | 값 |
|---|---|
| metadataValues | {
"dDocAuthor":"{{user}}",
"dDocTitle":"<file_name>",
"dSecurityGroup":"FAFusionImportExport",
"dDocAccount":"hcm$/dataloader$/import$",
"dDocType":"Document"
}
주: <file_name>를 파일 이름으로 바꿉니다. |
| primaryFile |
파일 업로드
이 단계에서는 위에서 생성한 요청을 사용하여 zip 및 csv 파일을 Oracle WebCenter Content 서버로 업로드합니다.
- 요청의 본문 폼 데이터에서 파일 선택을 누릅니다.
참고:
파일 선택 버튼은 primaryFile 선택 목록이 파일로 설정된 경우에만 사용할 수 있습니다. - 파일 브라우저를 사용하여 파일을 찾아 선택합니다.
- metadataValues 키 dDocTitle 값을 편집하여 파일 이름을 지정합니다.
참고:
HCM 데이터 로더를 시작할 때 데이터 세트 이름은 여기서 제공하는 값으로 기본 설정됩니다. - 전송을 누릅니다.
- 응답을 검토하고 콘텐츠 ID를 기록해 둡니다. HDL 및 HSDL을 시작할 때 파일을 식별해야 합니다.
- csv 파일에 대해 파일 업로드 단계를 반복합니다.
응답의 형식은 다음과 같습니다.
{
"dWebExtension": "zip",
"dRevClassID": "213206",
"createdBy": "VISION_INTEGRATION",
"modifiedBy": "VISION_INTEGRATION",
"XFND_RANDOM": "4641327459804635554",
"dReleaseState": "N",
"dPublishState": "",
"dID": "213551",
"xComments": "",
"errorCode": "0",
"title": "Grades and Jobs.zip",
"size": "1125",
"createdTime": "10/3/23 7:27 AM",
"dDocName": "UCMFA00213206",
"mimeType": "application/zip",
"dRevRank": "0",
"dDocID": "426034",
"name": "New Grades and Jobs.zip",
"dDocAccount": "hcm$/dataloader$/import$",
"ownedBy": "VISION_INTEGRATION",
"xStorageRule": "FusionStorageRule",
"dStatus": "DONE",
"modifiedTime": "10/3/23 7:27 AM",
"XFND_SIGNATURE": "Y-Qs7rQwyYANlmfo-....",
"errorKey": "!csServiceStatusMessage_checkin,UCMFA00213206",
"dExtension": "zip",
"dWorkflowState": "",
"XFND_SCHEME_ID": "1",
"XFND_CERT_FP": "901B32887DDC81F780757624",
"dPublishType": "",
"dUser": "VISION_INTEGRATION",
"dSecurityGroup": "FAFusionImportExport",
"errorMessage": "Successfully checked in content item 'UCMFA00213206'.",
"dRevisionID": "1",
"version": "1"
}
주:
Oracle WebCenter Content REST API는 콘텐츠 ID를 반환하기 위해 dDocName 레이블을 사용합니다.태스크 2: 대량 데이터 로드 시작
HCM 데이터 로더로 데이터 업로드
이 단계에서는 Oracle WebCenter Content 서버의 hcm$/dataloader$/import$ 계정에 이전에 로드된 파일을 처리하기 위해 HDL을 시작하는 createFileDataSet 사용자 정의 작업을 호출합니다.
- Postman에서 이 URL에 대한 새 POST 요청을 만듭니다.
- 다음 JSON 본문을 지정합니다.
- 요청에 대한 권한 부여를 구성합니다. 사용자에게 REST 서비스 - 데이터 로드 데이터 세트 사용 역할 계층이 있어야 합니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/createFileDataSet
주:
이 요청을 제출하려면 REST 서비스를 사용하여 HCM 데이터 로더 데이터 세트 생성 기능 보안 권한이 필요합니다.{
"contentId" : "<content_id>"
}
참고:
<content_id> 값을 파일의 콘텐츠 ID로 바꿉니다.유일한 필수 매개변수는 contentId입니다. createFileDataSet 사용자 정의 작업에 사용할 수 있는 매개변수는 다음과 같습니다.
| 매개변수 | 설명 | 기본값을 제공하는 HCM 데이터 로더 매개변수 구성 |
|---|---|---|
| contentId | Oracle WebCenter Content Server에서 파일의 고유 식별자입니다. | |
| fileAction | 적합한 값은 IMPORT_AND_LOAD 및 IMPORT_ONLY입니다. | 파일 조치 |
| dataSetName | 데이터 세트의 이름입니다. 기본값은 파일의 문서 제목입니다. | |
| importConcurrentThreads | 임포트 프로세스에 지정할 최대 동시 스레드 수입니다. | 임포트에 대한 최대 동시작업 스레드 |
| loadConcurrentThreads | 로드 프로세스에 지정할 최대 동시 스레드 수입니다. | 로드에 대한 최대 동시 스레드 |
| importMaxErrorPercentage | 가져오기가 중단되기 전에 오류가 발생한 최대 레코드 비율입니다. | 임포트 오류의 최대 퍼센트 |
| loadMaxErrorPercentage | 로드가 중단되기 전 오류가 발생한 레코드의 최대 퍼센트입니다. | 로드 오류의 최대 퍼센트 |
| fileEncryption | 소스 파일에 사용되는 암호화입니다.
공급 없음, PGPUNSIGNED 또는 PGPSIGNED. 참고: 파일을 Oracle WebCenter에 업로드하기 전에 항상 파일을 암호화하는 것이 좋습니다. HCM 데이터 로더 임포트 계정은 다양한 사용자가 자주 접근하며, 이 모든 계정은 암호화되지 않은 파일의 콘텐츠를 다운로드하고 검토할 수 있습니다. |
파일 암호화 |
| verificationKey | 소스 파일 암호화에 사용되는 확인 키입니다. fileEncryption가 PGPSIGNED인 경우 제공합니다. | |
| deleteSourceFile | 데이터를 스테이징 테이블로 임포트한 후 출처 파일을 삭제해야 하는지 여부를 나타냅니다. | 출처 파일 삭제 |
주:
테이블의 마지막 열은 각 REST API 매개변수에 대한 기본값을 정의하는 HCM 데이터 로더 구성 태스크의 매개변수 이름을 지정합니다.응답의 형식은 다음과 같습니다.
{
"result": {
"Status": "SUCCESS",
"RequestId": "107468"
}
}
주:
응답의 RequestId는 dataLoadDataSets 리소스를 사용하여 데이터 세트 정보를 검색하는 데 사용됩니다.HCM 스프레드시트 데이터 로더로 데이터 업로드
이 단계에서는 createSpreadsheetDataSet 사용자 정의 작업을 호출하여 이전에 Oracle WebCenter Content 서버의 hcm$/dataloader$/import$ 계정에 로드된 파일을 처리하도록 HSDL을 시작합니다.
파일을 업로드하는 데 사용 중인 HSDL 템플리트에 대해 파일 모양이 지정되어야 합니다.
- Postman에서 이 URL에 대한 새 POST 요청을 만듭니다.
- 다음 JSON 본문을 지정합니다.
- 요청에 대한 권한 부여를 구성합니다. 사용자에게 REST 서비스 - 데이터 로드 데이터 세트 사용 역할 계층이 있어야 합니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 전송을 누릅니다. 응답의 형식은 다음과 같습니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/createSpreadsheetDataSet
{
"contentId" : "<content_id>",
"templateCode" : "ORA_PER_JOB"
}
참고:
<content_id> 값을 파일의 콘텐츠 ID로 바꿉니다.참고:
ORA_PER_JOB 템플리트는 작업 로드에 사용할 수 있는 미리 구성된 템플리트입니다. 스프레드시트 데이터 로더 실행 태스크를 사용하여 템플리트 코드를 찾을 수 있습니다.필요한 매개변수는 contentId 및 templateCode뿐입니다. createSpreadsheetDataSet 사용자 정의 작업에 사용할 수 있는 매개변수는 다음과 같습니다.
| 매개변수 | 설명 | 기본값을 제공하는 HCM 데이터 로더 매개변수 구성 |
|---|---|---|
| contentId | Oracle WebCenter Content Server에서 파일의 고유 식별자입니다. | |
| templateCode | 파일을 업로드할 스프레드시트 템플리트 코드입니다. | |
| fileAction | 적합한 값은 IMPORT_AND_LOAD 및 IMPORT_ONLY입니다.
참고: 파일만 임포트하는 경우 REST를 사용하여 파일을 모니터링하거나 로드할 수 없습니다. 대신 템플리트에 대한 스프레드시트를 생성하고 데이터 세트를 인출하여 스프레드시트에서 업로드하십시오. |
"IMPORT_AND_LOAD" |
| dataSetName | 데이터 세트의 이름입니다. | 기본값은 템플리트 코드 및 시간 기록입니다. |
| importConcurrentThreads | 임포트 프로세스에 지정할 최대 동시 스레드 수입니다. | 임포트에 대한 최대 동시작업 스레드 |
| loadConcurrentThreads | 로드 프로세스에 지정할 최대 동시 스레드 수입니다. | 로드에 대한 최대 동시 스레드 |
| importMaxErrorPercentage | 가져오기가 중단되기 전에 오류가 발생한 최대 레코드 비율입니다. | 임포트 오류의 최대 퍼센트 |
| loadMaxErrorPercentage | 로드가 중단되기 전 오류가 발생한 레코드의 최대 퍼센트입니다. | 로드 오류의 최대 퍼센트 |
| fileEncryption | 소스 파일에 사용되는 암호화입니다.
공급 없음, PGPUNSIGNED 또는 PGPSIGNED. 참고: 파일을 Oracle WebCenter에 업로드하기 전에 항상 파일을 암호화하는 것이 좋습니다. HCM 데이터 로더 임포트 계정은 다양한 사용자가 자주 접근하며, 이 모든 계정은 암호화되지 않은 파일의 콘텐츠를 다운로드하고 검토할 수 있습니다. |
파일 암호화 |
| verificationKey | 소스 파일 암호화에 사용되는 확인 키입니다. fileEncryption가 PGPSIGNED인 경우 제공합니다. | |
| deleteSourceFile | 데이터를 스테이징 테이블로 임포트한 후 출처 파일을 삭제해야 하는지 여부를 나타냅니다. | 출처 파일 삭제 |
| headerIncludedFlag | 파일에 포함된 속성의 이름을 지정하기 위해 헤더가 출처 파일에 포함되어 있는지 여부를 나타냅니다. | "Y" |
| attributeDelimiter | 파일에서 값을 구분하는 데 사용되는 문자입니다. | ","(쉼표). |
| newLineIndicator | 새 라인을 나타내는 데 사용되는 문자입니다. | "n"은 이스케이프 문자가 앞에 붙습니다. |
| escapeIndicator | 속성 값 내에서 구분자 문자를 이스케이프하는 데 사용되는 문자입니다. | "/"(백슬래시) |
| dateFormat | 일자 데이터 유형의 속성에 사용되는 일자 형식입니다. | 기본 형식은 YYYY/MM/DD이며, |
{
"result": {
"Status": "SUCCESS",
"RequestId": "107483",
"UserInfo": "",
"Review": "https://{env}/hcmUI/oracle/apps/hcm/enterpriseSetup/hdlSpreadsheetLoader/di/GenericHdlSpreadsheet.xlsx?layoutCode=ORA_PER_JOB&dataSetName="Job#2024-08-06 11:40:56"",
"FileAction": "IMPORT_AND_LOAD",
"DataSetName": ""Job#2024-08-06 11:40:56""
}
}
주:
응답의 RequestId를 사용하여 dataLoadDataSets 리소스를 사용하여 데이터 세트의 상태를 모니터합니다.참고:
검토 링크를 사용하면 HSDL 템플리트에서 데이터 집합을 검토할 스프레드시트를 생성할 수 있습니다.태스크 3: 데이터 세트 상태 모니터링
이 단계에서는 dataLoadDataSets 리소스를 사용하여 데이터 세트 상태를 모니터링합니다. 이 리소스는 HDL 및 HSDL 데이터 세트를 모두 모니터하는 데 사용할 수 있습니다.
참고:
임포트된 HSDL 파일만 HCM 데이터 로더 스테이징 테이블에 데이터 세트를 생성하지 않으며 REST를 사용하여 모니터링할 수 없습니다.특정 데이터 세트 모니터링
- Postman에서 이 URL에 대한 새 GET 요청을 생성합니다.
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
- csv 파일에 대해 반복하면 응답이 스프레드시트 관련 요소에 대한 정보를 반환합니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}
주:
파일을 제출할 때 반환된 RequestId 값으로 {{RequestId}}을(를) 바꿉니다.응답의 형식은 다음과 같습니다.
{
"RequestId": 107468,
"DataSetId": 300100621962415,
"ContentId": "UCMFA00103266",
"DataSetName": "Grades and Jobs.zip",
"DataSetStatusCode": "ORA_IN_ERROR",
"DataSetStatusMeaning": "Error",
"TransferStatusCode": "SUCCESS",
"TransferStatusMeaning": "Success",
"ImportStatusCode": "SUCCESS",
"ImportStatusMeaning": "Success",
"LoadStatusCode": "ERROR",
"LoadStatusMeaning": "Error",
"SourceTypeCode": "ZIP_DAT_FILE",
"SourceTypeMeaning": "Compressed DAT file",
"IntegrationTypeCode": null,
"IntegrationTypeMeaning": null,
"ImportPercentageComplete": 100,
"LoadPercentageComplete": 100,
"ImportSuccessPercentage": 100,
"LoadSuccessPercentage": 59,
"FileLineTotalCount": 38,
"FileLineImportErrorCount": 0,
"FileLineImportSuccessCount": 38,
"ObjectTotalCount": 37,
"ObjectLoadErrorCount": 15,
"ObjectRollbackErrorCount": 0,
"ObjectSuccessCount": 22,
"ObjectUnprocessedCount": 0,
"SpreadsheetTemplateCode": null,
"SpreadsheetTemplateName": null,
"SpreadsheetTemplateUserTypeCode": null,
"SpreadsheetTemplateUserTypeMeaning": null,
"SpreadsheetMessage": null,
"FileSize": 1175,
"CreatedBy": "HCM_USER10",
"CreationDate": "2024-08-06T11:38:28+00:00",
"LastUpdatedBy": "HCM_USER10",
"LastUpdateDate": "2024-08-06T11:40:04.127+00:00",
"ProtectedFlag": false,
"Review": null,
"FailedLinesFileContentId": null,
"FailedLinesFileEncryptionType": null,
"FailedLinesFileEncryptionKey": null,
"links": [
...
]
}
오류가 있는 데이터 세트 식별
이 URL을 사용하여 오류가 있는 모든 데이터 세트에 대한 요약 정보를 검색합니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets?q=DataSetStatusCode=ORA_IN_ERROR&fields=RequestId,DataSetName,DataSetStatusCode,ImportStatusCode,LoadStatusCode,SourceTypeCode,FileLineTotalCount,FileLineImportErrorCount,ObjectTotalCount,ObjectLoadErrorCount,LastUpdateDate&onlyData=true
응답의 형식은 다음과 같습니다.
{
"items": [
{
"RequestId": 107483,
"DataSetName": "Job#2024-08-06 11:40:56",
"DataSetStatusCode": "ORA_IN_ERROR",
"ImportStatusCode": "SUCCESS",
"LoadStatusCode": "ERROR",
"SourceTypeCode": "SPREADSHEET",
"FileLineTotalCount": 6,
"FileLineImportErrorCount": 0,
"ObjectTotalCount": 6,
"ObjectLoadErrorCount": 2,
"LastUpdateDate": "2024-08-06T11:42:13.333+00:00"
},
{
"RequestId": 107468,
"DataSetName": "Grades and Jobs.zip",
"DataSetStatusCode": "ORA_IN_ERROR",
"ImportStatusCode": "SUCCESS",
"LoadStatusCode": "ERROR",
"SourceTypeCode": "ZIP_DAT_FILE",
"FileLineTotalCount": 38,
"FileLineImportErrorCount": 0,
"ObjectTotalCount": 37,
"ObjectLoadErrorCount": 15,
"LastUpdateDate": "2024-08-06T11:40:04.127+00:00"
},...
특정 HSDL 템플리트에 대한 데이터 세트 모니터링
이 URL을 사용하여 특정 스프레드시트 템플리트로 로드된 모든 데이터 세트에 대한 요약 정보를 검색합니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets?q=SpreadsheetTemplateCode=ORA_PER_JOB&fields=RequestId,DataSetName,ImportStatusCode,LoadStatusCode,SourceTypeCode,ObjectTotalCount,ObjectLoadErrorCount,Review&onlyData=true
응답의 형식은 다음과 같습니다.
{
"items": [
{
"RequestId": 107483,
"DataSetName": "Job#2024-08-06 11:40:56",
"ImportStatusCode": "SUCCESS",
"LoadStatusCode": "ERROR",
"SourceTypeCode": "SPREADSHEET",
"ObjectTotalCount": 6,
"ObjectLoadErrorCount": 2,
"Review": "https://cptapniqy.fusionapps.ocs.oc-test.com:443/hcmUI/oracle/apps/hcm/enterpriseSetup/hdlSpreadsheetLoader/di/GenericHdlSpreadsheet.xlsx?layoutCode=ORA_PER_JOB&dataSetName=Job#2024-08-06 11:40:56"
}
],
"count": 1,
"hasMore": false,
"limit": 25,
"offset": 0,
"links": [
...
작업 4: 비즈니스 객체 상태 모니터링
HDL 데이터 세트에 여러 비즈니스 객체 파일이 있는 경우 개별 비즈니스 객체의 상태를 모니터링할 수 있습니다.
데이터 세트의 모든 비즈니스 객체 검토
- Postman에서 이 URL에 대한 새 GET 요청을 생성합니다.
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects?onlyData=true
주:
파일을 제출할 때 반환된 RequestId 값으로 {{RequestId}}을(를) 바꿉니다.응답의 형식은 다음과 같습니다.
{
"items": [
{
"DataSetBusObjId": 300100621962438,
"BusinessObjectDiscriminator": "Grade",
"BusinessObjectName": "Grade",
"DatFileName": "Grade.dat",
"LoadOrder": 1,
"BusinessObjectId": 300100028324439,
"TransferStatusCode": "SUCCESS",
"TransferStatusMeaning": "Success",
"ImportStatusCode": "SUCCESS",
"ImportStatusMeaning": "Success",
"LoadStatusCode": "SUCCESS",
"LoadStatusMeaning": "Success",
"ImportPercentageComplete": 100,
"LoadPercentageComplete": 100,
"ImportSuccessPercentage": 100,
"LoadSuccessPercentage": 100,
"FileLineTotalCount": 14,
"FileLineImportErrorCount": 0,
"FileLineImportSuccessCount": 14,
"ObjectTotalCount": 14,
"ObjectLoadErrorCount": 0,
"ObjectRollbackErrorCount": 0,
"ObjectSuccessCount": 14,
"ObjectUnprocessedCount": 0,
"DataSetId": 300100621962415,
"RequestId": 107468,
"CreatedBy": "HCM_USER10",
"CreationDate": "2024-08-06T11:38:29+00:00",
"LastUpdateDate": "2024-08-06T11:39:24.490+00:00",
"LastUpdatedBy": "FUSION_APPS_HCM_ESS_LOADER_APPID",
"RollbackEnabledFlag": false,
"FailedLinesFileContentId": null,
"FailedLinesFileEncryptionType": null,
"FailedLinesFileEncryptionKey": null
},
{
"DataSetBusObjId": 300100621962439,
"BusinessObjectDiscriminator": "Job",
"BusinessObjectName": "Job",
"DatFileName": "Job.dat",
"LoadOrder": 2,
"BusinessObjectId": 300100028327309,
"TransferStatusCode": "SUCCESS",
"TransferStatusMeaning": "Success",
"ImportStatusCode": "SUCCESS",
"ImportStatusMeaning": "Success",
"LoadStatusCode": "ERROR",
"LoadStatusMeaning": "Error",
"ImportPercentageComplete": 100,
"LoadPercentageComplete": 100,
"ImportSuccessPercentage": 100,
"LoadSuccessPercentage": 34,
"FileLineTotalCount": 24,
"FileLineImportErrorCount": 0,
"FileLineImportSuccessCount": 24,
"ObjectTotalCount": 23,
"ObjectLoadErrorCount": 15,
"ObjectRollbackErrorCount": 0,
"ObjectSuccessCount": 8,
"ObjectUnprocessedCount": 0,
"DataSetId": 300100621962415,
"RequestId": 107468,
"CreatedBy": "HCM_USER10",
"CreationDate": "2024-08-06T11:38:29.004+00:00",
"LastUpdateDate": "2024-08-06T11:39:58.914+00:00",
"LastUpdatedBy": "FUSION_APPS_HCM_ESS_LOADER_APPID",
"RollbackEnabledFlag": false,
"FailedLinesFileContentId": null,
"FailedLinesFileEncryptionType": null,
"FailedLinesFileEncryptionKey": null
}
],
"count": 2,
"hasMore": false,
"limit": 25,
"offset": 0,
"links": [
...
데이터 세트의 특정 비즈니스 객체 모니터링
- Postman에서 이 URL에 대한 새 GET 요청을 생성합니다.
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}?onlyData=true&fields=DataSetBusObjId,BusinessObjectName,LoadOrder,TransferStatusCode,ImportStatusCode,LoadStatusCode,ImportSuccessPercentage,LoadSuccessPercentage,FileLineTotalCount,FileLineImportErrorCount,ObjectTotalCount,ObjectSuccessCount,ObjectLoadErrorCount
주:
파일을 제출할 때 {{RequestId}}을(를) 반환된 RequestId 값으로 바꾸고, {{DataSetBusObjId}}을(를) 검색할 비즈니스 객체 레코드에 대한 DataSetBusObjId으로 바꿉니다.응답의 형식은 다음과 같습니다.
{
"DataSetBusObjId": 300100621962439,
"BusinessObjectName": "Job",
"LoadOrder": 2,
"TransferStatusCode": "SUCCESS",
"ImportStatusCode": "SUCCESS",
"LoadStatusCode": "ERROR",
"ImportSuccessPercentage": 100,
"LoadSuccessPercentage": 34,
"FileLineTotalCount": 24,
"FileLineImportErrorCount": 0,
"ObjectTotalCount": 23,
"ObjectSuccessCount": 8,
"ObjectLoadErrorCount": 15
}
오류가 있는 비즈니스 객체 식별
- 이 URL을 사용하여 로드 중 오류가 발생한 데이터 세트의 모든 비즈니스 객체에 대한 요약 정보를 검색합니다.
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects?q=LoadStatusCode=ERROR&fields=DataSetBusObjId,LoadOrder,BusinessObjectName,TransferStatusCode,ImportStatusCode,LoadStatusCode,FileLineTotalCount,FileLineImportErrorCount,ObjectTotalCount,ObjectLoadErrorCount&onlyData=true
응답의 형식은 다음과 같습니다.
{
"items": [
{
"DataSetBusObjId": 300100621962439,
"LoadOrder": 2,
"BusinessObjectName": "Job",
"TransferStatusCode": "SUCCESS",
"ImportStatusCode": "SUCCESS",
"LoadStatusCode": "ERROR",
"FileLineTotalCount": 24,
"FileLineImportErrorCount": 0,
"ObjectTotalCount": 23,
"ObjectLoadErrorCount": 15
}
]...
작업 5: 메시지 검색
데이터 세트에 오류가 있는 경우 각 메시지가 보고되는 레코드의 식별자와 함께 해당 데이터 세트에 대해 발생한 메시지를 검색할 수 있습니다.
데이터 세트에 대한 모든 메시지 검색
- Postman에서 이 URL에 대한 새 GET 요청을 생성합니다.
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/messages?totalResults=true&orderBy=DatFileName,FileLine&fields=DatFileName,BusinessObjectDiscriminator,OriginatingProcessCode,FileLine,ConcatenatedUserKey,SourceSystemOwner,SourceSystemId,SourceReference001,MessageTypeCode,MessageText,MessageUserDetails&onlyData=true
주:
파일을 제출할 때 반환된 RequestId 값으로 {{RequestId}}을(를) 바꿉니다.응답의 형식은 다음과 같습니다.
{
"items": [
{
"DatFileName": "Job.dat",
"BusinessObjectDiscriminator": "Job",
"OriginatingProcessCode": "LOAD",
"FileLine": 4,
"ConcatenatedUserKey": "HDL_SNR_SALES_CONS-COMMON",
"SourceSystemOwner": null,
"SourceSystemId": null,
"SourceReference001": "HDL_SNR_SALES_CONS",
"MessageTypeCode": "ERROR",
"MessageText": "You need to enter a valid value for the JobFamilyId attribute. The current values are HDL_SALES.",
"MessageUserDetails": null
},
{
"DatFileName": "Job.dat",
"BusinessObjectDiscriminator": "Job",
"OriginatingProcessCode": "LOAD",
"FileLine": 10,
"ConcatenatedUserKey": "HDL_MRKT_DIR-COMMON",
"SourceSystemOwner": null,
"SourceSystemId": null,
"SourceReference001": "HDL_MRKT_DIR",
"MessageTypeCode": "ERROR",
"MessageText": "You need to enter a valid value for the JobFamilyId attribute. The current values are HDL_MARKETING.",
"MessageUserDetails": null
},
{
"DatFileName": "Job.dat",
"BusinessObjectDiscriminator": "Job",
"OriginatingProcessCode": "LOAD",
"FileLine": 5,
"ConcatenatedUserKey": "HDL_SALES_MGR-COMMON",
"SourceSystemOwner": null,
"SourceSystemId": null,
"SourceReference001": "HDL_SALES_MGR",
"MessageTypeCode": "ERROR",
"MessageText": "The FT value for the FullPartTime attribute is invalid and doesn't exist in the list of values.",
"MessageUserDetails": null
},
...
태스크 6: 실패한 라인 파일 생성
메시지 정보를 직접 추출하는 것 외에도 실패한 라인 파일 생성을 시작할 수 있습니다. 이러한 파일에는 오류가 있는 모든 데이터 행이 포함되며 선택적으로 메시지 텍스트도 포함됩니다.
참고:
생성된 실패한 행 파일은 Oracle WebCenter의 hcm$/dataloader$/export$ 계정에서 다운로드할 수 있습니다.데이터 세트에 대한 실패한 라인 파일 생성
- Postman에서 이 URL에 대한 새 POST 요청을 만듭니다.
- 다음 JSON 본문을 지정합니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다. 응답의 형식은 다음과 같습니다.
- 이 GET URL을 사용하여 dataLoadDataSets 리소스에서 파일 세부정보를 검색합니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}?onlyData=true&fields=FailedLinesFileContentId,FailedLinesFileEncryptionType,FailedLinesFileEncryptionKey응답은 다음과 같습니다.주:
파일을 제출할 때 반환된 RequestId 값으로 {{RequestId}}을(를) 바꿉니다.{ "FailedLinesFileContentId": "107468_ERRFILE", "FailedLinesFileEncryptionType": "PGPUNSIGNED", "FailedLinesFileEncryptionKey": "customer-key" }
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/generateFailedLinesFile
주:
파일을 제출할 때 반환된 RequestId 값으로 {{RequestId}}을(를) 바꿉니다.{
"includeMessagesFlag" : "Y",
"messageLanguage" : "US",
"fileEncryption" : "PGPUNSIGNED",
"encryptionKey" : "<customer-key>"
}
참고:
<customer-key>를 파일 암호화에 사용할 PGP 인증서 이름으로 바꿉니다. 보안 콘솔의 인증서 페이지에서 찾은 이름을 제공합니다.
이 사용자정의 작업에 사용할 수 있는 매개변수는 다음과 같습니다.
| 매개변수 | 설명 | 기본값 | 필수사항 |
|---|---|---|---|
| includeMessagesFlag | 파일에 경고 및 오류 메시지가 포함되는지 여부를 결정합니다. Y 또는 N을 제공합니다. | "N" | |
| messageLanguage | 메시지를 제공할 언어를 식별하는 2자 코드입니다. | "미국" | |
| fileEncryption | 생성된 파일을 암호화할 암호화 유형입니다. 유효한 값은 PGPUNSIGNED, PGPSIGNED 및 NONE입니다. |
항상. 파일을 암호화하지 않을 경우 NONE을 지정해야 합니다. | |
| encryptionKey | 생성된 파일을 암호화할 PGP 인증서입니다. 보안 콘솔의 PGP 인증서 목록에서 사용할 수 있어야 합니다. HDL은 개인 키로 해독 할 수 있도록 공개 키로 파일을 암호화합니다. | fileEncryption가 PGPUNSIGNED 또는 PGPSIGNED인 경우 |
{
"result": {
"Status": "SUCCESS",
"RequestId": "107640",
"ErrorFileContentID": "107468_ERRFILE",
"UserInfo": "The file will be available on the Oracle WebCenter on completion of this process."
}
}
비즈니스 객체에 대한 실패한 라인 파일 생성
generateFailedLinesFile 사용자 정의 작업은 하위 businessObjects 리소스에서도 사용할 수 있습니다. 데이터 세트 레벨 사용자정의 작업과 동일한 매개변수가 있습니다.
- Postman에서 이 URL에 대한 새 POST 요청을 만듭니다.
- 다음 JSON 본문을 지정합니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다. 응답의 형식은 다음과 같습니다.
- 이 GET URL을 사용하여 dataLoadDataSets 리소스에서 파일 세부정보를 검색합니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}?onlyData=true&fields=FailedLinesFileContentId,FailedLinesFileEncryptionType,FailedLinesFileEncryptionKey응답은 다음과 같습니다.작업 4에 설명된 대로 businessObjects 리소스에서 최신 파일 세부 정보를 가져올 수도 있습니다. 응답에는 다음 필드가 포함됩니다.
{ "FailedLinesFileContentId": "107468_JOB_ERRFILE", "FailedLinesFileEncryptionType": "PGPUNSIGNED", "FailedLinesFileEncryptionKey": "customer-key" }
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/generateFailedLinesFile
주:
Replace {{RequestId}} with the RequestId value returned when you submitted your file and {{DataSetBusObjId}} with the DataSetBusObjId for the business object in the data set that you want to generate the file for.{
"includeMessagesFlag" : "Y",
"messageLanguage" : "US",
"fileEncryption" : "PGPUNSIGNED",
"encryptionKey" : "customer-key"
}
{
"result": {
"Status": "SUCCESS",
"RequestId": "107669",
"ErrorFileContentID": "107468_JOB_ERRFILE",
"UserInfo": "The file will be available on the Oracle WebCenter on completion of this process."
}
}
태스크 7: 제출된 프로세스 세부정보 검색
데이터 세트에 대해 제출된 프로세스 및 하위 프로세스에 대한 정보를 검색할 수 있습니다.
프로세스 세부정보 검색
일반적으로 비즈니스 객체 및 데이터 세트 사후 프로세스와 함께 데이터 세트의 각 비즈니스 객체에 대한 이전, 임포트 및 로드 프로세스에 대한 레코드가 표시됩니다. 로드 다시 제출, 롤백 제출 또는 실패한 라인 생성과 같은 데이터 세트의 추가 처리를 제출한 경우 추가 프로세스가 있습니다.
- Postman에서 이 URL에 대한 새 GET 요청을 생성합니다.
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/processes?onlyData=true&fields=ProcessId,ProcessCode,BusinessObjectName,FileActionCode,TotalCount,ErrorCount,ElapsedTime,ThreadsAllocated,ThreadsUsed
응답이 근로자 비즈니스 객체를 포함하는 데이터 세트를 찾을 수 있는 방법입니다. 이 예에서는 업무 객체에 대해 로드를 두 번 실행했습니다.
{
"items": [
{
"ProcessId": 300100618948404,
"ProcessCode": "ORA_TRANSFER_OBJECT",
"BusinessObjectName": "Worker",
"FileActionCode": null,
"TotalCount": 540,
"ErrorCount": 0,
"ElapsedTime": "+000000000 00:00:40.347000",
"ThreadsAllocated": 8,
"ThreadsUsed": 1
},
{
"ProcessId": 300100618948432,
"ProcessCode": "ORA_IMPORT_OBJECT",
"BusinessObjectName": "Worker",
"FileActionCode": null,
"TotalCount": 540,
"ErrorCount": 0,
"ElapsedTime": "+000000000 00:00:13.475000",
"ThreadsAllocated": 8,
"ThreadsUsed": 8
},
{
"ProcessId": 300100618950528,
"ProcessCode": "ORA_LOAD_OBJECT",
"BusinessObjectName": "Worker",
"FileActionCode": "IMPORT_AND_LOAD",
"TotalCount": 54,
"ErrorCount": 54,
"ElapsedTime": "+000000000 00:00:43.242000",
"ThreadsAllocated": 8,
"ThreadsUsed": 3
},
{
"ProcessId": 300100618950575,
"ProcessCode": "ORA_HDL_POST_PROCESS",
"BusinessObjectName": "Worker",
"FileActionCode": null,
"TotalCount": 0,
"ErrorCount": 0,
"ElapsedTime": "+000000000 00:00:43.444000",
"ThreadsAllocated": null,
"ThreadsUsed": null
},
{
"ProcessId": 300100619031844,
"ProcessCode": "ORA_LOAD_OBJECT",
"BusinessObjectName": "Worker",
"FileActionCode": "ORA_LOAD",
"TotalCount": 54,
"ErrorCount": 11,
"ElapsedTime": "+000000000 00:14:56.706000",
"ThreadsAllocated": 8,
"ThreadsUsed": 3
},
{
"ProcessId": 300100619039767,
"ProcessCode": "ORA_HDL_POST_PROCESS",
"BusinessObjectName": "Worker",
"FileActionCode": null,
"TotalCount": 0,
"ErrorCount": 0,
"ElapsedTime": "+000000000 00:00:34.738000",
"ThreadsAllocated": null,
"ThreadsUsed": null
},
{
"ProcessId": 300100619039775,
"ProcessCode": "ORA_ORACLE_SEARCH",
"BusinessObjectName": "Worker",
"FileActionCode": null,
"TotalCount": 0,
"ErrorCount": 0,
"ElapsedTime": "+000000000 00:01:41.009000",
"ThreadsAllocated": null,
"ThreadsUsed": null
}
...
하위 프로세스 정보 검색
subprocesses는 processes 리소스의 하위 리소스입니다. 지정된 프로세스에서 제출한 하위 프로세스의 세부정보를 검색합니다. 이전, 임포트 및 로드 프로세스의 경우 다중 스레드 프로세스에 대한 세부정보가 됩니다. ORA_HDL_POST_PROCESS의 경우 제출된 개별 게시 프로세스가 자세히 설명됩니다.
- Postman에서 이 URL에 대한 새 GET 요청을 생성합니다.
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/processes/{{ProcessId}}/child/subprocesses?onlyData=true&fields=ProcessName,ProcessId,ProcessCode,Elapsedtime,ProcessStatusMeaning
주:
파일을 제출할 때 {{RequestId}}을(를) 반환된 RequestId 값으로 바꾸고, 하위 프로세스를 사용할 프로세스에 대해 {ProcessId}}을(를) ProcessId로 바꿉니다.이렇게 하면 응답이 근로자 비즈니스 객체에 대해 제출된 ORA_HDL_POST_PROCESS 프로세스를 찾을 수 있습니다.
{
"items": [
{
"ProcessName": "Refresh Manager Hierarchy",
"ProcessId": 300100619039790,
"ProcessCode": "WORKER_REFRESHMANAGERHIERARCHY",
"Elapsedtime": "+000000000 00:00:08.216000",
"ProcessStatusMeaning": "Succeeded"
},
{
"ProcessName": "Update Person Search Keywords",
"ProcessId": 300100619037746,
"ProcessCode": "WORKER_UPDATEPERSONSEARCHKEYWORDS",
"Elapsedtime": "+000000000 00:00:09.093000",
"ProcessStatusMeaning": "Succeeded"
},
{
"ProcessName": "EMEA Localization Postprocessing",
"ProcessId": 300100619037756,
"ProcessCode": "WORKER_EMEALOCALIZATIONPOSTPROCESSING",
"Elapsedtime": "+000000000 00:00:02.959000",
"ProcessStatusMeaning": "Succeeded"
},
{
"ProcessName": "Global Tax Reporting Unit Maintenance",
"ProcessId": 300100619037764,
"ProcessCode": "WORKER_GLOBALTAXREPORTINGUNITMAINTENANCE",
"Elapsedtime": "+000000000 00:00:02.702000",
"ProcessStatusMeaning": "Succeeded"
}
...
작업 8: 기존 데이터 집합 처리 제출
HCM 데이터 로더 파일만 임포트되었거나 이전에 실패한 레코드를 로드하려고 시도하려는 경우 데이터 세트에 대한 로드를 제출할 수 있습니다. 레코드를 성공적으로 로드한 경우 데이터 세트에 대해 롤백을 제출할 수 있습니다. 롤백 작업은 롤백 작업을 지원하는 비즈니스 객체에 대해서만 시작됩니다.
참고:
businessObjects 리소스의 RollbackEnabledFlag 요소는 비즈니스 객체가 롤백을 지원하는지 여부를 나타냅니다.데이터 세트 처리 제출
- Postman에서 이 URL에 대한 새 POST 요청을 만듭니다.
- 다음 JSON 본문을 지정합니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다. 응답의 형식은 다음과 같습니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/submit
주:
파일을 제출할 때 반환된 RequestId 값으로 {{RequestId}}을(를) 바꿉니다.{
"fileAction" : "LOAD"
}
이 사용자정의 작업에 사용할 수 있는 매개변수는 다음과 같습니다.
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| fileAction | 유효한 값은
참고: HSDL 파일의 경우 파일만 임포트하는 경우 REST를 사용하여 로드할 수 없습니다. 대신 템플리트에 대한 스프레드시트를 생성하고 데이터 세트를 인출하여 스프레드시트에서 업로드하십시오. |
"로드" |
| loadConcurrentThreads | 로드 프로세스에 지정할 최대 동시 스레드 수입니다. | 로드에 대한 최대 동시 스레드 매개변수에서 기본값이 설정됩니다. |
{
"result": {
"Status": "SUCCESS",
"RequestId": "107683"
}
}
데이터 세트 내의 비즈니스 객체에 대한 처리 제출
제출 사용자정의 작업은 동일한 매개변수가 있지만 URL로 지정된 비즈니스 객체의 처리만 제출하는 비즈니스 객체 레벨에서도 사용할 수 있습니다.
이 URL을 사용하여 특정 비즈니스 객체에 대한 처리를 시작합니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/submit
주:
데이터 세트 내에서 비즈니스 객체를 검토할 때 반환되는 {{DataSetBusObjId}} 값을 반환되는 DataSetBusObjId 값으로 바꿉니다.참고:
위의 오류로 인해 Job.dat 파일에서 참조하는 직무군을 생성하는 JobFamily.zip 파일을 Base64 인코딩, 업로드 및 제출하여 이를 테스트할 수 있습니다.작업 계열이 성공적으로 로드되면 위에 설명된 대로 데이터 집합 내에서 데이터 집합 또는 작업 비즈니스 객체에 대한 LOAD를 시작합니다.
태스크 9: 진행 중인 데이터 세트 또는 비즈니스 객체 중지
진행 중인 데이터 세트 및 비즈니스 객체 중지를 요청할 수 있습니다.
데이터 세트 처리 중지
- Postman에서 이 URL에 대한 새 POST 요청을 만듭니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/stop
이 작업에 대한 매개변수가 없습니다.
데이터 세트가 현재 진행 중이 아닌 경우 대신 다음 응답을 받게 됩니다.
{
"result": "You can't stop processing this data set because it isn't being processed. Check the current status of the data set."
}
비즈니스 객체 처리 중지
중지 사용자정의 작업은 비즈니스 객체 레벨에서도 사용할 수 있습니다. 이 URL을 사용하여 특정 비즈니스 객체에 대한 처리를 중지하도록 요청합니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/stop
주:
데이터 세트 내에서 비즈니스 객체를 검토할 때 반환되는 {{DataSetBusObjId}} 값을 반환되는 DataSetBusObjId 값으로 바꿉니다.작업 10: 데이터 집합 삭제
데이터 세트가 처리되고 있지 않은 경우 해당 데이터 세트에 대한 스테이징 테이블 데이터를 삭제할 수 있습니다.
HDL 단계 테이블 데이터 삭제
- Postman에서 이 URL에 대한 새 POST 요청을 만듭니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/deleteDataSet
이 작업에 대한 매개변수가 없습니다.
HSDL 단계 테이블 데이터 삭제
이 작업을 제출하면 HSDL 및 HDL 스테이징 테이블 모두에서 데이터 세트가 삭제됩니다.
- Postman에서 이 URL에 대한 새 POST 요청을 만듭니다.
- Content-Type 헤더를 다음 값으로 설정합니다.
application/vnd.oracle.adf.action+json
- 요청에 대한 권한 부여를 구성하고 전송을 누릅니다.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/deleteSpreadsheetDataSet
이 작업에 대한 매개변수가 없습니다.
관련 링크
- 솔루션 플레이북: Oracle Fusion Cloud Human Capital Management (HCM)으로 데이터 로드
- 사용 설명서: HCM 데이터 로더
- 예제별 HCM 데이터 로더 Oracle 자습서
작동 섹션에서는 Oracle WebCenter Content 서버에 파일을 로드하는 다른 방법에 대해 설명합니다.
추가 학습 자원
docs.oracle.com/learn에서 다른 랩을 탐색하거나 Oracle Learning YouTube 채널에서 더 많은 무료 학습 콘텐츠에 액세스하세요. 또한 education.oracle.com/learning-explorer를 방문하여 Oracle Learning Explorer가 되십시오.
제품 설명서는 Oracle Help Center를 참조하십시오.