适用于 UKG Pro 劳动力管理的 Teams 排班连接器的先决条件和要求

概述

借助适用于 UKG Pro 劳动力管理的 Microsoft Teams 排班连接器，可以将 Microsoft Teams 中的排班应用与 UKG Pro 劳动力管理 (UKG Pro WFM) 系统集成。 一线员工可以在 UKG Pro WFM 中从班次中无缝查看和管理他们的日程安排。

可以使用 Microsoft 365 管理中心或 PowerShell 中的 Shifts 连接器向导来创建连接和连接实例。 设置完成后，可以在 Microsoft 365 管理中心或使用 PowerShell 对其进行管理。

本文列出了在使用 向导 或 PowerShell 创建连接之前必须完成的要求、先决条件和配置任务。 它还概述了如何根据 UKG Pro WFM 组织结构在 Teams 中设置团队。

开始之前

在将 Shifts 与 UKG Pro WFM 集成之前，组织必须已设置以下环境要求。

• 已配置 UKG Pro WFM 环境。 这意味着你的组织已完成以下任务：

  • 你已确定如何组织“团队” (用户) 分组，以匹配组织结构和业务需求，并按位置对用户进行分组。

    重要

    班次当前支持在 UKG Pro WFM 中按位置对用户进行分组。 不支持其他用户分组类型。

  • 你已根据业务需求设置了相关请求，例如轮班请求和休假请求。

    重要

    班次当前支持以下 UKG Pro WFM 请求类型：

    • 打开排班请求。 不支持部分移位条件。
    • 交换请求。
    • 涵盖班次的请求。 不支持部分移位条件。
    • 休假请求。
    • 可用性模式更改请求子类型。

• 使用 Microsoft Entra ID 作为标识提供者。

先决条件

在使用 向导 或 PowerShell 创建连接之前，请确保收集以下信息并完成以下配置任务。

帐户

• 你是 Microsoft 365 全局管理员。

• 你知道你的 UKG Pro WFM 帐户用户名和密码，以及以下服务 URL：

  • API URL
  • 应用程序密钥
  • 客户端 ID
  • 客户端密码
  • 单一登录 (SSO) URL

  如果没有所有这些信息，请联系 UKG Pro WFM 支持。

  重要

  使用的 UKG Pro WFM 帐户必须具有访问配置文件，该配置文件允许对 UKG 中所有基于 API 的集成进行完全访问。

通过在 Microsoft Entra ID 和 UKG Pro Workforce Management 之间设置集成来启用 SSO

有关分步教程，请参阅 教程：Microsoft Entra SSO 与 Kronos Workforce Dimensions 集成。 如果需要有关设置 SSO 的帮助或详细信息，请联系 UKG Pro WFM 支持。

在 UKG Pro Workforce Management 中配置联合 SSO 身份验证

按照以下步骤在 UKG Pro WFM 环境中配置联合 SSO 身份验证。

步骤 1：将用户帐户更改为联合帐户

要连接到 UKG Pro WFM 的每个 Shifts 用户都需要 UKG Pro WFM 中的联合帐户。

1. 使用有权访问应用程序设置的管理员或超级用户帐户登录到 UKG Pro WFM。
2. 在左侧菜单中，转到 “维护>人员信息”。
3. 打开用户的配置文件。
4. 在 “员工 ”部分下，展开“ 信息”。
5. 将 “身份验证类型 ”更改为 “联合身份验证”。
6. 保存所做的更改，并为要连接到 UKG Pro WFM 的所有排班用户重复此过程。

步骤 2：允许排班 SSO 重定向 URL

配置连接器的重定向 URL。 这允许 UKG Pro WFM 将用户重定向到 Teams 中的排班应用，作为 SSO 流的一部分。

1. 使用有权访问应用程序设置的管理员或超级用户帐户登录到 UKG Pro WFM。
2. 在左侧菜单中，转到 “管理>应用程序设置”。
3. 然后，转到 “系统配置” ，然后选择 “系统设置”。
4. 选择“ 全局值”。
5. 在 global.oAuth.authCode.重定向.uris 字段中，输入值“https://aka.ms/shifts/connector/ukgdimensions/auth"”。
6. 在 global.oAuthToken.重定向.domain.whiteList 字段中，输入值“aka.ms”。
7. 选择“保存”。

在 Teams 中创建至少一个团队

在 Teams 中创建至少一个团队，并向其添加以下人员和帐户：

• 一线工作人员作为团队成员。

• 作为团队所有者和/或计划所有者的一线经理。 若要详细了解班次中的团队所有者和计划所有者，请参阅 使用角色在排班中定义一线经理和工作人员。

  注意

  将人员添加到团队时，请确保执行以下操作：

  • 根据他们的 UKG Pro WFM 位置，将一线员工添加到他们被允许工作的每个团队。
  • 将一线经理添加到他们拥有一线员工作为直接下属的每个团队。 否则，经理只会在 UKG Pro WFM 中收到工人的请求，而不会在排班中收到。

• 一个常规帐户，我们称之为 Microsoft 365 系统帐户，作为团队所有者。

  Microsoft 365 系统帐户是一个常规帐户，必须作为团队所有者添加到要映射的所有团队。 在 Microsoft 365 管理中心中创建此帐户 ，并为其分配Microsoft 365 许可证。 然后，将帐户添加为团队所有者。 从 UKG Pro WFM 同步排班更改时，排班连接器使用此帐户。 建议专门为此目的创建一个帐户，不要使用个人用户帐户。

