이 사용지침서에서는 HCM 데이터 로더(HDL)를 사용하여 데이터를 Oracle HCM Cloud로 업로드하는 OIC(Oracle Integration Cloud) 통합을 생성합니다. 소스 파일은 압축, 암호화 및 Oracle WebCenter에 업로드되기 전에 FTP 서버에서 해독, 압축 해제, HDL 비즈니스 객체 파일 구성으로 변환됩니다. 마지막으로 파일의 데이터를 임포트하고 로드하기 위해 HCM 데이터 로더가 시작됩니다.
이 자습서에 제공된 단계는 HDL을 사용하는 모든 인바운드 통합에 사용할 수 있습니다. 제공된 파일을 사용하여 단계를 완료하여 새 고용 통합을 생성합니다.
업로드된 파일 정의에서 생성된 정보를 검토합니다. 필요에 따라 변경하고 계속 및 완료를 누릅니다.
작업 5: 파일에 쓰기
이 태스크에서는 업데이트 중인 HDL 비즈니스 객체에 대해 이름이 지정되어야 하는 HCM 데이터 로더 파일을 생성합니다.
상수 값 지정
파일 정의 내에서 여러 번 사용되는 속성 값에 대한 변수를 생성하면 매핑 프로세스가 간소화됩니다. 이러한 변수를 수동으로 반복해서 입력하는 대신 변수를 매핑할 수 있으며 필요한 경우 매핑된 모든 필드를 업데이트하기 위해 한 번 변경됩니다. 여기서 ActionCode 및 SourceSystemOwner과 같은 속성에 대한 상수를 생성합니다.
ReadFile 작업 뒤에 Assign 작업을 만들고 이름을 AssignFileConstants으로 지정합니다.
정기적으로 참조하는 상수 값에 대한 문자열 기반 변수를 생성합니다. 신규입사자 통합의 경우 다음을 정의합니다.
이름
설명
값
SourceSystemOwner
출처 시스템 소유자의 이름입니다.
소스 시스템 소유자 이름입니다. 예를 들어 'VISION'입니다.
유효 종료 일자
새 유효 일자 레코드에 대한 유효 종료 일자입니다.
'4712/12/31'
ActionCode
작업 코드입니다.
'HIRE'
LegislationCode
국가 코드입니다.
'US'
HDL 비즈니스 객체 파일 작성
AssignFileConstants 작업 뒤에 WriteFile 이름을 지정하고 선택적으로 설명을 지정하여 Stage File 작업을 만듭니다. 계속을 누릅니다.
파일 쓰기 단계 파일 작업을 선택합니다.
변환된 데이터를 작성할 파일 이름을 지정합니다. HDL 비즈니스 객체 파일의 이름(예: 'Worker.dat')을 제공해야 합니다.
파일에 대한 임시 출력 디렉토리(예: 'WorkerOutput')를 지정합니다. 계속을 누릅니다.
파일 내용의 구조를 설명하려면 XSD(XML 체계) 문서를 지정합니다. 계속을 누릅니다.
소스 파일 구조 예가 포함된 파일을 끌어 놓습니다.
참고:
이 자습서의 필요 조건에 따라 생성한 nxsd 매핑 파일입니다.
스키마 요소를 nxsd 파일의 맨 위에 정의된 요소로 설정합니다. 이 요소의 이름은 일반적으로 'FileData'로 끝납니다. 계속을 누릅니다.
완료를 누릅니다.
WriteFile 맵 작업이 자동으로 생성됩니다. 다음 단계에서 이를 구성합니다.
작업 6: WriteFile 매핑을 완료합니다.
이 태스크에서는 출처 데이터를 비즈니스 객체 파일 구성으로 변환하기 위한 매핑을 완료합니다. Worker.dat(이 예)
근로자 비즈니스 객체 계층은 특히 복잡합니다. 새 고용 예제를 사용하여 생성하는 파일은 계층의 해당 구성요소에 대한 레코드를 생성합니다.
근로자(근로자)
개인 법률 데이터(PersonLegislativeData)
개인 이름(PersonName)
개인 전자메일(PersonEmail)
근로 관계(WorkRelationship)
고용 조건 (WorkTerms)
발령(발령)
각 구성 요소의 레이블과 값 모두에 대해 매핑을 정의해야 합니다.
주:
'레이블' 요소에 제공된 값은 METADATA 라인을 생성하는 데 사용되므로 제공된 값은 생성 중인 비즈니스 객체 파일에 대해 적합한 속성 이름이어야 합니다.
참고:
대상 요소의 필드에 대한 매핑 생성을 시작했으면 해당 요소의 모든 필드에 대한 값을 정의해야 합니다. 그렇지 않으면 OIC가 데이터를 변환하지 못합니다.
참고:
Worker와 같은 HDL 파일을 매핑할 때는 여러 가지 구성을 완료해야 합니다. 매핑을 정기적으로 검증하고 통합 내용을 저장합니다.
근로자
WriteFile 맵 작업을 편집하여 매퍼를 엽니다.
왼쪽 패널 소스에는 이 매핑에 사용할 수 있는 모든 사용 가능한 값과 필드가 표시됩니다. 오른쪽의 대상 패널은 쓰기 계층을 보여줍니다. HDL 비즈니스 객체 파일(이 예에서는 Worker.dat)의 구조를 나타냅니다. 해당 구성은 HDL을 사용하여 생성한 nxsd 매핑 파일에 의해 결정되며 WriteFile 작업에 업로드됩니다.
요소의 기술 이름을 표시하려면 개발자 및 XSLT 단추를 누릅니다.
대상 패널에서 WorkerFileData 및 WorkerLabel 요소를 확장합니다.
참고:
'레이블' 요소를 사용하여 각 구성요소에 적용할 수 있는 HDL 비즈니스 객체 속성 이름을 정의해야 합니다.
다음 표현식을 다음 WorkerLabel 대상 요소에 지정합니다.
대상 WorkerLabel 속성
표현식
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonNumberLabel
'PersonNumber'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
StartDateLabel
'StartDate'
ActionCodeLabel
'ActionCode'
DateOfBirthLabel
'DateOfBirth'
참고:
요소의 표현식을 생성하려면 다음과 같이 하십시오.
대상 필드를 마우스 오른쪽 단추로 누르고 대상 노드 생성을 선택합니다.
표현식 패널에서 개발자 뷰로 전환합니다.
따옴표를 포함한 표현식 값을 지정합니다.
틱 아이콘을 눌러 표현식을 저장합니다.
$ReadFile 계층을 확장합니다.
NewHire 반복 소스 요소를 Worker 반복 대상 요소에 매핑합니다.
참고:
매핑을 완료하면 for-each 루프가 내부에 반복되는 Worker 요소로 생성됩니다. XSLT 단추를 누른 경우에만 이와 같이 표시됩니다.
이제 작업자 대상 계층이 NewHire 소스 계층과 연결되고 작업자가 각 for-each 루프의 하위입니다. 즉, 소스 파일의 각 NewHire 레코드에 대해 대상 Worker 레코드가 생성됩니다.
정의된 변수, NewHire 소스 및 Worker 대상 요소 간에 다음 매핑을 생성합니다.
출처 NewHire 속성
대상 WorkerLabel 속성
표현식
(x) $SourceSystemOwner
SourceSystemOwner
employeeExternalNumber
SourceSystemId
employeeExternalNumber
PersonNumber
hireDate
유효 시작 일자
(x) $EffectiveEndDate
유효 종료 일자
hireDate
StartDate
(x) $ActionCode
ActionCode
dob
DateOfBirth
참고:
신규입사자의 경우와 같이 매핑할 구성요소가 여러 개 있는 경우 Oracle WebCenter에 파일 쓰기 시점에 대한 통합 정의를 완료한 후 나머지 매핑을 완료하는 것이 좋습니다. 그런 다음 파일 처리를 위해 HCM 데이터 로더를 시작하기 전에 Oracle WebCenter에 업로드된 생성된 파일을 검토하여 파일 매핑을 반복적으로 활성화하고 테스트할 수 있습니다.
개인 법률 데이터
PersonLegislativeDataLabel 대상 요소를 확장합니다.
이러한 표현식을 다음 PersonLegislativeDataLabel 속성에 지정합니다.
대상 PersonLegislativeDataLabel 속성
표현식
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonId_SourceSystemId_Label
'PersonId(SourceSystemId)'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
LegislationCodeLabel
'LegislationCode'
SexLabel
'성'
$ReadFile 계층의 NewHire 반복 소스 요소를 PersonLegislativeData 반복 대상 요소에 매핑하여 각 for-each 루프를 생성합니다.
정의된 변수, NewHire 소스 및 PersonLegislativeData 대상 요소 간에 다음 매핑을 생성합니다.
출처 NewHire 속성
대상 PersonLegislativeData 속성
표현식
(x) $SourceSystemOwner
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('LD', {employeeExternalNumber} )
employeeExternalNumber
PersonId_SourceSystemId_
hireDate
유효 시작 일자
(x) $EffectiveEndDate
유효 종료 일자
(x) $LegislationCode
LegislationCode
성별
성별
참고:
employeeExternalNumber 소스 요소는 Worker를 고유하게 식별하기 위해 SourceSystemId 값으로 사용됩니다. 다른 구성요소에서 SourceSystemId를 생성하는 데 동일한 필드가 사용됩니다. 그러나 SourceSystemId를 구성요소 전체에서 고유하게 만들면 디버깅이 더 쉬워집니다. employeeExternalNumber 소스 요소를 SourceSystemId 대상 요소로 끌어온 후 concat('LD', 접두어로 표현식을 변경합니다. 표현식 끝에 )를 배치합니다. 구문은 다음과 같습니다.
사용자 이름
PersonNameLabel 대상 요소를 확장합니다.
이러한 표현식을 다음 PersonNameLabel 속성에 지정합니다.
대상 PersonNameLabel 속성
표현식
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonId_SourceSystemId_Label
'PersonId(SourceSystemId)'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
LegislationCodeLabel
'LegislationCode'
NameTypeLabel
'NameType'
FirstNameLabel
'FirstName'
MiddleNamesLabel
'MiddleNames'
LastNameLabel
'LastName'
TitleLabel
'제목'
NewHire 반복 소스 요소를 PersonName 반복 대상 요소에 매핑하여 각 for-each 루프를 생성합니다.
NewHire 소스와 PersonName 대상 요소 간에 다음 매핑을 만듭니다.
출처 NewHire 속성
대상 WorkerLabel 속성
표현식
(x) $SourceSystemOwner
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('PN', {employeeExternalNumber} )
employeeExternalNumber
PersonId_SourceSystemId_
hireDate
유효 시작 일자
(x) $EffectiveEndDate
유효 종료 일자
(x) $LegislationCode
LegislationCode
NameType
'글로벌'
firstName
FirstName
MiddleNames
''
lastName
LastName
title
직함
참고:
요소의 모든 대상 필드에 매핑이 있어야 합니다. 이 예에서 MiddleNames과 같이 지정할 값이 없는 경우 두 개의 따옴표로 표현식을 만듭니다(예: '').
개인 전자메일
PersonEmailLabel 대상 요소를 확장합니다.
이러한 표현식을 다음 PersonEmailLabel 속성에 지정합니다.
대상 PersonEmailLabel 속성
표현식
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonId_SourceSystemId_Label
'PersonId(SourceSystemId)'
DateFromLabel
'DateFrom'
EmailTypeLabel
'EmailType'
EmailAddressLabel
'EmailAddress'
NewHire 반복 소스 요소를 PersonEmail 반복 대상 요소에 매핑하여 각 for-each 루프를 생성합니다.
NewHire 소스와 PersonEmail 대상 요소 간에 다음 매핑을 만듭니다.
출처 NewHire 속성
대상 PersonEmail 속성
표현식
(x) $SourceSystemOwner
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('EM', {employeeExternalNumber})
employeeExternalNumber
PersonId_SourceSystemId_
hireDate
DateFrom
EmailType
'W1'
전자메일
EmailAddress
근로관계
WorkRelationshipLabel 대상 요소를 확장합니다.
이러한 표현식을 다음 WorkRelationshipLabel 속성에 지정합니다.
대상 WorkRelationshipLabel 속성
표현식
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonId_SourceSystemId_Label
'PersonId(SourceSystemId)'
DateStartLabel
'DateStart'
WorkerTypeLabel
'WorkerType'
LegalEmployerNameLabel
'LegalEmployerName'
ActionCodeLabel
'ActionCode'
PrimaryFlagLabel
'PrimaryFlag'
NewHire 반복 소스 요소를 WorkRelationship 반복 대상 요소에 매핑하여 각 for-each 루프를 생성합니다.
NewHire 소스와 WorkRelationship 대상 요소 간에 다음 매핑을 만듭니다.
출처 NewHire 속성
대상 WorkRelationship 속성
표현식
(x) $SourceSystemOwner
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('WR', {employeeExternalNumber})
employeeExternalNumber
PersonId_SourceSystemId_
hireDate
DateStart
WorkerType
'E'
legalEmployerName
LegalEmployerName
(x) $ActionCode
ActionCode
PrimaryFlag
'Y'
고용 조건
WorkTermsLabel 대상 요소를 확장합니다.
다음 표현식을 다음 WorkTermsLabel 속성에 지정합니다.
대상 WorkTermsLabel 속성
표현식
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PeriodOfServiceId_SourceSystemId_Label
'PeriodOfServiceId(SourceSystemId)'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
EffectiveSequenceLabel
'EffectiveSequence'
EffectiveLatestChangeLabel
'EffectiveLatestChange'
ActionCodeLabel
'ActionCode'
AssignmentNameLabel
'AssignmentName'
AssignmentNumberLabel
'AssignmentNumber'
PrimaryWorkTermsFlagLabel
'PrimaryWorkTermsFlag'
NewHire 반복 소스 요소를 WorkTerms 반복 대상 요소에 매핑하여 각 for-each 루프를 생성합니다.
NewHire 소스와 WorkTerms 대상 요소 간에 다음 매핑을 만듭니다.
출처 NewHire 속성
대상 WorkTerms 속성
표현식
(x) $SourceSystemOwner
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('ET', {employeeExternalNumber})
employeeExternalNumber
PeriodOfServiceId_SourceSystemId_
concat('WR',{employeeExternalNumber})
hireDate
유효 시작 일자
(x) $EffectiveEndDate
유효 종료 일자
EffectiveSequence
'1'
EffectiveLatestChange
'Y'
(x) $ActionCode
ActionCode
employeeExternalNumber
AssignmentName
concat('ET', {employeeExternalNumber})
employeeExternalNumber
지정 번호
concat('ET', {employeeExternalNumber})
PrimaryWorkTermsFlag
'Y'
지정
AssignmentLabel 대상 요소를 확장합니다.
다음 표현식을 다음 AssignmentLabel 속성에 지정합니다.
대상 AssignmentLabel 속성
표현식
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
WorkTermsAssignmentId_SourceSystemId_Label
'WorkTermsAssignmentId(SourceSystemId)'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
EffectiveSequenceLabel
'EffectiveSequence'
EffectiveLatestChangeLabel
'EffectiveLatestChange'
ActionCodeLabel
'ActionCode'
AssignmentNameLabel
'AssignmentName'
AssignmentNumberLabel
'AssignmentNumber'
PrimaryAssignmentFlagLabel
'PrimaryAssignmentFlag'
BusinessUnitShortCodeLabel
'BusinessUnitShortCode'
AssignmentStatusTypeCodeLabel
'AssignmentStatusTypeCode'
PersonTypeCodeLabel
'PersonTypeCode'
ProjectedStartDateLabel
'ProjectedStartDate'
NewHire 반복 소스 요소를 Assignment 반복 대상 요소에 매핑하여 각 for-each 루프를 생성합니다.
NewHire 소스와 Assignment 대상 요소 간에 다음 매핑을 생성합니다.
출처 NewHire 속성
대상 지정 속성
표현식
(x) $SourceSystemOwner
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('E', {employeeExternalNumber})
employeeExternalNumber
PersonId_SourceSystemId_
concat('ET', {employeeExternalNumber})
hireDate
유효 시작 일자
(x) $EffectiveEndDate
유효 종료 일자
EffectiveSequence
'1'
EffectiveLatestChange
'Y'
(x) $ActionCode
ActionCode
employeeExternalNumber
AssignmentName
concat('E', {employeeExternalNumber})
employeeExternalNumber
지정 번호
concat('E', {employeeExternalNumber})
PrimaryAssignmentFlag
'Y'
businessUnit
BusinessUnitShortCode
AssignmentStatusTypeCode
'ACTIVE_PROCESS'
PersonTypeCode
'직원'
hireDate
ProjectedStartDate
SET 지침
파일에 SET 지침을 포함해야 하는 경우 다음 단계를 수행합니다.
SetInstructions 대상 요소를 확장합니다.
Instruction 속성에 대한 전체 SET 지침을 포함할 표현식을 생성합니다.
작업 7: 생성된 파일 압축
이 작업에서는 생성한 파일을 압축합니다.
WriteFile 작업 바로 아래에 Stage File 작업을 추가하고 이름을 ZipFile로 지정합니다.
Zip File 스테이지 파일 작업을 선택합니다.
zip 파일의 파일 이름(예: NewHires.zip)을 지정합니다.
디렉토리 필드에 대한 개발자 뷰 아이콘을 누르고 $WriteFile 소스 계층 에서 디렉토리를 선택합니다.
출력 디렉토리에 대해 'outputdirectory'를 지정합니다.
계속 및 완료를 누릅니다.
작업 8: 파일 암호화
Oracle WebCenter에 로드되는 모든 파일을 암호화하는 것이 좋습니다.
이 작업에서는 파일을 암호화할 시기를 제어할 수 있는 스위치를 만듭니다. 개발 중에 파일을 암호화되지 않은 상태로 두어 통합 정의 및 파일 변환을 테스트할 수 있습니다.
HCM 데이터 로더 매개변수에 대한 변수 정의
오른쪽 탐색 패널에서 작업을 누르고 지정을 선택합니다. 통합의 첫 번째 작업이 되도록 스케줄 뒤의 + 아이콘으로 끌어옵니다.
작업 이름을 AssignHDLParameters로 바꿉니다.
FileEncryption라는 변수를 만들고 'NONE' 값을 지정합니다.
DeleteSourceFile라는 두 번째 변수를 만들고 'N' 값을 지정합니다.
참고:
개발과 생산 간에 변경할 수 있는 다른 HDL 매개변수에 대해서도 반복합니다.
주:
FileEncryption 변수가 다음 단계에서 생성된 스위치에서 참조되므로 이제 이러한 변수를 생성하고 있습니다.
제어 파일 암호화로 전환 생성
오른쪽 탐색 패널에서 작업을 누르고 논리 머리글 아래에서 전환을 선택합니다. ZipFile 작업 뒤의 + 아이콘으로 끌어옵니다. 경로 구성 페이지가 표시됩니다.
에서 
