从 Workday (预览) 导入组织数据

重要

此功能仅适用于公共预览版客户。 预览版中的功能可能不完整,并且可能会在更广的版本中推出之前进行更改。

可以使用下面所述的过程,使用 Workday 连接器将组织数据导入 Microsoft 365。

先决条件

在 Workday 与 Microsoft 365 之间设置连接之前,需要从 Workday 管理员获取有关 Workday 环境的以下信息:

  • Workday Web 服务 URL
  • 令牌 URL
  • 用户名
  • ClientID
  • 在后续部分所述的 Workday 中完成步骤

步骤

1.设置 Workday 连接

适用于:Microsoft 365 全局管理员

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

    1. 还可以选择左侧的 “Copilot ”,然后选择“ 代理 & 连接器”来开始导入。

    2. “连接器”下,选择“ 你的连接”。

    3. 选择“ 添加连接”。

    4. 在页面底部的“人员”下,选择“Workday”旁边的“添加”。

    用于启动 Workday 连接的页面的屏幕截图。

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

  3. “选择连接类型” 页上,选择“ 开始 Workday 设置”。

  4. 选择要与之共享数据的应用和服务。 默认情况下,所有公共保留属性在 Microsoft 365 和 Viva 应用和服务之间共享。 使用此页选择要与之共享特定于应用程序的数据和自定义数据的应用。 可以随时在 “设置”中更改选择。 了解详细信息

  5. “下载 Workday 证书”下,选择“ 下载证书”。 将下载名为“publicKey.pem”的 x509 证书文件。在文本编辑器中打开文件并复制其内容。 与 Workday 管理员共享此帐户。

    用于下载证书的页面的屏幕截图。

  6. 阅读确认说明,然后选择“ 下一步”。

  7. “设置 Workday 连接”下:

    1. 输入连接的名称。

    2. 请联系 Workday 管理员完成下面所述的 Workday 中的步骤。

    3. 输入 Workday 管理员提供的 Workday Web 服务 URL令牌 URLClientID

    4. 对于 “用户名”,请输入 Workday 管理员创建的 ISU 的名称。

    5. 选择希望 Workday 将数据发送到 Microsoft 365 的频率:每周或每月。

      用于设置连接的页面的屏幕截图。

  8. 如果需要,请在 Microsoft 365 中选择“确定组织数据的优先级”。 详细了解数据优先级

  9. 确认你同意使用 Workday API 传输数据的条款。

  10. “上传属性映射 ”页上,如果使用自己的自定义映射,请选择“ 浏览 ”以上传自定义的.json映射文件。 然后在页面底部选择“ 下一步”。

    • 或者,如果使用默认映射,则无需上传.json文件。 选择页面底部的“ 下一步 ”。
  11. 查看保留属性映射的详细信息。 若要进行更改,请返回到 “上传属性映射 ”页,然后上传新的.json文件。 如果一切正常,请在页面底部选择“ 下一步”。

  12. 如果已导入任何自定义属性,请在下一页上查看它们。 无法重命名它们,并且无法更改其数据类型。 若要更改名称,请返回到 “上传属性映射 ”页并上传新的.json文件。 如果一切正常,请在页面底部选择“ 验证映射”。

  13. 接下来,如果将任何特定于应用或自定义的数据发送到任何目标,请选择哪些应用可以访问你映射的属性,然后查看用于所有 Microsoft 365 应用和服务的全局属性。 了解如何操作

  14. 在最后一页上,查看连接的所有详细信息、应用和属性映射。 如果一切正常,请选择“ 连接”。 验证完成后,组织数据将可用于所选的应用和服务。

    注意

    如果设置了定期导出,则会验证数据是否满足 Viva 和 Microsoft 365 服务要求。 验证需要几个小时;但是,完成数据上传最多可能需要三天才能在配置文件存储中可用。 可以在Microsoft 365 管理中心的“组织数据”页上检查验证状态。 验证完成后,会显示一条消息,指示你的数据正在由 Viva 和 Microsoft 365 使用和管理。

2. Workday 中的步骤

