Shifts コネクタ ウィザードを使用して Shifts を Blue Yonder Workforce Managementに接続する

  • [アーティクル]
  • 適用対象:
    Microsoft Teams

概要

Microsoft 365 管理センターの Shifts コネクタ ウィザードを使用すると、Microsoft Teams の Shifts アプリを従業員管理 (WFM) システムと統合できます。 接続を設定すると、フロントライン ワーカーは、Shifts 内からWFM システムでスケジュールをシームレスに表示および管理できます。

ウィザードによって Shifts コネクタが構成され、WFM システムへの接続が作成され、選択した同期設定とチーム マッピングが適用されます。 同期設定は、WFM システムと Shifts の間で同期されるスケジュール情報を決定します。 チーム マッピングは、WFM インスタンスと Teams 内のチーム間の同期関係を定義します。 既存のチームと新しいチームにマップできます。

複数の接続を設定できます。それぞれ異なる同期設定を使用します。 たとえば、組織に異なるスケジュール要件を持つ複数の場所がある場合は、場所ごとに一意の同期設定を持つ接続を作成します。 WFM インスタンスは、特定の時点で 1 つのチームにのみマップできることに注意してください。 WFM インスタンスが既にチームにマップされている場合、別のチームにマップすることはできません。

WFM システムをレコードのシステムとして使用すると、フロントライン ワーカーはシフトの表示とスワップ、可用性の管理、デバイスの Shifts での休暇の要求を行うことができます。 フロントライン マネージャーは、引き続きWFM システムを使用してスケジュールを設定できます。

Shifts と Blue Yonder Workforce Managementを統合する

現在、ウィザードは Blue Yonder 用の Microsoft Teams Shifts コネクタをサポートしています。 このコネクタを使用すると、Shifts と Blue Yonder Workforce Management (Blue Yonder WFM) を統合してスケジュールを管理し、最新の状態に保つことができます。 この記事では、ウィザードを実行してコネクタ経由で Blue Yonder WFMへの接続を設定する方法について説明します。

注意

PowerShell を使用して、Shifts と Blue Yonder WFMを統合することもできます。 詳細については、「PowerShell を使用して Shifts を Blue Yonder Workforce Managementに接続する」を参照してください。

はじめに

ウィザードを実行するには、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
    • Retail web API URL
    • サイト マネージャー API URL
    • 管理 API URL

    この情報がない場合は、Blue Yonder サポートにお問い合わせください。 このアカウントは、Blue Yonder エンタープライズ管理者によってルートエンタープライズ レベルで作成されます。 API Access、クライアント管理者、および Store Manager アクセス権が必要です。 接続を作成するには、アカウントとパスワードが必要です。

  • フェデレーション SSO 認証は、Blue Yonder WFM 環境で有効になっています。 フェデレーション SSO が有効になっていることを確認するには、Blue Yonder サポートにお問い合わせください。 次の情報が必要になります。

    • federatedSSOValidationService: https://wfmconnector.teams.microsoft.com/api/v1/fedauth/{tenantId}/6A51B888-FF44-4FEA-82E1-839401E9CD74/authorize {tenantId} が tenantId である場合
    • proxyHeader: X-MS-AuthToken

  • Teamsに少なくとも 1 つのチームが設定されています。

  • マップするすべてのチームに、Microsoft 365 システム アカウントをチーム所有者として追加しました。
    Microsoft 365でこのアカウントを作成し、Microsoft 365 ライセンスを割り当てます。 次に、マップするすべてのチームにチーム所有者としてアカウントを追加します。 Shifts コネクタは、Blue Yonder WFM から Shifts の変更を同期するときに、このアカウントを使用します。

    この目的のために特別にアカウントを作成し、ユーザー アカウントを使用しないことをお勧めします。

  • マップするチームにはスケジュールがありません。 チームに既存のスケジュールがある場合は、Blue Yonder WFM インスタンスをチームにマップする前に、チームからスケジュールを削除します。 それ以外の場合は、重複するシフトが表示されます。

マップするチームからスケジュールを削除する

注意

Blue Yonder 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-CsTeamsShiftsConnectionConnectionConnector を実行します。 指定した日付と時刻の範囲のスケジュール データが削除されます。

詳細については、「 Remove-CsTeamsShiftsScheduleRecord」を参照してください。

ウィザードを実行する

