共用方式為

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

  • 發行項
  • 適用於:
    Microsoft Teams, Microsoft 365 for frontline workers

概觀

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

在本文中，我們會逐步引導您在 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 實例。 若要建立連線，您可以提供藍色 Yonder WFM 詳細數據，其中包括您的服務帳戶名稱、密碼和服務 URL。
線上實例 若要建立連線實例，您可以設定下列設定：
  • 同步處理設定，決定 Blue Yonder WFM 與 Shifts 之間同步處理資訊的方式和排程
  • 小組對應，以定義WFM實例與Teams中小組之間的關聯性。
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. 選 取 [連接器管理控制台]。 Microsoft 365 系統管理中心中班次連接器精靈的詳細資料頁面螢幕擷取畫面。

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

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

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

  6. 輸入您的 Blue Yonder WFM 服務帳戶名稱、密碼和服務 URL。 如果您不知道一或多個連線詳細數據，請連絡 Blue Yonder 支援。 精靈中顯示連線設定之連線詳細資料頁面的螢幕擷取畫面。

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

注意事項

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

建立連線實例

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

您建立的聯機會列在 [連接器管理控制台] 頁面上。 在您要建立新實例的連線底下，選取 [ 建立實例]。 連接器管理主控台的螢幕快照，其中顯示建立新實例的按鈕。

選擇設定

在 [實例設定] 頁面上，您可以選擇要從 Blue Yonder WFM 同步至 Shifts 的資訊、同步頻率，以及 Shifts 使用者是否可以變更數據。 顯示同步處理設定的精靈 [同步設定] 頁面的螢幕擷取畫面。

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

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

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

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

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

    重要事項

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

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

  3. 選擇您的同步頻率。

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

    重要事項

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

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

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

將 WFM 實例對應至小組

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

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

手動將 WFM 實例對應至小組

精靈的螢幕快照，其中顯示藍色 Yonder 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 勞動力管理的連線。