Compartilhar via

Configurar notificações no Unified Service Desk

  • Artigo

 

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

Configurar notificações no Unified Service Desk para exibir mensagens de notificação de pop-up para seus agentes de serviço do cliente que contém informações gerais ou alguma informação relacionada ao cliente ou ao processo em que o agente pode atuar. O layout e o procedimento da mensagem de notificação são definidos no formato XAML, usando formulários no Unified Service Desk e exibidos como uma mensagem pop-up de flutuação usando o novo tipo de controle hospedado, Popup Notification.Para obter mais informações:Notificação pop-up (controle hospedado)

As notificações suportam ações, eventos e parâmetros de substituição do Unified Service Desk para você definir mensagens de pop-up que aparecem quando ocorrem eventos específicos, interagir com outros controles hospedados e exibir informações contextuais de uma sessão. Você pode definir várias notificações para aparecerem ao mesmo tempo. É possível definir a posição na qual a notificação pode ser exibida no aplicativo do agente e as informações de tempo esgotado após o qual a notificação desaparece automaticamente.

As notificações podem ser globais ou baseadas na sessão. As notificações globais são exibida fora de uma sessão e ficarão ocultas somente o tempo for esgotado ou forem fechadas explicitamente pelo usuário. As notificações com base na sessão aparecem somente dentro de uma sessão e alternar para outra sessão ocultará a notificação. Alternar de volta para a sessão com notificação exibirá a notificação novamente, até o tempo ser esgotado ou ela ser fechada explicitamente pelo usuário.

Dica

Esse recurso foi introduzido na versão Unified Service Desk 2.2.

Neste tópico

Definir layout e comportamento da notificação usando formulários

Mostrar notificações usando o controle de Notificação de Pop-up

Vários controles de notificação

Como configurar uma notificação?

Definir layout e comportamento da notificação usando formulários

Use os formulários do Unified Service Desk para definir o layout e o comportamento de seus formulários. Ao definir um novo registro do formulário (Configurações > Unified Service Desk > Formulários > Novo), você especifica seu XAML no campo Marcação do registro do formulário para definir o layout.

Criar um formulário usando XAML

Dica

É necessário ter conhecimento prévio do Windows Presentation Foundation (WPF) e do script de XAML para definir o layout e o comportamento do formulário.

Associação de comando para executar ações de UII, chamadas de ação e eventos de notificação

Há comandos do WPF personalizados disponíveis no Unified Service Desk (montagem doMicrosoft.Crm.UnifiedServiceDesk.Dynamics) que podem ser associados aos controles do WPF, como botões e hiperlinks na forma de XAML para serem hospedados no controle da notificação. Os comandos podem ser associados aos controles que implementam a interface de ICommandSource.Para obter mais informações:Visão Geral do Comando.

Os comandos podem ser usados para executar ações em qualquer controle hospedado ou acionar eventos do controle de notificação que hospeda o XAML do formulário.

Importante

Os valores do comando mencionados abaixo para serem especificados no XAML do formulário têm o alias de namespace como CCA que deve ser definido no elemento-raiz do XAML, como segue:

xmlns:CCA="clr-namespace:Microsoft.Crm.UnifiedServiceDesk.Dynamics;assembly=Microsoft.Crm.UnifiedServiceDesk.Dynamics"

  • ação de UII: Para executar uma ação UII do XAML do formulário, especifique os seguintes valores para Command e CommandParameter.

    • Command
      CCA:ActionCommands.DoActionCommand

    • CommandParameter
      O parâmetro do comando deve conter o nome do controle hospedado no qual a ação deve ser executada, o nome da ação da UII e os dados da ação opcional. Todos esses valores devem ser especificados no seguinte formato de URL: http://uii/[HostedControlName]/[UIIActionName]?[ActionData].

      Observe que as diferentes partes do URL devem ser codificadas, se necessário, conforme as diretrizes padrão. Por exemplo, o caractere de espaço deve ser codificado como “%20” ou ‘+’.

    • Exemplo
      Suponha que haja um controle hospedado com o nome Contact do tipo Página CRM e você quer executar a ação Open_CRM_Page neste controle com os seguintes dados da ação:

      LogicalName=contactid=[[contact.Id]]

      Em seguida, você precisa informar o seguinte URL como o valor do CommandParameter em seu XAML do formulário:

      http://uii/Contact/Open_CRM_Page?LogicalName%3Dcontact%0D%0Aid%3D%5B%5Bcontact.Id%5D%5D

      Além de associar o comando com um botão, clique no XAML do formulário, como segue:

      <Button Command="CCA:ActionCommands.DoActionCommand"
CommandParameter="http://uii/Contact/Open_CRM_Page?LogicalName%3Dcontact%0D%0Aid%3D%5B%5Bcontact.Id%5D%5D"

  • Chamada da ação: Serve como uma alternativa para executar uma ação UII em um controle hospedado onde você não quer codificar os dados da ação e colocá-los no XAML. Para executar uma chamada de ação do XAML do formulário, especifique os seguintes valores para Command e CommandParameter.

    • Command
      CCA:ActionCommands.DoActionCommand

    • CommandParameter
      O parâmetro do comando deve conter o nome da chamada da ação a ser executada e deve ser especificado no seguinte formato do URL: http://actioncall/[ActionCallName].

      Observe que o nome da chamada de ação deve ser codificado por URL, se contiver espaços ou caracteres especiais. Por exemplo, o caractere de espaço deve ser codificado como “%20” ou ‘+’.

    • Exemplo
      Suponha que você queira executar uma chamada de ação com o nome Open Contact Page.

      Em seguida, você precisa informar o seguinte URL como o valor do CommandParameter em seu XAML do formulário:

      http://actioncall/Open+Contact+Page

  • Evento: Para executar um evento do XAML do formulário, especifique os seguintes valores para Command e CommandParameter.

    • Command
      CCA:ActionCommands.UIIEvent

    • CommandParameter
      O parâmetro do comando deve conter o nome do evento, opcionalmente seguido por um ponto de interrogação (?) e parâmetros de evento na forma de uma sequência de caracteres de consulta. Cada parâmetro é especificado como um par de "nome = valor", onde nome e valor precisam ser codificados por URL, se necessário. Além disso, os parâmetros devem ser separados usando "&amp;".

      Especifique o parâmetro de comando no seguinte formato:[EventName]?[Name]=[Value]&amp;[Name]=[Value]

    • Exemplo
      Suponha que você queira acionar um evento com o nome OK com os seguintes parâmetros.

      Name1=Value1Name2=My Value

      Em seguida, você precisa informar o seguinte como o valor do CommandParameter em seu XAML do formulário:

      OK?Name1=Value1&amp;Name2=My+Value

Exibir temporizador de contagem nas notificações

Você pode usar o parâmetro TimeoutProperty para exibir um temporizador de contagem para sua mensagem de notificação até que a mensagem seja exibida. O valor do temporizador de um controle de notificação é definido quando você configura a ação para mostrar o controle.Para obter mais informações:Como configurar uma notificação?

Por exemplo, você pode adicionar um elemento de etiqueta no XAML do form que esteja vinculado ao parâmetro TimeoutProperty para exibir a contagem em segundos após a qual a mensagem de notificação será fechada. Por exemplo:

<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 de amostra da notificação

O seguinte XAML de amostra exibe uma notificação com base no número máximo de valores da sessão configurado no parâmetro de substituição de sua instância e exibe uma notificação quando você atinge o limite da sessão.

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

Mostrar notificações usando o controle de Notificação de Pop-up

Usar ações predefinidas para o controle de Popup Notification mostrar, ocultar e fechar uma mensagem de notificação.

Usando a ação Show é possível especificar o nome do formulário a ser exibido, a posição na tela onde você quer que mensagem de notificação seja exibida e a duração de tempo para que a notificação seja exibida.Para obter mais informações:Ações de UII predefinidas.

Usar eventos predefinidos para que o controle de Popup Notification responda as ações do usuário executadas na mensagem de notificação, conforme explicado anteriormente. Você também pode adicionar ações adicionais para um evento que é executado quando o evento ocorre.Para obter mais informações:Eventos predefinidos.

Vários controles de notificação

É possível configurar vários controles de notificação e chamar as ações independentemente umas das outras. Quando várias notificações são mostradas ao mesmo tempo, todas as notificações ficam visíveis na ordem em que foram chamadas. Se duas notificações globais forem configuradas para serem exibidas na mesma posição, a última será colocada na parte superior da notificação anterior. Da mesma forma, se notificações globais ou com base na sessão ou várias notificações com base na sessão forem configuradas para serem exibidas na mesma posição de uma sessão, a última ficará na parte superior da notificação anterior da sessão.

Como configurar uma notificação?

Há grandes etapas para exibir uma notificação:

  1. Criar um registro de Formulário com sua definição de notificação (XAML). Por exemplo, crie um formulário com o XAML de exemplo ilustrado anteriormente e com o seguinte nome: MaxSessionNotificationForm.

  2. Crie um controle de Popup Notification e mantenha-o global. Por exemplo, crie um controle com o seguinte nome: MaxSessionNotificationControl.

  3. Crie uma chamada de ação para exibir a notificação, especificando o nome do formulário para exibir junto com outros parâmetros no campo Dados da ação Show. Por exemplo, crie uma chamada de ação com o seguinte nome: Action Call for Max Sessions Notification:

    Action Call for displaying notification

  4. Finalmente, adicione a chamada de ação a um evento para executar a ação. Como estamos verificando o número máximo de sessões sobre a criação de uma nova sessão para mostrar a notificação, adicione a chamada de ação ao evento SessionNew do Gerenciador global (controle hospedado).

Confira Também

Notificação pop-up (controle hospedado)
Adicionar chamadas de ação a um evento
Introdução à configuração do aplicativo agente

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais