계획 디멘션 로더 생성
메타데이터 로더는 소스 시스템의 계층 정보를 계획 모델의 계층으로 동기화합니다. 동기화하려면 소스 시스템에 계층이 이미 있어야 합니다.
계획 디멘션 로더 요청은 계층형 디멘션에 최대 10000개의 디멘션 값을 업데이트하거나 비계층 디멘션에 40000개의 디멘션 값을 업데이트하도록 제한되어 있습니다. 이러한 제한은 로더 요청 내에서 신규 디멘션 값을 생성하는 데에는 적용되지 않습니다.
계획 디멘션 로더를 사용하면 스테이징 영역의 디멘션 값에 대한 메타데이터를
Adaptive Planning
. 계획 디멘션 로더를 사용할 때의 주요 이점은 모델링> 모델 관리 > 디멘션에서 한 번에 하나씩 디멘션 값을 생성하는 대신 일괄적으로 가져올 수 있다는 점입니다. 로더를 생성한 후에는 로더를 수동으로 실행하거나 통합태스크의 일부로 실행되도록 스케줄링할 수 있습니다.계획 디멘션 로더를 생성하려면 다음 흐름을 따릅니다.
- 데이터 소스 설정 입력
- 열 매핑 구성
- 비즈니스 규칙 생성
- 로더 출력 미리보기
- 로더 실행 또는 스케줄링
시작하기 전에
계획 디멘션 로더를 사용하려면 기존데이터 소스가져오기의 스테이징 데이터가 필요합니다.
데이터 소스 설정 입력
데이터 소스 설정을 통해 스테이징 영역에서 사용하려는 소스 테이블을 선택하고, 어떤 계획 디멘션으로 로드할지, 그리고 신규 디멘션 값을 자동으로 생성할지 여부를 선택할 수 있습니다.
- 통합 > 통합 디자인으로 이동합니다.
- 구성요소 라이브러리의 로더 영역에서신규 로더 생성을 클릭합니다.
- 로더 유형으로계획 디멘션 로더를 선택합니다. 로더에 대한 이름을 입력합니다.
- 생성을 클릭합니다.
모범 사례: 로더를 생성하고 편집할 때마다 액션 패널에서
저장
을 클릭하여 자주 저장하는 것이 좋습니다. 닫기
를 클릭한 다음 아니요
를 클릭하여 저장되지 않은 변경사항을 취소할 수 있습니다. 계획 디멘션 로더 일반 속성 정보를 입력합니다.
- 소스 테이블:드롭다운 목록에서 소스 테이블을 선택합니다. 목록의 소스 테이블은 사용자가 액세스 권한을 가진 스테이징 영역에서 사용가능한 모든 테이블입니다.
- 계획 디멘션:소스에 대한 모든 디멘션에서 로드할 디멘션을 선택합니다. 나열된 디멘션은 모델링 > 모델 관리 > 디멘션에서 제공됩니다.
- 계획에 없는 경우 디멘션 값 생성:소스 시스템에는 있지만 모델링 > 모델 관리 > 디멘션에서 찾을 수 없는 신규 디멘션 값을 자동으로 생성하도록 하려면 확인란을 선택합니다. 이 옵션을 선택하지 않으면 기존 디멘션 값에 대한 업데이트만 수행되며 신규 디멘션은 생성되지 않습니다.
- 로드한 디멘션에 모델링 > 모델 관리 > 디멘션에서 '데이터 가져오기에서 자동으로 디멘션 값 생성' 옵션이 활성화되어 있지 않은 경우, 로더에서 경고 메시지가 표시됩니다.
- 로그 레벨:로더를 실행할 때 기록할 세부내용의 유형을 선택합니다.
- 오류:심각한 오류만 기록합니다.
- 정보:로더가 업데이트된 시기와 같은 기본 정보를 기록합니다.
- 상세:모든 단계 및 액션에 대한 세부 정보를 제공합니다. 이 레벨은 일반적인 사용에 비해 더 많은 로그 정보를 생성할 수 있으므로 주로 디버깅 또는 감사에 사용합니다.
열 매핑 구성
열 매핑을 통해 데이터 소스의 모델링 > 모델 관리 > 디멘션에서 사용가능한 디멘션 값으로 매핑할 수 있습니다.
매핑할 열이 여러 개 있는 경우
표시
필터를 사용하여 다음을 선택할 수 있습니다.
- 모두: 모든 계획 열을 표시합니다.
- 필수: 모든 필수 계획 열을 표시합니다.
- 매핑되지 않음: 매핑되지 않은 모든 계획 열을 표시합니다.
- 매핑 완료: 매핑된 모든 계획 열을 표시합니다.
검색
필드를 사용하여 열을 찾을 수 있습니다. 검색하려는 전체 또는 부분 이름을 입력하고 돋보기를 클릭합니다. 검색과 일치하는 모든 스테이징 열이 결과에 나타납니다.- 열 매핑
- 열 매핑을 클릭합니다.열 매핑 탭에는 다음이 포함됩니다.
- 상태:계획 열이 매핑되어 있는지를 표시합니다.
확인 표시는 매핑된 열을 나타냅니다. 느낌표 - 매핑
매핑되지 않은 열을 나타냅니다. - 계획 열:시트에서 매핑에 사용할 수 있는 모든 계획 열을 표시합니다. 계획 열 목록에는 필수 계획 열 세트에 이어 모든 기타 계획 열이 포함됩니다. 필수 계획 열은 별표가 있는 굵은 텍스트로 표시되며 값 열을 포함합니다. 필수가 아닌 열에는 약식 이름과 설명이 포함됩니다.
- 소스 열:데이터 소스 설정에서 선택한 스테이징 테이블 내에 열을 표시합니다.
- 매핑되지 않은 열을 선택하고 드롭다운을 클릭합니다. 매핑할 수 있는 열 목록이 드롭다운 목록에 나타납니다. 열을 매핑하면 상태 표시기가 빨간색
에서 녹색
로 변경됩니다.
데이터 가져오기에서 자동으로 디멘션 값 생성이 활성화되면 코드를 기준으로 특성을 매핑할 수 있습니다. 특성명이 자동으로 코드가 됩니다.디멘션 값과 해당 parent가 계획에 매핑되는 방식의 예는예: 스프레드시트 데이터 소스에서 디멘션 값 로드를참조하십시오.- 로드 시 계획 디멘션 값 이름 변경
- 로드 시 계획 디멘션 값의 이름을 변경하려면 다음을 수행합니다.
- 소스에서 디멘션 값을 고유하게 식별하는 소스 열을 선택합니다.
- ID 열을 디멘션 값 ID에 매핑합니다.
- 이름을 디멘션 값 이름에 매핑합니다.
- 열 매핑취소
- 열 매핑을 취소하려면매핑취소를 클릭하고 다음을 선택합니다.
- 모두 매핑취소:모든 열의 매핑을 취소합니다.
- 선택항목 매핑취소:선택한 열에 대해서만 매핑을 취소합니다.
열 매핑을 취소하면 해당 맵 상태 아이콘이 빨간색로 변경됩니다. - 목록형 디멘션에 연결된 특성 매핑
- 데이터 소스 가져오기의 열을 매핑하여 특성을 목록형 디멘션에 연결할 수 있습니다.특성을 디멘션에 연결하는 것은 목록형 디멘션에 대해서만 가능합니다. 특성을 계층형 디멘션과 연결할 수는 없습니다.범위 내Adaptive Planning모델 관리>디멘션으로 이동하고 디멘션을 클릭하여 세부내용을 조회하여 목록형 디멘션인지 확인할 수 있습니다.데이터 소스 설정에서 목록형 디멘션을계획 디멘션으로 선택합니다.해당 디멘션이 목록형 디멘션이므로 특성이 열 매핑 내에서 열로 제공됩니다.목록형 디멘션은 계층형이 아니기 때문에 소스 열에 parentId가 옵션으로 제공되지 않습니다.
매핑 다운로드 및 업로드
신속하게 매핑 오류를 해결하도록 로더의 매핑을 다운로드 및 수정한 후 업로드할 수 있습니다. 업로드는 양자택일로 모든 액션 대체를 수행합니다. 업로드할 때 파일의 매핑 시트 1개만 처리됩니다. 매핑 시트를 추가하면 오류가 발생하고 업로드가 취소됩니다.
- 액션창에서Download Member Mappings를 클릭합니다.
- .XLSX 파일을 다운로드합니다. 매핑 파일의 다운로드 링크가 있는 이메일이나 Workday 알림도 수신합니다.
- 파일을 열고 오류가 발생한 매핑 시트에서 스테이징 테이블 값을 조회합니다.계획 코드또는계획명열에 (INVALID)라고 표시된 셀은 이 코드가 더 이상 Workday Adaptive Planning에 없음을 나타냅니다.
- 오류를 수정하고Upload Member Mappings를 클릭하여 파일을 로드합니다.읽기 전용열은 업로드되지 않습니다.
- 로더를 다시 실행합니다.
구현 파트너 또는 Workday Adaptive Planning 지원에서 지시하지 않는 한
구성원 매핑 지우기
를 클릭하지 마십시오.비즈니스 규칙 생성
비즈니스 규칙
을 사용하여 로딩에 사용할 수 있는 스테이징 데이터를 제한하는 SQL 표현식을 생성할 수 있습니다. 필터 조건을 충족하는 레코드만 로드됩니다.
SQL 필터를 생성하려면 다음을 수행합니다.
- 비즈니스 규칙탭에서SQL 필터를 선택합니다.편집을 클릭합니다.
- SQL 표현식을 입력합니다. 직접 입력하는 대신 사용가능한 열 목록의 항목을 클릭하여 해당 열을 SQL 표현식으로 가져올 수 있습니다.
- 적용을 클릭하여 SQL 구문을 확인합니다. 구문에 오류가 있는 경우 표현식의 테두리가 빨간색으로 바뀝니다. SQL 편집기 위로 마우스 커서를 가져가서 구문 오류 정보를 확인합니다.상세한 SQL 구문 도움말을 확인하려면 'SQL 필터 편집'의 '메모' 섹션에 있는 '온라인 도움말'을 클릭합니다. SQL 표현식 참조 를방문할 수도 있습니다.
- 구문에 있는 모든 오류를 수정하고적용을 클릭합니다. 로더를 실행할 때 SQL 표현식과 일치하는 스테이징 행만 가져오게 됩니다.
로더 출력 미리보기
전체 로드를 수행하기 전에 로더 출력 미리보기를 통해 매핑이 필요한 방식대로 수행되는지 확인할 수 있습니다. 또한 출력을 XML 파일로 다운로드하여 디멘션 값을 로드하기 전에 데이터 소스에서 요구사항에 대해 수동으로 디멘션 값을 검증할 수 있습니다.
- 액션 패널에서로더 출력 미리보기를 클릭합니다.
- (옵션) 로더 출력 미리보기 설정을 입력합니다. 입력할 수 있는 정보는 이 계획 디멘션 로더에 대해 선택한 데이터 소스에 따라 달라집니다. 여기에서 설정을 변경하면 스테이징 테이블 및 열로 새로운 데이터를 가져옵니다.
- 로더 출력 미리보기를 클릭합니다.
실행의 일부로 모든 변환 및 비즈니스 규칙을 적용하여 로더가 실행됩니다. 상태 팝업에 로더가 실행되는 단계가 표시됩니다. 로드할 디멘션 값이 있는 경우 로더에서 XML 파일을 생성하고 로더 출력을 압축된 XML 첨부파일로 포함하여 이메일 알림을 전송합니다.
로더가 성공적으로 실행된 후 추가 팝업을 통해 로더 출력 미리보기를 압축된 XML 파일로 다운로드할 수 있습니다. 디멘션 값의 수 및 파일 크기에 따라 다운로드 팝업이 나타나는 데 시간이 소요될 수 있습니다.
- 검증 오류 수정
- 디멘션 값이 로드되면 소스 데이터가 다음 오류에 대해 검증됩니다.
- 디멘션 값에 대한 소스 ID 값이 데이터에서 누락(비어 있음)된 경우
- 데이터에 중복 소스 ID가 있는 경우. 소스 ID는 고유해야 합니다.
- 데이터에서 디멘션 값 이름이 누락(비어 있음)된 경우
- 데이터에 중복 디멘션 값 이름이 있는 경우
- 데이터에서 parent ID가 소스 ID와 동일한 경우. 이 경우, 열은 자신을 parent 항목으로 참조합니다.
- 하위 트리를 가져올 때 하위 트리의 root 항목이 계획의 기존 노드에 매핑되는 경우. 이 경우, 계획에 도입된 신규 노드에 대한 소스 데이터에는 parent ID가 없습니다.
- 기존 노드가 신규 노드 아래로 이동하고 신규 생성 플래그가 비활성화된 경우. 이 경우, 로더가 새로운 디멘션 값을 생성하지 않도록 명시적으로 설정되어 있으면 기존 디멘션 값이 신규 노드로 이동합니다.
- 데이터에 계층 내에 순환 참조가 있는 경우. 이 경우, parent ID는 child 항목을 parent 항목으로 참조합니다.
로더 실행
계획 디멘션 로더를 모든 필수 구성 설정과 함께 저장한 후, 로더를 수동으로 실행하거나 스케줄링된 통합 태스크로 실행할 수 있습니다.
각 계획 디멘션 로더 실행 사이에 15~30분 정도 기다립니다.
Adaptive Planning
에게 가져오기와 동기화할 시간이 있습니다. 가져오기 크기가 클수록 동기화하는 시간이 오래 걸립니다. 대기 시간은 모델 크기 및 기타 요인에 따라 달라집니다.소스 시스템에서 바로 로드하거나 이미 가져온 스테이징 값을 사용하여 로더를 실행할 수 있습니다. 로더 실행 시 이 중에서 원하는 동작을 선택합니다. 기존 스테이징 테이블을 로드에 사용하려면
데이터 가져오기 건너뛰기
를 선택합니다. 데이터 가져오기 건너뛰기는 스프레드시트를 데이터 소스로 사용하는 경우에는 사용할 수 없습니다.실행 프로세스의 일부로, 로더는 스테이징 테이블의 데이터가 올바르게 매핑되었는지 확인합니다. 로드 도중 여러 검증이 적용됩니다. 로드 중에 발생하는 모든 오류는 가져오기를 성공적으로 수행하기 위해 해결해야 할 사항을 표시합니다.
- 통합 태스크에 계획 디멘션 로더 포함
- 모든 통합 태스크는하나 이상의 로더를 포함할 수 있습니다. 태스크는 Discovery 메트릭 로더 및 스크립팅된 로더와 같은 기타 통합 태스크를 포함할 수 있습니다.모범 사례: 로더마다 별도의 통합 태스크를 생성하십시오.한 태스크에 여러 로더가 포함된 경우 태스크가 실행될 때 각 로더의 매개변수가 표시됩니다. 한 태스크 내 로더에 하나의 공통된, 즉 공유된 매개변수가 있는 경우 이 매개변수에 대한 프롬프트는 한 번만 표시됩니다. 매개변수 프롬프트를 재정의할 수도 있습니다.태스크의 스케줄링된 실행에는 로더가 생성될 때 저장된 매개변수의 기본값이 사용됩니다.
- 문제 해결 메시지 및 경고
- 로드 중에 기록되는 메시지에 대한 설명은 다음을 참조하십시오. 참조: 계획 디멘션 로더에 대한 로그 메시지.
소스 디멘션 값에 대한 변경사항 로드
계획 디멘션 로더는 소스 디멘션 값에 이미 매핑이 설정된 경우 로드 시 디멘션 값의 이름을 바꿀 수 있습니다.
다음 표는 로더에서 이미 설정된 매핑을 보여줍니다. 소스 디멘션 값 'USA'는 소스 ID 열 '1001'에 매핑됩니다.
계획 디멘션 값 | 소스 ID 열 | 소스 디멘션 값 |
|---|---|---|
USA | 1001 | USA
|
캐나다 | 1002 | Canada |
소스 시스템에서 'USA'가 'United States'로 변경될 경우 계획 디멘션 로더가 이 변경사항을 로드 시에 적용할 수 있습니다. 이는 로더가 소스 ID 열 '1001'과 디멘션 값 'USA'에 대한 계획 내부 ID 간의 매핑을 유지하기 때문입니다.
계획 디멘션 값 | 소스 ID 열 | 소스 디멘션 값 |
|---|---|---|
USA | 1001 | United States
|
캐나다 | 1002 | Canada |
로더를 실행하면 계획의 디멘션 값이 'USA'에서 'United States'로 변경됩니다.