通过

在 Workday 门户上创建 RaaS 报表

本文包含在 Workday 中启用目录、用户、分配和完成数据同步和Viva Learning集成所需的步骤。 管理员需要在 Workday 门户中创建自定义 RaaS 报表。 为 Workday 门户创建集成系统用户并提供所有安全访问权限后，请按照以下步骤创建所需的 RaaS 报表。

注意

应从同一用户帐户创建 (目录、用户数据、LRS) 的所有 RaaS 报表，或者应在 Workday 门户中为单个用户授予报表所有权。 此用户名应插入Viva Learning管理提供程序的“报告 URL”属性下。 查看此示例： https://wd2-impl-services1.workday.com/ccx/service/customreport2/microsoft_dpt6/username/Viva_Learning_Catalog_Report.

注意

管理员需要手动创建自定义报表。 这是一个一次性过程。 我们仅支持此支持文章中提到的报表结构。 我们不建议在报表中进行任何其他更改。

  1. 确保已为租户设置 Workday 到 AAD 用户同步 。
  2. 使用 Workday 启用入站用户预配，以确保 Workday 中的所有用户都同步到Microsoft Entra ID。
  3. 如果你已经是 Microsoft 365 客户，则应为租户设置 Workday 到Microsoft Entra用户同步。

请与组织管理员联系，了解大致相同的详细信息。 否则，可以参考此处提到的步骤来启用预配。 教程：使用 本地 Active Directory 为 Workday 配置自动用户预配

重要

在创建报表后，验证报表字段名称、筛选器名称和提示名称的 XML 别名是否与支持文档完全匹配。

在 Workday 门户上创建 RaaS 报表进行目录同步

