Freigeben über

Anpassen von Themen im Unified Service Desk

  • Artikel

Themen in Unified Service Desk definieren das Erscheinungsbild der Agent-Anwendung. Ein Design in Unified Service Desk besteht aus einer XAML-Ressourcenbibliothek und kann auf einem beliebigen Webserver platziert und über eine URL referenziert oder in .NET-Assemblies (DLLs) kompiliert und mit den Bearbeiteranwendungen verteilt werden.

Vordefinierte Themen in Unified Service Desk

Unified Service Desk enthält zwei vordefinierte Designs.

Unified Blue Thema

Dies ist das vordefinierte Theme für Unified Service Desk, wenn Sie eine einheitliche Schnittstellen-App verwenden.

Einheitlich blau in Unified Service Desk.

Air Thema

Dies ist das vordefinierte Theme für Unified Service Desk, wenn Sie den Webclient verwenden.

Luft-Design in Unified Service Desk.

Das Air Thema unterstützt den Hochkontrasnt-Modus. Wenn Sie auf Ihrem Computer den Hochkontrastmodus einschalten und das Design Air verwenden, wechselt der Unified Service Desk Client automatisch in den Hochkontrastmodus. Wenn Sie den kontrastreichen Modus auf Ihrem Computer deaktivieren, schaltet der Unified Service Desk Client automatisch auf den normalen Anzeigemodus um.

Das automatische Umschalten zwischen normalem und kontrastreichem Modus im Unified Service Desk Client wird nur für das vordefinierte Air Design unterstützt. Wenn Sie angepasste Designs oder benutzerdefinierte gehostete Steuerelemente verwenden, die den Hochkontrastmodus unterstützen, erfolgt der Wechsel erst, nachdem Sie den Unified Service Desk Client neu gestartet haben, nachdem Sie auf Ihrem Computer in den normalen oder den Hochkontrastmodus gewechselt haben. Weitere Informationen: Unterstützung des Hochkontrastmodus für angepasste Designs

Vorsicht

Möglicherweise treten Probleme auf, wenn Sie in Einheitliche Oberfläche-Apps zum Air-Design wechseln, da das Air-Design nur für den Webclient gilt.

Festlegen eines vordefiniertes Designs

Mit der Aktion SetTheme für das gehostete Steuerelement Global Manager können Sie ein Design in Unified Service Desk festlegen. Sie können einen Aktionsaufruf für die Aktion SetTheme erstellen und anschließend den vordefinierten Designaufruf im Feld Daten mit der folgenden Syntax weitergeben, um eines der vordefinierten Designs einzurichten:

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

Die folgende Tabelle enthält dieSyntax für das Feld Daten in Ihrem Aktionsaufruf zum Einrichten eines vordefinierten Designs:

Thema Syntax für das Datenfeld
Ausstrahlung /UnifiedServiceDesk;component/Styles/AirStyle.xaml
Blau /UnifiedServiceDesk;component/Styles/BlueStyle.xaml
Format /UnifiedServiceDesk;component/Styles/Style.xaml

In der Beispielanwendung Unified Service Desk Client können die Bearbeiter das Design festlegen, indem sie den Pfeil nach unten neben dem Symbol für die Einstellungen in der oberen rechten Ecke anklicken und dann ein vordefiniertes Design aus dem Untermenü Design festlegen auswählen.

Das Auswählen eines Designs im Untermenü Design festlegen löst einen Aktionsaufruf für die Aktion SetTheme mit der entsprechenden Syntax im Feld Daten aus, wie zuvor erwähnt. Beispielsweise ist dies die Aktionsaufrufdefinition für den Air-Style:

Aktionsanrufdefinition für das Luft--Design.

Anpassen von Themen im Unified Service Desk

Neben der Möglichkeit, aus verschiedenen vordefinierten Designs auszuwählen, können Sie ein Design in Unified Service Desk anpassen. Dies geschieht durch die Aktualisierung ausgewählter Steuerelemente und die anschließende Zusammenführung mit dem vorhandenen Design in Unified Service Desk, um das Erscheinungsbild anzupassen. Unified Service Desk bietet einen Standardstil (XAML-Datei) und eine Reihe von XAML-Brush-Ressourcen, die Sie verwenden können, um die verschiedenen WPF-Steuerelemente und das Layout zu verstehen, die das Aussehen Ihrer Anwendung für die Bearbeiter definieren. Den Standardstil für die Unified Service Desk-Anwendung, DefaultStyle.xaml, finden Sie zusammen mit anderen XAML-Brush-Ressourcen im Download-Paket User Interface Integration SDK. Laden Sie das Paket herunter und extrahieren Sie es, um die Datei und ihre Inhalte im Verzeichnis UII\USD Developer Assets\USD Layout and Style Sheet anzuzeigen.

Notiz

WPF- und XAML-Skripting sind wichtige Kenntnisse für die Anpassung der Anzeige Ihrer Agent-Anwendungen durch die Manipulation von Steuerelementen in einer XAML-Datei.

Verwenden Sie die SetTheme-Aktion für die gehostete Globaler Manager-Anwendung, um den Standardstil der Agent-Anwendung anzupassen. Unified Service Desk unterstützt die Zusammenführung Ihrer Anpassungen mit dem bestehenden Design oder Anzeigestil der Bearbeiteranwendung. Dies bedeutet, dass Sie nur die Steuerelemente oder Bereiche angeben müssen, die geändert werden sollen, zusammen mit dem ResourceDictionary-Referenzblock, um einen vorhandenen Anzeigestil anzupassen. Wählen Sie für allgemeine Informationen zum ResourceDictionary die Option ResourceDictionary und XAML-Ressourcenreferenzen aus.

Erstellen wir nun einen Aktionsaufruf, um den Text im Titel und die Designfarbe der Agent-Anwendung zu Gelb zu ändern. Stellen Sie sicher, dass Sie die DefaultStyle.xaml-Datei bereit haben.

  1. Melden Sie sich bei Unified Service Desk Administrator an.

  2. Wählen Sie Aktionsaufrufe unter Grundeinstellungen.

  3. Wählen Sie Neu, um einen Aktionsaufruf zu erstellen.

  4. Stellen Sie auf der Seite Neuer Aktionsaufruf die allgemeinen Eigenschaften ein:

    1. Geben Sie im Feld Name Aktionsaufruf für benutzerangepasstes Display ein.

    2. Wählen Sie im Feld Gehostetes Steuerelement CRM Globaler Manager. Wenn Sie einen anderen Namen für Ihren gehosteten Global Manager-Steuerelementtyp haben, geben Sie stattdessen diesen Namen an.

    3. Wählen Sie im Feld Aktion SetTheme aus.

  5. Jetzt legen wir den Parameter für das Anpassen der Anzeige fest. Kopieren Sie im Feld Daten die folgende ResourceDictionary-Referenz:

    
<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">

    Wichtig

    Diese ResourceDictionary-Referenz muss in jedem Aktionsaaufruf hinzugefügt werden, den Sie verwenden, um die Standard-Anzeige anzupassen.

  6. Kopieren Sie den folgenden Befehl im Feld Daten nach der ResourceDictionary-Referenz, die Sie zuvor kopiert haben.

    <SolidColorBrush x:Key="WindowBackgroundStyle" Color="Yellow"/>

    Dadurch wird das Erscheinungsbild der Agent-Anwendung zu Gelb geändert. Sie finden diesen Befehl zum Ändern der Hintergrundfarbe im Abschnitt <!-- Region General --> in der Datei DefaultStyle.xaml.

  7. Kopieren Sie den folgenden Befehl nach dem Befehl, den Sie im vorherigen Schritt kopiert haben:

    <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>

    Hierdurch wird in der Titelleiste der Text zu "BENUTZERDEFINIERTER TITEL: Agent-Anwendung für CONTOSO INC." geändert. Sie finden diesen Befehl zum Festlegen des Fenstertitels in deri <!-- Region Window --> section in the DefaultStyle.xaml file.

  8. Schließen Sie das ResourceDictionary-Tag, indem Sie Folgendes am Ende des Feldes Daten hinzufügen:

    </ResourceDictionary>

    So sieht Ihre Aktionsaufrufdefinition aus:

    Definieren des Aktionsaufrufs zum Anpassen der Anzeige.

  9. Wählen Sie Speichern.

    Sie sind fertig und können jetzt den Aktionsaufruf in der Agent-Anwendung testen.

