使用排班连接器向导将排班连接到 UKG Pro Workforce Management

• 适用于:

  Microsoft Teams, Microsoft 365 for frontline workers

概述

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

本文介绍如何使用Microsoft 365 管理中心中的排班连接器向导将排班连接到 UKG Pro WFM。

注意

如果需要，可以使用 PowerShell 将 Shifts 与 UKG Pro WFM 集成。 若要了解详细信息，请参阅使用 PowerShell 将班次连接到 UKG Pro Workforce Management。

该向导创建与 UKG Pro WFM 系统和连接实例的连接。 连接实例应用所选的同步设置和团队映射。

• 同步设置确定计划信息以及 UKG Pro WFM 和 排班之间同步的实体。
• 团队映射定义 UKG Pro WFM 实例 (也称为WFM实例) 和 Teams 中的团队之间的同步关系。

可以创建一个或多个连接实例，每个实例具有不同的同步设置。 例如，如果组织的多个位置具有不同的计划要求，请为每个位置创建具有唯一同步设置的连接实例。 在任何给定时间，WFM实例只能映射到 Teams 中的团队一次。 但是，在向导中，可以具有具有相同映射的不同连接实例。 这意味着可以创建具有重复映射的连接实例。

将 UKG Pro WFM 作为记录系统，一线员工可以有效地管理其设备上的排班计划和可用性。 一线经理可以继续使用 UKG Pro WFM来设置计划。

注意

UKG Pro Workforce Management以前称为 UKG 维度。 你可能会在向导中看到对 UKG 维度的引用。

本文中使用的术语

Term	定义
Connection	使用连接可以访问在 UKG Pro WFM 系统中创建的所有WFM实例。 若要创建连接，请提供 UKG Pro WFM详细信息，其中包括帐户用户名、密码和服务 URL。
连接实例	若要创建连接实例，请配置以下设置： 确定 UKG Pro WFM和排班之间同步的方式和计划信息的同步设置 团队映射，用于定义WFM实例与 Teams 中的团队之间的关系
WFM 实例	此术语是指 UKG Pro WFM 系统中的团队，这与 Teams 中的团队不同。

先决条件

运行向导之前，请花点时间查看适用于 UKG Pro Workforce Management的 Teams 排班连接器的先决条件和要求中的信息并完成所有先决条件和配置任务。

在按照本文中的步骤操作之前，请确保完成所有任务。

运行 Shifts 连接器向导

确认满足所有先决条件后，即可运行向导并将 UKG Pro WFM系统连接到 Teams 中的排班。

创建连接

1. 在Microsoft 365 管理中心的左侧导航菜单中，选择“设置”，然后在“特色集合”下，选择“一线工作人员”。

2. 选择“ 连接器管理控制台”。

3. 若要创建新连接，请选择 “添加连接”。

4. 在“选择连接器”窗格中，选择“UKG 维度”，然后选择“下一步”以创建 UKG Pro WFM 连接。

5. 在“连接设置”窗格中，为连接指定唯一名称。 它不能超过 100 个字符，也不能包含任何特殊字符。

   

6. 输入 UKG Pro WFM信息，然后选择“保存连接”。

   • 帐户用户名
   • 帐户密码
   • API URL
   • 应用程序密钥
   • 客户端 ID
   • 客户端密码
   • SSO URL

   使用用户名登录可以访问在 UKG Pro WFM 中创建的所有实例。 如果不知道一个或多个连接详细信息，请联系 UKG Pro WFM支持。

   注意

   • 检查 SSO URL 的结构是否与此示例 URL 类似，
     https://contoso-sso.mykronos.com.
   • 然后，在 URL 的末尾添加此额外文本， (.com) 之后， (示例客户端 ID XDV45GTaaaaab43342XA) ，
     https://contoso-sso.mykronos.com/oauth2/authorize?client_id=XDV45GTaaaaab43342XA.

若要创建另一个连接，请转到“连接器管理控制台”页，然后选择“ 添加连接”。

创建连接实例

创建连接后，可以在该连接中设置一个或多个连接实例。

创建的连接在“连接器管理控制台”页上列出。 在要在其中创建新实例的连接下，选择“ 创建实例”。

选择设置

在“实例设置”页上，选择要从 UKG Pro WFM同步到排班的信息、同步频率以及排班用户是否可以对数据进行更改。

1. 输入连接实例的名称。 它不能超过 100 个字符，也不能包含任何特殊字符。

2. 输入 Microsoft 365 系统帐户。 这是 作为先决条件创建的帐户 ，该帐户是要映射的所有团队的团队所有者。

3. 在“Email通知收件人”下，选择接收有关此连接实例电子邮件通知的人员。 可以向这些组中添加单个用户，也可以添加安全组。 电子邮件通知包含有关设置状态的信息，以及设置连接实例后可能发生的任何问题或错误。

4. 选择同步设置。
   对于每个设置，有以下选项可供选择：

   • 排班用户将看不到提供程序数据：数据不会在 UKG Pro WFM 和排班之间同步。
   • 排班用户可以查看提供程序数据：数据同步是单向的，从 UKG Pro WFM到排班。
   • 排班用户可以查看和更改提供程序数据：数据同步在 UKG Pro WFM 和排班之间是双向的。

   重要

   在通过选择“ 排班用户将看不到提供程序数据 ”选项来禁用某个功能之前，请注意：

   • 如果禁用“ 计划、组、班次和活动 ”设置，则所有其他设置（如 休假 和 员工可用性等）也会被禁用。
   • 如果“ 打开班次 ”设置处于禁用状态，则 也会禁用“打开班次请求 ”。
   • 如果禁用 “休假 ”设置，则也会禁用 休假请求 。