应从 Workday 的主要管理员帐户创建此报表，以避免任何隐私和安全相关问题。 目前，我们正在同步历史作业和当前作业。

  1. 登录到 Workday 门户。

    1. 登录到 Workday 门户。
    2. 搜索任务“创建自定义报表”。

  2. 配置报表参数。

    1. 将报表名称标题为 Viva Learning Catalog Report。 报表名称必须与此字符串完全匹配。
    2. 将报表类型设置为“高级”。
    3. 将复选框标记为“作为 Web 服务启用”。
    4. 将复选框标记为“针对性能进行优化”。
    5. 在“数据源”字段中，转到“全部”，然后选择“学习内容”。选择 “确定”。

  3. 添加报表字段。

    1. 选择“ 确定”后，数据源将“学习内容”作为值。 删除“数据源筛选器”字段中的任何现有值，并添加“可管理学习内容”。
    2. 如以下架构中所述，在“Columns”中添加字段。 你会看到字段“rating”的三个对象;选择旁边带有哈希 (#) 图标的。

    重要

    这些列值区分大小写。

    业务对象 字段 列标题替代 列标题替代 XML 别名
    学习内容 Workday ID LearningObjectId LearningObjectId
    学习内容 标题 标题 标题
    学习内容 说明 说明 说明
    学习内容 指向学习内容的链接 DeepLinkUrl DeepLinkUrl
    学习内容 持续时间（分钟） 持续时间 持续时间
    学习内容 非活动状态 非活动 非活动
    学习内容 学习内容类型 ContentType ContentType
    学习内容 内容提供程序 ContentProvider ContentProvider
    学习内容 从搜索和浏览中排除 IsNonSearchable IsNonSearchable
    学习内容 评级 评级 评级
    学习内容 技能级别 DifficultyLevel DifficultyLevel
    学习内容 主题 主题 主题
    学习内容 技能 技能 技能
    学习内容 第三方内容缩略图 URL ExternalImageURL ExternalImageURL
    语言 用户语言代码 Locale Locale
    学习内容 上次更新时间 LastUpdated LastUpdated

    编辑自定义报表的屏幕截图。

  4. 在“组列标题”下，添加以下字段：

    业务对象 分组列标题 组列标题 XML 别名
    语言 语言 语言
    学习内容 learningContent_group learningContent_group

  5. 在“筛选器部分”下向报表添加筛选器。

    And/Or ( 字段 运算符 比较类型 比较值 ) Indexed
    And 学习内容类型 与选择列表完全匹配 提示用户输入值 提示 #1 是
    And 上次更新时间 大于或等于 提示用户输入值 提示 #2 是
    And 上次更新时间 小于或等于 提示用户输入值 提示 #3 是

    筛选器值的带格式字段的屏幕截图。

  6. 添加提示：转到提示。 标记“字幕中的提示值”并添加以下提示值。 可以直接复制并粘贴这些值。

    重要

    这些列值区分大小写。

    字段 提示限定符 提示标签 提示 XML 别名的标签 默认类型 默认值 必需
    学习内容类型 提示 #1 contentType contentType 无默认值 是
    上次更新时间 提示 #2 Start_Date Start_Date 无默认值 是
    上次更新时间 提示 #3 End_Date End_Date 无默认值 是

    提示值的带格式字段的屏幕截图。

  7. 转到 “高级 ”，然后选择“ 针对性能优化”字段。

    注意

    isEffective 日期更改后，无法打开性能优化。 考虑到手头的数据量，我们可以建议客户取消选中此字段。

  8. 与集成系统用户 (ISU) 共享报表，该报表是在启用目录同步时创建的。转到报表中的 “共享 ”部分，选择“与特定授权组和用户共享”选项，并在“ 授权用户 ”字段中添加 ISU 名称。

    目录报表的“编辑自定义报表”窗口的屏幕截图。

  9. 保存报表。 选择“确定”。

    最终报表的屏幕截图。

    1. 生成报表 URL。 此 URL 作为Viva Learning 管理员选项卡上的输入参数是必需的。创建报表的同一用户应生成 URL。

      1. 选择报表 >“Web 服务>视图 URL”。

        自定义报表的视图 URL 部分的屏幕截图。

      2. 在下一个窗口中，选择任意 contentType 和任何日期范围，然后选择 “确定”。

        “查看 URL”Web 服务“窗口的屏幕截图，其中包含用于编辑内容类型和日期的选项

      3. 选择 “JSON”。 此作将打开一个新窗口。

        选择 JSON 时打开的新窗口的屏幕截图。

    2. 在下一个窗口中，提供 Workday 凭据并登录。 它会下载 JSON。

    3. 从浏览器复制 URL，并在Viva_Learning_Catalog_Report后追加该 URL。 即报表名称

      1. 例如，对于Microsoft测试租户，URL 为： https://wd2-impl-services1.workday.com/ccx/service/customreport2/microsoft_dpt6/svasireddy/Viva_Learning_Catalog_Report?Start_Date=2023-03-01-08:00&End_Date=2023-05-14-07:00&contentType!WID=9882927d138b100019b928e75843018d&format=json
      2. 追加后，测试租户的最终 URL： https://wd2-impl-services1.workday.com/ccx/service/customreport2/microsoft_dpt6/svasireddy/Viva_Learning_Catalog_Report
      3. 保存最终 URL，在启用配置时，该 URL 用作管理员门户上的输入配置参数。

    4. 在 管理员 门户中完成配置后，在接下来的 24 小时内，增量同步将调用报表 API，并相应地将数据反映在Viva Learning中。 有关在 管理员门户上启用集成的详细信息，请参阅此文档。

在 Workday 门户上为用户数据同步创建 RaaS 报表

从主要 Workday 管理员帐户创建此报表，以避免任何与隐私和安全相关的问题。 目前，我们正在同步历史作业和当前作业。

  1. 登录到 Workday 门户。

    1. 登录。
    2. 搜索任务“创建自定义报表”。

  2. 配置报表参数：

    1. 将报表命名为“Viva Learning用户报告”。 报表名称必须与此字符串匹配。
    2. 将报表类型指示为“高级”。
    3. 选中“作为 Web 服务启用”。
    4. 选中“针对性能进行优化”。
    5. 在“数据源”中，转到“全部”，然后选择“HCM 报告的辅助角色”。选择 “确定”。

  3. 添加报表 字段。

  4. 在“列”中添加字段。

    重要

    这些列值区分大小写。

    业务对象 字段 列标题替代 列标题替代 XML 别名
    工人 Workday ID UserID UserID
    工人 首选名称 - 名字 FirstName FirstName
    工人 首选名称 - 姓氏 LastName LastName
    工人 用户名 UserName UserName
    工人 “工作线程已终止”或“已终止” 终止 终止
    工人 公共主要工作Email地址 Email_Address Email_Address
    工人 员工 ID Employee_ID Employee_ID

    查看“Viva Learning用户”报表的“自定义报表”中表的屏幕截图。

    1. 向报表添加筛选器

      1. 在“对实例进行筛选”中添加以下值。 按照下面提到的步骤添加计算字段。

        And/Or ( 字段 运算符 比较类型 比较值 ) Indexed
        And 雇用日期 大于或等于 提示用户输入值 启动提示 是
        And 雇用日期 小于或等于 提示用户输入值 结束提示 是

    2. 添加提示：转到提示。 标记“在字幕中显示提示值”，并添加以下提示值。 可以直接复制并粘贴这些值。

    重要

    这些列值区分大小写。

    字段 提示限定符 提示标签 提示 XML 别名的标签 默认类型 默认值 必需 运行时不提示 不要包含在副标题中
    临时辅助角色类型 Contingent_Worker_Type 无默认值 是
    员工类型 Employee_Type 无默认值 是
    辅助角色类型 Worker_Types 无默认值 是
    包括已终止的辅助角色 Include_Terminated_Workers 指定默认值 是 是
    雇用日期 启动提示 Start_Date Start_Date 无默认值 是
    雇用日期 结束提示 End_Date End_Date 无默认值 是

    1. 转到 “高级 ”，然后选择字段 Optimized for Performance。

    2. 与集成系统用户 (ISU) 以及启用内容同步时创建的相应安全组共享报表。转到报表中的 “共享 ”部分，选择“与特定授权组和用户共享”选项，并在“授权组”和“ 授权用户 ”字段中添加组名称和用户名。

    3. 保存报表。 选择“确定”。

    4. 在管理员门户上完成配置后，在接下来的 24 小时内，增量同步将调用报表 API，并相应地将数据反映在Viva Learning中。 有关在 管理员门户上启用集成的详细信息，请参阅此文档。

在 Workday 门户中创建 RaaS 报表，供组织分配及其完成状态

应从主要 Workday 管理员帐户创建此报表，以避免任何隐私和安全相关问题。 目前，我们正在同步历史作业和当前作业。 此处，学习器记录同步缩写为 LRS。

  1. 登录到 Workday 门户：

    1. 登录。
    2. 搜索任务“创建自定义报表”。

  2. 配置报表参数：

    1. 将报表命名为“Viva Learning LRS 工作分配报告”。 报表名称必须与此字符串匹配。
    2. 将“报表类型”设置为“高级”。
    3. 将复选框标记为“作为 Web 服务启用”。
    4. 在“数据源”字段中，转到“全部”，然后选择“学习作业记录”。 选择“确定”。

  3. 添加报表字段。

    1. 选择 “确定”后，“数据源”会自动将值设置为“学习作业记录”。对于“数据源筛选器”字段，请删除任何现有值，并添加“来自学习组织的 ~Person~的作业记录”。 可以复制此值并直接粘贴到 字段中。
    2. 将字段添加到“列”中，如下所示。 你将看到“学习作业”的两个对象，选择旁边带有蓝色图标的一个对象。

    重要

    这些列值区分大小写。

    业务对象 字段 列标题替代 列标题替代 XML 别名
    学习作业 Workday ID AssignmentId AssignmentId
    工人 Workday ID LearnerId LearnerId
    学习内容 Workday ID LearningObjectId LearningObjectId
    学习作业 截止日期 DueDate DueDate
    学习作业 分配状态 CompletionStatus CompletionStatus
    学习作业 分配日期 AssignmentDate AssignmentDate
    分配者 Workday ID AssignerId AssignerId
    学习作业 工作分配记录完成时刻 CompletionDate CompletionDate
    学习作业 必需 AssignmentType AssignmentType

    LRS (学习者记录同步) 分配 RaaS 报表列值的表的屏幕截图。需要输入的文本值在 preceeding 表中进行了概述。

    注意

    In progress Workday 中的状态不会同步到Viva Learning。

  4. 在“组列标题”下，添加以下字段。

    业务对象 组列标题 组列标题 XML 别名
    分配者 Assigned_By_group Assigned_By_group
    学习作业 Learning_Assignment_group Learning_Assignment_group
    学习内容 Learning_Content_group Learning_Content_group
    工人 Worker_group Worker_group

  5. 在“提示符”“在字幕中显示提示值”下，添加以下提示值。 可以直接复制并粘贴这些值。 在“Learning Organization for Learning Assignment”的“默认值”字段中，提供顶级组织 (根组织) 的默认值，你需要为其透视报表。

    重要

    这些标签值区分大小写。

    字段 提示标签 提示 XML 别名的标签 默认类型 默认值 必需 运行时不提示
    用于学习作业的学习组织 Learning_Organizations_for_Learning_Assignment Learning_Organizations_for_Learning_Assignment 无默认值 是
    包括从属组织 Include_Subordinate_Organizations 指定默认值 是 是 是

  6. 向报表添加日期筛选器，以便进行增量同步。

    1. 转到“筛选器”。 选择“+”，在“And/Or”中选择“和”。 在“字段”中选择“为报表创建计算字段”。

    2. 在下一个屏幕中，将“字段名称”写入为 ModifiedDate，然后选择“函数”作为“生成日期”。 选择“确定”。

    3. 在下一个屏幕中，在“日期字段”下添加以下值，然后选择“ 确定”。

      字段 值
      从日期字段提取年份 上次功能更新
      从日期字段提取月份 上次功能更新
      从日期字段提取日期 上次功能更新

    4. 在开始筛选器的剩余字段中添加以下值：

      字段 值
      字段 修改日期
      运算符 大于或等于
      比较类型 提示用户输入值，如果值为空，则忽略筛选条件
      比较值 启动提示

    5. 使用以下值添加另一个筛选器 和 ，然后选择“确定”。

      字段 值
      字段 ModifiedDate
      运算符 小于或等于
      比较类型 提示用户输入值，如果值为空，则忽略筛选条件
      比较值 结束提示

    针对自注册完成字段的实例进行筛选的屏幕截图。

    修改提示

    1. 转到提示。

      1. 选择“ 填充未定义的提示默认值”。 此选择会添加上一步中定义的“修改日期”的开始和结束提示。

        自注册完成提示的屏幕截图

      2. 在新提示中添加以下值，然后选择“ 确定”。

        • 对于“开始提示”，请在“提示标签”和“提示 XML 别名标签”字段中添加值Start_Date。
        • 对于“结束提示”，请在“提示符标签”字段和“提示符XML 别名的标签”字段中添加值End_Date。

    重要

    这些标签值区分大小写。

    1. 转到 “高级”。 取消选中“ 性能优化”字段。

    2. 保存报表。 选择“确定”。

    3. 与集成系统用户 (ISU) 以及启用内容同步时创建的相应安全组共享报表。

    4. 在接下来的 24 小时内，LRS 同步调用报表 API，并且数据相应地反映在Viva Learning中，前提是管理员已在管理员门户上启用 LRS。 有关管理员门户上的配置步骤，请参阅此文档。

注意

完成状态为“手动放弃”的分配不会显示在Viva Learning用户体验中。

在 Workday 门户上创建 RaaS 报告，了解自注册的完成状态

应从主要 Workday 管理员帐户创建此报表，以避免任何隐私和安全相关问题。 目前，我们正在同步历史作业和当前作业。

  1. 登录到 Workday 门户。

    1. 登录。
    2. 搜索“创建自定义报表”。

  2. 配置报表参数：

    1. 将报表命名为“Viva Learning自注册报告”。 报表名称必须与此字符串匹配。
    2. 将“报表类型”设置为“高级”。
    3. 将复选框标记为“作为 Web 服务启用”。
    4. 在“数据源”字段中，转到“全部”，然后选择“学习注册”。 选择“确定”。

  3. 添加报表字段。

    1. 选择“ 确定”后，“数据源”会自动将值设置为“学习注册”。将“数据源筛选器”字段留空。

    2. 按照以下架构在“Columns”中添加字段。 你将看到“学习注册”的两个对象，选择旁边带有蓝色图标的一个对象。

    重要

    这些列值区分大小写。

    业务对象 字段 列标题替代 列标题替代 XML 别名
    学习注册 Workday ID EnrollmentId EnrollmentId
    学习注册参与者 Workday ID LearnerId LearnerId
    学习内容详细信息 Workday ID LearningObjectId LearningObjectId
    学习注册 完成状态 CompletionStatus CompletionStatus
    学习注册 完成日期 CompletionDate CompletionDate

    Workday 自我注册报告的屏幕截图。

    1. 在“组列标题”下，添加以下字段：

      业务对象 组列标题 组列标题 XML 别名
      学习内容详细信息 Learning_Content_Detail_group Learning_Content_Detail_group
      学习注册 Learning_Enrollment_group Learning_Enrollment_group
      学习注册参与者 Learning_Enrollment_Participant_group Learning_Enrollment_Participant_group

    2. 向报表添加筛选器，以便进行增量同步。

      1. 转到筛选器并添加以下值：
      And/Or ( 字段 运算符 比较类型 比较值 ) Indexed
      And 完成日期 大于或等于 提示用户输入值 启动提示 是
      And 完成日期 小于或等于 提示用户输入值 结束提示 是
      And 学习作业 为空
      And 完成状态 在选择列表中 此筛选器中指定的值 已完成 是

    Workday 中自注册完成筛选器的屏幕截图。

修改提示

  1. 转到提示。

    1. 选择“ 填充未定义的提示默认值”。 此选择可快速添加完成日期的开始和结束提示，如上一步中定义。 还可以输入提示，如下图所示。 填充提示后，此检查框选择将消失。

    2. 选择“ 在副标题中显示提示值”。

      Workday 自我注册完成提示的屏幕截图。

    3. 在新提示中添加以下值，然后选择“确定”。

      • 对于“开始提示”，请在“提示标签”和“提示 XML 别名标签”字段中添加值 StartDate。
      • 对于“结束提示”，请在“提示标签”和“提示 XML 别名的标签”字段中添加值 EndDate。

    重要

    这些标签值区分大小写。

  2. 转到 “高级”。 选中“ 针对性能优化”字段。

    Workday 高级选项自我注册报告窗口的屏幕截图。

  3. 保存字段。 选择“确定”。

  4. 与集成系统用户 (ISU) 以及启用内容同步时创建的相应安全组共享报表。转到报表中的 “共享 ”部分，选择“与特定的授权组和用户共享”，并在 “授权 组”和“ 授权用户 ”字段中添加组名和用户名。

  5. 在接下来的 24 小时内，LRS 同步调用报表 API，并相应地反映Viva Learning中的数据。 这取决于管理员是否在管理员门户上启用了 LRS。 有关管理员门户上的配置步骤，请参阅此文档。

注意

自注册完成状态不支持课程。

重要

如果租户刷新，RaaS 报表中的报表所有者参数可以自动更改为默认系统用户。 所有者状态的此更改也会更改Viva Learning的 API URL。 若要使连接正常工作，可以重新配置 Workday 连接器，或将报表转移到原始所有者。