有关创建一线团队的指导，请参阅 如何为组织找到最佳一线团队解决方案。 如果要创建多个团队，请参阅 大规模部署一线动态团队 和 大规模部署一线静态团队。

确保要映射的团队没有任何现有计划

如果团队具有在排班中创建的现有计划，请按照以下步骤从团队中删除计划实体，然后再将 UKG Pro WFM 位置 (也称为 WFM 实例) 映射到该团队。 否则，你将看到重复的班次。

使用 PowerShell 从团队中删除计划实体。

1. 安装 PowerShell 模块， (设置 PowerShell 环境 （如果尚未) ）。

2. 运行以下命令：

   Remove-CsTeamsShiftsScheduleRecord -TeamId <Teams team ID> -DateRangeStartDate <start time> -DateRangeEndDate <end time> -ClearSchedulingGroup:$false -EntityType <the scenario entities that you want to remove, the format is @(scenario1, scenario2, ...)> -DesignatedActorId <Teams team owner ID>
   

   若要获取 EntityType 参数的应用场景列表，请运行 Get-CsTeamsShiftsConnectionConnector。 将删除指定的日期和时间范围内的计划数据。

如需了解更多信息，请参阅 Remove-ClassificationRuleCollection。

了解 UKG Pro 劳动力管理组织结构如何影响团队和班次设置

如前所述，Shifts 支持在 UKG Pro WFM 中按位置对用户进行分组。 在 UKG Pro WFM 中，每个位置的节点表示组织结构图中的层次结构。 配置作业类型时，位置路径到达其终结点。

UKG Pro WFM 中的用户按位置中存在的作业进行分配和分组。 这意味着，从 Teams 和班次的角度来看，在作业类型之前具有相同位置路径到节点的员工将被视为同一团队的一部分。 位置路径中的作业类型将同步，并在排班中表示为 计划组 。

示例

以下示例可帮助你了解 UKG Pro WFM 结构如何影响你设置团队的方式、映射注意事项以及信息如何同步到排班。

应用场景

Contoso 在英国拥有数百家零售店。 每个商店都位于英国的一个区域内。 为了简化此示例，我们专注于伦敦中部地区的三家商店，Contoso 希望开始为一线员工推出 Teams 和班次。

假设：

• 每个商店都由不同的经理管理。
• 一些一线工人被允许从伦敦市中心地区的其他商店轮班。 换句话说，在 UKG Pro WFM 中，这些一线员工是作业转移集的一部分。

UKG Pro 劳动力管理位置结构

在此方案中，UKG Pro WFM 位置结构如下所示，其中“公司”节点表示层次结构中的最顶层。

下面介绍了一线经理 (FLM) 和一线员工 (FLW) 在 UKG Pro WFM 的位置结构中是如何设置的。 下表列出了每个辅助角色的主要工作以及他们向谁报告。

¹FLW1还可以在伦敦市中心/切尔西担任美容顾问。
^{阿拉伯数字}FLW5 还可以在伦敦市中心/考文特花园以及伦敦市中心/切尔西担任销售助理。

在 Teams 中设置团队时，这意味着什么？

在此方案中，IT 管理员在 Teams 中组织团队，如下所示。

1. 在 Teams 中为伦敦市中心区域的每家商店创建三个不同的团队：Soho Store、考文特花园商店、切尔西商店。

2. 将属于相应 UKG Pro WFM 位置的员工添加到每个团队，包括员工报告的经理。 一线工作人员作为团队成员添加，一线经理被添加为团队所有者和/或计划所有者。

   下面是添加到每个团队的团队和人员的列表。

   团队名称	团队成员	团队所有者和/或计划所有者
   Soho Store	FLW1、FLW2、FLW3、FLW4、FLW5、FLW6、FLW7、FLW8、FLW9、FLW10	FLM1
   考文特花园商店	FLW5、FLW11、FLW12、FLW13、FLW14	FLM2
   切尔西商店	FLW1、FLW5、FLW15、FLW16、FLW17	FLM3

   请记住，FLW1 和 FLW5 将添加到允许他们工作的商店位置的所有团队。 其他一线员工不允许在其他商店工作，只能添加到代表其主要工作位置的团队。

   注意

   在 UKG Pro WFM 中，如果你有具有业务位置的部门，请为每个部门创建团队 (，而不是为每个商店) 。 如本文前面所述，为了建立平台之间的映射，我们采用节点的位置路径，并将团队视为一个团队。

运行排班连接器向导时，这意味着什么？

当 IT 管理员在 向导中设置连接实例时，他们将每个存储位置映射到相关团队，如下表所示。

这在排班中是怎样的？

在排班中，每个团队的计划组表示为商店位置定义的作业。

在每个商店中，在“排班”中：

• 一线经理看到员工在其各自的计划组中 (即作业类型) 。
• 一线员工将看到自己的日程安排和团队的日程安排。
• 一线员工可以通过聊天与自己商店中的同事进行通信。
• 如果请求是在 UKG Pro WFM 中配置的，并且设置为在 向导中配置的连接实例设置中同步，则一线员工和经理可以请求休假、换班、提供排班和开班。
• 如果启用了基于班次的标记，一线员工和经理可以联系其商店中轮 班 的其他员工。

对于在多个商店工作的员工，请在班次中：

• 一线员工和经理只能在特定商店内提出请求。 班次当前不支持不同商店之间的工作人员请求。
• 一线员工可以在他们工作的任何商店中查看他们的日程安排和团队的日程安排。

相关文章

• 排班连接器
• 在 Teams 中管理排班应用