Personalizar temas no Unified Service Desk

 

Publicado: novembro de 2016

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Os temas no Unified Service Desk definem a aparência do aplicativo agente. Um tema no Unified Service Desk consiste em uma biblioteca de recursos XAML e pode ser colocado em qualquer servidor da web e ser referenciado por meio da URL ou pode ser compilado em assemblies .NET (dll) e distribuído com os aplicativos agentes.

Com Unified Service Desk 2.2, o Tema de ar predefinido oferece suporte ao modo de alto contraste. O modo de alto contraste no Windows ajuda você a ler o texto na tela claramente aumentando o contraste de cor. Quando você ligar o modo de alto contraste sem seu computador e estiver usando o Air Theme, o cliente Unified Service Desk trocará automaticamente para o modo de alto contraste. De forma similar, desabilitar o modo de alto contraste no seu computador causará a troca automática do cliente de Unified Service Desk para o modo de exibição normal.

Dica

A troca automática entre os modos de contraste alto e normal no cliente Unified Service Desk é suportado apenas pelo Tema de ar predefinido. Se estiver usando temas personalizados ou controles hospedados personalizados que suportam o modo de alto contraste, a troca acontece apenas após você reiniciar o cliente Unified Service Desk após troca para o mode de alto contraste ou normal em seu computador.Para obter mais informações:Suporte de modo de alto contraste para temas personalizados

Neste tópico

Temas predefinidos no Unified Service Desk

Definir um tema predefinido

Personalizar temas no Unified Service Desk

Teste a chamada de ação para personalizar a exibição

Suporte de modo de alto contraste para temas personalizados

Temas predefinidos no Unified Service Desk

O Unified Service Desk vem com três temas predefinidos.

Tema de ar

Este é o tema de Ar. Este tema oferece suporte ao modo de alto contraste.

Tema azul

Este é o tema Azul. Esse tema não oferece suporte a configuração de alto contraste, e é obsoleto na versão Unified Service Desk 2.2.Para obter mais informações:Blog: Alguns temas obsoletos do Unified Service Desk predefinidos

Tema de estilo

Este é o tema Estilo. Este tema não oferece suporte a configuração de alto contraste e é obsoleto na versão Unified Service Desk 2.2.Para obter mais informações:Blog: Alguns temas obsoletos predefinidos no Unified Service Desk

Definir um tema predefinido

A ação SetTheme para o controle hospedado do gerenciador global permite definir um tema no Unified Service Desk. Você pode criar uma chamada de ação para a ação SetTheme e transmitir o tema predefinido no campo Dados usando a sintaxe a seguir para definir um dos temas predefinidos:

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

A tabela a seguir fornece a sintaxe para o campo Dados em sua chamada de ação para definir um tema predefinido:

Tema	Sintaxe para o campo Dados
Ar	/UnifiedServiceDesk;component/Styles/AirStyle.xaml
Azul	/UnifiedServiceDesk;component/Styles/BlueStyle.xaml
Estilo	/UnifiedServiceDesk;component/Styles/Style.xaml

No aplicativo cliente Unified Service Desk, os agentes podem definir o tema clicando na seta para baixo ao lado do ícone de configurações no canto superior direito e, em seguida, selecionando um tema predefinido no submenu Definir tema.

Clicar em um tema no submenu Definir tema faz uma chamada de ação para a ação SetTheme com a sintaxe apropriada no campo Dados como mencionado anteriormente. Por exemplo, esta é a definição de chamada de ação para o estilo de Ar:

Personalizar temas no Unified Service Desk

Além de poder escolher diversos temas predefinidos, você também poderá personalizar um tema em Unified Service Desk. Isso é feito atualizando controles seletivos e mesclando com o tema existente Unified Service Desk para personalizar as aparências relacionadas.Unified Service Desk fornece um arquivo de estilo padrão (XAML) e vários recursos de brush de XAML que você pode usar com vários controles para compreender e com layout WPF que define a aparência do agente do aplicativo. Você pode encontrar o estilo padrão do aplicativo Unified Service Desk, DefaultStyle.xaml, junto com outros recursos de brush no XAML no pacote de download do SDK Integração da Interface do Usuário.Baixar o pacote, e extraí-lo para ver o arquivo e seus conteúdos no diretório "UII\USD Developer Assets\USD Layout and Style Sheet".

Dica

Os scripts WPF e XAML são habilidades essenciais necessárias para personalizar a exibição do aplicativo agente manipulando controles em um arquivo XAML.

Use a ação SetTheme do aplicativo gerenciador global hospedado para personalizar o estilo padrão do agente do aplicativo.Unified Service Desk suporta mescla das personalizações com o estilo do tema existente ou exibição do agente do aplicativo. Isso significa que é preciso especificar os controles ou as áreas que deverão ser alteradas com o pacote de referência ResourceDictionary para personalizar um estilo de exibição existente. Para obter informações gerais sobre ResourceDictionary, clique em ResourceDictionary e XAML resource references.

