文件规则和验证错误
在本文中,我们将介绍如何设置上传文件的格式,并提供将数据引入高级见解应用时可能遇到的错误。
文件和字段规则
当任何数据行或列具有任何属性的无效值时,整个上载将失败,直到源文件修复,或者映射通过使值有效的方式更改属性的验证类型)。
文件的规则
数据文件需要采用 .csv UTF-8 格式,不能为空。
源和目标字段标头的规则
所有源和目标字段标题或列名都需要:
- 仅包含 ASCII 字母数字字符 (字母和数字,例如 Date1) 或下划线 (_) 。 不支持特殊非字母数字字符,例如 @、#、% & 或其他字符。
- 包含一个值。
- 独一无二。
自定义目标字段标头的规则
所有自定义目标字段标题或列名称都需要:
- 没有前导、中间或尾随空格。
- 不包含系统字段,这些字段包括:
- PeopleHistoricalId
- StartDate
- EndDate
- Domain
- PopulationType
- TimeZone
- StandardTimeZone
- WorkdayStart
- WorkDayEnd
- 周末日
- InferredTeamSize
- ObjectId
- IsActive
- 从“Microsoft_”开始
- MetricDate
- PrimaryCollaborator_PersonId
- SecondaryCollaborator_PersonId
必填字段需要为每一行指定一个值。
上传文件后,只能将一个列标题映射到每个 Viva Insights 数据字段。
字段值的规则
需要以正确的数据类型提供字段值。 请参阅 属性引用。
字段值中字符的规则
- 行中字段值的字符长度不能超过 128 KB,大约为 1024 x 128 个字符。
- 字段值中不允许使用“新行” (\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},使其不使用系统字段并再次上传文件。 | 全部 | |
上传文件后,只能将一个列标题映射到每个 Viva Insights 数据字段。 | 文件有多个映射到数据字段的源列。 确保每个源列都映射到唯一字段。 | 全部 | |
字段值 | 需要以正确的数据类型提供字段值。 请参阅 属性引用。 | {header name} 值无效。 {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。 | 全部 | ||
不能有 循环, 其中:
|
全部 |