Passo a passo 4: Exibir um registro do Microsoft Dynamics 365 em uma sessão no aplicativo agente 

Publicado: novembro de 2016

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

Este passo a passo demonstra como exibir registros Microsoft Dynamics 365 em uma sessão no aplicativo do agente, usando regras de navegação de janela e controles de sessão no Unified Service Desk. Ele também demonstra o uso de parâmetros de substituição para exibir dinamicamente o nome do controle hospedado, com base no registro da conta exibido no momento. Este passo a passo aprimora o passo a passo anterior, Passo a passo 3: Exibir registros do Microsoft Dynamics 365 no aplicativo agente, para exibir um registro de conta em uma sessão, ao clicar em uma das contas na janela de resultados da pesquisa Conta.

Pré-requisitos

Neste Passo a Passo

Etapa 1: Crie um controle hospedado definido no escopo da sessão para exibir o registro da conta em uma sessão

Etapa 2: Configure o evento para fechar o controle hospedado a partir do local de origem da pesquisa

Etapa 3: Crie um controle hospedado Guias da sessão

Etapa 4: Crie uma regra de navegação de janela para exibir o registro da conta em uma sessão

Etapa 5: Adicione os controles na configuração

Etapa 6: Teste o aplicativo

Conclusão

Etapa 1: Crie um controle hospedado definido no escopo da sessão para exibir o registro da conta em uma sessão

Nesta etapa, você criará um controle hospedado definido no escopo da sessão para exibir um registro da conta em uma sessão.

  1. Entre no Microsoft Dynamics 365.

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

  3. Clique em Controles hospedados.

  4. Clique em Novo.

  5. Na página Novo Controle Hospedado, especifique os seguintes valores.

    Campo

    Valor

    Nome

    Sessão de conta do Contoso

    Nome para Exibição

    [[account.name]]

    Observação

    Usaremos um parâmetro de substituição para exibir dinamicamente o nome da conta selecionada como o nome de exibição do controle hospedado.

    Tipo de Componente do USD

    Página do Dynamics 365

    Permitir Várias Páginas

    Não

    Tipo de Hospedagem

    WPF Interno

    O Aplicativo é Global

    Não verificado

    Observação

    Isso garante que o controle hospedado esteja definido no escopo da sessão, ou seja, somente seja exibido em uma sessão.

    Grupo de Exibição

    MainPanel

    Criar um controle hospedado com foco na sessão

  6. Clique em Salvar.

Etapa 2: Configure o evento para fechar o controle hospedado a partir do local de origem da pesquisa

Nesta etapa, será configurado o evento NavegadorDocumentoCompleto no controle hospedado Sessão de conta do Contoso para que, quando ele for carregado, o controle hospedado pai onde o usuário clicou para abrir a conta, Pesquisa de contas do Contoso, seja fechado. O controle hospedado Sessão de conta do Contoso foi criado em Passo a passo 3: Exibir registros do Microsoft Dynamics 365 no aplicativo agente. Isso é feito para garantir que o usuário não possa abrir outras informações de contas na mesma guia da sessão.

  1. Na barra de navegação, clique na seta para baixo ao lado do controle hospedado Sessão de conta do Contoso e clique em Eventos.

    Configurar eventos para um controle hospedado

  2. Na página de eventos, clique em BrowserDocumentoCompleto.

  3. Na página BrowserDocumentoCompleto, clique em + na área Ações ativas para adicionar uma chamada de ação para o evento.

  4. Na caixa de pesquisa, clique no ícone de pesquisa ou pressione ENTER e clique em Novo no canto inferior direito da caixa de resultados da pesquisa.

    Adicionar uma chamada de ação a um evento

  5. Na página Nova chamada de ação, especifique os seguintes valores.

    Campo

    Valor

    Nome

    Chamada de ação do Contoso: Fechar pesquisa de contas

    Controle Hospedado

    Pesquisa de conta do Contoso

    Ação

    Fechar

    Criar uma nova chamada de ação no Unified Service Desk

  6. Clique em Salvar, para incluir a chamada de ação no evento NavegadorDocumentoCompleto.

Etapa 3: Crie um controle hospedado Guias da sessão

Para exibir registros em sessões no aplicativo do agente, uma instância do tipo de controle hospedado Guias da sessão deve ser configurada no aplicativo do agente.

  1. Na página de controles hospedados, clique em Novo.

  2. Na página Novo controle hospedado, especifique os seguintes valores.

    Campo

    Valor

    Nome

    Guia da sessão Contoso

    Tipo de Componente do USD

    Guias da sessão

    Crie um controle hospedado Guias da sessão

  3. Clique em Salvar.

Etapa 4: Crie uma regra de navegação de janela para exibir o registro da conta em uma sessão

Nessa etapa, será criada uma regra de navegação de janela que exiba o registro em uma sessão quando o usuário clicar em alguma das contas na janela de resultados de pesquisa.

  1. Entre no Microsoft Dynamics 365.

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

  3. Clique em Regras de Navegação da Janela.

  4. Clique em Novo.

  5. Na página Nova regra de navegação da janela, especifique os seguintes valores:

    Campo

    Valor

    Nome

    Regra de sessão de conta do Contoso

    Pedido

    5

    De

    Pesquisa de contas do Contoso

    Entidade

    conta

    Tipo de rota

    Pop-up

    Destino

    Tabulação

    Ação

    Criar sessão

    Guia de destino

    Sessão de conta do Contoso

    Mostrar guia

    Sessão de conta do Contoso

    Ocultar barra de comandos

    Não

    Ocultar barra de navegação

    Sim

    Criar uma regra de navegação da janela

  6. Clique em Salvar.

Etapa 5: Adicione os controles na configuração

Nesta etapa, adicione a chamada de ação, o evento, os controles hospedados e a regra de navegação de janela configurados neste passo a passo na Configuração do Contoso para exibir esses controles ao usuário atribuído à configuração. A Configuração do Contoso foi criada no Passo a passo 1: Criar um aplicativo agente simples.

Adicione o seguinte na Configuração do Contoso.

Nome do controle

Tipo de controle

Chamada de ação do Contoso: Fechar pesquisa de contas

Chamada de ação

BrowserDocumentComplete

Evento para o controle hospedado Sessão da conta do Contoso

Sessão de conta do Contoso

Controle Hospedado

Guia da sessão Contoso

Controle Hospedado

Regra de sessão de conta do Contoso

Regras de navegação da janela

Para adicionar um controle na configuração:

  1. Entre no Microsoft Dynamics 365.

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

  3. Clique em Configuração.

  4. Clique em Configuração do Contoso para abrir a definição.

  5. Na barra de navegação, clique na seta para baixo ao lado de Configuração do Contoso e selecione Chamadas de ação.

  6. Na página seguinte, clique em Adicionar chamada de ação existente, digite “Contoso Action Call: Close Accounts Search” na barra de pesquisa e, em seguida, pressione ENTER ou clique no ícone de pesquisa.

  7. Na caixa de resultados de pesquisa, clique na chamada de ação para adicioná-la na Configuração do Contoso.

  8. Da mesma forma, adicione o evento, os controles hospedados e a regra de navegação de janela, clicando na seta para baixo ao lado de Configuração Contoso e, em seguida, clicando em EventosControles hospedados e Regras de navegação de janela, respectivamente.

  9. Clique em Salvar.

Etapa 6: Teste o aplicativo

  1. Inicie o aplicativo cliente Unified Service Desk e conecte-se à instância do Dynamics 365 na qual a Unified Service Desk foi configurada, usando as mesmas credenciais do usuário atribuídas à Configuração do Contoso no Passo a passo 1: Criar um aplicativo agente simples. Para obter informações sobre como se conectar à instância Dynamics 365 usando o aplicativo cliente Unified Service Desk, consulte TechNet: Conectar-se à instância do CRM usando o cliente do Unified Service Desk

  2. Para exibir os registros da conta a partir da instância do Dynamics 365, clique na seta para baixo ao lado do botão Pesquisar na barra de ferramentas e, em seguida, clique em Conta.

  3. Clique em algum dos registros de conta para exibir as respectivas informações da conta em uma sessão. As informações serão exibidas em uma guia da sessão. Observe que o nome da guia do controle hospedado que contém o registro da conta exibe automaticamente o nome da conta, porque anteriormente foram usados parâmetros de substituição para exibir dinamicamente o nome da conta atual em vez de um valor estático.

    Registro da conta exibido em uma sessão

  4. Se outro registro da conta for aberto, ele será exibido em outra sessão no aplicativo cliente. Para abrir outra conta, clique na seta para baixo ao lado do botão Pesquisar, clique em Conta e, em seguida, clique em um nome da conta para exibir as informações da conta em outra sessão.

    Várias sessões no Unified Service Desk

Conclusão

Neste passo a passo, foi demonstrado como usar o controle hospedado de sessão e as regras de navegação de sessão para exibir registros do Dynamics 365 em uma sessão no aplicativo do agente. Você também aprendeu como filtrar acesso aos controles Unified Service Desk com a configuração.

Observação

Execute o próximo passo a passo para apresentar informações de sessão aprimoradas no aplicativo do agente: Passo a passo 5: Exibir informações avançadas da sessão, com o nome da sessão e os dados de visão geral.

Confira Também

Passo a passo 1: Criar um aplicativo agente simples
Passo a passo 2: Exibir uma página Web externa no aplicativo agente
Passo a passo 3: Exibir registros do Microsoft Dynamics 365 no aplicativo agente
Passo a passo 6: Configurar o controle hospedado do Depurador no aplicativo agente.
Passo a passo 7: Configurar o script do agente no aplicativo agente
Passo a passo da configuração do Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais