Unified Service Desk のテーマのカスタマイズ

[アーティクル]
06/27/2024

Unified Service Desk のテーマはエージェントアプリケーションの外観を定義します。 Unified Service Desk のテーマは XAML リソースライブラリで構成され、任意の Web サーバーに配置して、URL を通して参照したり、あるいは .NET アセンブリ (DLLs) にコンパイルして、エージェントアプリケーションで配布することができます。

Unified Service Desk で使用できる定義済みのテーマ

Unified Service Desk には、2 つの定義済みテーマが含まれています。

Unified ブルーテーマ

統一インターフェイスアプリを使用している場合は、Unified Service Desk にこれが事前定義されています。

Unified Service Desk の Unified ブルー。

Air テーマ

Web クライアントを使用している場合は、Unified Service Desk にこれが事前定義されています。

Unified Service Desk のAir テーマ。

Air テーマによりハイコントラストモードがサポートされます。コンピュータのハイコントラストモードをオンに設定し、Air テーマを使用する場合は、Unified Service Desk はハイコントラストモードに自動的に切り替わります。同様に、コンピューターのハイコントラストモードを無効にすることにより、Unified Service Desk クライアントは正常な表示モードに自動的に切り替わります。

Unified Service Desk クライアントでの通常およびハイコントラストモードの自動切り替えは、あらかじめ定義された Air テーマに対してのみサポートされています。ハイコントラストモードをサポートするカスタムテーマまたはユーザー定義されたホストされたコントロールを使用している場合、Unified Service Desk クライアントを再起動した後にのみ切り替えが発生します。詳細: カスタムテーマのハイコントラストモードサポート

注意

Air テーマは Web クライアントにのみ適用されるため、統一インターフェイスアプリで Air テーマに切り替えると問題が発生する可能性があります。

定義済みのテーマの設定

グローバルマネージャーにホストされたコントロール SetTheme アクションにより、Unified Service Desk でテーマを設定できます。 SetTheme アクションへのアクションコールを作成し、次の構文を使用してあらかじめ定義されたテーマコールをデータフィールドに渡して、定義済みのテーマのいずれかを設定できます。

/UnifiedServiceDesk;component/Styles/<Theme_Style>.xaml

次の表は、定義済みのテーマを設定するアクション呼び出しのデータフィールドの構文を説明しています。

テーマ	データフィールドの構文
Air	/UnifiedServiceDesk;component/Styles/AirStyle.xaml
青	/UnifiedServiceDesk;component/Styles/BlueStyle.xaml
スタイル	/UnifiedServiceDesk;component/Styles/Style.xaml

サンプルの Unified Service Desk クライアントアプリケーションでは、エージェントは右上隅の設定アイコンの横にある下矢印を選択し、テーマの設定サブメニューから定義済みのテーマを選択することで、テーマを設定できます。

サブメニューの テーマの設定 を選択すると、前述の データ フィールドの適切な構文を使用して、 SetTheme アクションの呼び出しが行われます。たとえば、これは、空気スタイルのアクション呼び出しの定義です。

Air テーマのアクションコール定義。

Unified Service Desk のテーマのカスタマイズ

様々な定義済みテーマを選択できることに加え、Unified Service Desk でテーマをカスタマイズできます。これは、選択的コントロールを更新し、Unified Service Desk にある既存のテーマを統合して外観をカスタマイズすることにより行われます。 Unified Service Deskは、既定の形式 (XAML ファイル) および一連の XAML ブラシリソースが提供されますを提供します。これにより、エージェントアプリケーションの表示を定義する各種 WPF コントロールとレイアウトを理解するのに使用できます。 Unified Service Desk アプリケーション用の既定のスタイル、DefaultStyle.xaml は、User Interface Integration SDK のダウンロードパッケージでその他の XAML ブラシリソースと共に見つかります。パッケージをダウンロードし、それを展開して、「UII\USD Developer Assets\USD Layout and Style Sheet」ディレクトリにあるファイルとその内容を表示します。

Note

WPF および XAML スクリプトの記述は、XAML ファイル内のコントロールを操作することによって、エージェントアプリケーションの表示をカスタマイズするために必要な技能です。

グローバル管理者がホストするアプリケーションに対して、SetTheme アクションを使用して、エージェントアプリケーションの既定の形式をカスタマイズします。 Unified Service Desk は、エージェントアプリケーションの既存のテーマまたは表示スタイルのカスタマイズの統合をサポートします。これは事実上、ResourceDictionary 参照ブロックに加えて、変更したいコントロールまたは領域を指定するだけで、既存の表示スタイルをカスタマイズできることを意味します。 ResourceDictionary の全般的な情報は、 ResourceDictionary と XAML のリソース参照を選択してください。

アクションコールを作成し、タイトルのテキストおよびエージェントアプリケーションのスキンの色を黄色に変更しましょう。 DefaultStyle.xaml ファイルの準備ができていることを確認します。

Unified Service Desk 管理者にサインインします。
基本設定 で、アクションコール を選択します。
新規を選択して、アクションコールを作成します。
新しいアクションコールページで、全般プロパティを設定します。
1. 名前フィールドで、カスタム表示のアクションコール を入力します。
2. ホストされたコントロール フィールドで、CRM Global Manager を選択します。 Global Manager のホストされたコントロールタイプの別の名前がある場合、その名前を指定します。
3. アクションフィールドで、SetTheme を選択します。

ここでは、表示をカスタマイズするためのパラメーターを設定します。 データフィールドで、次の ResourceDictionary 参照をコピーします。


<ResourceDictionary xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"  
     xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"  
     xmlns:Microsoft_Windows_Themes="clr-namespace:Microsoft.Windows.Themes;assembly=PresentationFramework.Classic"  
     xmlns:themes="clr-namespace:Microsoft.Windows.Themes;assembly=PresentationFramework.Luna"  
     xmlns:ribbon="clr-namespace:Microsoft.Windows.Controls.Ribbon;assembly=RibbonControlsLibrary"  
     xmlns:classic="clr-namespace:Microsoft.Windows.Themes;assembly=PresentationFramework.Classic"  
     xmlns:shell="clr-namespace:Microsoft.Windows.Shell;assembly=Microsoft.Windows.Shell"  
     xmlns:system="clr-namespace:System;assembly=mscorlib">

重要

この ResourceDictionary 参照は、既定のスタイルをカスタマイズするのに使用するすべてのアクションコールに含める必要があります。

次のコマンドをデータフィールドの、以前コピーした ResourceDictionary 参照の後にコピーします。
```
<SolidColorBrush x:Key="WindowBackgroundStyle" Color="Yellow"/>  
```
エージェントアプリケーションのスキンが黄色に変更されます。背景色を設定するこのコマンドは、DefaultStyle.xaml ファイルの  セクションにあります。
前の手順でコピーしたコマンドの後に、次のコマンドをコピーします。
```
<Style x:Key="MainWindow" TargetType="{x:Type Window}" BasedOn="{StaticResource {x:Type Window}}">  
    <Setter Property="Title" Value="CUSTOM TITLE: Agent Application for CONTOSO INC."/>  
    <Setter Property="Icon" Value="/UnifiedServiceDesk;component/imageResources/dynamics16-32-48-256.ico"/>  
    <Setter Property="FontFamily" Value="Segoe UI" />  
</Style>  
```
これにより、タイトルバーのテキストは、“CUSTOM TITLE: Agent Application for CONTOSO INC.” に変更されます。ウィンドウタイトルを設定するこのコマンドは、 section in the DefaultStyle.xaml file. にあります。
データフィールドの最後に次のものを追加することにより、ResourceDictionary タグを閉じます。
```
</ResourceDictionary>  
```
これがアクションコールの外観です。
保存を選びます。

これにより、エージェントアプリケーションでアクションコールをテストする準備が整いました。

表示をカスタマイズするためにアクションコールをテスト

