파일 규칙 및 유효성 검사 오류
이 문서에서는 업로드 파일의 서식을 지정하고 고급 인사이트 앱으로 데이터를 가져오는 동안 발생할 수 있는 오류를 제공하는 방법을 설명합니다.
파일 및 필드 규칙
모든 데이터 행 또는 열에 특성에 대한 잘못된 값이 있는 경우 원본 파일이 수정될 때까지 전체 업로드가 실패합니다(또는 매핑이 값의 유효성을 검사하는 방식으로 특성의 유효성 검사 유형을 변경).
파일에 대한 규칙
데이터 파일은 .csv UTF-8 형식이어야 하며 비워 둘 수 없습니다.
원본 및 대상 필드 헤더에 대한 규칙
모든 원본 및 대상 필드 헤더 또는 열 이름은 다음을 수행해야 합니다.
- ASCII 영숫자 문자(예: Date1 또는 밑줄(_)와 같은 문자와 숫자만 포함됩니다. @, #, %, & 또는 기타 문자와 같은 영숫자가 아닌 특수 문자는 지원되지 않습니다.
- 값을 포함합니다.
- 고유합니다.
사용자 지정 대상 필드 헤더에 대한 규칙
모든 사용자 지정 대상 필드 헤더 또는 열 이름은 다음을 수행해야 합니다.
- 선행 공백, 가운데 또는 후행 공백이 없습니다.
- 다음과 같은 시스템 필드를 포함하지 않습니다.
- PeopleHistoricalId
- StartDate
- EndDate
- 도메인
- PopulationType
- TimeZone
- StandardTimeZone
- WorkdayStart
- WorkDayEnd
- WeekendDays
- 유추TeamSize
- ObjectId
- IsActive
- "Microsoft_"부터
- MetricDate
- PrimaryCollaborator_PersonId
- SecondaryCollaborator_PersonId
필수 필드에는 모든 행에 대한 값이 있어야 합니다.
파일을 업로드한 후에는 하나의 열 머리글만 각 Viva Insights 데이터 필드에 매핑할 수 있습니다.
필드 값에 대한 규칙
필드 값은 올바른 데이터 형식으로 제공해야 합니다. 특성 참조를 참조하세요.
필드 값의 문자에 대한 규칙
- 행에 있는 필드 값의 문자 길이는 약 1024 x 128자인 128KB를 초과할 수 없습니다.
- 필드 값에는 "새 줄"(\n) 문자가 허용되지 않습니다.
참고
필드 값에 일본어 문자와 같은 더블 바이트 문자를 사용할 수 있습니다.
ManagerId 필드의 값에 대한 규칙
각 PersonId에는 고유한 ManagerId가 있어야 합니다. 즉, 한 사람에 대한 관리자가 여러 명 있을 수 없습니다.
다음과 같은 루프는 있을 수 없습니다.
- 관리자와 직원은 서로 보고합니다.
- 관리자는 직원에게 다시 보고합니다.
딜런이 크리스의 매니저라고 가정해 봅시다. 조직 데이터를 표시할 수 없습니다.
- 크리스는 딜런에게 보고하고 딜런은 크리스에게 다시 보고합니다.
- 딜런이 크리스에게 보고하고 있다.
다음 계층 구조는 모두 최종 사용자 환경에서 오류를 생성합니다.
파일 내보내기 예제 .csv
다음은 유효한 .csv 내보내기 파일의 예제 코드 조각입니다.
PersonId,EffectiveDate,HireDate,ManagerId,LevelDesignation,Organization,Layer,Area Emp1@contoso.com,12/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp2@contoso.com,11/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp3@contoso.com,12/1/2020,1/3/2014,Mgr2@contoso.com,Manager,Sales,7,Northeast Emp4@contoso.com,10/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp5@contoso.com,11/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp6@contoso.com,12/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest
유효성 검사 오류
다음은 고급 인사이트 앱에 데이터를 업로드하는 동안 발생할 수 있는 유효성 검사 오류입니다. 대부분의 경우 오류를 수정하고 파일을 다시 업로드해야 합니다. 조직 데이터 준비 문서를 검토하여 데이터를 업로드할 수 있도록 서식을 지정하고 준비하는 방법을 알아봅니다.
| 범주 | 관련 규칙 | 메시지 | 적용 대상 |
|---|---|---|---|
| 파일 및 파일 확장자 | 데이터 파일은 .csv UTF-8 형식이어야 하며 비워 둘 수 없습니다. | 파일이 비어 있습니다. 다른 파일을 선택하고 다시 업로드합니다. | 업로드만 .csv |
| 이 파일의 확장명은 ''{0}입니다. .csv 파일을 선택하고 다시 업로드합니다. | 업로드만 .csv | ||
| 잘못된 .csv 형식입니다. 행의 열 수가 헤더의 열 수와 일치하지 않습니다. 누락되거나 잘못 배치된 쉼표를 확인하고 다시 업로드하세요. | 전체 | ||
| UTF-8이 아닌 문자가 있습니다. .csv 파일이 UTF-8 인코딩을 사용하는지 확인하고 다시 업로드합니다. | 전체 | ||
| 열 머리글 | 모든 필드 머리글 또는 열 이름은 고유해야 합니다. | 파일의 열 머리글이 두 개 이상 동일합니다. 각 열에 대한 고유 헤더를 포함합니다. | 전체 |
| 모든 필드 머리글 또는 열 이름은 값을 포함해야 합니다. | {J}열에 헤더가 없습니다. 선택한 파일에 헤더 이름을 포함하고 다시 업로드합니다. | 전체 | |
| 모든 필드 머리글 또는 열 이름에는 영숫자 문자(예: Date1과 같은 문자 및 숫자) 또는 다음 기호만 포함되어야 합니다. ~ ! @ # $ % ^ & * + > : <> [] ?. 다른 문자는 지원되지 않습니다. | {Header name}에는 지원되지 않는 특수 문자가 포함되어 있습니다. 특수 문자를 제거하고 다시 업로드합니다. | ||
| 모든 필드 머리글 또는 열 이름에는 시스템 필드가 없어야 합니다. | {header name}은(는) 시스템 필드입니다. 시스템 필드를 사용하지 않도록 {header name}의 이름을 바꾸고 파일을 다시 업로드하세요. | 전체 | |
| 파일을 업로드한 후에는 하나의 열 머리글만 각 Viva Insights 데이터 필드에 매핑할 수 있습니다. | 파일에 데이터 필드에 매핑된 원본 열이 두 개 이상 있습니다. 각 원본 열이 고유한 필드에 매핑되어 있는지 확인합니다. | 전체 | |
| 필드 값 | 필드 값은 올바른 데이터 형식으로 제공해야 합니다. 특성 참조를 참조하세요. | {header name} 값이 잘못되었습니다. {헤더 이름}은(는) 양식 employee@contoso.com다음에 있는 이메일 주소여야 합니다. |
전체 |
| {header name} 값이 잘못되었습니다. {Header name}은(는) 문자열이어야 합니다. | 전체 | ||
| 전체 | |||
| {header name} 값이 잘못되었습니다. {Header name}은(는) 양식 23.75 다음에 이중이어야 합니다. | 전체 | ||
| {header name} 값이 잘못되었습니다. {Header name}은(는) 정수여야 합니다. | 전체 | ||
| 필수 필드에는 모든 행에 대한 값이 있어야 합니다. | {header name} 열 또는 {header name} 값이 없습니다. {Header name}은(는) 필수 필드이며 모든 행에 대한 값이 필요합니다. {header name} 값을 추가하고 파일을 다시 업로드합니다. | 전체 | |
| 새 PersonId 필드에 대한 ManagerId 값이 없습니다. ManagerId는 필수 필드입니다. 해당 ManagerId 필드를 추가하고 다시 업로드합니다. | 전체 | ||
| 각 PersonId에는 고유한 ManagerId가 있어야 합니다. | 전체 | ||
다음과 같은 루프는 있을 수 없습니다.
|
전체 |