上传组织数据（首次上传）

组织数据可以通过以下两种方式之一显示在 Microsoft Viva Insights 的高级见解应用中：通过 Microsoft Entra ID（默认源）或作为管理员上传的 .csv 文件。

本文介绍第二个选项：上传 .csv 文件。

重要

仅当这是你第一次上传组织数据时，才使用以下步骤。 如果这不是首次上传，请参阅 上传组织数据 (后续上传) 更新以前上传的数据。

对于从旧版应用获取的客户：

如果要从旧版高级见解应用迁移，并且首次将组织数据上传到 Viva Insights，我们建议 仅 使用新应用进行数据上传。 使用新应用可防止数据不一致。

工作流

准备源数据后，将按照以下步骤操作：

1. 上传 .csv 文件。
2. 映射字段。
3. 应用验证数据。 (如果验证不成功，可以从 验证失败中所述的几个选项中进行选择。)
4. 应用处理数据。 (如果处理不成功，可以从 处理失败中所述的几个选项中进行选择。)

数据成功验证和处理后，就可以完成整个数据上传任务。

File upload

若要上传 .csv 文件，请执行以下步骤：

1. 打开 高级见解应用的 管理员体验。

2. 在“数据中心”页上，转到屏幕右侧的“数据源”下方的“.csv 上传”卡片。

3. 选择“开始”。

4. 在 步骤 1（第 2 步：准备和上传）下：

   1. 输入 上传名称。
   2. 在 “上传文件”下，选择要上传的 .csv 文件。

   确保 .csv 文件为：

   • UTF-8 编码。

   • 开始上传过程时，不会在不同的程序中打开。

   • 不大于 1 GB。

     

注意

若要查看 .csv 文件的结构和指南，并避免上传过程中的常见问题，可以通过下载 .csv 模板链接下载模板 。

4. 若要上传，请选择“ 下一步”。 若要取消上传，请选择“ 取消”。

字段映射

上传文件后，你将看到 “步骤 2（共 2 步）映射 ”页。 若要查看数据中的见解，需要将 .csv 文件中) 字段 (列映射到应用可识别的字段名称。

有两种类型的字段： 系统默认 字段和 自定义字段。

系统默认 (必需或可选)

系统默认字段可以是 必需字段（即 PersonId、 ManagerId和组织）或 “保留”可选字段。 这些字段表示 Viva Insights 在分组和筛选以外的特定计算中知道和使用的属性。

重要

每个必填字段都需要在每一行中都有一个有效的非 null 值。 即使 .csv 文件中的列标题与 Viva Insights 值名称不完全匹配，也需要映射所有必需的 Viva Insights 值。

可选字段是应用建议使用的常见系统字段。 如果组织没有可选字段的数据，则无需映射这些字段。

若要了解字段是必需字段还是可选字段，请参阅映射列表右侧的 Viva attributes 部分。 必需属性在字段名称下方具有“必需”标签，而可选属性具有“保留的可选”标签。

如果需要字段的定义，请将鼠标悬停在 i ) 图标 ( 信息上。

自定义警报

自定义字段是可以创建的可选属性。 以下部分介绍了映射和命名自定义属性。

映射字段

按照以下步骤将 .csv 数据映射到 Viva Insights 属性。

重要

所有显示在 “源列名称”下的 .csv 标头字段都需要映射，然后才能继续执行上传过程的下一部分。

1. 对于每个必需的 Viva Insights 字段：

   1. 在 “源列名称”下找到相应的列标题。 若要防止以后出现验证错误，请确保此列是正确的数据类型。
   2. 在 “映射到 Viva Insights 字段 ”列下，打开下拉列表并选择与步骤 1a 中标识的列标题对应的 Viva Insights 属性。

2. 对自定义字段和可选字段重复步骤 1a 和 1b。

   若要添加自定义字段，只需将其作为列包含在数据文件中即可。 应用会自动为其分配一个名称并映射它。 对于此版本的 Viva Insights，所有自定义属性都分配有默认名称，并且只能归类为 字符串 数据类型。

   重要

   不要将 TimeZone 作为列上传。 你将收到一个错误。

3. 完成属性映射后，选择屏幕左下角的“ 下一步 ”按钮。

映射字段后，应用将验证和处理数据，如以下部分所述。 如果验证和处理成功，则完成上传过程中的一部分。

Validation

映射属性后，应用将开始验证数据。

在大多数情况下，文件验证应很快完成。 如果组织数据文件很大，验证最多可能需要一两分钟。

此阶段完成后，验证已成功或失败。 根据结果，你将在 “数据连接 ”屏幕右上角收到成功通知或失败通知。

有关后续操作的信息，请转到相应的部分：

验证成功

验证失败

验证成功

成功验证后，Viva Insights 开始处理新数据。 处理可能需要几个小时到一天左右的时间。 在处理过程中，你将在 “数据连接 > 正在上传或删除 ”表中看到“正在处理”状态。

处理完成后，它要么成功，要么失败。 根据结果，你将在 “数据连接 ”屏幕右上角收到成功通知或失败通知。

处理成功

处理成功后，你将在 “上传或删除历史记录 ”表中看到“成功”状态。 此时，上传过程已完成。

下面是在以下体验中上传组织数据后反映组织数据的典型时间：

• 数据连接>导入历史记录中显示的成功状态：几个小时

• 数据质量选项卡、灵活查询和 Power BI 模板： 一到两天

• Teams 应用中的领导/经理报表： 下一次每周刷新

收到“成功”状态后，可以：

• 选择 (眼睛) 图标的视图以查看验证结果的摘要。
• 选择映射图标以查看工作流的映射设置。

注意

每个租户一次只能进行一次上传。 你需要完成一个数据文件的工作流，这意味着在开始下一个数据文件的工作流之前，要么引导它成功验证和处理，要么放弃它。 上传工作流的状态或阶段显示在“ 数据连接 ”选项卡上。

处理失败

如果处理失败，你将在 “正在上传或删除 ”表中看到“失败”状态。 选择状态中的链接可转到失败说明。

选择 “编辑”或“开始新上传”。 通过此按钮，可以再次开始上传过程。

注意

处理失败通常是由后端错误导致的。 如果你看到持续处理失败，并且已更正上传文件中的数据，请向我们记录支持票证。

验证失败

如果数据验证失败，你将看到一个新屏幕，其中包含“验证失败”错误和有关失败的一些信息。 如果不想继续上传过程，可以选择“ 取消 上传”按钮。

在源文件中进行更改并再次尝试上传之前，可以选择“ 下载问题”。 此日志文件描述了数据中可能导致验证错误的问题。 使用此信息决定接下来要执行的操作-修复源数据或更改映射设置。

更正数据中的错误指南

当任何数据行或列对任何属性具有无效值时，整个上传将失败，直到修复源文件 (或修复属性映射) 。

若要了解如何设置文件格式以防止错误，请参阅 文件规则和验证错误。

相关主题

准备组织数据