5. 选择同步频率。

6. 选择完设置后，选择“ 下一步”。

   重要

   如果选择以下任一选项来禁用开班、打开排班请求、交换请求、提供班次请求或休假请求，则需要执行另一个步骤来隐藏班次中的功能。

   • 打开班次： 排班用户将看不到提供程序数据
   • 交换请求： 排班用户将看不到提供程序数据
   • 休假请求： 排班用户将看不到提供程序数据
   • 提供班次请求： 排班用户将看不到提供程序数据

   运行向导后，请确保按照本文后面的“禁用未分配班次、未分配班次请求、换班请求，以及休假请求”部分中的步骤进行操作。

将WFM实例映射到团队

选择要连接到排班的WFM实例，然后将每个实例映射到 Teams 中的团队。 最多可以映射 400 个实例。

若要完成此步骤，可以：

• 手动映射WFM实例
• 使用 CSV 文件映射WFM实例

手动将WFM实例映射到团队

1. 在“映射”页上，首先选择要映射到 Teams 中的团队的WFM实例。

2. 选中要映射的每个WFM实例的复选框。 仅当选择了“检查”框时，才会映射实例。

3. 接下来，在 Teams 中搜索并选择正确的团队。

   请记住，已映射到此连接实例中的 WFM 实例的团队不再可供映射。

4. 选择时区。 最近的城市会自动填充，但你可以更改它。

5. 映射完所有团队后，选择“ 下一步”。

使用 CSV 文件将WFM实例映射到团队

1. 在“映射”页上，选择 “CSV 上传工具”。

2. 选择“ 下载模板 ”以获取 CSV 映射文件。 该模板包括所有WFM实例及其 ID 的列表。 模板的顶部行如下所示：

   UKG 维度实例 ID	UKG 维度实例名称	团队 ID	工作组名称	时区
   自动预填充	自动预填充	空白	空白	默认*

   模板的底部行将如下所示：

   UKG 维度实例 ID	UKG 维度实例名称	团队 ID	工作组名称	时区
   空白	空白	自动预填充	自动预填充	默认*

3. 选择要映射到WFM实例的团队。 从模板的下半部分剪切并粘贴团队 ID 和团队名称，以符合所需的WFM实例。 模板的已完成行应如下所示：

   UKG 维度实例 ID	UKG 维度实例名称	团队 ID	工作组名称	时区
   自动预填充	自动预填充	移动的团队 ID	移动的团队名称	默认*

   对所有映射重复此步骤。

4. 如果需要，请在 “时区 ”列中输入正确的位置。

   注意

   向导支持大约 460 个位置。 时区必须采用 tz 格式。 如果所选的特定位置不受支持，则向导中会显示错误。 尝试在同一时区内使用最近的城市或主要城市。

5. 在“映射”页上，选择“ 浏览 ”以查找并上传已完成的 CSV 文件。

6. 如果文件正确上传，请选择 “完成 ”。 否则，请查看错误报告并上传更正的文件。

7. 新映射在“映射”页上列出。 选择“下一步”。

审阅并完成

在完成之前，请查看连接实例创建过程的摘要。 如果需要在连接实例创建过程中进行更改，请选择“ 后退”。 完成更改后，选择“完成”。

向导启动设置连接实例的过程，这可能需要一些时间才能完成。 如果在安装完成之前尝试编辑连接实例，则很可能无法查看之前创建的映射。

如果出现任何错误，所选电子邮件通知收件人将收到有关设置状态电子邮件通知。

禁用打开排班、打开排班请求、交换请求和休假请求

重要

如果选择以下任一选项来禁用开班、打开排班请求、交换请求、提供班次请求或休假请求，则需要执行另一个步骤来隐藏班次中的功能。

• 打开班次： 排班用户将看不到提供程序数据
• 交换请求： 排班用户将看不到提供程序数据
• 休假请求： 排班用户将看不到提供程序数据
• 提供班次请求： 排班用户将看不到提供程序数据

编辑设置后，请确保按照禁用开班、打开排班请求、交换请求和休假请求的步骤进行操作。

若要隐藏排班、交换请求和休假请求，请使用图形 API计划资源类型为映射到 WFM 实例的每个团队设置以下参数false：

• 打开排班：openShiftsEnabled
• 交换请求： swapShiftsRequestsEnabled
• 休假请求： timeOffRequestsEnabled
• 产品/服务班次请求： offerShiftRequestsEnabled

若要在排班中隐藏打开排班请求，请转到 排班中的“设置”，然后关闭“打开排班”设置。

管理连接和连接实例

设置连接后，可以在Microsoft 365 管理中心或使用 PowerShell 对其进行管理和更改。

使用Microsoft 365 管理中心

连接器管理控制台页面列出了你设置的每个连接和连接实例，以及运行状况状态和同步间隔详细信息等信息。 还可以访问向导以创建新的连接和连接实例，并更改任何现有连接和连接实例。 例如，可以更新同步设置和团队映射。

若要了解详细信息，请参阅使用Microsoft 365 管理中心管理与 UKG Pro Workforce Management的排班连接。

使用 PowerShell

可以使用 PowerShell 查看错误报告、更改连接设置、禁用同步等。 有关分步指南，请参阅使用 PowerShell 管理与 UKG Pro Workforce Management的排班连接。

相关文章

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