使用 .csv 文件导入和管理组织数据

可以将员工信息从非Microsoft系统导入到 Microsoft 365,以便在 Microsoft 365 和 Viva 之间使用。

注意

组织数据必须由组织数据源管理员导入。 任何预先存在的特定于应用的管理员角色 都不会 自动转换为组织数据源管理员角色。 需要分配角色。 详细了解组织数据管理员角色

若要导入数据,请使用要包含 .csv 用户的属性 (或信息) 填充 .csv 模板,然后通过Microsoft 365 管理中心上传文件。 下面是入门步骤:

  1. 下载 .csv 模板
  2. 构建组织数据
  3. 首次导入组织数据
  4. 更新或对数据进行其他更改
  5. 对现有数据进行追溯更新

步骤 1 - 下载 .csv 模板

  1. 以具有组织数据源管理员权限的用户身份登录到Microsoft 365 管理中心。

  2. “Microsoft 365 中的组织数据 ”页 (“ 设置 > 迁移和导入) ”下,选择“ 开始 (”(如果这是第一次导入数据) 或 “新建导入”。

  3. “选择连接类型” 页上,选择“ 启动 CSV 设置”。

  4. 选择要与之共享数据的应用和服务,然后选择“ 下一步 ”以继续前进。

  5. “准备组织数据 ”页上,选择“ 下载 CSV 模板”。

注意

还可以使用从另一个系统(例如 HR 软件)导出的组织数据作为起点,如 获取组织数据的导出中所述。

步骤 2 - 组织数据的结构

创建 .csv 文件起点后,请添加要在 Microsoft 365 中使用的组织数据,然后保存该文件。

示例数据文件

下面是有效 .csv 文件的示例片段:

Microsoft_PersonEmail,Microsoft_ManagerEmail,Microsoft_LevelDesignation,Microsoft_Organization,Microsoft_Layer,Microsoft_CompanyOfficeCity
Emp1@contoso.com,Mgr1@contoso.com,Junior IC,Sales,8,Seattle
Emp2@contoso.com,Mgr1@contoso.com,Junior IC,Sales,8,Seattle
Emp3@contoso.com,Mgr2@contoso.com,Manager,Sales,7,Seattle
Emp4@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York
Emp5@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York
Emp6@contoso.com,Mgr3@contoso.com,Support,Sales,9,New York

有关属性的详细信息,请参阅 属性参考

步骤 3 - 首次导入组织数据

使用数据创建 .csv 文件后,下一步是从计算机上的本地文件或 SharePoint 网站导入数据。

从计算机上的本地文件上传 .csv 文件

使用数据创建 .csv 文件后,可以直接从计算机上的本地文件上传该文件。

注意

直接从本地文件上传的文件有 25 MB 的限制。 如果 .csv 文件较大,请先 将其上传到 SharePoint ,然后从中导入。

屏幕截图显示了上传 csv 文件的第一步。

从 SharePoint 上传 .csv 文件

首先,需要将文件从本地计算机上传到安全的 SharePoint 位置;然后导入数据。

将文件上传到 SharePoint

使用以下步骤将数据上传到 SharePoint。 可以上传最大为 2 GB 的文件。

  1. 成为 SharePoint 网站的所有者。 如果你不是所有者,则必须对 SharePoint 网站具有成员访问权限。 不要使用自定义域或本地 SharePoint 网站。

  2. 将组织数据文件上传到可以访问的文件夹。 将显示为文件所有者。

    注意

    上传数据的管理员必须是将文件上传到 SharePoint 网站的用户。

  3. 复制文件路径,如以下说明中所述。

SharePoint 说明

  1. 打开 SharePoint 网站库。

  2. 选择“ 上传”,然后选择“ 文件”。

    屏幕截图显示了 SharePoint 中的“上传”菜单。

  3. 导航到保存 .csv 文件的位置,然后选择“ 打开”。

    还可以使用拖放来上传文件。

    将数据导入 Viva 之前,您需要 SharePoint 上文件的路径,格式如下:https:// domain.sharepoint.com/sites/sitename/Documents/foldername/文件名.csv。 使用以下步骤获取文件的路径 - 路径与查看文件时在浏览器中看到的 URL 不同。

  4. 选择文件旁边的省略号 (...) ,然后选择“ 详细信息”。

    屏幕截图显示 SharePoint 库中文件旁边的省略号选项。

  5. 找到 “路径” 值,然后选择复制图标。

    屏幕截图显示了 SharePoint 中文件的路径信息。

注意

请务必按照以下步骤获取文件的路径。 此路径与在 SharePoint 中查看 .csv 文件时浏览器的 URL 字段中显示的路径不同。

将数据导入 Microsoft 365

现在可以导入数据了。

  1. Microsoft 365 页的“组织数据”页上的“数据连接”页开始导入 (“主页>设置>迁移”,并在) Microsoft 365>数据连接中导入>组织数据。

  2. 如果这是你第一次导入数据) ,请选择 “开始 (”;如果尚未导入数据) ,请选择 “新建 导入 (”。

  3. “选择连接类型” 页上,选择“ 启动 CSV 设置”。

  4. 选择要与之共享数据的应用和服务,然后选择“ 下一步 ”以继续前进。

  5. “准备组织数据 ”页上,选择“ 下一步 ”以继续前进。

  6. “导入数据 ”页上,选择“从 Sharepoint 导入”和“本地导入”。

    • 从 Sharepoint 导入 (建议) :输入保存 .csv 文件的 SharePoint 位置。 (如果在上传步骤结束时复制了位置,请粘贴到此处。)
    • 本地导入:直接从本地计算机上传。
  7. 选择 下一步

  8. 按照屏幕上的提示导入属性标头、映射属性并授予属性访问权限。 选择“ 下一步 ”以继续前进。 详细了解如何映射属性和设置访问权限

  9. 查看连接详细信息,然后选择“ 开始验证”。

根据 Viva 和 Microsoft 365 服务使用的要求验证组织数据。 验证需要几个小时;但是,完成数据上传最多可能需要三天才能在配置文件存储中可用。 可以在管理中心的“组织数据”页上检查验证状态。 验证完成后,会看到一条消息,指出数据正在使用并由 Viva 和 Microsoft 365 管理。

每个最终用户的组织数据存储在该最终用户的邮箱中,并遵循Exchange Online (的数据驻留规则,如Exchange Online) Data Residency中所述。

后续上传

若要导入新数据,需要设置另一个连接。

注意

对于 .csv 导入,在属性映射页上, “导入的属性 ”下的值来自导入的文件。 它不显示以前导入的任何数据的记录。

按照屏幕上的提示进行更改,对上述第一次上传使用相同的过程。

更新或对数据进行其他更改

组织数据源管理员可以更新或删除组织数据。

若要更新或删除最终用户的组织数据,请创建并上传一个新的 .csv 文件,该文件仅包含要更新或删除其数据的用户。

  • 若要更新值,请包括要更新的所有属性。 为要更改的任何属性提供不同的值。 如果包含属性,但未 (提供值,并且 未) 将其设置为空字符串 ,则使用 Microsoft 365 用户配置文件中的当前值,并且不会更新该值。 新上传与以前的数据合并,不会覆盖该数据。
  • 若要删除用户的所有数据,请输入其所有属性的空字符串或整数值,并将 Microsoft_Layer 属性设置为 -1。 若要删除 Microsoft_ManagerEmail,请将管理员电子邮件设置为租户中不存在的电子邮件地址,例如“noname@contoso.com”。

注意

如果使用 Excel 编辑 .csv 文件,请使用三个单引号 ('') 而不是两个 ('') - Excel 将单引号 (') 作为转义字符。

对现有数据进行追溯更新

还可以对已上传的现有数据进行追溯更新。

例如,假设你的公司于 2024 年 10 月 2 日为销售团队聘请了一位新经理,但直到现在,更改才反映在组织数据中。 2024 年第 4 季度的报告不准确,因为它们显示了老经理。 你希望更新数据以显示截至 2024 年 10 月 2 日的正确经理,以便报表可以准确表示历史报告行。

注意

只能使用 .csv 文件更新现有数据,只能更新 Viva Insights 数据。

步骤:

  1. 准备包含受影响员工和正确信息的 .csv 文件。 例如:

    • Microsoft_PersonEmail,Microsoft_ManagerEmail
    • alex.jones@contoso.com,new.manager@contoso.com
  2. 转到 “新建导入>”“选择连接类型”。

  3. 选择 “开始 csv 导入”,然后选择“ 历史导入”。

    屏幕截图显示了如何开始导入。

  4. 查看更新的数据访问,这些数据只能发送到 Viva Insights。

    屏幕截图显示如何查看历史数据的数据访问。

  5. “导入数据 ”页上,将 “文件”设置为“有效日期”。 在此示例中,日期为 2024/10/02。

    屏幕截图显示如何设置文件的有效日期。

  6. 完成上传并选择“ 提交”。

    显示如何提交更改的屏幕截图。