Shifts コネクタ ウィザードを使用して Shifts を UKG Pro Workforce Managementに接続する
概要
UKG Pro Workforce Management用の Microsoft Teams Shifts コネクタを使用すると、Microsoft Teams の Shifts アプリを UKG Pro Workforce Management (UKG Pro WFM) システムと統合できます。 現場担当者は、シフト内から UKG Pro WFMでスケジュールをシームレスに表示および管理できます。
この記事では、Microsoft 365 管理センターの Shifts コネクタ ウィザードを使用して、Shifts を UKG Pro WFMに接続する方法について説明します。
注:
必要に応じて、PowerShell を使用して Shifts と UKG Pro WFMを統合できます。 詳細については、「PowerShell を使用して Shifts を UKG Pro Workforce Managementに接続する」を参照してください。
ウィザードによって、UKG Pro WFM システムと接続インスタンスへの接続が作成されます。 接続インスタンスは、選択した同期設定とチーム マッピングを適用します。
- 同期設定により、スケジュール情報と、UKG Pro WFMと Shifts の間で同期されるエンティティが決まります。
- チーム マッピングは、UKG Pro WFM インスタンス (WFM インスタンスとも呼ばれます) と Teams のチームの間の同期関係を定義します。
1 つ以上の接続インスタンスを作成し、それぞれ異なる同期設定を使用できます。 たとえば、organizationに複数の場所があり、スケジュール要件が異なる場合は、場所ごとに一意の同期設定を持つ接続インスタンスを作成します。 WFM インスタンスは、特定の時点で Teams のチームに 1 回だけマップする必要があります。 ただし、ウィザードでは、同じマッピングを持つ異なる接続インスタンスを使用できます。 つまり、重複するマッピングを使用して接続インスタンスを作成できます。
UKG Pro WFMを記録システムとして使用すると、現場担当者はデバイスのシフトでスケジュールと可用性を効率的に管理できます。 現場マネージャーは引き続き UKG Pro WFMを使用してスケジュールを設定できます。
注:
UKG Pro Workforce Managementは、以前は UKG ディメンションとして知られていました。 ウィザードに UKG ディメンションへの参照が表示される場合があります。
この記事で使用される用語
用語 | 定義 |
---|---|
Connection | 接続を使用すると、UKG Pro WFM システムで作成されたすべてのWFM インスタンスにアクセスできます。 接続を作成するには、UKG Pro WFMの詳細 (アカウントのユーザー名、パスワード、サービス URL など) を指定します。 |
接続インスタンス | 接続インスタンスを作成するには、次の設定を構成します。
|
インスタンスWFM | この用語は、UKG Pro WFM システムのチームを指します。これは Teams のチームとは異なります。 |
前提条件
ウィザードを実行する前に、情報を確認し、「UKG Pro Workforce Managementの Teams Shifts コネクタの前提条件と要件」のすべての前提条件と構成タスクを完了してください。
この記事の手順に従う前に、すべてのタスクを完了していることを確認してください。
Shifts コネクタ ウィザードを実行する
すべての前提条件を満たしていることを確認したら、ウィザードを実行し、UKG Pro WFM システムを Teams の Shifts に接続する準備ができました。
接続を作成する
Microsoft 365 管理センターの左側のナビゲーション メニューで、[セットアップ] を選択し、[おすすめコレクション] で [現場担当者] を選択します。
新しい接続を作成するには、[ 接続の追加] を選択します。
[コネクタの選択] ウィンドウで [UKG ディメンション] を選択し、[次へ] を選択して UKG Pro WFM接続を作成します。
[接続設定] ウィンドウで、接続に一意の名前を付けます。 100 文字を超えたり、特殊文字を使用したりすることはできません。
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.
別の接続を作成するには、[コネクタ管理コンソール] ページに移動し、[ 接続の追加] を選択します。
接続インスタンスを作成する
接続を作成した後、その接続で 1 つ以上の接続インスタンスを設定できます。
作成した接続は、[コネクタ管理コンソール] ページに一覧表示されます。 新しいインスタンスを作成する接続で、[インスタンスの作成] を選択 します。
[設定の選択]
[インスタンスの設定] ページで、UKG Pro WFMから Shifts に同期する情報、同期頻度、Shifts ユーザーがデータを変更できるかどうかを選択します。
接続インスタンスの名前を入力します。 100 文字を超えたり、特殊文字を使用したりすることはできません。
Microsoft 365 システム アカウントを入力します。 これは、マップするすべてのチームのチーム所有者である 前提条件として作成したアカウント です。
[Email通知受信者] で、この接続インスタンスに関する電子メール通知を受信するユーザーを選択します。 これらのグループには、個別のユーザーおよびセキュリティ グループの両方を追加できます。 電子メール通知には、セットアップの状態と、接続インスタンスのセットアップ後に発生する可能性がある問題やエラーに関する情報が含まれています。
同期設定を選択します。
これらの設定ごとに、次のオプションから選択できます。- Shifts ユーザーにはプロバイダー データが表示されません。データは UKG Pro WFMと Shifts の間で同期されません。
- Shifts ユーザーはプロバイダー データを確認できます。データ同期は UKG Pro WFMから Shifts への一方向です。
- Shifts ユーザーはプロバイダー データを表示および変更できます。データ同期は UKG Pro WFMと Shifts 間の双方向です。
重要
[Shifts ユーザーにプロバイダー データが表示されません] オプションを選択して機能を無効にする前に、次の点に注意してください。
- [スケジュール]、[グループ]、[シフト]、[アクティビティ] の設定が無効になっている場合は、休暇や従業員の可用性など、他のすべての設定も無効になります。
- [シフトを開く] 設定が無効になっている場合、シフトのオープン要求も無効になります。
- [休暇] 設定が無効になっている場合、休暇要求も無効になります。
同期頻度を選択します。
設定の選択が完了したら、[ 次へ] を選択します。
重要
次のいずれかのオプションを選択して、オープン シフト、オープン シフト要求、スワップ要求、オファー シフト要求、または休暇要求を無効にした場合は、Shifts で機能を非表示にする必要がある別の手順があります。
- シフトを開く: Shifts ユーザーにプロバイダー データが表示されない
- スワップ要求: Shifts ユーザーにプロバイダー データが表示されない
- 休暇要求: Shifts ユーザーにプロバイダー データが表示されない
- オファーのシフト要求: Shifts ユーザーにプロバイダー データは表示されません
ウィザードを実行した後は、この記事の後半の「オープン シフトを無効にする、シフト要求を開く、要求をスワップする、および休暇要求を無効にする 」セクションの手順に従っていることを確認します。
WFM インスタンスをチームにマップする
Shifts に接続するWFMインスタンスを選択し、各インスタンスを Teams のチームにマップします。 最大 400 個のインスタンスをマップできます。
この手順を完了するには、次の操作を行います。
WFM インスタンスをチームに手動でマップする
[マッピング] ページで、まず、Teams でチームにマップするWFM インスタンスを選択します。
マップする各WFM インスタンスのチェック ボックスをオンにします。 インスタンスは、チェック ボックスが選択されている場合にのみマップされます。
次に、Teams で正しいチームを検索して選択します。
この接続インスタンス内のWFM インスタンスに既にマップされているチームは、再度マップできないことに注意してください。
タイム ゾーンを選択します。 最も近い都市は自動的に入力されますが、変更することはできます。
すべてのチームのマッピングが完了したら、[ 次へ] を選択します。
CSV ファイルを使用してWFMインスタンスをチームにマップする
[マッピング] ページで、[ CSV アップロード ツール] を選択します。
[ テンプレートのダウンロード ] を選択して、CSV マッピング ファイルを取得します。 テンプレートには、すべてのWFM インスタンスとその ID の一覧が含まれています。 テンプレートの上位行は次のようになります。
UKG ディメンション インスタンス ID UKG ディメンション インスタンス名 チーム ID チーム名 タイム ゾーン 自動入力 自動入力 空白 空白 既定* テンプレートの一番下の行は次のようになります。
UKG ディメンション インスタンス ID UKG ディメンション インスタンス名 チーム ID チーム名 タイム ゾーン 空白 空白 自動入力 自動入力 既定* WFM インスタンスにマップするチームを選択します。 テンプレートの下半分からチーム ID とチーム名を切り取って貼り付け、目的のWFMインスタンスに合わせて貼り付けます。 テンプレートの完成した行は次のようになります。
UKG ディメンション インスタンス ID UKG ディメンション インスタンス名 チーム ID チーム名 タイム ゾーン 自動入力 自動入力 移動したチーム ID 移動したチーム名 既定* すべてのマッピングに対してこの手順を繰り返します。
必要に応じて、[ タイム ゾーン ] 列に正しい場所を入力します。
注:
ウィザードでは、約 460 の場所がサポートされています。 タイム ゾーンは tz 形式である必要があります。 選択した特定の場所がサポートされていない場合は、ウィザードにエラーが表示されます。 同じタイム ゾーン内で最も近い都市または主要都市を使用してみてください。
[マッピング] ページで、[ 参照 ] を選択して、完了した CSV ファイルを見つけてアップロードします。
ファイルが正しくアップロードされている場合は、[ 完了] を選択します 。 それ以外の場合は、エラー レポートを確認し、修正されたファイルをアップロードします。
新しいマッピングが [マッピング] ページに一覧表示されます。 [次へ]を選択します。
確認して完了します。
完了する前に、接続インスタンス作成プロセスの概要を確認してください。 接続インスタンスの作成プロセス中に変更を加える必要がある場合は、[ 戻る] を選択します。 準備ができたら、[完了] を選択します。
ウィザードは、接続インスタンスを設定するプロセスを開始します。完了するまでに時間がかかる場合があります。 セットアップが完了する前に接続インスタンスを編集しようとすると、以前に作成したマッピングを表示できない可能性が高くなります。
選択した電子メール通知の受信者は、エラーが発生した場合に備えて、セットアップ状態に関する電子メール通知を受け取ります。
オープン シフト、オープン シフト要求、スワップ要求、および休暇要求を無効にする
重要
次のいずれかのオプションを選択して、オープン シフト、オープン シフト要求、スワップ要求、オファー シフト要求、または休暇要求を無効にした場合は、Shifts で機能を非表示にする必要がある別の手順があります。
- シフトを開く: Shifts ユーザーにプロバイダー データが表示されない
- スワップ要求: Shifts ユーザーにプロバイダー データが表示されない
- 休暇要求: Shifts ユーザーにプロバイダー データが表示されない
- オファーのシフト要求: Shifts ユーザーにプロバイダー データは表示されません
設定を編集した後、開いているシフトを無効にする、シフト要求を開く、要求を交換する、および休暇要求の手順に従っていることを確認します。
Shifts で開いているシフト、スワップ要求、および休暇要求を非表示にするには、Graph API スケジュール リソースの種類を使用して、WFM インスタンスにfalse
マップしたチームごとに次のパラメーターを に設定します。
- 開いているシフト:
openShiftsEnabled
- スワップ要求:
swapShiftsRequestsEnabled
- 休暇要求:
timeOffRequestsEnabled
- オファーシフトリクエスト:
offerShiftRequestsEnabled
Shifts で開いているシフト要求を非表示にするには、Shifts の [設定] に移動し、[シフトを開く] 設定をオフにします。
接続と接続インスタンスを管理する
接続を設定した後は、Microsoft 365 管理センターまたは PowerShell を使用して、接続を管理して変更できます。
Microsoft 365 管理センターを使用する
[コネクタ管理コンソール] ページには、設定した各接続と接続インスタンスと、正常性状態や同期間隔の詳細などの情報が一覧表示されます。 ウィザードにアクセスして、新しい接続と接続インスタンスを作成し、既存の接続インスタンスに変更を加えることもできます。 たとえば、同期設定とチーム マッピングを更新できます。
詳細については、「Microsoft 365 管理センターを使用して UKG Pro Workforce Managementへの Shifts 接続を管理する」を参照してください。
PowerShell を使う
PowerShell を使用すると、エラー レポートの表示、接続設定の変更、同期の無効化などを行うことができます。 詳細なガイダンスについては、「PowerShell を使用して UKG Pro Workforce Managementへの Shifts 接続を管理する」を参照してください。