使用 PowerShell 将排班连接到 Blue Yonder Workforce Management

项目
10/18/2023
适用于:

Microsoft Teams, Microsoft 365 for frontline workers

概述

使用适用于 Blue Yonder 的 Microsoft Teams 排班连接器将 Microsoft Teams 中的排班应用与 Blue Yonder Workforce Management (Blue Yonder WFM) 集成。一线员工可以在 Blue Yonder WFM中从排班中无缝查看和管理他们的日程安排。

本文介绍如何使用 PowerShell 设置和配置连接器，以将排班与 Blue Yonder WFM 集成。

若要设置连接，请运行 PowerShell 脚本。此脚会本配置连接器，应用同步设置，创建连接，并将 Blue Yonder WFM 实例映射到团队。同步设置将确定在排班中启用的功能以及 Blue Yonder WFM 和排班之间同步的计划信息。映射定义了 Blue Yonder WFM 实例与 Teams 中的团队之间的同步关系。可以映射到现有团队和新团队。

我们提供两个脚本。可以使用任一脚本，具体取决于是要映射到现有团队还是创建要映射到的新团队。

可以设置多个连接，每个连接具有不同的同步设置。例如，如果你的组织具有多个具有不同计划要求的位置，请为每个位置创建具有唯一同步设置的连接。请记住，Blue Yonder WFM 实例只能在任何给定时间映射到一个团队。如果实例已映射到团队，则无法将其映射到另一个团队。

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

注意

还可以在 Microsoft 365 管理中心中使用排班连接器向导将排班连接到 Blue Yonder WFM。

开始之前

先决条件

在开始之前，请确保满足以下所有先决条件：

你有 Blue Yonder WFM版本 2020.3、2021.1 或 2021.2。

注意

如果有 Blue Yonder WFM 2020.3 或 2021.1，请应用 2020.3.0.4 或 2021.1.0.3 修补程序。此修补程序修复了用户在 Shifts 中收到持久性错误消息的问题。它还修复了用户在排班中无法更新空闲状态的问题。
你知道 Blue Yonder WFM服务帐户名称、密码和服务 URL：
- 联合身份验证 URL
- Cookie 身份验证 URL
- 员工自助服务 URL
- 零售 Web API URL
- 网站管理器 API URL
- 管理 API URL
如果没有所有这些信息，请联系 Blue Yonder 支持。 Blue Yonder 帐户由 Blue Yonder 企业管理员在根企业级别创建。它必须具有 API 访问权限、客户端管理员、应用商店管理器和辅助角色访问权限。创建连接需要帐户和密码。
已在 Blue Yonder WFM 环境中启用联合 SSO 身份验证。请联系 Blue Yonder 支持部门，确保已启用联合 SSO。他们将需要以下信息：
- federatedSSOValidationService： https://wfmconnector.teams.microsoft.com/api/v1/fedauth/{tenantId}/6A51B888-FF44-4FEA-82E1-839401E9CD74/authorize 其中 {tenantId} 是 tenantId
- proxyHeader：X-MS-AuthToken
Teams 中至少设置了一个团队。
你添加了一个常规帐户，我们称之为 Microsoft 365 系统帐户，作为要映射的所有团队的团队所有者。

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

使用 PowerShell 管理连接器的管理员角色

你必须是 Microsoft 365 全局管理员或排班连接器管理员才能完成本文中的步骤。

Shifts 连接器管理员角色是在 Microsoft Entra ID 中创建并分配给用户的自定义角色。角色的名称必须是“Shifts 连接器管理员”。角色不需要具有任何特定权限，不过，创建该角色时必须至少设置一个权限。该服务依赖于用户上角色的存在，而不是其权限。

若要了解详细信息，请参阅在Microsoft Entra ID 中创建和分配自定义角色和向用户分配Microsoft Entra角色。请记住，创建角色并将其应用到用户最多可能需要 24 小时。

设置环境

安装 Powershell 版本 7 或更新。有关分步指南，请参阅在 Windows 上安装 PowerShell。
以管理员模式运行 Powershell。

安装 Microsoft Graph PowerShell 模块。

Install-Module Microsoft.Graph
Import-Module Microsoft.Graph

验证其版本是否为 1.6.1 或更高版本。

Get-InstalledModule Microsoft.Graph

安装 Teams 预览版 PowerShell 模块。

Install-Module -Name MicrosoftTeams -AllowPrerelease -Force
Import-Module MicrosoftTeams

验证它是否至少为版本 4.7.0 并包含 Shifts 连接器 cmdlet。

Get-Command -Module MicrosoftTeams -Name *teamsshiftsconnection*

将 PowerShell 设置为在运行脚本时出错时退出。
```
$ErrorActionPreference = "Stop" 
```
启用脚本以在 Windows 中运行。
```
Set-ExecutionPolicy bypass 
```

连接到 Teams

运行以下命令以连接到 Teams。

Connect-MicrosoftTeams

出现提示时，请使用管理员凭据登录。现在你已设置完成，可以运行本文中的脚本和排班连接器 cmdlet 了。

确定要映射的团队

注意

如果要将 Blue Yonder WFM 实例映射到现有团队，请完成此步骤。如果要创建要映射到的新团队，则可以跳过此步骤。

在 Azure 门户中，转到所有组页面，获取组织中团队的 TeamId 列表。

记下要映射的团队的 TeamId。此脚本将提示你输入此信息。

注意

如果一个或多个团队具有现有计划，则脚本将从这些团队中删除计划。否则，你将看到重复的班次。

运行脚本

运行以下脚本之一，具体取决于是要创建新团队还是映射到现有团队：

若要设置连接，在 Teams 中创建新团队，并将 Blue Yonder WFM 实例映射到新团队，请运行新团队脚本。
若要设置连接并将 Blue Yonder WFM 实例映射到 Teams 中的现有团队，请运行现有团队脚本。

运行脚本时，请按照屏幕上的说明进行操作。该脚本完成以下操作：

使用输入的 Blue Yonder WFM 服务帐户凭据和服务 URL 测试并验证与 Blue Yonder WFM 的连接。
应用同步设置。这些设置包括同步频率 (（以分钟为单位）) ，以及 Blue Yonder WFM 和 Shifts 之间同步的计划数据。可以启用由以下方案定义的计划数据：Shift、、SwapRequest、UserShiftPreferencesOpenShift、OpenShiftRequest、TimeOff、。 TimeOffRequest

若要了解详细信息，请参阅 New-CsTeamsShiftsConnectionInstance。若要查看每个参数支持的同步选项列表，请运行 Get-CsTeamsShiftsConnectionConnector。

注意

该脚本为每个支持的同步选项启用同步。如果要更改同步设置，可以在设置连接后执行此操作。若要了解详细信息，请参阅使用 PowerShell 管理与 Blue Yonder Workforce Management 的排班连接。
将 Blue Yonder WFM实例映射到 Teams 中的团队。
- 如果选择运行新团队脚本来创建新团队，则映射将基于你创建的新团队。
- 如果选择运行现有团队脚本来映射现有团队，则映射将基于输入的 Blue Yonder 实例 ID 和 TeamId。如果团队具有现有计划，则脚本会删除所有计划数据。

运行脚本后， “成功” 消息确认连接是否已成功设置。

管理连接

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

使用Microsoft 365 管理中心

“连接器管理”页列出了你设置的每个连接，以及运行状况和同步间隔详细信息等信息。还可以访问向导来更改任何连接。例如，可以更新同步设置和团队映射。

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