はじめに

  1. Microsoft 365 管理センターの左側のナビゲーションで、[セットアップ] を選択し、[アプリと電子メール] セクションに移動します。
  2. [ 従業員管理システムの接続] を選択します。 ここでは、Shifts コネクタと、Shifts をWFM システムに接続するときの現場のワーカーとマネージャーのエクスペリエンスについて詳しく説明します。 Microsoft 365 管理センターの Shifts コネクタ ウィザードの詳細ページのスクリーンショット。
  3. 準備ができたら、[ 作業の開始] を選択します。
  4. [次へ] を選択して Blue Yonder WFM接続を作成します。

接続の詳細を入力する

  1. [接続の詳細] ページで、接続に一意の名前を付けます。 128 文字を超えたり、特殊文字を含めたりすることはできません。 接続設定を示すウィザードの [接続の詳細] ページのスクリーンショット。
  2. Blue Yonder WFMサービス アカウント名とパスワードとサービス URL を入力します。
  3. 完了したら、[ 次へ ] を選択して、入力した設定で接続をテストします。

同期設定を選択する

[同期設定] ページで、Blue Yonder WFMから Shifts に同期する情報、同期頻度、および Shifts ユーザーがデータを変更できるかどうかを選択します。

  1. Microsoft 365 システム アカウントを入力します。 同期設定を示すウィザードの [同期設定] ページのスクリーンショット。

  2. [ 電子メール通知の受信者] で、この接続に関する電子メール通知を受け取るユーザーを選択します。 個々のユーザーとグループを追加できます。 電子メール通知には、接続のセットアップ状態と、接続のセットアップ後に発生する可能性がある問題やエラーに関する情報が含まれています。

  3. 同期設定を選択します。

    1. [スケジュールとシフト] で、Shifts ユーザーが表示または変更できる Blue Yonder WFM データを選択し、同期頻度を設定します。
    2. [ 要求] で、Shifts ユーザーが表示および作成できる要求の種類を選択します。

    重要

    オープン シフト、オープン シフト要求、スワップ要求、または休暇要求を無効にする次のいずれかのオプションを選択した場合は、Shifts で機能を非表示にするには、別の手順を実行する必要があります。

    • シフトを開く: Shifts ユーザーに Blue Yonder WFMデータが表示されない
    • スワップ要求: すべてのユーザーに対して機能が無効になっている
    • 休暇要求: すべてのユーザーに対して機能が無効になっている

    ウィザードを実行した後は、この記事の後半の「 オープン シフトを無効にする、シフト要求を開く、要求をスワップする、および休暇要求を無効にする 」セクションの手順に従っていることを確認します。

  4. 設定の選択が完了したら、[ 接続の作成] を選択します。

Blue Yonder Workforce Management インスタンスをチームにマップする

Shifts に接続する Blue Yonder WFM インスタンスを選択し、Teams のチームに各インスタンスをマップします。 最大 100 個のインスタンスをマップできます。 これを行うには、次の 2 つの方法があります。

インスタンスをチームに手動でマップする

マップするインスタンスを選択します。

Blue Yonder WFM インスタンスの一覧を示すウィザードのスクリーンショット。 次に、各インスタンスを Teams のチームにマップします。 インスタンスを既存のチームにマップすることも、新しいチームを作成することもできます。 検索チーム オプションと新しいチーム オプションの作成を示すウィンドウのスクリーンショット。

インスタンスを既存のチームにマップするには
  1. インスタンス名を選択します。
  2. ウィンドウでチームを検索し、それを選択します。 この接続内のインスタンスに既にマップされているチームは、検索に表示されないことに注意してください。
  3. タイム ゾーンと最も近い都市を選択します。
  4. [保存] を 選択し、[次へ] を選択します。
インスタンスを新しいチームにマップするには
  1. インスタンス名を選択します。
  2. ウィンドウで、[ 新しいチームの作成] を選択します。 ブラウザーの新しいタブに移動し、Microsoft 365 管理センターで新しいチームを作成できます。
    1. チームの名前とオプションの説明を入力します。
    2. 1 つ以上のチーム所有者を追加します。 Microsoft 365 システム アカウントを所有者として追加してください。
    3. チーム メンバーを追加します。
    4. チームのメール アドレスを追加し、プライバシー設定を選択します。
    5. 設定を確認し、[チームの 追加] を選択します。 チームが作成されたら、[ 閉じる] を選択します。
  3. ウィザードに戻るし、作成した新しいチームを検索して選択します。
  4. タイム ゾーンと最も近い都市を選択します。
  5. [保存] を 選択し、[次へ] を選択します。

CSV ファイルを使用してインスタンスをチームにマップする

  1. [一括モードに切り替える] を選択します。

  2. テンプレート ファイルをダウンロード して、マッピングの定義に使用できるマッピング テンプレートをダウンロードします。

    ウィザードの [マッピング ファイルのアップロード] ページのスクリーンショット。

  3. テンプレートを使用してマッピング ファイルを作成します。 最初の列から始まる次の順序で、これらの列が含まれます。 アスタリスク (*) は、必要な列を示します。

    列名 説明
    Blue Yonder インスタンス ID* Blue Yonder WFMインスタンス ID。
    Blue Yonder インスタンス名 Blue Yonder WFMインスタンス名。
    チーム ID* チーム ID。
    チーム名 チーム名。
    タイム ゾーン* tz データベース形式のタイム ゾーン。 たとえば、ヨーロッパ/ロンドンなどです。

    注意

    必要な列 (Blue Yonder インスタンス ID、チーム ID、タイム ゾーン) に入力するだけで、インスタンスをチームにマップできます。

    マッピング ファイルの例を次に示します。

    Blue Yonder インスタンス ID Blue Yonder インスタンス名 チーム ID チーム名 タイム ゾーン
    2111 Contoso 米国チーム 3a4d78a-2261 米国チーム アメリカ/Los_Angeles
    3212 Contoso UK チーム 2d1f6c2e-5272 UK チーム ヨーロッパ/ロンドン
    4865 bfa6o89e-1328 アメリカ/トロント

  4. マッピング ファイルを作成したら、[ 参照 ] を選択してアップロードします。 ウィザードによってファイルが検証されます。 エラーが見つかると、エラーの一覧と、エラーの修正を要求するメッセージが表示されます。 それ以外の場合は、次の手順に進むメッセージが表示されます。

  5. [次へ] を選択します。

確認と完了

設定を確認します。 チーム マッピングに変更を加える必要がある場合は、[ 編集] を選択して変更します。 準備ができたら、[完了] を選択 します。

マッピングを示すウィザードの [確認] ページのスクリーンショット。

要求を受信したことを確認するメッセージと操作 ID が表示されます。 操作 ID をメモしておきます。 接続のセットアップ状態を確認する必要があります。

確認メッセージと操作 ID を示すウィザード ページのスクリーンショット。

ウィザードによってプロセスが開始され、接続が設定され、選択したチームにインスタンスがマップされます。 このプロセスの完了には時間がかかる場合があります。 選択した受信者には、セットアップの状態に関する電子メール通知が送信されます。

[完了] を 選択してウィザードを終了します。

あなたは途中ですが、まだ完了していません。 メールを必ず確認してください。 要求を受け取ったという確認と、セットアップの状態を確認する方法への リンク が表示されます。

注意

セットアップ後に接続で問題またはエラーが発生した場合は、電子メールで通知を受け取ります。 電子メールの指示に従って、問題のトラブルシューティングを行います。

オープン シフト、オープン シフト要求、スワップ要求、および休暇要求を無効にする

重要

次のいずれかのオプションを選択して、開いているシフト、シフト要求を開く、要求をスワップする、またはウィザードで休暇要求を無効にする場合にのみ、次の手順に従います。 この手順を完了すると、Shifts で機能が非表示になります。

  • シフトを開く: Shifts ユーザーに Blue Yonder WFMデータが表示されない
  • スワップ要求: すべてのユーザーに対して機能が無効になっている
  • 休暇要求: すべてのユーザーに対して機能が無効になっている

この 2 番目の手順を実行しないと、Shifts で機能が表示され、使用しようとすると"サポートされていない操作" というエラー メッセージが表示されます。

Shifts でオープン シフト、スワップ要求、および休暇要求を非表示にするには、リソースの種類をスケジュールGraph API使用して、Blue Yonder WFM インスタンスにマップした各チームに対してfalse次のパラメーターを設定します。

  • 開いているシフト: openShiftsEnabled
  • スワップ要求: swapShiftsRequestsEnabled
  • 休暇要求: timeOffRequestsEnabled

Shifts で開いているシフト要求を非表示にするには、Shifts の [設定] に移動し、[シフトを 開く ] 設定をオフにします。

接続に変更を加える必要がある場合

接続が設定されたら、PowerShell を使用して変更を加えます。 たとえば、同期設定、チーム マッピングを更新し、接続の同期を無効にすることができます。 詳細なガイダンスについては、「PowerShell を使用して Blue Yonder Workforce Managementへの Shifts 接続を管理する」を参照してください。