使用班次連接器精靈將 Shifts 連接至 Blue Yonder 勞動力管理

• 適用於:

  Microsoft Teams, Microsoft 365 for frontline workers

概觀

適用於 Blue Yonder 的 Microsoft Teams 班次連接器可讓您將 Microsoft Teams 中的班次應用程式與 Blue Yonder Workforce Management (Blue Yonder WFM) 整合。 您的一線員工可以在 Blue Yonder 中順暢地檢視和管理他們的排程，WFM從 Shifts 內進行。

在本文中，我們會逐步引導您在Microsoft 365 系統管理中心中執行 Shifts 連接器精靈，以將 Shifts 連線到 Blue Yonder WFM。

注意事項

如有需要，您可以使用 PowerShell 來整合 Shifts 與 Blue Yonder WFM。 若要深入了解，請參閱 使用 PowerShell 將 Shifts 連接至 Blue Yonder 勞動力管理。

精靈會建立與 Blue Yonder WFM系統和連線實例的連線。 連線實例會套用您選擇的同步處理設定和小組對應。

• 同步設定會決定排程資訊，以及藍 Yonder WFM與 Shifts 之間的哪些實體同步。
• 小組對應會定義 Blue Yonder WFM實例與 Teams 中小組之間的同步關聯性。

您可以建立一或多個連線實例，每個實例都有不同的同步設定。 例如，如果您的組織有多個位置具有不同的排程需求，請為每個位置建立具有唯一同步設定的連線實例。 Blue Yonder WFM實例應該只在任何指定時間對應到 Teams 中的小組一次。 不過，在精靈中，可能會有具有相同對應的不同連線實例。 這表示您可以建立具有重複對應的連接實例。

使用 Blue Yonder WFM作為記錄系統，您的第一線員工可以有效率地管理其裝置上 Shifts 中的排程和可用性。 前線經理可以繼續使用 Blue Yonder WFM 來設定排程。

本文中使用的詞彙

術語	定義
連線	連線可讓您存取在 Blue Yonder WFM 系統中建立的所有WFM實例。 若要建立連線，您可以提供 Blue Yonder WFM詳細資料，其中包括您的服務帳戶名稱、密碼和服務 URL。
連線實例	若要建立連線實例，您可以設定下列設定： 可決定 Blue Yonder WFM 與 Shifts 之間同步處理資訊的方式和排程資訊的同步設定 小組對應，以定義您在 Teams 中WFM實例和小組之間的關聯性。
WFM實例	此詞彙是指 Blue Yonder WFM系統中的網站。

必要條件

開始之前，請確定您符合下列所有必要條件。

• 您是 Microsoft 365 全域系統管理員。

• 您有 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 中收到持續性錯誤訊息的問題。 它也會修正會導致使用者無法在 Shifts 中更新其狀態的問題。

• 您知道您的 Blue Yonder WFM服務帳戶名稱、密碼和服務 URL：

  • 同盟驗證 URL
  • Cookie 驗證 URL
  • 員工自助服務 URL
  • 零售網路 API URL
  • 網站管理員 API URL
  • 系統管理 API URL

  如果您沒有這項資訊，請連絡 Blue Yonder 支援。 Blue Yonder 帳戶是由 Blue Yonder 企業系統管理員在根企業層級建立。 它必須具有 API 存取權、用戶端管理員、存放區管理員和背景工作角色存取權。 帳戶和密碼是建立連線的必要項目。

• 同盟 SSO 驗證已在您的 Blue Yonder WFM 環境中啟用。 請連絡 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 授權。 然後，將帳戶新增為您想要對應之所有小組的團隊擁有者。 Shifts 連接器會在同步處理來自 Blue Yonder WFM 的 Shifts 變更時使用此帳戶。 我們建議您特別為此目的建立帳戶，而不要使用您的個人使用者帳戶。

• 請確定您想要對應的小組在 Shifts 或 Blue Yonder WFM中沒有任何排程。 如果小組有現有的排程，請依照下一節中的步驟從小組移除排程實體，然後再將WFM實例對應至其中。 否則，您將看到重複的班次。

從您想要對應的小組移除排程實體

注意事項

如果您要將WFM實例對應至具有排程實體的現有小組，請完成此步驟。 如果您要與沒有任何排程的團隊進行比對，或如果您要建立要對應的新團隊，您可以略過此步驟。

使用 PowerShell 從小組移除排程實體。

1. 首先，您必須安裝 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-CsTeamsShiftsScheduleRecord。

執行 Shifts 連接器精靈

建立連線

1. 在Microsoft 365 系統管理中心的左側導覽中，選擇 [設定]，然後在 [精選集合] 底下，選取 [第一線工作者]。

2. 選 取 [連接器管理主控台]。

3. 若要建立新的連線，請選擇 [ 新增連線]。

4. 在 [選擇您的連接器] 窗格中，選擇[藍色 Yonder Workforce Management]，然後選取 [下一步] 以建立 Blue Yonder WFM連線。

5. 在 [連線設定] 窗格中，為您的連線指定唯一的名稱。 長度不能超過 100 個字元，或具有任何特殊字元。

6. 輸入您的 Blue Yonder WFM 服務帳戶名稱、密碼和服務 URL。 如果您不知道一或多個連線詳細資料，請連絡 Blue Yonder 支援。

7. 當您完成時，請選取 [ 儲存連線]。

注意事項

如果您需要建立另一個連線，請移至 [連接器管理主控台] 頁面，然後選取 [ 新增連線]。

建立連線實例

建立連線之後，您可以在該連線中設定一或多個連線實例。

您建立的連線會列在 [連接器管理主控台] 頁面上。 在您要建立新實例的連線底下，選取 [ 建立實例]。

選擇設定

在 [實例設定] 頁面上，您可以選擇要從 Blue Yonder WFM同步至 Shifts 的資訊、同步頻率，以及 Shifts 使用者是否可以變更資料。

1. 輸入連線實例的名稱。 長度不能超過 100 個字元，或具有任何特殊字元。

2. 輸入您的 Microsoft 365 系統帳戶。 這是 您建立為必要條件的帳戶 ，該帳戶是您想要對應之所有小組的小組擁有者。

3. 在[Email通知收件者] 底下，選擇接收此連線實例相關電子郵件通知的人員。 您可以新增個別使用者和群組。 電子郵件通知包含安裝狀態的相關資訊，以及在設定連線實例之後可能發生的任何問題或錯誤。

4. 選擇您的同步處理設定。
   針對這些設定，您有下列選項可供選擇：

   • 班次使用者不會看到提供者資料：Blue Yonder WFM 和 Shifts 之間的資料不會同步。
   • 班次使用者可以看到提供者資料：資料同步是從 Blue Yonder WFM到 Shifts 的單向。
   • 班次使用者可以看到並變更提供者資料：資料同步是 Blue Yonder WFM與 Shifts 之間的雙向。

   重要事項

   選取 [ 班次使用者不會看到提供者資料 ] 選項來停用功能之前，請注意：

   • 如果已停用 [ 排程]、[群組]、[輪班] 和 [活動 ] 設定，則也會停用所有其他設定，例如 [休假 ] 和 [員工可用性] 等。
   • 如果 [ 開啟班次 ] 設定已停用，也會停用 [開啟輪班要求 ]。
   • 如果停 用 [休假] 設定，也會停 用 [休假要求 ]。

5. 選擇您的同步頻率。

6. 當您完成選擇設定時，請選取 [ 下一步]。

   重要事項

   如果您選擇下列任一選項來停用待認領班次、待認領班次要求、調班要求或請假要求，您必須執行另一個步驟來隱藏 Shifts 中的功能。

   • 開啟輪班： 班次使用者不會看到提供者資料
   • 交換要求： 班次使用者不會看到提供者資料
   • 逾時要求： 班次使用者不會看到提供者資料

   執行此精靈之後，請確定您遵循本文稍後的停用待認領班次、待認領班次要求、換班要求和休假要求一節中的步驟。

將WFM實例對應至小組

選擇您想要連線到 Shifts 的WFM實例，然後將每個實例對應至 Teams 中的小組。 您最多可以對應 400 個實例。

若要完成此步驟，您可以：

• 手動對應WFM實例
• 使用 CSV 檔案對應WFM實例

手動將WFM實例對應至小組

1. 在 [對應] 頁面上，從選擇要對應至 Teams 中團隊的WFM實例開始。

2. 選取您想要對應之每個WFM實例的核取方塊。 只有在選取核取方塊時，才會對應實例。

3. 接下來，在 Teams 中搜尋並選擇正確的小組。 請記住，已對應到此連線實例中WFM實例的小組無法再次對應。

4. 選擇時區。 最接近的城市會自動填入，但您可以變更它。

5. 當您完成對應所有小組時，請選取 [ 下一步]。

使用 CSV 檔案將WFM實例對應至小組

1. 在 [對應] 頁面上，選擇 [CSV 上傳工具]。

