Unified Service Desk で通知を構成する方法 | MicrosoftDocs
Unified Service Desk で通知を構成して、一般的な情報、顧客またはエージェントが操作できるプロセスに関連する情報を含む、顧客サービス エージェントにポップアップ通知メッセージを表示できます。 通知メッセージのレイアウトおよび動作は、Unified Service Desk のフォームを使用して XAML 形式で定義され、新規にホストされたコントロールの種類 Popup Notification を使用して、浮動ポップアップ メッセージとして表示されます。 詳細: ポップアップ通知 (ホストされたコントロール)
通知は、特定のイベントが発生したときに表示されるポップアップ メッセージを定義したり、他のホストされたコントロールとやり取りしたり、セッションからのコンテキスト情報を表示したりするための Unified Service Desk アクション、イベント、および置換パラメーターをサポートします。 一度に表示される複数の通知を定義することはできません。 エージェント アプリケーションで表示することができる通知を表示できる場所と通知が自動的に消えるまでのタイムアウトの情報を定義できます。
通知はグローバルまたはセッション ベースにすることができます。 グローバル通知は、セッション外で表示され、タイムアウトまたはユーザーによって明示的に閉じられた場合にのみ非表示になります。 セッション ベースの通知は、セッション内でのみ表示され、別のセッションに切り替えると通知が非表示になります。 通知のセッションに戻すと、タイムアウトするまたはユーザーによって明示的に閉じるまで通知が再度表示されます。
キーボード ショートカットを使用して通知を移動
Alt+1 キー (既定) を使用して、通知にフォーカスを設定することができます。 複数の通知が表示されている場合は、Alt+1 を繰り返して押すと、画面上のアクティブな通知すべてを順に見ることができます。 通知の既定のキーボード ショートカット キーを変更するには、新しい PopupNavigationShortcut UII オプションを使用し、ショートカット キーを選択して指定します。 詳細: Unified Service Desk のオプションの管理
キーボード ショートカットを使用して通知を移動
既定のキーボード ショートカットを使用して移動したり、フォーカスを移動したり、通知から移動することができます。 既定のキーボード ショートカットを変更するには、UII オプションを作成して使用したいキーボードの値を設定します。 詳細については Unified Service Desk のオプションの管理 を参照してください。
| UII オプション | 既定のキーボード ショートカット | 説明 |
|---|---|---|
PopupNavigationShortcut |
Alt + 1 | 通知にフォーカスを合わせます。 |
PopupEscapeShortcut |
Shift+Esc | 通知から Unified Service Desk のクライアント アプリケーションにフォーカスを合わせます。 |
PopupMoveUpShortcut |
Shift + 上矢印 | 通知がスタックで表示されているときに、ある通知から別の通知に上に移動する。 |
PopupMoveDownShortcut |
Shift + 下矢印 | 通知がスタックで表示されているときに、ある通知から別の通知に下へ移動します。 |
PopupMoveLeftShortcut |
Shift + 左矢印 | 複数の通知が表示されているときに、ある通知から別の通知に左へ移動します。 |
PopupMoveRightShortcut |
Shift + 右矢印 | 複数の通知が表示されているときに、ある通知から別の通知に右へ移動します。 |
フォームを使用した通知のレイアウトと動作の定義
Unified Service Desk フォームを使用して、フォームのレイアウトと動作を定義します。 新しいフォーム レコードを定義する際に、フォーム レコードの 利幅 フィールド に XAML を指定してレイアウトを定義します。
注意
フォームのレイアウトと動作を定義するには、Windows Presentation Foundation (WPF) および XAML スクリプトの事前の知識が必要です。
通知からの UII アクション、アクションの呼び出し、およびイベントを実行するコマンド バインド
通知コントロール内でホストされるフォーム XAML のボタンおよびハイパーリンクなどの WPF コントロールに関連付けられるカスタム WPF コマンドが Unified Service Desk (Microsoft.Crm.UnifiedServiceDesk.Dynamics アセンブリ) にあります。 コマンドは、ICommandSource インターフェイスを実装するコントロールに関連付けることができます。 詳細: コマンドの概要。
コマンドは、フォーム XAML をホストする通知コントロールからホストされたコントロールまたは発生したイベントでアクションを実行して使用できます。
重要
コマンドは、フォーム XAML で指定される下記のコマンド値には、XAML のルート要素で次のように定義される CCA、名前空間エイリアスがあります:
xmlns:CCA="clr-namespace:Microsoft.Crm.UnifiedServiceDesk.Dynamics;assembly=Microsoft.Crm.UnifiedServiceDesk.Dynamics"
UII アクション: フォーム XAML から UII アクションを実行するには、
CommandおよびCommandParameterに次の値を指定します。Command
CCA:ActionCommands.DoActionCommandCommandParameter
コマンド パラメーターは、アクションが実行されるホストされたコントロールの名前、UII アクションの名前、および任意のアクション データを含める必要があります。 これらの値はすべて次の URL 形式で指定する必要があります:https://uii/[HostedControlName]/[UIIActionName]?[ActionData]。URLの別の部分は、標準のガイドラインどおりに必要に応じてエンコードする必要があることに注意してください。 たとえば、スペース文字は、「%20」または「+」としてエンコードする必要があります。
例
CRM ページの種類のContactと名付けられホストされたコントロールがあり、このコントロールで次のアクションデータを使用して [Open_CRM_Page] アクションを実行するとします。LogicalName=contact id=[[contact.Id]]次に、フォーム XAML の
CommandParameterの値として次の URL を渡す必要があります:https://uii/Contact/Open_CRM_Page?LogicalName%3Dcontact%0D%0Aid%3D%5B%5Bcontact.Id%5D%5Dさらに次のように フォーム XAML でボタンを選択してコマンドを関連付けることができます:
<Button Command="CCA:ActionCommands.DoActionCommand" CommandParameter="https://uii/Contact/Open_CRM_Page?LogicalName%3Dcontact%0D%0Aid%3D%5B%5Bcontact.Id%5D%5D"アクション コール: これはアクション データをエンコードする、および XAML に配置することを強制しないホストされたコントロールで UII アクションの実行の代替を提供します。 フォーム XAML からアクション コールを実行するには、
CommandおよびCommandParameterに次の値を指定します。Command
CCA:ActionCommands.DoActionCommandCommandParameter
コマンド パラメーターは、実行するアクション コールの名前が含まれている必要があり、次のURLの形式で指定する必要があります:https://actioncall/[ActionCallName].スペースまたは特殊文字が含まれている場合は、アクション コール名は URL エンコードする必要があることに注意してください。 たとえば、スペース文字は、「%20」または「+」としてエンコードする必要があります。
例
Open Contact Pageという名前のアクションを実行するとします。次に、フォーム XAML の
CommandParameterの値として次の URL を渡す必要があります:https://actioncall/Open+Contact+Pageイベント: フォーム XAMLからイベントを実行するには、
CommandおよびCommandParameterに次の値を指定します。Command
CCA: ActionCommands.UIIEventCommandParameter
コマンド パラメーターは、オプションで疑問符 (?) をつけたイベント名およびクエリ文字列のフォームのイベント パラメーターを含んでいる必要があります。 各パラメーターは、必要に応じて名前と値の両方を URL エンコードする必要がある「名前 ＝ 値」のペアとして指定します。 さらに、パラメーターは、「&」を使用して区切る必要があります。次の形式でコマンド パラメーターを指定します:
[EventName]?[Name]=[Value]&[Name]=[Value]例
OKと名付けられたイベントを次のイベントで起動するとします。Name1=Value1 Name2=My Value次に、フォーム XAML の
CommandParameterとして次の URL を渡す必要があります:OK?Name1=Value1&Name2=My+Value
通知のカウントダウン タイマーを表示する
TimeoutProperty パラメーターを使用して、メッセージを表示されるまでの通知メッセージのカウントダウン タイマーを表示できます。 通知コントロールのタイムアウト値は、コントロールを表示するようにアクションを構成するときに定義されます。 詳細: どのように通知を構成しますか?
たとえば、TimeoutProperty パラメーターにバインドされたフォーム XAML でラベル要素を追加すると、通知メッセージが閉じられるまでを秒単位でカウントダウン表示できます。 たとえば、次のようになります。
<TextBlock Foreground="White" x:Name="lblElapsedTime" Margin="0,0,9,0"
HorizontalAlignment="Right" VerticalAlignment="Center" FontSize="20"
Grid.Column="1" Text="{Binding TimeoutProperty}" FontFamily="Calibri" />
通知のためのサンプル XAML
次のサンプル XAML は、インスタンスの置換パラメーターで構成されたセッションの最大数の値に基づいて通知を表示し、セッション制限に達したときに通知を表示します。
<Border xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
xmlns:CCA="clr-namespace:Microsoft.Crm.UnifiedServiceDesk.Dynamics;assembly=Microsoft.Crm.UnifiedServiceDesk.Dynamics"
BorderBrush="Blue" BorderThickness="1">
<Grid Background="AliceBlue" Height="100" Width="400">
<Grid.Resources>
<CCA:CRMImageConverter x:Key="CRMImageLoader" />
<Style x:Key="ImageLogo" TargetType="{x:Type Image}">
<Setter Property="Width" Value="16" />
<Setter Property="Height" Value="16" />
<!--<Setter Property="Margin" Value="5" /> -->
</Style>
</Grid.Resources>
<Grid.RowDefinitions>
<RowDefinition Height="75"/>
<RowDefinition Height="*"/>
</Grid.RowDefinitions>
<Grid.ColumnDefinitions>
</Grid.ColumnDefinitions>
<Grid Grid.Row="0">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="50"/>
<ColumnDefinition Width="350"/>
</Grid.ColumnDefinitions>
<Image Style="{DynamicResource ImageLogo}" Source="{Binding Source=msdyusd_Email16, Converter={StaticResource CRMImageLoader}}" Grid.Column="0" />
<TextBlock TextWrapping="Wrap" Grid.Column="1" Text="You can have a maximum of [[$Global.maxNumberOfSessions]+] concurrent sessions open. To open a new session, close at least one of the existing ones."/>
</Grid>
<Grid Background="SkyBlue" Grid.Row="1">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="300"/>
<ColumnDefinition Width="100"/>
</Grid.ColumnDefinitions>
<TextBlock Grid.Column="0">
<Run Text="The notification closes in " />
<Run Text="{Binding TimeoutProperty}" />
<Run Text=" seconds"/>
</TextBlock>
<Button Height="20" Width="90" Grid.Column="1" Foreground="Black" Command="CCA:ActionCommands.UIIEvent" CommandParameter="Cancel">Close</Button>
</Grid>
</Grid>
</Border>
ポップアップ通知コントロールを使用して通知を表示する
通知メッセージを表示、非表示、および閉じるには、Popup Notification コントロールに事前定義されたアクションを使用します。
Show アクションを使用して、表示するフォーム名、表示する通知メッセージの画面上の位置および通知が表示される時間を指定できます。 詳細: 事前定義された UII アクション。
Popup Notification コントロールの事前定義されたイベントを使用して、前に説明したように通知メッセージで実行されるユーザー アクションに応答します。 イベントが発生したときに実行されるイベントに対して追加のアクションを追加することもできます。 詳細: 事前定義されたイベント。
通知に使用するフォームでイベント パラメーターを使用する
また、ポップアップ通知コントロールの Show アクションで使用されるフォームは、Show アクション コールをトリガーしたイベントのパラメーターを使用することができます。
Unified Service Desk のアクション コールは、アクション データ内の置換パラメーターとしてイベント パラメーターを使用することができます。 これらのイベント パラメーターの一部またはすべてをフォーム XAML でにフォームで使用できるようにするため、事前に定義されたパラメーターの代わりに、Show アクション内にさらにパラメーターを追加することができます。 たとえば、1 つの Show アクション パラメーターを次の方法で追加することができます。
Param1 = [[EventParam1]+]。ここで EventParam1 は Show アクション コールをトリガーしたイベントのパラメーターのひとつです。
追加されたカスタム パラメーターは、そのほかの置換パラメーターのように、置換パラメーターとしてフォーム XAML で使用することができます。 上の例では、[[Param1]] は一部のデータを表示するフォーム XAML として使用することができます。
複数の通知コントロール
複数の通知コントロールを構成し、互いに独立してアクションを呼び出すことができます。 2 つのグローバル通知が同じ位置に表示されるように構成されている場合は、最新の通知が以前の通知の上にオーバーレイされます。 同様に、グローバルおよびセッション ベースの通知または複数のセッション ベースの通知がセッションで同じ位置に表示されるために構成される場合、最新のものがセッションで以前の通知の上にオーバーレイされます。
スタック通知
表示 アクションの データ フィールドに stack パラメーターを追加することで、スタック通知を構成することもできます。 パラメーターはブール値を取得します。 Unified Service Desk では、パラメーターが true に設定されているとスタックに通知が表示されます。 既定値は false です。 値を指定しない場合、既定値 (false) が渡されます。 たとえば、stack = true ではスタックに通知が表示されます。
さらに、stackHeight パラメーターを定義することによりスタックの高さを定義できます。 値の範囲は 1 ～ 100 です。 既定値は 50 です。 値を指定しない場合、既定値 (50) が渡されます。 さらに、0 を指定した場合、または 100 超を指定した場合、既定値 (50) が渡されます。 たとえば、stackHeight = 60 です。
パラメーターの詳細については、ポップアップ通知 (ホストされたコントロール) を参照してください。
スタックでの通知の順序は上から下です。新しい通知が下に表示されます。 特定の時点で最大 5 つスタック通知を表示できます。
Note
通知が 6 つ以上ある場合、新しい表示が最近表示された通知に重なって表示されます。
たとえば、スタックに 5 つの通知があります。 6 つ目の通知が生成されました。6 つ目の通知は 5 つ目の通知に重なって表示されます。 同様に、7 つ目の通知が生成されると、6 つ目に重なって表示されます。
通知を構成するには？
これらは通知を表示するための広範なステップです:
通知定義 (XAML) でフォームレコードを作成します。 たとえば、以前に XAML の例で示された、
Sample Notification Formという名前でフォームを作成します。Popup Notificationコントロールを作成し、グローバルに保ちます。 たとえば、MaxSessionNotificationControlという名前でコントロールを作成します。
通知を表示するアクション コールを作成します。
たとえば、アクション コールを作成して次を指定します。フィールド Value Name 最大セッション通知用のアクション コール ホストされたコントロール MaxSessionNotificationControl 目的 [表示] データ formName = サンプル通知フォーム
top = 10
left = 80
timeout = 20
stack = true
stackHeight = 60最後に、アクションを実行するためにイベントにアクション コールを追加します。
通知を表示する新しいセッションの作成で最大セッション数を確認する際、アクション コールを グローバル マネージャー (ホストされたコントロール) のSessionNewイベントに追加します。a. イベント に移動します。
b。 一覧から SessionNew を選択します。
c。 SessionNew イベント ページの アクティブ アクション 領域で、既存の アクション コール を追加を選択して アクション コールを追加します。 レコードの検索 ウィンドウが表示されます。
d。 検索ボックスに、最大セッション通知のアクション コールと入力して検索アイコンを選択します。 結果が表示されます。 アクション コールを選択し、 追加 を選択します。 e. 保存。
を選択
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示