소스 CSV 데이터 설명
Workday Studio의
PrismAnalytics
구성요소에는 소스 CSV 데이터에 대한 설명이 필요합니다. 선택한 도구에서 JSON 텍스트를 생성하여 나중에 Studio에서 사용할 수 있습니다. 예: write
단계의 Message Builder
탭에 있는 텍스트 메시지에 붙여넣습니다.- 2개의 기본 노드를 포함하는 JSON 텍스트를 생성합니다.
- parseOptions: 문자 세트 및 구분 기호 문자를 포함하여 CSV 데이터의 형식에 대한 정보입니다.
- fields: 데이터 유형 및 서식을 포함하여 CSV 데이터의 각 필드에 대한 정보입니다.
- 에서parseOptions노드에서 다음 필드를 정의할 수 있습니다.필드명유형필수설명charsetName오브젝트예CSV 데이터 파일의 문자 세트 예를 들어 다음과 같습니다."charset": { "id": "Encoding=UTF-8" }현재 Workday는 UTF-8 인코딩 형식만 지원합니다. 최종적으로 데이터는 Unicode 형식으로 저장됩니다. 해당하는 유니코드가 없는 문자는 검은색 마름모꼴 배경에 물음표인 유니코드 대체 문자로 저장됩니다.fieldsEnclosedByString아니요CSV 데이터에서 필드를 묶는 데 사용되는 문자입니다. 기본값은 큰따옴표입니다. 필드 내에서 큰따옴표를 사용하는 경우 필드 앞에 다른 큰따옴표를 붙여 이스케이프합니다. 예를 들어 다음과 같습니다."fieldsEnclosedBy": "\""fieldsDelimitedByString예CSV 데이터에서 필드 값을 구분하는 데 사용되는 문자입니다. 예를 들어 다음과 같습니다."fieldsDelimitedBy": ","headerLinesToIgnore숫자아니요파서가 헤더로 무시할 라인 수입니다. 다음으로 설정0CSV 데이터에 헤더가 없는 경우 예를 들어 다음과 같습니다."headerLinesToIgnore": 1type오브젝트예입력 파일의 유형입니다. 현재 Workday는 구분된 파일만 지원합니다. 예를 들어 다음과 같습니다."type": { "id": "Schema_File_Type=Delimited" }이 값은 대소문자를 구분합니다. Delimited에서 대문자 D를 확인합니다.
- 에서fields노드에서 다음 필드를 정의할 수 있습니다.필드명유형필수설명ordinal숫자예CSV 데이터세트(인덱스)에서 필드의 순서입니다. 서수 값은 다음과 같습니다.
- 1로 시작해야 합니다.
- 연속적이어야 합니다.
- 숫자는 건너뛸 수 없습니다.
- 최대값은 1,000입니다.
nameString예CSV 데이터세트 필드의 이름입니다. 필드명은 다음과 같습니다.- 데이터세트에서 고유해야 합니다.
- 최대 255자를 포함할 수 있습니다.
- 영숫자 및 밑줄 문자만 포함할 수 있습니다.
- 문자로 시작해야 합니다.
- 밑줄 문자로 끝날 수 없습니다.
- WPA_로 시작할 수 없습니다.
descriptionString아니요필드에 대한 설명입니다. 최대 1,000자 예를 들어 다음과 같습니다."description": "The worker's full name."type오브젝트예필드의 유형입니다. 옵션은 다음과 같습니다.- 텍스트
- 숫자
- 부울
- 날짜
"type": { "id":"Schema_Field_Type=Date"}parseFormatString예(날짜 유형의 경우)날짜 형식입니다. 예를 들어 다음과 같습니다."parseFormat": "dd-MM-yy HH24:mm:ss"precision숫자예(숫자 유형의 경우)숫자 값의 최대 자릿수입니다. 소수점 왼쪽 및 오른쪽에 있는 모든 숫자를 포함하되, 소수점 자체는 포함하지 않습니다. 최대값은 38입니다. 예를 들어 다음과 같습니다."precision": 38scale숫자예(숫자 유형의 경우)숫자 값에서 소수점 오른쪽의 자릿수입니다. 값은 보다 작아야 합니다.precision값 예를 들어 다음과 같습니다."scale": 2defaultValue텍스트아니요필드의 기본값입니다(업로드 파일에 값이 지정되지 않은 경우).큰따옴표로 묶은 기본 텍스트 값을 표시합니다. 예:“N/A”.기본 날짜 값은 yyyy-MM-dd'T'HH:mm:ss'Z' 형식이어야 합니다.기본 숫자 값은 지정된 값과 일치해야 합니다.precision및scale.required부울아니요필드에 값이 포함되어야 하는지 여부를 지정합니다. 다음으로 설정True필드가 필수인 경우 , 그렇지 않으면 으로 설정False. 필드가 필수인 경우 데이터 삽입, 업데이트 및 upsert 작업에서 해당 값이 null일 수 없습니다.externalID부울예(업데이트, 업서트 및 삭제 작업 활용)필드가 외부 ID를 나타내는지 여부를 지정합니다. 다음으로 설정True필드를 지정하려면 외부 ID를 지정합니다. 그렇지 않으면 으로 설정됩니다.False.외부 ID 필드는 null일 수 없으므로 외부 ID 필드를 필수로 지정해야 합니다. 1개의 필드만 외부 ID로 지정할 수 있습니다.업데이트, 업서트 및 삭제 기능을 활용하려면 새 테이블에서 외부 ID를 지정합니다.기존 테이블에서 업데이트, 업서트 및 삭제 기능을 사용하려면 외부 ID로 지정된 단일 필드를 갖도록 테이블을 수정해야 합니다. Prism 공개 API는 데이터가 포함된 테이블의 수정을 지원하지 않습니다. 그러한 경우에는 Workday에서 수정하십시오.
소스 CSV 파일은 다음 테이블을 설명합니다.
직원 | 직원 ID | 직무명 | 입사일 | Annual Salary |
|---|---|---|---|---|
Logan McNeil | 21001 | Vice President, Human Resources | 1/1/2010 | 213298.00 |
Oliver Reynolds | 21003 | Chief Information Officer | 1/1/2010 | 394935.00 |
Maximilian Schneider | 21004 | Chief Operating Officer | 1/1/2010 | 255373.00 |
Teresa Serrano | 21005 | Controller | 1/1/2010 | 291785.00 |
다음과 같이 JSON을 사용하여 설명합니다.
{ "parseOptions": { "fieldsDelimitedBy": ",", "fieldsEnclosedBy": "\"", "headerLinesToIgnore": 1, "charset": { "id": "Encoding=UTF-8" }, "type": { "id": "Schema_File_Type=Delimited" } }, "fields": [ { "ordinal": 1, "name": "Employee", "description": "Employee", "precision": 255, "scale": 0, "parseFormat": null, "type": { "id": "Schema_Field_Type=Text" } }, { "ordinal": 2, "name": "Employee_ID", "description": "Employee ID", "precision": 38, "scale": 0, "parseFormat": null, "type": { "id": "Schema_Field_Type=Numeric" } }, { "ordinal": 3, "name": "Job_Title", "description": "Job Title", "precision": 255, "scale": 0, "parseFormat": null, "type": { "id": "Schema_Field_Type=Text" } }, { "ordinal": 4, "name": "Hire_Date", "description": "Hire Date", "precision": 0, "scale": 0, "parseFormat": "MM/dd/yy", "type": { "id": "Schema_Field_Type=Date" } }, { "ordinal": 5, "name": "Annual_Salary", "description": "Annual Salary", "precision": 38, "scale": 2, "type": { "id": "Schema_Field_Type=Numeric" } } ], "schemaVersion": { "id": "Schema_Version=1.0" } }