2. 選取 [下載範本 ] 以取得 CSV 對應檔案。 此範本包含所有WFM實例及其識別碼的清單。 範本的頂端資料列看起來會像這樣：

   藍色 Yonder WFM實例識別碼	藍色 Yonder WFM實例名稱	團隊識別碼	小組名稱	時區
   自動預先填入	自動預先填入	空白	空白	預設*

   範本的底部資料列看起來會像這樣：

   藍色 Yonder WFM實例識別碼	藍色 Yonder WFM實例名稱	團隊識別碼	小組名稱	時區
   空白	空白	自動預先填入	自動預先填入	預設*

3. 選擇您想要對應至WFM實例的小組。 從範本的下半部剪下並貼上 [小組識別碼] 和 [小組名稱]，以符合您想要的WFM實例。 範本的已完成資料列看起來應該像這樣：

   藍色 Yonder WFM實例識別碼	藍色 Yonder WFM實例名稱	Team bottomID	小組名稱	時區
   自動預先填入	自動預先填入	您移動的小組識別碼	您移動的小組名稱	預設*

   針對所有對應重複此步驟。

4. 視需要在 [時區] 資料行中輸入正確的位置。

   注意事項

   精靈支援大約 460 個位置。 時區必須是 tz 格式。 如果不支援您選擇的特定位置，您會在精靈中看到錯誤。 請嘗試在同一個時區內使用最接近的城市或主要城市。

5. 在 [對應] 頁面上，選取 [ 流覽 ] 以尋找並上傳您已完成的 CSV 檔案。

6. 如果您的檔案已正確上傳，請選擇 [ 完成 ]。 否則，請檢閱錯誤報表並上傳更正的檔案。

7. 您的新對應會列在 [對應] 頁面上。

8. 選擇 [下一步]。

檢閱並完成

完成之前，請檢閱連接實例建立程式的摘要。 如果您需要在連線實例建立程式期間進行變更，請選擇 [上一步]。 當您準備好時，請選取 [完成]。

精靈會啟動設定連線實例的程式，這可能需要一些時間才能完成。 如果您在安裝完成之前嘗試編輯連線實例，您很可能無法檢視您先前建立的對應。

如果您選擇的電子郵件通知收件者會收到有關安裝狀態的電子郵件通知，以防發生任何錯誤。

選取 [完成] 以離開精靈。

停用待認領班次、待認領班次要求、調班要求和休假要求

重要事項

只有在您選擇下列任一選項以停用精靈中的待認領班次、待認領班次要求、調班要求或請假要求時，才執行下列步驟。 完成此步驟會在 Shifts 中隱藏該空缺。

• 待認領班次: Shifts 使用者不會看到 Blue Yonder WFM 資料
• 調班要求: 已停用所有使用者的功能
• 請假要求: 已停用所有使用者的功能

如果沒有這第二個步驟，使用者仍會看到 Shifts 中的空缺，並將遇到「不支援的作業」錯誤訊息 (如果他們嘗試使用它的話)。

若要在 Shifts 中隱藏待認領的班次、調班要求和休假要求，請使用 Graph API 排程資源類型，以針對對應至 Blue Yonder WFM 執行個體的每個團隊，將下列參數設定為false:

• 待認領班次: openShiftsEnabled
• 交換要求： swapShiftsRequestsEnabled
• 請假要求: timeOffRequestsEnabled

若要隱藏 Shifts 中的待認領班次要求，請前往 Shifts 中的 [設定]，然後關閉 [待認領班次] 設定。

管理您的連線和連線實例

設定連線之後，您可以在Microsoft 365 系統管理中心或使用 PowerShell 來管理和變更連線。

使用Microsoft 365 系統管理中心

[連接器管理主控台] 頁面會列出您已設定的每個連線和連線實例，以及健康情況狀態和同步間隔詳細資料等資訊。 您也可以存取精靈來建立新的連線和連線實例，並變更任何現有的連線和連線實例。 例如，您可以更新同步處理設定和小組對應。

若要深入瞭解，請參閱使用Microsoft 365 系統管理中心來管理與 Blue Yonder Workforce Management的 Shifts 連線。

使用 PowerShell

您可以使用 PowerShell 來檢視錯誤報表、變更連線設定、停用同步處理等等。 如需逐步指引，請參閱 使用 PowerShell 管理 Shifts 與 Blue Yonder 勞動力管理的連線。

相關文章

• 班次連接器
• 在 Teams 中管理 Shifts 應用程式