适用于:Workday 管理员

  1. 打开 Workday。 搜索“创建集成系统用户”并将其选中。 这是与真人不关联的系统用户。

    创建集成系统用户的搜索字段的屏幕截图。

  2. “创建集成系统用户”下,填写每个字段,然后选择“ 确定”。

    “创建集成系统用户”页面的屏幕截图。

  3. 创建安全组。 在 Workday 中,搜索“创建安全组”并将其选中。

  4. 选择“ 集成系统安全组” (“不受约束) ”。

    用于创建安全组的页面的屏幕截图。

  5. 将集成系统用户添加到此组。

  6. 搜索“维护安全组”,然后选择“ 维护安全组的权限”。

    用于维护安全组权限的页面的屏幕截图。

  7. “作”旁边,选择“ 维护”。 在 “源安全组”旁边,选择你创建的安全组。

    用于选择已创建的安全组的页面的屏幕截图。

  8. 选择“+”图标以添加新 的域安全策略权限

    1. “选定 ”复选框保留为选中状态。

    2. “查看/修改访问权限”旁边,选择“ 仅获取”。

    3. 对于 域安全策略

      1. 添加 辅助角色数据:公共辅助角色报告
      2. 添加 辅助角色数据:组织信息
      3. 添加人员数据:专用工作Email集成
      4. 添加 人员数据:技能
      5. 添加 辅助角色数据:当前人员配备信息

      用于添加域安全策略的页面的屏幕截图。

  9. 搜索“激活挂起的安全策略更改”并选择它。

  10. 添加有关更改的描述性注释,然后选择“ 确定”。

  11. 选择“ 确认”,然后选择“ 确定”。 你现在有了一个新的系统用户,该用户具有获取辅助角色数据所需的适当权限。

3.注册 API 客户端

  1. 搜索“注册 API 客户端”并选择它。

    用于搜索 API 客户端的页面的屏幕截图。

  2. 填写以下字段:

    1. 为客户端指定适当的名称,例如“VivaConnectorClient”。
    2. 对于客户端授权类型,请选择“ Jwt 持有者授予”。
    3. 对于 x509 证书
      1. 选择“ 创建 x509 公钥”。
      2. 为证书指定适当的名称,例如“VivaX509Certificate”。
      3. 粘贴前面步骤中全局管理员共享的 publicKey.pem 文件的内容。
      4. 选择“确定”
      5. 确保为 “x509 证书”字段选择了此证书。
    4. 对于 “集成系统用户”,请输入之前创建的用户。
    5. 将访问令牌类型保留为“Bearer”。
    6. “范围 (功能区域) ”下,搜索并选择“人员配备”、“联系信息”和“工作人员个人资料和技能”。
    7. “包含 Workday 拥有的范围 ”保留为清除。
    8. 选择剩余字段的默认值。
  3. 选择“确定”

    API 客户端窗口的屏幕截图。

  4. 一些新字段应填充在 “限制为 IP 范围”下方。 保存以下信息,并与全局管理员共享,以在Microsoft 365 管理中心中输入:

    1. “ClientID”

    2. Workday 令牌 URL,例如 https://wd3-impl-services1.workday.com/ccx/oauth2/contoso4/token

    3. Workday Web 服务 URL,例如 https://wd3-impl-services1.workday.com/ccx/service/contoso4

      注意

      这与 Workday REST API 终结点不同。 如果不熟悉 Workday Web 服务 URL,可以复制令牌终结点,将“oauth2”替换为“服务”,并从末尾删除“/token”来创建它。

对连接或数据进行更改

  1. 转到“Microsoft 365 中的组织数据”页上的“选择连接类型”页, (“主页>设置>迁移”并导入>Microsoft 365> 中的“选择连接类型”) 。 在 “Workday 连接器”下,选择“ 开始 Workday 设置”。

  2. 选择 “编辑连接”。

  3. 若要更改哪些应用可以访问你的数据,请在第一页上选择“ 编辑数据访问选择 ”,并使用上述相同过程进行更改。

  4. 继续此过程并浏览屏幕,在相应的页面上进行任何所需的更改,例如凭据、属性访问和映射。 跳过任何不需要更新的页面。

  5. 完成后,请在“ 查看和确认 ”页上查看新的连接详细信息。 如果一切正常,请选择“ 确认”。

Workday 如何将数据发送到 Microsoft 365

