소개

이 사용지침서에서는 데이터를 HCM 데이터 로더 비즈니스 객체 파일 구성으로 변환하기 위해 OIC(Oracle Integration Cloud)로 임포트할 수 있는 비즈니스 객체 관련 매핑 파일을 생성하고 편집하는 단계에 대해 설명합니다.

목표

이 자습서에서는 다음을 수행합니다.

• 매핑 파일 생성을 사용으로 설정합니다.
• 일반 및 사용자정의 매핑 파일을 생성합니다.
• 생성된 매핑 파일을 편집합니다.

필요 조건

이 자습서의 단계를 완료하려면 다음에 대한 액세스 권한이 필요합니다.

• 매핑 파일 생성을 사용으로 설정하는 HCM 데이터 로더 구성 태스크입니다.
• 일반 매핑 파일을 생성하는 비즈니스 객체 보기 태스크입니다.
• HCM 데이터 로더 - 테스트 파일을 임포트하고 사용자정의 매핑 파일을 생성합니다.

이 접근 구성 단계는 HCM 데이터 로더(HDL)에 대한 접근 구성 및 HDL 보안 옵션 이해 자습서를 참조하십시오.

작업 1: 매핑 파일 생성 사용

이 단계에서는 HCM 데이터 로더 내에서 OIC 매핑 파일 생성을 사용으로 설정합니다.

다음 두 가지 방법으로 매핑 파일을 생성할 수 있습니다.

• 완전한 일반 비즈니스 객체 파일을 생성합니다.

  비즈니스 객체 보기 태스크를 사용하여 전체 비즈니스 객체 계층을 설명하는 매핑 파일을 생성하고 다운로드합니다.

• 사용자정의 비즈니스 객체 파일을 생성합니다.

  임포트한 파일의 모양에 매핑 파일을 생성하는 동안 테스트 파일을 임포트 및 로드하여 파일 모양을 확인합니다.

매핑 파일 생성을 사용으로 설정하려면 다음을 수행합니다.

1. Oracle HCM Cloud 애플리케이션에 로그인합니다.
2. 내 엔터프라이즈 > 설정 및 유지 관리로 이동합니다.
3. HCM 데이터 로더 기능별 영역을 선택합니다.
4. HCM 데이터 로더 구성 태스크를 누릅니다.





5. 비즈니스 객체 매핑 파일 생성 매개변수를 검색합니다.





6. 대체를 예로 설정합니다.

매핑 파일 생성을 사용으로 설정할 때 두 가지 대체 옵션을 사용할 수 있습니다.

우선 적용 값	설명
사용자정의만	HCM 데이터 로더로 업로드한 비즈니스 객체 dat 파일에 대한 매핑 파일을 생성하는 기능을 사용으로 설정합니다.
예	사용자정의 파일 외에 비즈니스 객체 보기 태스크에서 일반 매핑 파일을 생성할 수 있습니다.



7. 저장을 누릅니다.

참고:

자세한 내용은 HCM 데이터 로더 구성 매개변수 항목에서 비즈니스 객체 매핑 파일 생성을 검색합니다.

작업 2: 전체 매핑 파일 생성

이 단계에서는 전체 비즈니스 객체 계층에 대한 매핑 파일을 생성합니다.

1. Oracle HCM Cloud 애플리케이션에 로그인합니다.
2. 내 클라이언트 그룹 > 데이터 교환 > 비즈니스 객체 보기로 이동합니다.
3. 문서 레코드 비즈니스 객체를 검색하여 선택하고 객체 새로고침을 누릅니다.





4. 통합 매핑 파일 열에 문서 레코드 비즈니스 객체에 대한 다운로드 파일 아이콘이 표시될 때까지 테이블 콘텐츠를 새로 고칩니다.





5. 파일 다운로드 아이콘을 누르면 매핑 파일이 다운로드됩니다.

주:

작업 4에서 이 파일을 편집합니다.

작업 3: 사용자 정의 매핑 파일 생성

이는 OIC에 대한 매핑 파일을 생성하는 데 권장되는 방법입니다. 먼저 OIC 통합에서 파일을 생성할 구성에서 HCM 데이터 로더 파일을 생성합니다. 이렇게 하면 통합을 구축하기 전에 HDL 파일 구성이 올바른지 테스트하는 이점이 있습니다.

1. HDL 비즈니스 객체 파일을 정의합니다. 이 자습서에서는 작업자 매핑 File.zip 파일을 다운로드할 수 있습니다.
2. Oracle HCM Cloud 애플리케이션에 로그인합니다.
3. 내 클라이언트 그룹 > 데이터 교환 > 데이터 임포트 및 로드로 이동합니다.
4. 파일 임포트를 누릅니다.
5. 다운로드한 Worker Mapping File.zip을 Choose File 버튼으로 끌어서 Review Parameters(매개변수 검토)를 누릅니다.





6. 비즈니스 객체 매핑 파일 생성 체크박스를 선택합니다.





7. 제출을 누릅니다.
8. 확인을 눌러 제출됨 확인 창을 닫습니다.
9. 테스트 파일이 표시될 때까지 데이터 세트 테이블을 새로 고칩니다.
10. 경우에 따라 임포트가 완료될 때까지 데이터 세트에 대한 비즈니스 객체 테이블을 새로 고칩니다.
11. 비즈니스 객체 테이블 도구 모음에서 매핑 파일 다운로드를 눌러 사용자정의 매핑 파일을 다운로드합니다.

    비즈니스 객체 파일을 임포트하면 이 단추가 사용으로 설정됩니다.

참고:

가져오기 오류가 있는 경우 파일 모양이 올바르지 않을 수 있습니다. 테스트 파일을 성공적으로 임포트한 경우에만 오류를 검토 및 수정하고 매핑 파일을 다운로드합니다.

작업 4: 매핑 파일 편집

HCM 데이터 로더에서 생성된 매핑 파일을 편집할 수 있습니다. 이 태스크에서는 태스크 2에서 생성한 문서 레코드 매핑 파일을 편집합니다.

파일 구성 이해

1. 작업 2에서 생성한 DocumentsOfRecord.nxsd 파일을 엽니다.
2. 파일 내용을 검토합니다. 모든 매핑 파일은 동일한 구조를 따르며 다음과 같은 세 가지 유형의 요소 그룹이 있습니다.
   • ObjectFileData 그룹

     파일 맨 위에 있는 하나의 ObjectFileData 그룹이 있습니다. 계층의 각 비즈니스 객체에 대해 이 그룹에는 ObjectLabel 요소 및 객체 요소가 포함됩니다.

     • ObjectLabel 요소는 METADATA 라인을 정의합니다.
     • Object 요소는 MERGE(데이터) 라인을 정의합니다.

     참고:

     선의 형식도 정의됩니다.

   • ObjectLabel 그룹

     객체 계층의 모든 비즈니스 객체에 대해 ObjectLabel 그룹이 있습니다. ObjectLabel 그룹에는 비즈니스 객체에 사용할 수 있는 속성의 이름을 정의하는 요소가 포함되어 있습니다. OIC가 이 매핑을 사용하여 파일을 생성할 때 위의 ObjectFileData 그룹에 정의된 ObjectLabel 요소에 속성 이름(및 종료자)이 추가됩니다.

   • Object 그룹

     객체 계층의 모든 비즈니스 객체에 대한 객체 그룹이 있습니다. 객체 그룹에는 비즈니스 객체에 사용 가능한 속성의 값을 매핑하는 요소가 포함됩니다. OIC가 이 매핑을 사용하여 파일을 생성할 때 위의 ObjectFileData 그룹에 정의된 객체 요소에 속성 값(및 종료자)이 추가됩니다.

3. ObjectFileData 그룹 DocumentOfRecordFileData를 검토합니다.

DocumentsOfRecord 비즈니스 객체 계층에는 DocumentOfRecord 및 DocumentAttachment의 두 객체가 있습니다. 계층의 각 비즈니스 객체에 대해 ObjectLabel 요소 및 객체 요소가 생성됩니다.





4. ObjectLabel 그룹 DocumentOfRecordsLabel를 검토합니다.

이 그룹에는 배포된 가변필드 세그먼트 속성을 포함하여 DocumentsOfRecord 비즈니스 객체에 사용할 수 있는 각 속성의 이름을 정의하는 요소가 포함됩니다.






주:

전체 그룹이 너무 커서 여기에 표시할 수 없습니다.
5. 객체 그룹 DocumentOfRecord를 검토합니다.

이 그룹에는 DocumentsOfRecord 비즈니스 객체에 사용할 수 있는 각 속성의 값을 매핑하는 요소가 포함됩니다.






참고:

동일한 비즈니스 객체에 대한 ObjectLabel 및 객체 그룹의 속성 순서가 대응해야 합니다.
6. ObjectLabel 그룹 DocumentAttachmentLabel를 검토합니다.

이 그룹에는 DocumentAttachment 비즈니스 객체에 사용할 수 있는 각 속성의 이름을 정의하는 요소가 포함됩니다.





7. 객체 그룹 DocumentAttachment를 검토합니다.

이 그룹에는 DocumentAttachment 비즈니스 객체에 사용할 수 있는 각 속성의 값을 매핑하는 요소가 포함됩니다.

DocumentOfRecord 구성 편집

OIC에서는 매핑 파일의 요소에 의해 정의된 모든 속성에 대한 값을 제공해야 합니다. 생성된 HDL 파일에 속성이 필요하지 않은 경우 ObjectLabel 및 객체 그룹에서 속성에 대한 두 요소를 모두 제거합니다.

1. 다음을 제외한 모든 속성에 대해 DocumentsOfRecordLabel 및 DocumentsOfRecord 그룹에서 요소를 삭제합니다.
   • DocumentName
   • DocumentCode
   • PersonNumber
   • DocumentType
2. 이 속성 순서로 표시되도록 이러한 그룹의 요소 순서를 재지정합니다.
   • PersonNumber
   • DocumentType
   • DocumentCode
   • DocumentName

   

   
   

   주:

   그룹의 마지막 요소에 다른 terminatedBy 값이 있습니다. 대부분의 요소는 파이프 문자에 의해 종료되고 마지막 요소는 라인 문자의 끝에 의해 종료됩니다. 파일을 편집할 때 각 그룹의 마지막 요소가 행 종료자의 끝을 갖도록 합니다.

   참고:

   이러한 그룹의 요소 순서는 OIC에서 생성된 파일에 속성이 포함되는 순서를 결정합니다. 예를 들어, 이 구조는 다음 METADATA 행을 생성합니다.

   METADATA|DocumentsOfRecord|PersonNumber|DocumentType|DocumentCode|DocumentName

DocumentAttachment 구성 편집

1. 다음을 제외한 모든 속성에 대해 DocumentAttachmentLabel 및 DocumentAttachment 그룹에서 요소를 삭제합니다.
   • 직함
   • 파일
   • DataTypeCode
   • DocumentCode
   • PersonNumber
   • DocumentType
   • URLorTextorFileName
2. 이 속성 순서로 표시되도록 이러한 그룹의 요소 순서를 재지정합니다.
   • PersonNumber
   • DocumentType
   • DocumentCode
   • DataTypeCode
   • URLorTextorFileName
   • 직함
   • 파일

   

   
   

   이 METADATA 라인이 생성됩니다.

   METADATA|DocumentAttachment|PersonNumber|DocumentType|DocumentCode|DataTypeCode|URLorTextorFileName|Title|File

이제 파일을 OIC로 임포트하여 HDL DocumentOfRecord.dat 파일을 생성할 수 있습니다.

주:

데이터를 제공할 필요가 없는 경우 생성된 매핑 파일에서 전체 비즈니스 객체 정의를 제거할 수 있습니다. 이렇게 하려면 비즈니스 객체에 대한 ObjectLabel 및 객체 그룹과 ObjectFileData 그룹에서 ObjectLabel 및 객체 요소를 모두 제거합니다.

SET 지침을 파일 구성에 추가

SET 지침을 비즈니스 객체 파일에 포함해야 할 수도 있습니다. 이 작업을 수행하는 가장 간단한 방법은 nxsd를 편집하여 OIC 매핑 내에서 SET 지침을 정의할 수 있는 요소를 생성하는 것입니다.

이 단계에서는 작업 3에서 생성한 Worker.nxsd를 편집합니다.

1. 텍스트 편집기에서 작업 3에서 생성한 Worker.nxsd 파일을 엽니다.

WorkerFileData 요소는 다음과 같아야 합니다.





2. 이 요소를 편집하여 WorkerLabel 참조 앞에 참조 항목을 삽입합니다. 추가:

<element ref="tns:SetInstructions" minOccurs="0" nxsd:startsWith="">

3. WorkerFileData 요소 바로 아래에 새 SetInstructions 요소를 만듭니다.

<!-- SetInstructions -->
  <element name="SetInstructions">
      <complexType>
         <sequence>
            <element name="Instruction" type="string" nxsd:style="terminated" nxsd:terminatedBy="${eol}" />
         </sequence>
      </complexType>
   </element>

참고:

이것은 하나의 SET 명령어를 지원합니다. OIC에서 생성할 파일 내에 여러 SET 지침을 정의해야 하는 경우 Instruction1, Instruction2 등의 추가 요소를 생성합니다.

다음 단계

이 자습서의 단계에 따라 OIC가 HCM 데이터 로더 비즈니스 객체 파일 구성에 소스 데이터를 생성하는 데 사용하는 매핑 파일을 생성합니다.

• OIC(Oracle Integration Cloud)에서 HCM 데이터 로더(HDL) 통합 설정 태스크
• Oracle Integration Cloud(OIC)용 암호화 HCM 데이터 로더(HDL) 통합

감사의 글

• Authors - Ema Johnson(수석 수석 제품 관리자)

추가 학습 자원

docs.oracle.com/learn에서 다른 랩을 탐색하거나 Oracle Learning YouTube 채널에서 더 많은 무료 학습 콘텐츠에 액세스하세요. 또한 education.oracle.com/learning-explorer를 방문하여 Oracle Learning Explorer가 되십시오.

제품 설명서는 Oracle Help Center를 참조하십시오.

---

제목 및 저작권 정보

OIC(Oracle Integration Cloud)에서 사용할 HCM 데이터 로더(HDL) 매핑 파일 생성

G35328-01

2025년 5월

Copyright ©2025,

Oracle and/or its affiliates.