MS Dynamics 365 統合のアップグレード（CIF 1.0）

要件：

Comm ウィジェット 2.0 をご利用いただくには、BPCC 5.36.0 以降が必要です

移行

Comm ウィジェット 2.0 は、CIF 1.0 および CIF 2.0（Channel Integration Framework）の両方に対応しています。本ガイドでは特に CIF 1.0 について解説します。CIF 2.0（エージェントエクスペリエンスプロファイル）については、CIF 2.0 ガイドをご参照ください。

アプリパッケージは、CIF 1.0 および CIF 2.0 のいずれにおいても、旧ウィジェットと新ウィジェットで共通です。既存のお客様（Universal Repeater または Comm Widget 1.0 をご利用中の方）の場合、移行は、チャネルプロバイダーレコードのチャネル URL を Comm Widget 2.0 形式に更新するだけで完了します。

テストや段階的な移行のため、新旧のウィジェットを同じ Dynamics 365 インスタンス内で並行して実行することができます。制限事項：ユーザーは 1 つのチャネルプロバイダーのみを読み込みます。CIF 1.0 では、これはユーザーのセキュリティ役割（「チャネルの役割を選択」経由）によって決定されます。

新規チャネルプロバイダーの設定（CIF 1.0）

Channel Integration Framework アプリを開き、新規のチャネルプロバイダーレコードを作成してください。または、既存の下書きを使用することもできます。
チャネル URL の形式を <contact center>/agent/crmembedded/adapters/msdyn-omnichannel.html に更新します。
「チャネル用の統合インターフェースアプリを選択」で、ウィジェットを利用可能にするアプリ（例：CRM Hub）を選択してください。
「チャネルの役割を選択」で、新規ウィジェットを割り当てる役割を選択してください。

注：旧バージョンのウィジェットと Comm Widget 2.0 を引き続き併用する予定がある場合は、該当する場合、旧チャネルプロバイダーの役割割り当てからこれらの役割を必ず除外してください。
レコードを保存してください。
Customer Service Hub / CRM Hub を開き、[チャネル] パネルを確認してください。「Agent Desktop — Powered by Bright Pattern」のログイン画面が表示されれば、新規の Comm Widget 2.0 が接続済みで正常に動作しています。

複数のウィジェットバージョンの同時使用

テストや段階的な移行を目的として、同じ Dynamics 365 インスタンス内で旧統合と新統合の両方を有効にすることは可能ですが、以下の例外があります：

同一のユーザーに対してウィジェットを同時に実行することはできません。これは、ユーザーのアプリ／役割の割り当てによって、CIF 1.0 で読み込まれるチャネルプロバイダーが 1 つに限定されるためです。
組織全体で並行して実行するには、CIF 1.0 においてセキュリティ役割ごとにアクセス権を分割する必要があります。
- 例えば、RoleA を持つユーザーは旧チャネルプロバイダーに、RoleB を持つユーザーは新チャネルプロバイダーにそれぞれスコープされます。
ユーザーをウィジェットのバージョン間で切り替えるには、CIF 1.0 で役割の再割り当てを行います。その他の設定変更は不要です。

テスト用のパイロット役割の作成

テストをスムーズに行うには、専用のパイロットセキュリティ役割（[設定] > [セキュリティ役割] > [新規役割]）、例えば「BP_CommWidget2.0_Pilot」を作成し、既存の数十もの役割に手を加える代わりに、テストユーザーに対してその役割を追加・削除するだけにするのが最も簡単です。


	極めて重要な点：旧チャネルプロバイダーの「チャネルの役割を選択」フィールドが空白（「---」）のままになっている場合、これは「制限なし」を意味し、役割に関係なくすべてのユーザーに一致します。新規プロバイダーにパイロット役割を割り当てても、これは自動的に上書きされません。役割によって排他性を確実に適用するためには、旧プロバイダー側にも、パイロット役割を除外する明示的な役割割り当て（例：「BP_oldWidget」のような専用の役割）が必要です。

クリーンな（管理者権限のない）テストユーザーの設定

役割ベースのルーティングを適切に検証するには、テストユーザーはシステム管理者であってはなりません（下記の重要な注意事項を参照）。最も確実な方法は、このテスト専用のまったく新規のユーザーを作成することです：

portal.azure.com > Microsoft Entra ID > ユーザー > 新規ユーザー の順に選択し、新しいユーザーを作成します。ユーザーの名前を設定し、パスワードを生成してください。
admin.cloud.microsoft（Microsoft 365 管理センター）> [ユーザー] > [アクティブなユーザー] > 対象のユーザーを選択 > [ライセンスとアプリ] タブで、必要な Dynamics 365 ライセンス（例：「Dynamics 365 Customer Service Enterprise」試用版）およびその他の必要なアプリライセンス（例：Power Automate）を割り当ててください。その後、[保存] を押します。

注：「Dynamics 365 管理者」や「Power Platform 管理者」などの Azure AD（Microsoft Entra）管理者役割は、Dynamics のセキュリティ役割とは別の、テナントレベルの権限レイヤーです。これらの役割を割り当てても、ユーザーの Dynamics セキュリティ役割に「システム管理者」が自動的に追加されることはありません。そのアカウントを管理業務にも使用する場合は、これらの役割を維持しても問題ありません。
Dynamics 365 環境への同期には数分ほどお時間をいただくか、Power Platform 管理センター > [環境] > 該当する環境 > [ユーザー] > [更新] を使用して同期を早めることができます。
Dynamics 365 で（Power Platform 管理センター > ユーザー > 新規ユーザー > 役割の管理 経由で）、「システム管理者」の代わりに、ユーザーが通常持つべき実際の Dynamics セキュリティ役割（例：「カスタマーサービス担当者」）に加え、上記の「テスト用のパイロット役割の作成」で作成したパイロット役割または旧ウィジェット役割を割り当ててください。


	実際にバイパスを引き起こすのは、Azure AD のテナント管理者役割ではなく、Dynamics 内部の「システム管理者」セキュリティ役割（Power Platform 管理センター > ユーザー > 対象ユーザー > 直接割り当てられた役割のリストに表示されます）です。テストユーザーの「直接割り当てられた役割」リストに「システム管理者」が含まれていないことを再確認してください。

最終確認

テストユーザー（管理者権限を持たず、パイロット役割が追加され、対象アプリへのアクセス権が付与されているユーザー）として、Customer Service Hub / CRM Hub を開き、[チャネル] パネルを確認してください。「Agent Desktop — Powered by Bright Pattern」のログイン画面が表示されれば、新規の Comm Widget 2.0 が接続済みで正常に動作しています。

重要な注意事項

役割の変更は即座には適用されません。

ユーザーの役割を変更した後、[ユーザーの更新]をクリックしてください（Power Platform 管理センター > [環境] > 該当する環境 > [ユーザー] > ユーザーを選択 > 上部のコマンドバーにある[ユーザーの更新]をクリック）。
その後、ユーザーの権限を更新するには、ページを更新するだけでなく、ユーザーが完全にサインアウトしてから再度サインインする必要があります。

「システム管理者」役割は、チャネルプロバイダーの制限をバイパスします。

テストユーザーが「システム管理者」の場合、「チャネルの役割を選択」でどのような設定がされていても、どのチャネルプロバイダーとも一致させることができます。役割ベースのルーティングを適切に検証するには、管理者権限を持たないテストユーザーを使用してください。

「役割の管理」パネルから役割を割り当てるときは、保存する前に結果のリストを再確認してください。

確認ダイアログには、追加した役割だけでなく、そのユーザーに割り当てられる結果としての役割セット全体が表示されます。新規役割のみがチェックされた状態で保存すると、そのユーザーの他のすべての役割が削除されます。

アプリへのアクセス権は、チャネルプロバイダーとは別の設定です。

適切な役割が割り当てられていても、その役割にアプリ自体（Customer Service Hub / CRM Hub）へのアクセス権が付与されていない場合、ユーザーには「お使いの役割に該当するアプリが見つかりません」というメッセージが表示されることがあります。
この問題を解決するには、Dynamics 365 でアプリ管理グリッド（[アプリ]、公開済みアプリが表示されます）を開き、該当するアプリの「...」をクリックして[役割の管理] > 必要な役割にチェックを入れ > [保存] の順に操作してください。

[役割の管理] パネルには、環境内のすべてのセキュリティ役割（この例では 225 個）が検索可能な完全なリストとして表示されます。アプリを開けるようにする役割（例：「カスタマーサービス担当者」）にチェックを入れ、[保存] をクリックしてください。

< 前へ | 次へ >