このアクションコールは、ツールバーボタンを作成し、アクションコールをそれに添付することにより、コールできます。時間を短縮するため、デバッガーのホストされたアプリケーションを使用してアクションコールをテストします。

Unified Service Desk クライアントアプリケーションを開始し、Dynamics 365 インスタンスにサインインします。
クライアントアプリケーションで、右上隅の設定メニューの隣にある下矢印を選択し、 デバッグ を選択します。
デバッガーで、 アクションコール タブの隣の下矢印を選択して、アクションの呼び出しと、 UII アクションのテスト可能な領域を表示します。
アクションコールのドロップダウンリストからカスタムテーマのアクションコールを選択し、アクション呼び出しの実行アイコン () を選択します。タイトルバーのテキストとエージェントアプリケーションのスキンの色が変化します。

変更を元に戻すには、クライアントアプリケーションで定義済みテーマのいずれかを選択します。

カスタムテーマに対してハイコントラストモードをサポートする

Unified Service Desk は通常モードおよびハイコントラストモード XAML ブラシリソースを内部で使用し、コンピューターのハイコントラストモード設定に従って UI 要素を表示します。 User Interface Integration SDK ダウンロードパッケージで XAML ブラシリソースを見つけることができます。パッケージをダウンロードし、それを展開して、「UII\USD Developer Assets\USD Layout and Style Sheet」ディレクトリにあるファイルとその内容を表示します。

カスタムテーマでハイコントラストモードをサポートするには、次を考慮します:

カスタムテーマの設定に対して 2 つのアクションを作成する: 1 つは通常モードおよびもう 1 つはハイコントラスト モードです。例えば、XAML ブラシのカラープロパティを定義している際に、次を使用します:
- [通常] モードの色クラスで定義されたあらかじめ定義された色の 1 つ:
```
<SolidColorBrush x:Key="WindowBackgroundStyle" Color="Yellow"/>  
```
- ハイコントラスト モードの SystemColors クラスで定義されたシステムカラーの 1 つ:
```
<SolidColorBrush x:Key="WindowBackgroundStyle" Color="{x:Static SystemColors.WindowColor}"/>  
```
アクションコールが適切に実行されるように、各アクションコール定義の新しい $SystemParameters.HighContrast 置換パラメーターを条件として使用します。例えば、カスタムテーマを設定するためのアクションコール定義では次を考慮します:
- 通常モードの場合、条件フィールドで次を使用し、ハイコントラストモードがコンピューターに設定されていないことを確認します:
```
"[[$SystemParameters.HighContrast]g]"=="False"  
```
- ハイコントラスト モードの場合、条件フィールドで次を使用し、ハイコントラストモードがコンピューターに設定されていることを確認します:
```
"[[$SystemParameters.HighContrast]g]"=="True"  
```

参照

Unified Service Desk の構成チュートリアル
 テーマを使用してアプリケーションの外観をカスタマイズ
 ホストされたコントロールの種類とアクション/イベントリファレンス

次の方法で共有

Unified Service Desk のテーマのカスタマイズ

Unified Service Desk で使用できる定義済みのテーマ

Unified ブルーテーマ

Air テーマ

定義済みのテーマの設定

Unified Service Desk のテーマのカスタマイズ

表示をカスタマイズするためにアクションコールをテスト

カスタムテーマに対してハイコントラストモードをサポートする

参照

フィードバック

その他のリソース

次の方法で共有

Unified Service Desk のテーマのカスタマイズ

Unified Service Desk で使用できる定義済みのテーマ

Unified ブルー テーマ

Air テーマ

定義済みのテーマの設定

Unified Service Desk のテーマのカスタマイズ

表示をカスタマイズするためにアクション コールをテスト

カスタム テーマに対してハイ コントラスト モードをサポートする

参照

フィードバック

その他のリソース

Unified ブルーテーマ

表示をカスタマイズするためにアクションコールをテスト

カスタムテーマに対してハイコントラストモードをサポートする