주 컨텐츠로 이동
Administrator Guide
최종 업데이트: 2023-06-23
소스 CSV 데이터 설명

소스 CSV 데이터 설명

Workday Studio의
PrismAnalytics
구성요소에는 소스 CSV 데이터에 대한 설명이 필요합니다. 선택한 도구에서 JSON 텍스트를 생성하여 나중에 Studio에서 사용할 수 있습니다. 예:
write
단계의
Message Builder
탭에 있는 텍스트 메시지에 붙여넣습니다.
  1. 2개의 기본 노드를 포함하는 JSON 텍스트를 생성합니다.
    • parseOptions
      : 문자 세트 및 구분 기호 문자를 포함하여 CSV 데이터의 형식에 대한 정보입니다.
    • fields
      : 데이터 유형 및 서식을 포함하여 CSV 데이터의 각 필드에 대한 정보입니다.
  2. 에서
    parseOptions
    노드에서 다음 필드를 정의할 수 있습니다.
    필드명
    유형
    필수
    설명
    charsetName
    오브젝트
    CSV 데이터 파일의 문자 세트 예를 들어 다음과 같습니다.
    "charset": { "id": "Encoding=UTF-8" }
    현재 Workday는 UTF-8 인코딩 형식만 지원합니다. 최종적으로 데이터는 Unicode 형식으로 저장됩니다. 해당하는 유니코드가 없는 문자는 검은색 마름모꼴 배경에 물음표인 유니코드 대체 문자로 저장됩니다.
    fieldsEnclosedBy
    String
    아니요
    CSV 데이터에서 필드를 묶는 데 사용되는 문자입니다. 기본값은 큰따옴표입니다. 필드 내에서 큰따옴표를 사용하는 경우 필드 앞에 다른 큰따옴표를 붙여 이스케이프합니다. 예를 들어 다음과 같습니다.
    "fieldsEnclosedBy": "\""
    fieldsDelimitedBy
    String
    CSV 데이터에서 필드 값을 구분하는 데 사용되는 문자입니다. 예를 들어 다음과 같습니다.
    "fieldsDelimitedBy": ","
    headerLinesToIgnore
    숫자
    아니요
    파서가 헤더로 무시할 라인 수입니다. 다음으로 설정
    0
    CSV 데이터에 헤더가 없는 경우 예를 들어 다음과 같습니다.
    "headerLinesToIgnore": 1
    type
    오브젝트
    입력 파일의 유형입니다. 현재 Workday는 구분된 파일만 지원합니다. 예를 들어 다음과 같습니다.
    "type": { "id": "Schema_File_Type=Delimited" }
    이 값은 대소문자를 구분합니다. Delimited에서 대문자 D를 확인합니다.
  3. 에서
    fields
    노드에서 다음 필드를 정의할 수 있습니다.
    필드명
    유형
    필수
    설명
    ordinal
    숫자
    CSV 데이터세트(인덱스)에서 필드의 순서입니다. 서수 값은 다음과 같습니다.
    • 1로 시작해야 합니다.
    • 연속적이어야 합니다.
    • 숫자는 건너뛸 수 없습니다.
    • 최대값은 1,000입니다.
    name
    String
    CSV 데이터세트 필드의 이름입니다. 필드명은 다음과 같습니다.
    • 데이터세트에서 고유해야 합니다.
    • 최대 255자를 포함할 수 있습니다.
    • 영숫자 및 밑줄 문자만 포함할 수 있습니다.
    • 문자로 시작해야 합니다.
    • 밑줄 문자로 끝날 수 없습니다.
    • WPA_로 시작할 수 없습니다.
    description
    String
    아니요
    필드에 대한 설명입니다. 최대 1,000자 예를 들어 다음과 같습니다.
    "description": "The worker's full name."
    type
    오브젝트
    필드의 유형입니다. 옵션은 다음과 같습니다.
    • 텍스트
    • 숫자
    • 부울
    • 날짜
    예를 들어 다음과 같습니다.
    "type": { "id":"Schema_Field_Type=Date"}
    parseFormat
    String
    예(날짜 유형의 경우)
    날짜 형식입니다. 예를 들어 다음과 같습니다.
    "parseFormat": "dd-MM-yy HH24:mm:ss"
    precision
    숫자
    예(숫자 유형의 경우)
    숫자 값의 최대 자릿수입니다. 소수점 왼쪽 및 오른쪽에 있는 모든 숫자를 포함하되, 소수점 자체는 포함하지 않습니다. 최대값은 38입니다. 예를 들어 다음과 같습니다.
    "precision": 38
    scale
    숫자
    예(숫자 유형의 경우)
    숫자 값에서 소수점 오른쪽의 자릿수입니다. 값은 보다 작아야 합니다.
    precision
    값 예를 들어 다음과 같습니다.
    "scale": 2
    defaultValue
    텍스트
    아니요
    필드의 기본값입니다(업로드 파일에 값이 지정되지 않은 경우).
    큰따옴표로 묶은 기본 텍스트 값을 표시합니다. 예:
    “N/A”
    .
    기본 숫자 값은 지정된 값과 일치해야 합니다.
    precision
    scale
    .
    기본 날짜 값은 yyyy-MM-dd'T'HH:mm:ss'Z' 형식이어야 합니다.
    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" } }