Testen Sie den Aktionsaufruf zum Anpassen Ihres Displays.

Sie können diesen Aktionsaufruf aufrufen, indem Sie eine Symbolleistenschaltfläche erstellen, und anschließend den Aktionsanruf daran anhängen. Weil dies kürzer ist, verwenden wir zum Testen des Aktionsaufrufs das gehostete Debugger-Steuerelement.

  1. Starten Sie die Unified Service Desk Client-Anwendung und melden Sie sich bei Ihrer Dynamics 365-Instanz an.

  2. Starten Sie in der Client-Anwendung den Debugger durch Auswählen des Abwärtspfeils neben dem Einstellungsmenü oben rechts und Auswahl von Debuggen.

  3. Wählen Sie im Debugger den Abwärtspfeil oberhalb der Registerkarte Aktionsaufrufe aus, um den Bereich anzuzeigen, in dem Sie Aktionsaufrufe und UII-Aktionen testen können.

    Testen von Aktionsaufrufen und UII-Aktionen im Debugger.

  4. Wählen Sie in der Dropdown-Liste Aktionsaufrufe die Option Aktionsaufruf für angepasstes Design und wählen Sie das Symbol Aktionsaufruf ausführen (USD-Debugger Schaltfläche „Handlungsaufforderung ausführen“.). Der Text in der Titelleiste und die Designfarbe der Agent-Anwendung ändern sich.

    Benutzerdefinierte Anzeige der Client-Anwendung.

    Wählen Sie zum Rückgängigmachen der Änderungen eines der vordefinierten Designs in der Client-Anwendung.

Support für kontrastreichen Modus für benutzerdefinierte Themen

Unified Service Desk verwendet intern XAML-Brush-Ressourcen im normalen und im kontrastreichen Modus, um seine Benutzeroberflächenelemente anzuzeigen, je nachdem, welcher Modus auf Ihrem Computer festgelegt ist. Sie finden die XAML-Brush-Ressourcen im User Interface Integration SDK Download-Paket. Laden Sie das Paket herunter und extrahieren Sie es, um die Datei und ihre Inhalte im Verzeichnis UII\USD Developer Assets\USD Layout and Style Sheet anzuzeigen.

Um den kontrastreichen Modus in Ihren benutzerdefinierten Designs zu unterstützen, erwägen Sie Folgendes:

  • Erstellen Sie zwei Aktionsanrufe zum Festlegen eines benutzerdefinierten Designs: eine für den normalen Modus und das andere für den kontrastreichen Modus. Verwenden Sie beispielsweise beim Definieren der Farbeigenschaft eines XAML-Pinsels Folgendes:

    • Eine der vordefinierten Farben, die in der Farben-Klasse für den normalen Modus definiert sind:

      <SolidColorBrush x:Key="WindowBackgroundStyle" Color="Yellow"/>

    • Eine der Systemfarben, wie in der SystemColors-Klasse für den kontrastreichen Modus definiert:

      <SolidColorBrush x:Key="WindowBackgroundStyle" Color="{x:Static SystemColors.WindowColor}"/>

  • Verwenden Sie den neuen $SystemParameters.HighContrast-Ersetzungsparameter in jeder Aktionsaufrufdefinition als Bedingung, um sicherzustellen, dass ein Aktionsaufruf richtig ausgelöst wird. Beispilsweise in der Aktionsanrufdefinition zum Festlegen benutzerdefinierter Designs für:

    • Im Modus normal verwenden Sie Folgendes im Feld Bedingung, um zu prüfen, ob der kontrastreiche Modus nicht auf Ihrem Computer festgelegt ist:

      "[[$SystemParameters.HighContrast]g]"=="False"

    • Im Modus kontrastreich verwenden Sie Folgendes im Feld Bedingung, um zu prüfen, ob der kontrastreiche Modus auf Ihrem Computer festgelegt ist:

      "[[$SystemParameters.HighContrast]g]"=="True"

Siehe auch

Importieren von exemplarischen Vorgehensweisen zur Unified Service Desk-Konfiguration
Verwenden Sie Themen, um das Erscheinungsbild Ihrer Anwendung anzupassen
Typen gehosteter Steuerelemente und Referenz zu Aktionen/Ereignissen