将 Workday 连接到 Microsoft 365 时,如果使用默认映射文件,Workday 会通过一组预定义的源列发送。 这些列映射到 Microsoft 365 中的字段。 可以通过更新映射文件来更改这些预定义字段。

字段映射

下表显示了 Workday 字段与默认映射文件中Microsoft 365 个字段的对应方式。 详细了解Microsoft 365 个字段,包括数据类型和格式要求

属性 Workday 域
Microsoft_PersonEmail /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Contact_Data/wd:Email_Address_Data/wd:Email_Address
Microsoft_ManagerEmail /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Manager_as_of_last_detected_manager_change_Reference/wd:ID[@wd:type=“Employee_ID” or @wd:type=\“Contingent_Worker_ID”][1]
Microsoft_Organization (部门) /wd:Worker/wd:Worker_Data/wd:Organization_Data/wd:Worker_Organization_Data[1]/wd:Organization_Data/wd:Organization_Name
Microsoft_Layer 没有来自 Workday 的映射
Microsoft_LevelDesignation /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Job_Profile_Summary_Data/wd:Management_Level_Reference/wd:ID[@wd:type=“Management_Level_ID”]
Microsoft_JobDiscipline /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Job_Profile_Summary_Data/wd:Job_Family_Reference/wd:ID[@wd:type=“Job_Family_ID”]
Microsoft_CompanyOfficeLocation /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Location_Reference/wd:ID[@wd:type=“Location_ID”]
Microsoft_CompanyOfficeCountryOrRegion /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Country_Reference/wd:ID[@wd:type=“ISO_3166-1_Alpha-3_Code”]
Microsoft_CompanyPostOfficeBox 没有来自 Workday 的映射
Microsoft_CompanyOfficeStreet /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Address_Line_Data
Microsoft_CompanyOfficeCity /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:市政
Microsoft_CompanyOfficeState /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Country_Region_Descriptor
Microsoft_CompanyOfficePostalCode /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Postal_Code
Microsoft_Company /wd:Worker/wd:Worker_Data/wd:Organization_Data/wd:Worker_Organization_Data[1]/wd:Organization_Data/wd:Organization_Name
Microsoft_CompanyCode 没有来自 Workday 的映射
Microsoft_FirstName /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:First_Name
Microsoft_LastName /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:Last_Name
Microsoft_DisplayName /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Name_Data/wd:Preferred_Name_Data/wd:Name_Detail_Data/@wd:Formatted_Name
Microsoft_JobTitle /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Title
Microsoft_SecondaryJobTitle 没有来自 Workday 的映射
Microsoft_UserSkillNames /wd:Worker/wd:Worker_Data/wd:Skill_Data/wd:Worker_Skill_Item/wd:Skill_Data[@wd:Inactive=“0”]/@wd:Name
Microsoft_EmploymentType /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Worker_Type_Reference/wd:ID[@wd:type=“Employee_Type_ID” or @wd:type=\“Contingent_Worker_Type_ID”][1]
Microsoft_EmployeeID /wd:Worker/wd:Worker_Data/wd:Worker_ID
Microsoft_ManagerID /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Manager_as_of_last_detected_manager_change_Reference/wd:ID[@wd:type=“Employee_ID” or @wd:type=\“Contingent_Worker_ID”][1]
Microsoft_HireDate /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Status_Data/wd:Hire_Date
Microsoft_EmploymentStatus /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Status_Data/wd:Active (1 映射到“活动”,0 映射到“非活动”)
Microsoft_GlintEmploymentStatus /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Status_Data/wd:Active (1 映射到“活动”,0 映射到“非活动”)
Microsoft_Phone /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Contact_Data/wd:Phone_Data/@wd:Tenant_Formatted_Phone
Microsoft_CostCenter /wd:Worker/wd:Worker_Data/wd:Organization_Data/wd:Worker_Organization_Data/wd:Organization_Reference/wd:ID[@wd:type='Cost_Center_Reference_ID'][1]
ExternalSource_PersonIdentifier /wd:Worker/wd:Worker_Data/wd:Worker_ID
ExternalSource_ManagerIdentifier /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Manager_as_of_last_detected_manager_change_Reference/wd:ID[@wd:type=“Employee_ID” or @wd:type=\“Contingent_Worker_ID”][1]