Vamos criar uma chamada de ação para alterar o texto no título e a cor de fundo do aplicativo agente para Amarelo. Certifique que você tenha o arquivo DefaultStyle.xaml por perto, pois precisaremos dele.

1. Entrar no Microsoft Dynamics 365.

2. Vá para Configurações > Unified Service Desk.

3. Clique em Chamadas de ação.

4. Clique em NOVA para criar uma chamada de ação.

5. Na página Nova Chamada de Ação, defina as propriedades gerais:

   1. No campo Nome, digite Chamada de Ação para Exibição Personalizada.

   2. No campo Controle Hospedado, selecione Gerenciador Global Dynamics 365. Se houver um nome diferente para o seu tipo de controle hospedado do Gerenciador Global, especifique o nome.

   3. No campo Ação, selecione DefinirTema.

6. Agora, definiremos o parâmetro para personalizar a exibição. No campo Dados, copie a seguinte referência do 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">
   

   Importante

   Essa referência do ResourceDictionary deve ser incluída em cada chamada de ação usada para personalizar o estilo padrão.

7. Copie o comando a seguir no campo Dados depois da referência do ResourceDictionary que você copiou antes.

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

   Isso alterará o fundo do aplicativo agente para Amarelo. Você encontrará esse comando para definir a cor do plano de fundo na seção <!-- Region General --> no arquivo DefaultStyle.xaml.

8. Copie o seguinte comando depois do comando copiado na etapa anterior:

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

   Isso alterará o texto na barra de título para: "TÍTULO PERSONALIZADO: Aplicativo agente para CONTOSO INC.”. Você encontrará esse comando para definir o título da Janela no <!-- Region Window --> section in the DefaultStyle.xaml file.

9. Feche a marca do ResourceDictionary ao adicionar no final do campo Dados o seguinte:

   </ResourceDictionary>
   

   Esta será a aparência da definição da chamada de ação:

   

10. Clique em Salvar.

Você terminou e agora está pronto para testar a chamada de ação no aplicativo agente.

Teste a chamada de ação para personalizar a exibição

Você pode chamar essa chamada de ação ao criar um botão na barra de ferramentas e anexar a chamada de ação à ele. Para ser breve, usaremos o aplicativo hospedado depurador para testar a chamada de ação.

1. Inicie o aplicativo cliente Unified Service Desk e conecte-se ao servidor do Dynamics 365.

2. No aplicativo cliente, inicie o depurador clicando na seta para baixo, ao lado do menu de configurações no canto superior direito, e em Depurar.

3. Em Depurador, clique na seta para baixo acima da guia Chamadas de Ação para exibir a área onde você poderá testar as chamadas de ação e as ações de UII.

   

4. A partir da lista suspensa de Chamadas de Ação, selecione Chamada de Ação para Tema Personalizado e clique no ícone Executar Chamada de Ação (). O texto na barra de título e a cor de fundo do aplicativo agente são alterados.

   

Para desfazer as alterações, selecione um dos temas predefinidos no aplicativo cliente.

Suporte de modo de alto contraste para temas personalizados

O Unified Service Desk usa internamente os modos de contraste alto e normal dos recursos de bush XAML para exibir seus elementos de IU dependendo na configuração do modo de alto contraste em seu computador. Você poderá encontrar os recursos brush XAML no pacote de download do Integração da Interface do UsuárioSDK.Baixar o pacote, e extraí-lo para ver o arquivo e seus conteúdos no diretório "UII\USD Developer Assets\USD Layout and Style Sheet".

Para apoiar o modo de alto contraste em seus temas personalizados, considere o seguinte:

• Criar duas chamadas de ação para definir um tema personalizado: uma para o modo normal e outra para o modo alto contraste. Por exemplo, ao definir a propriedade de uma cor de brush de XAML, use:

  • Uma das cores predefinidas na classe Cores do modo normal:

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

  • Uma das cores do sistema como definido na classe SystemColorsdo modo alto contraste:

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

• Use o novo parâmetro de substituição do $SystemParameters.HighContrast em cada uma de sua chamada de ação definida como uma condição, para garantir que uma chamada de ação seja lançada apropriadamente. Por exemplo, na definição de chamada de ação para personalizar tema de configuração para:

  • O modo normal, usa o seguinte no campo Condição para verificar se o modo de alto contraste não está definido em seu computador:

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

  • O modo alto contraste, usa o seguinte no campo Condição para verificar se o modo de alto contraste está definido em seu computador:

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

Confira Também

Customize themes for High Contrast settings
Passo a passo da configuração do Unified Service Desk
Personalizar a aparência do aplicativo
Tipos de controle hospedado e referência de ação/evento
TechNet: Guia de administração do Unified Service Desk for Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais