Share via

Configurar informações de sessão

  • Artigo

 

Publicado: novembro de 2016

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

As informações da sessão são exibidas nas guias em Unified Service Desk duas áreas: nome da guia da sessão e visão geral de sessão. Para uma visão geral, consulte: Gerenciamento de sessão no Unified Service Desk. Você pode configurar o formato das informações exibidas no nome da guia e visão geral da sessão ao criar regras de linha da sessão apropriadas.

Neste tópico

Configure o formato do nome da guia da sessão

Defina as informações de visão geral da sessão

Defina as informações de visão geral da sessão com scriptlets

Exibindo alertas nas informações de visão geral da sessão

Configure o formato do nome da guia da sessão

  1. Entre no Microsoft Dynamics 365.

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

  3. Clique em Linhas de Sessão.

  4. Na nova página Novas Informações de Sessão:

    1. Digite um valor inteiro (100, por exemplo) no campo Pedido para garantir que a regra seja executada no pedido apropriado.

    2. No campo Nome, digite um nome representativo.

    3. No campo Entidade Selecionada, digite o nome da entidade para a qual a guia de sessão será exibida.

    4. Selecione Nome da Sessão na lista suspensa Tipo.

    5. No campo Exibição, digite o formato de exibição da guia. Nesse caso, queremos exibir o nome da conta seguida por um traço e o nome do contato primário da conta. Digite o seguinte valor: [[account.name]] [[- account.address1_primarycontactname]].

      Configure o nome da guia da sessão

      Como alternativa, você também pode usar parâmetros de substituição para extrair valores em tempo de execução e exibir dinamicamente o nome da guia. Por exemplo, para exibir o nome da conta seguida por um traço e terminada com o nome da atividade que iniciou a sessão (como a chat ou telefonema). Digite o seguinte valor: [[account.name]]-[[$Context.InitialEntity]].

      Dica

      Se todos os valores de substituição tiverem valores compatíveis no conjunto de dados, será usada a regra e o sistema interromperá a procura por regras subsequentes. Se um ou mais valores não puderem ser substituídos, porque os dados não existem, a regra falhará e o sistema tentará a próxima ordem de regra no campo Ordem (selecionada em ordem crescente).

      No exemplo anterior, [[account.name]] estará procurando pelo campo de nome de uma entidade de conta carregada em algum lugar da sessão atual. Como utilizamos a versão em minúscula de "conta" que corresponde ao nome da entidade em Dynamics 365, significa que está procurando a última página da conta carregada, independente da guia em que foi carregada. Assim, se você carregar uma subconta e as regras acabarem carregando-a em uma guia de subconta (exibindo, assim, a conta primária na guia da Conta e a subconta na guia Subconta), o nome da conta será aquele da subconta. Isso acontece porque a subconta é carregada depois da guia Conta. Se desejar sempre usar o nome da conta que será exibida na guia Conta, use o seguinte: [[Account.name]].

      O valor [[$Context.InitialEntity]] é substituído em tempo de execução pela variável do contexto InitialEntity. É uma variável de contexto especial preenchida pelo sistema com o nome da entidade usado para iniciar a sessão.

  5. Clique em Salvar.

Defina as informações de visão geral da sessão

  1. Entre no Microsoft Dynamics 365.

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

  3. Clique em Linhas de Sessão.

  4. Na página Novas Informações de Sessão,

    1. Digite um valor inteiro (100, por exemplo) no campo Pedido para garantir que a regra seja executada no pedido apropriado.

    2. No campo Nome, digite um nome representativo.

    3. No campo Entidade Selecionada, digite o nome da entidade com as informações de visão geral da sessão.

    4. Selecione Linha de Visão Geral da Sessão na lista suspensa Tipo.

    5. No campo Exibição, especifique o script XAML que define o layout e o conteúdo da área de visão geral. Você pode usar ferramentas de designer como Blend for Visual Studio para criar e desenvolver o script XAML e copiá-lo nesse campo. O script XAML deve ser formatado de forma adequada para ser exibido corretamente no Unified Service Desk.

      Configurar visão geral da sessão

  5. Clique em Salvar.

Defina as informações de visão geral da sessão com scriptlets

Para desenvolvedores familiarizados com JavaScript, você pode usar scriptlets para exibir as informações de visão geral da sessão. Por exemplo:

  1. É possível criar um scriptlet, digamos Endereço de Saída, que aceite todos os valores de endereço.

  2. Com o JavaScript, você pode usar as funções da cadeia de caracteres para realizar a concatenação da cadeia de caracteres para gerar a saída desejada.

  3. No XAML para a definição das informações de visão geral da sessão, use o seguinte parâmetro de substituição:

    [[script.Address Output]]

Em tempo de execução, isso dispara a execução do scriptlet que formata a saída de endereço como especificada. Se o scriptlet gerar uma exceção, a regra será ignorada. Este é normalmente o método preferido quando o estilo AutoCollapse não é suficiente para ocultar marcações relacionadas na saída conforme necessário. O parâmetro de substituição também pode gerar XAML, que será substituído antes que o processador XAML interprete o resultado final.

Exibindo alertas nas informações de visão geral da sessão

Os alertas são notificações ao usuário sobre informações importantes relacionadas ao cliente. Um sistema de alerta básico está incluído no mecanismo de informações da sessão. As linhas da sessão são avaliadas e exibidas quando todos os parâmetros de substituição são substituídos e os scriptlets não geram exceções. Com essas informações, é possível exibir linhas opcionais de saída na área de visão geral da sessão da tela com base na existência ou seleções de entidades ou valores de pesquisa da entidade. Use os scriptlets para testar valores específicos e retornar um valor se deseja que o alerta seja exibido ou gerar uma exceção se não quiser.

Veja um exemplo de scriptlet que verifica se o crédito da conta carregada está suspenso.

Scriptlet do exemplo no Unified Service Desk

Observe que a propriedade creditonhold verifica a existência da conta. Se o valor for true, ela retorna true, caso contrário será gerada uma exceção. A seguir, uma linha de visão geral da sessão que exibe uma caixa de texto e um botão (meu alerta) se o valor for true.

Alertas de exibição no Unified Service Desk

Observe o comando realçado. Esta é uma coluna oculta para o usuário. Em vez disso, o parâmetro de substituição fará com que a linha de visão geral da sessão seja exibida ou ignorada. Se o scriptlet Verificação do Crédito Suspenso gerar uma exceção, o sistema não exibirá os elementos da Informações da Sessão. Agora que temos a condição que decide quando mostrar o alerta, vamos nos focar no botão e em alguns recursos interessantes.

Como não há um code-behind para esse XAML, nos aproveitamos de outro recurso XAML, o Comandos. Há um comando especial definido em Unified Service Desk, “USD:ActionCommands.DoActionCommand”. Esse comando é criado para chamar uma ação User Interface Integration (UII) em qualquer aplicativo na sessão em execução dos agentes. O CommandParameter é uma chamada URL de ação codificada, no seguinte formato.

http://uii/[UII Hosted Application]/[Action]?[Parameter]

A ação deve ser configurada como uma ação de UII para o aplicativo hospedado UII especificado. O botão no aplicativo chama a ação GotoTask no aplicativo AgentScripting e repassa "Bem-vindo" como o parâmetro. Para o aplicativo AgentScripting, a chamada localiza a tarefa com o nome “Bem-vindo” e pula para a tarefa, exibindo um novo script do agente.

A origem da imagem usa um carregador especial de imagem definido em Unified Service Desk chamado CRMImageLoader e deve ser definida nos recursos da Grade.

Agora quando você especificar uma expressão de associação, será possível especificar a origem como um nome do recurso da imagem. Isso faz com que Unified Service Desk carregue a imagem a partir dos recursos da Web em Dynamics 365 mostre-a no botão. Com esse método, é possível consultar recursos do Dynamics 365 no Windows Presentation Foundation (WPF) (WPF) que está na visão geral da sessão. Também é possível especificar um URL inseguro para a origem da imagem. Especificar a imagem Dynamics 365através do URL não funciona, pois é necessária uma autenticação com o servidor para fins de acesso. Os componentes do WPF não são autenticados com o URL quando tenta carregar componentes.

Confira Também

Gerenciamento de sessão no Unified Service Desk
Executar scripts usando scriptlets no Unified Service Desk
Passo a passo da configuração do Unified Service Desk
Configurar o aplicativo agente usando o Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais