HCM 스프레드시트 데이터 로더(HDSL)를 사용하여 비즈니스 사용자 및 인바운드 통합에 대한 대량 데이터 로딩 기능을 제공합니다. 특정 사용 사례에 대한 스프레드시트 템플리트를 구성하고 필요한 역할에만 해당 템플리트에 대한 접근 권한을 지정할 수 있습니다. 예를 들어 채용 통합에서 새 고용 스프레드시트에 접근할 수 있는 반면 초과 근무 시간 스프레드시트는 급여 관리자가 사용할 수 있습니다.
주:
통합에 HSDL을 사용하면 템플리트에서 지원되는 사용 사례로 업로드된 데이터를 제한할 수 있다는 이점이 있습니다. 필요한 경우 데이터 보안을 적용할 수도 있습니다.
목표
이 자습서에서는 다음 작업을 수행합니다.
HSDL 템플리트를 설계 및 구성하는 방법 이해
새 고용을 로드할 수 있는 작업 템플리트를 생성합니다.
근로자 비즈니스 객체는 객체 계층에서 약 30개 구성요소가 5개 레벨을 초과하는 복합 객체입니다. 이 자습서에서는 스프레드시트 템플리트를 정의하기 위한 공통 태스크를 설명하면서 간단한 작업 중인 새 고용 템플리트를 생성하는 방법에 대해 설명합니다. 그런 다음 지원되는 비즈니스 객체에 이러한 단계를 적용할 수 있습니다.
템플리트 생성의 기본 사항을 이해하면 가변 필드 속성, 중복 레코드 등을 포함하도록 지식과 템플리트를 추가로 확장할 수 있습니다. 다음 자습서를 검토하십시오.
작업자 비즈니스 객체에 대한 접근 권한이 있는 HSDL 템플리트 디자이너 롤이 있는 사용자로 애플리케이션에 로그인합니다.
내 클라이언트 그룹 > 데이터 교환 > 스프레드시트 템플리트로 이동합니다.
생성을 눌러 템플리트 생성 페이지를 엽니다.
템플리트 이름 및 코드를 지정하고 비즈니스 객체를 근로자로 설정한 후 선택적으로 설명을 제공합니다.
확인을 누릅니다. 정의 탭으로 이동합니다.
작업 2: 템플리트 속성 선택
이 단계에서는 근로자 객체 계층의 필수 및 권장 구성요소 각각에 필요한 기본 속성을 추가합니다.
여기에 설명된 단계를 반복하여 근로자 비즈니스 객체의 다른 구성요소에서 속성을 추가할 수 있습니다.
주:
비즈니스 객체 보기 태스크를 사용하여 객체 계층 및 지원되는 속성을 검토하고 이해할 수 있습니다.
참고:
객체 계층의 맨 위에서 시작한 다음 계층에 1차 하위 구성요소와 1차 하위 구성요소를 포함하는 것이 좋습니다. 템플리트 디자이너는 자동으로 상위-하위 관계를 생성합니다.
근로자
객체 계층의 근로자 구성요소는 개인 번호 속성을 가진 근로자를 식별하고 생년월일을 수집합니다.
설계를 누릅니다.
사용 가능한 속성 패널에서 작업 코드 속성을 선택하고 선택된 속성 패널에 추가합니다.
템플리트로 첫 번째 속성을 선택하면 디자이너는 레코드를 고유하게 식별하는 데 사용할 키를 묻습니다.
키 선택 대화상자에서 사용자 키를 선택하고 확인을 누릅니다.
참고:
일부 객체에는 여러 사용자 키 조합이 있습니다. 사용자 키 선택 목록을 사용하여 사용 사례에 맞는 올바른 사용자 키를 선택할 수 있습니다. 기존 레코드를 유지 관리하는 데 사용되는 템플리트에 대해 대리 ID를 선택할 수 있습니다. 대리 ID 속성은 검색 가능한 값 목록을 제공합니다.
항상 필요한 기타 속성은 선택된 속성 패널에 자동으로 추가됩니다.
참고:
키 아이콘은 스프레드시트에서 레코드를 고유하게 식별하는 모든 속성 앞에 붙습니다.
페이지 머리글에서 검증 및 저장 단추를 누릅니다.
확인 대화상자에서 확인을 누릅니다.
사용 가능한 속성 패널 도구 모음에서 표시를 누릅니다. 모두 확인란을 선택 취소하고 새 레코드에 필요를 선택합니다.
다중 선택 선택 목록 외부를 눌러 사용 가능한 속성 목록을 지정된 조건을 충족하는 속성으로 필터링합니다.
참고:
선택 표시가 있는 녹색 원은 속성이 이미 선택되었음을 나타냅니다.
시작 날짜를 선택된 속성 패널에 추가합니다.
템플리트를 검증하고 저장합니다.
사용자 이름
개인 이름 구성요소는 사원 이름을 기록합니다.
사용 가능한 속성 헤더 옆에 있는 선택 목록을 누르고 개인 이름을 선택하여 개인 이름 객체에 속하는 속성을 표시합니다.
사용 가능한 속성 패널 도구 모음에서 표시를 누르고 조건부 필수 및 선택 사항 확인란의 선택을 취소합니다.
다중 선택 선택 목록 외부를 눌러 사용 가능한 속성 목록을 지정된 조건을 충족하는 속성으로 필터링합니다.
모두 추가 버튼을 눌러 사용 가능한 속성 패널에 표시된 모든 속성을 선택된 속성 패널에 추가합니다.
새로 선택한 속성 중 일부는 선택된 속성 패널에 표시되지 않습니다. 하위 레코드의 속성은 상위 레코드의 동등한 속성에서 자동으로 기본값이 설정되며 스프레드시트에서 숨겨집니다. 이는 상위(예: PersonNumber)를 식별하는 속성과 유효 시작 일자 속성에 대해 발생합니다.
개인 이름 구성요소의 유효 시작 일자 및 개인 번호 속성이 선택된 속성 패널에 표시되지 않습니다.
참고:
템플리트 정의에 포함되지만 템플리트에서 생성된 스프레드시트에 표시되지 않는 속성을 검토하려면 선택된 속성 패널 도구 모음에서 제외된 속성 표시 체크박스를 선택합니다.
사용 가능한 속성 패널에서 다중 선택 표시 선택 목록을 변경하여 모두 속성을 표시합니다.
사용 가능한 속성 검색 상자에 첫번째를 입력하고 검색 단추를 누릅니다.
선택한 속성 목록에 First Name 속성을 추가합니다.
템플리트에 원하는 다른 선택적 개인 이름 속성을 추가합니다.
템플리트를 검증하고 저장합니다.
개인 법률 데이터
개인 법률 데이터 구성요소는 사원의 결혼 여부 및 성별을 수집합니다.
사용 가능한 속성 패널을 필터링하여 개인 법률 데이터 속성을 표시합니다.
표시 필터를 사용하여 필수 및 새 레코드에 필요인 속성을 표시합니다.
모두 추가를 눌러 사용 가능한 속성 패널에 표시된 모든 속성을 선택된 속성 패널에 추가합니다.
모두 속성을 표시하도록 다중 선택 선택 선택 목록을 표시합니다.
다음 선택적 속성을 검색하여 템플리트에 추가합니다.
Gender
결혼 여부
이제 선택된 속성 패널에 표시되는 개인 법률 데이터 속성을 검토합니다.
사용 가능한 다른 개인 법률 데이터 속성을 검토하고 필요에 따라 템플리트에 추가합니다.
템플리트를 검증하고 저장합니다.
근로관계
근로 관계 구성요소는 사원에 대한 법적 고용주를 지정합니다.
근로 관계 구성요소의 모든 필수 및 새 레코드에 필요 속성을 템플리트에 추가합니다.
다중 선택 표시 선택 목록을 변경하여 모두 속성을 표시하고 기본 고용 속성을 검색하여 템플리트에 추가합니다.
사용 가능한 다른 근로 관계 속성을 검토하고 필요에 따라 템플리트에 추가합니다.
참고:
비즈니스 객체 보기 태스크를 사용하여 사용 가능한 모든 속성을 해당 설명과 함께 검토합니다.
템플리트를 검증하고 저장합니다.
고용 조건
고용 조건은 더 이상 Oracle HCM에 표시되지 않지만 근로 관계 및 지정 레코드를 연결하려면 골격 고용 조건 레코드를 제공해야 합니다.
Employment Terms 객체에서 Required 및 Required for new records 속성을 모두 추가합니다.
템플리트를 검증하고 저장합니다.
지정
할당 레코드 유형은 사원의 부서, 위치, 직위, 직무 등을 지정하는 위치입니다.
지정 객체에 대한 모든 필수 및 새 레코드에 필요 속성을 추가합니다.
모두 속성을 표시하도록 다중 선택 선택 선택 목록을 표시합니다.
템플리트에 필요한 다른 속성을 검색하고 추가합니다. 다음은 몇 가지 제안 사항입니다.
사원 유형
근로 관계에 대한 1차 지정
부서
비즈니스 단위입니다.
직무 코드
위치 코드
등급코드
참고:
비즈니스 객체 보기 태스크를 사용하여 사용 가능한 모든 속성을 해당 설명과 함께 검토합니다.
템플리트를 검증하고 저장합니다.
작업 3: 속성 기본값 구성
이 연습에서는 템플리트 속성에 대한 기본값을 구성하는 방법을 배웁니다. 이렇게 하면 사용자에 대한 데이터 입력이 간소화되고 일반 사용자가 수행할 수 있는 작업을 제한할 수 있습니다.
상수 기본값 구성
상수 값을 가지도록 속성 값을 구성할 수 있습니다.
선택된 속성 패널에서 작업자 구성요소의 작업 코드 속성을 선택하고 패널 도구 모음에서 편집 단추를 누릅니다.
값 라디오 단추를 선택하고, 상수 값 유형을 선택하고, HIRE 값을 지정하여 작업 코드에 대한 기본값을 정의합니다.
확인을 누릅니다.
이러한 다른 속성을 편집하여 상수 값 기본값을 구성합니다.
속성
구성요소
상수 값
이름 유형입니다.
사용자 이름
GLOBAL
유효 순번
고용 조건
1
최신 변경 유효
고용 조건
Y
발령 상태 유형
고용 조건
ACTIVE_PROCESS
주:
룩업 검증 속성에 대한 기본값을 지정하는 경우 의미가 아닌 룩업 코드를 지정해야 합니다.
선택한 다른 속성 값에서 기본값 구성
선택한 다른 속성에서 기본값을 설정하도록 속성을 구성할 수 있습니다.
참고:
스프레드시트 내의 출처 속성에서 자동으로 채워진 속성은 표시되지 않으며 스프레드시트 데이터를 스테이징 테이블로 업로드할 때 기본값이 설정됩니다. 선택한 다른 속성에서 속성 값을 기본값으로 설정하는 경우 항상 기본값으로 설정된 속성을 숨깁니다.
선택된 속성 패널에서 작업자 객체의 유효 시작 날짜 속성을 편집합니다.
값 라디오 단추를 선택하고, 기존 선택된 속성 유형을 선택하고, 값을 복사할 시작 일자 | 근로자 속성을 지정하여 유효 시작 일자 속성에 대한 기본값을 정의합니다.
참고:
파이프 앞의 값은 속성 이름이고 파이프 뒤의 값은 속성이 속한 계층의 구성 요소입니다.
주:
새 고용을 생성하는 경우 근로자 레코드의 유효 시작 일자는 직원의 시작 일자와 동일해야 합니다.
스프레드시트에서 속성을 숨기려면 표시 체크박스의 선택을 취소합니다.
확인을 누릅니다.
주:
템플리트 디자이너가 이미 다른 객체의 유효 시작 일자 속성을 근로자 유효 시작 일자로 기본 설정했으므로 이 작업을 수동으로 수행할 필요가 없습니다.
근로 관계, 고용 조건 및 지정 구성요소의 작업 코드를 편집하여 근로자 구성요소의 작업 코드에서 기본값을 설정하고 스프레드시트에서 속성을 숨깁니다.
이러한 속성을 편집하여 기존 선택된 속성에서 기본값을 구성하고 표시 체크박스를 선택 해제합니다.
속성
구성요소
기존에 선택한 속성
시작 날짜
근로관계
시작일 | 근로자 | ~
국가 번호
개인 법률 데이터
국가 코드 | 개인 이름 | ~
발령 상태 유형
지정
발령 상태 유형 | 고용 조건 | ~
템플리트를 검증하고 저장합니다.
표현식을 사용하여 기본값 구성
Groovy 표현식을 사용하여 속성에 대한 기본값을 정의할 수 있습니다. 여기에는 템플리트에서 속성을 고유하게 식별하는 속성 키를 지정하여 선택된 다른 속성에 대한 참조가 포함될 수 있습니다.
선택한 속성 패널 도구 모음에서 고급 옵션 버튼을 누릅니다.
개인 번호 속성에 대한 속성 키를 찾습니다.
참고:
속성 키는 일반적으로 구성요소 이름(작업자) 다음에 기본 속성 이름(PersonNumber)이 옵니다. 이러한 항목은 편집할 수 있지만 템플리트 내에서 고유해야 합니다.
취소를 누릅니다.
고용 조건 구성요소의 발령 번호 속성을 편집합니다.
값 라디오 단추를 선택하고, 표현식 사용 유형을 선택하고, "ET" + Worker_PersonNumber을 값으로 지정하여 기본값을 정의합니다.
참고:
Worker_PersonNumber가 다른 경우 템플리트에서 사용하는 속성 키로 바꿉니다.
검증을 눌러 표현식을 검증합니다.
확인을 누릅니다.
"E" + Worker_PersonNumber 표현식을 사용하여 지정 구성요소의 지정 번호 속성에 대한 표현식 기본값을 구성합니다.
변경 사항을 검증하고 저장합니다.
참고:
국가 코드, 근로자 유형, 비즈니스 단위 및 법적 고용주와 같은 데이터 입력을 단순화하도록 기타 속성에 대한 기본값을 구성합니다. 필요한 경우 이를 숨기거나 일반 사용자가 재정의하도록 유지할 수 있습니다.
참고:
성공적으로 테스트하기 전까지는 상수 값 또는 표현식으로 기본 설정된 속성을 숨기지 않는 것이 좋습니다.
작업 4: 자동 생성된 개인 번호 구성
사용자가 개인 및 발령 번호를 수동으로 지정하도록 하려면 이 단계를 생략할 수 있습니다.
선택된 속성 패널에서 근로자 구성요소의 개인 번호 속성을 선택하고 편집을 누릅니다.
자동 생성 확인란을 선택합니다.
참고:
열 머리글 및 설명이 업데이트됩니다. 필요에 따라 변경하십시오.
주:
근로자가 성공적으로 업로드될 때 개인 번호가 생성되지만 스프레드시트의 사용자는 스프레드시트에서 각 근로자를 고유하게 구별하기 위해 값을 제공해야 합니다. 제공된 값이 자동 생성된 값으로 바뀝니다.
구성된 템플리트에 대한 스프레드시트를 생성하려면 미리보기를 누릅니다. 웹 브라우저에 따라 GenericHdlSpreasdheet.xlsx 파일이 다운로드됩니다. 열어 봅니다.
로그인하라는 메시지가 표시되면 Yes를 누릅니다.
응용 프로그램 사용자 이름과 암호로 로그인합니다. 스프레드시트는 선택된 속성 패널에 표시되는 각 속성을 스프레드시트에 열로 표시하여 생성됩니다.
스프레드시트 로더 도구모음에서 데이터 세트 생성을 누릅니다.
주:
스프레드시트 행은 데이터 세트 내에 생성되어야 합니다. 그런 다음 Oracle HCM Cloud로 업로드되는 데이터 세트입니다.
대화상자 페이지에서 확인을 누릅니다.
데이터 세트는 사전 정의된 이름으로 생성됩니다. 원하는 경우 이를 대체할 수 있습니다.
열 제목 아래의 첫 번째 행에 있는 셀을 두 번 눌러 행을 시작합니다.
참고:
값이 없는 모든 필수 셀은 빨간색 윤곽선으로 강조 표시됩니다. 기본 상수 값으로 구성된 속성은 기본값을 표시합니다.
스프레드시트 행의 빈 셀 각각에 대해 적합한 데이터를 입력하십시오.
참고:
개인 번호가 자동 생성되도록 구성한 경우 값을 지정합니다. 스프레드시트에 제공된 모든 행에서 고유해야 합니다.
이 값은 레코드를 식별하기 위해 업로드하는 동안에만 사용되지만 생성된 후에는 개인 번호 및 지정 번호에 대해 자동 생성된 값이 사용됩니다.
참고:
이름 뒤에 [..] 기호가 있는 열은 검색 가능한 값 목록을 제공합니다. LOV 창을 열 값을 제공할 셀을 두 번 누릅니다.
스프레드시트 로더 도구 모음에서 더 보기 > 업로드를 누릅니다.
표시된 대화상자 페이지에서 확인을 누릅니다.
새로고침을 정기적으로 눌러 스프레드시트 행 상태를 새로 고칩니다.
업로드 진행률은 처리가 성공 또는 오류 상태로 완료될 때까지 상태를 변경합니다.
오류 상태가 나타나면 오류 메시지를 검토하고 필요에 따라 수정합니다. 업로드를 눌러 데이터 집합에서 정정된 스프레드시트 행을 다시 제출합니다.
개인 관리 태스크로 이동하여 새 고용을 확인할 수 있도록 합니다.
참고:
애플리케이션에서 직원을 확인하는 데 짧은 지연이 발생할 수 있습니다.
태스크 6: 스프레드시트 속성 구성
이 태스크는 일반 사용자가 변경하지 않으려는 기본 속성을 숨기고, 필요에 따라 속성을 구성하고, 열 순서를 변경하고, 레이블 및 설명을 업데이트하는 방법에 대해 설명합니다.
기본 열 숨기기
상수 및 표현식 기본값이 성공적으로 테스트되면 사용자가 변경하지 않으려는 기본 속성을 숨깁니다.
생성된 스프레드시트에서 숨기도록 속성을 편집합니다.
표시 확인란의 선택을 취소합니다.
확인을 누릅니다.
속성을 필수로 설정
이 단계에서는 스프레드시트에서 필요에 따라 강조 표시할 속성을 편집합니다.
선택된 속성 패널에서 성 속성을 편집하고 필수 체크박스를 선택합니다.
확인을 누릅니다.
열 머리글 및 도움말 텍스트 구성
비즈니스 사용자가 이해할 수 있는 용어를 사용하도록 열 머리글 및 설명을 변경합니다. 예를 들어 개인 번호를 자동 생성하는 경우 개인 이름 - 자동 생성 열 제목 및 설명의 이름을 바꿀 수 있습니다.
선택된 속성 패널에서 개인 번호 속성을 편집합니다.
개인이 다른 개인 번호로 생성될 때 혼동되지 않도록 열 제목을 행 식별자로 변경합니다.
스프레드시트에서 행을 고유하게 식별하려면 설명을 숫자로 변경합니다.
참고:
설명은 스프레드시트의 열 머리글 위에 마우스를 갖다 대면 표시됩니다.
확인을 누릅니다.
열 재정렬
선택된 속성 패널에 열이 표시되는 순서는 스프레드시트에 해당 열이 표시되는 순서를 결정합니다.
선택한 속성 패널 도구 모음에서 재정렬 아이콘을 누릅니다.
속성을 선택하고 단추를 사용하여 스프레드시트에 열이 표시되는 순서를 정의합니다.
확인을 눌러 변경 사항을 적용하고 창을 닫습니다.
작업 7: 템플리트 매개변수 구성
매개변수 기본값을 대체하여 기본 스프레드시트 데이터 로드 동작을 대체할 수 있습니다. 이 섹션에서는 스프레드시트 행의 10% 이상이 오류가 있는 경우 데이터 로드가 중단되고 증분 업데이트에 대해 로드 이벤트를 사용으로 설정하도록 합니다.
설계 탭을 누릅니다.
스프레드시트 매개변수 테이블에서 생성 아이콘을 누릅니다.
템플리트에 사용 가능한 모든 매개변수를 보려면 검색을 누릅니다.
로드 오류의 최대 백분율 매개변수를 선택하고 확인을 누릅니다.
값을 10으로 업데이트합니다.
생성 아이콘을 누르고 증분 업데이트에 대해 로드 이벤트 사용 매개변수를 선택한 후 확인을 누릅니다.
값을 예로 업데이트합니다.
템플리트를 검증하고 저장합니다.
작업 8: 롤 지정 및 템플리트 활성화
프로덕션에서 이 템플리트에 접근할 수 있어야 하는 역할에 이 템플리트를 지정하므로 템플리트를 익스포트하기 전에 의도한 대로 템플리트로 작업하도록 지정하는 역할을 평가해야 합니다.
비즈니스 사용자가 이 템플리트를 사용할 수 있으려면 해당 역할에 템플리트에 대한 데이터 세트 접근 권한이 지정되어야 하며 템플리트를 활성화해야 합니다. 활성화되면 더 이상 템플릿을 유지 관리할 수 있는 액세스 권한이 자동으로 부여되지 않습니다.
템플리트 관리 액세스 지정
템플리트가 활성화된 후에는 롤이 템플리트를 유지 관리하도록 구성된 경우에만 템플리트를 유지 관리할 수 있습니다.
다음 단계에서는 템플리트 유지 관리를 지정하는 방법에 대해 설명합니다.
템플리트의 역할 접근 탭으로 이동합니다.
템플리트 관리 테이블에서 추가를 누릅니다.
템플리트 디자이너 또는 유지 관리 롤(예: HSDL 템플리트 디자이너)을 검색하고 이 템플리트를 유지 관리할 수 있는 롤을 추가합니다.
검증 후 저장을 누릅니다.
역할 데이터 세트 접근 지정
이 템플리트에서 스프레드시트를 생성할 수 있는 역할 및 스프레드시트 접근 권한을 구성합니다.
역할 접근 탭으로 이동합니다.
허용된 데이터 집합 작업 테이블에서 추가를 누릅니다.
템플리트 접근 권한을 지정할 역할(예: 인적 자원 전문가)을 검색합니다.
추가할 롤을 확인하고 추가를 누릅니다.
기본적으로 역할에는 데이터 세트를 생성, 저장 및 업로드할 수 있는 접근 권한이 지정됩니다.
필요에 따라 데이터 세트 액세스를 변경합니다.
데이터 세트 작업
연산
설명
생성
데이터 세트를 생성할 수 있습니다.
저장
데이터 세트 데이터는 스테이징 테이블에 저장할 수 있습니다.
Upload
데이터 세트를 업로드하고 애플리케이션에 저장된 적합한 행을 업로드할 수 있습니다.
롤백
데이터 세트를 롤백하여 성공적으로 로드된 후 업데이트되지 않은 데이터를 삭제할 수 있습니다. 롤백은 일부 비즈니스 객체에만 사용할 수 있습니다.
모두 보기
사용자가 생성한 데이터뿐 아니라 템플리트에 대한 모든 기존 데이터 세트를 다운로드하고 검토할 수 있습니다.
참고:
스테이징 테이블에 데이터를 생성하고 저장할 수 있지만 해당 데이터를 업로드할 수 있는 접근 권한이 없는 역할과 새 데이터 세트를 생성할 수 없지만 다른 사용자가 생성한 데이터 세트를 검토하고 업로드할 수 있는 두 번째 역할이 필요한 템플리트가 있을 수 있습니다. 이것은 일종의 승인을 얻을 수 있습니다.
검증 및 저장합니다.
템플리트 활성화
활성 템플리트만 스프레드시트 데이터 로더 실행 태스크에 표시되며 REST를 사용하여 HSDL을 시작할 때 사용할 수 있습니다. 초안 상태인 템플리트의 경우 다음 단계를 완료합니다.
정의 탭을 누릅니다.
상태를 활성으로 업데이트합니다.
검증 및 저장을 누릅니다.
이제 템플리트에 대한 데이터 세트 접근 권한으로 구성된 역할이 있는 사용자가 템플리트를 사용할 수 있습니다.
비즈니스 사용자 접근 테스트
이제 템플리트에 대한 접근 권한이 지정된 역할의 사용자로 로그인하고 스프레드시트 데이터 로더 실행 태스크에서 템플리트를 사용할 수 있으며 템플리트에서 생성된 스프레드시트가 원하는 대로 작동하는지 확인해야 합니다.
템플리트 익스포트
템플리트가 완전히 테스트되고 운용 환경으로 이동할 준비가 되면 템플리트 정의를 익스포트할 수 있습니다.