Passo a passo 3: Exibir registros do Microsoft Dynamics 365 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 os registros de Microsoft Dynamics 365 no aplicativo agente. Neste passo a passo, você exibirá todos os registros de conta e contato na instância Dynamics 365. Você também criará um botão de pesquisa com os itens do menu suspenso para exibir as contas e os contatos no aplicativo agente.

Pré-requisitos

• É necessário ter concluído o Passo a passo 1: Criar um aplicativo agente simples. As configurações concluídas no passo a passo 1 serão necessárias para este.

• Este passo a passo assume que você usará as mesmas credenciais de usuário usadas no passo a passo 1 para conectar-se ao aplicativo agente no final do passo a passo para testar o aplicativo. Para que um usuário diferente teste o aplicativo, você deverá atribuir a Configuração do Contoso ao usuário.Para obter mais informações:Passo a passo 1: Criar um aplicativo agente simples

• É necessário saber o seguinte no Unified Service Desk:

  • Os seguintes dois tipos de controles hospedados: Página do Dynamics 365 e Contêiner da Barra de Ferramentas.Para obter mais informações:Tipos de controle hospedado e referência de ação/evento

  • Chamada de ação e como configurá-la.Para obter mais informações:Chamadas de ação

  • Acesso de filtro usando a configuração do Unified Service Desk.Para obter mais informações:TechNet: Gerenciar acesso usando a configuração do Unified Service Desk

Neste Passo a Passo

Passo 1: Criar o tipo da Página do Dynamics 365 de controles hospedados para exibir os registros de conta e contato

Passo 2: Criar um tipo de contêiner de barra de ferramentas do controle hospedado

Passo 3: Adicionar uma barra de ferramentas e a anexá-la ao contêiner da barra de ferramentas

Passo 4: Adicionar botões da barra de ferramentas e chamadas de ação para exibir os registros do Dynamics 365.

Etapa 5: Adicione os controles na configuração

Etapa 6: Teste o aplicativo

Conclusão

Passo 1: Criar o tipo da Página do Dynamics 365 de controles hospedados para exibir os registros de conta e contato

Neste passo, você criará dois controles hospedados do tipo da Dynamics 365 Página para exibir os registros da conta e do contato, respectivamente.

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	Pesquisa de contas do Contoso
   Nome para exibição	Contoso: Contas
   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	Verificado
   Grupo de Exibição	MainPanel

   

6. Clique em Salvar.

7. Clique em Novo para criar outro controle hospedado para exibir os registros do contato.

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

   Campo	Valor
   Nome	Pesquisa de Contados do Contoso
   Nome para exibição	Contoso: Contatos
   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	Verificado
   Grupo de Exibição	MainPanel

   

9. Clique em Salvar.

Passo 2: Criar um tipo de contêiner de barra de ferramentas do controle hospedado

Os tipos de Contêiner de Barra de Ferramentas dos controles hospedados são usados para conter e exibir as barras de ferramentas do Unified Service Desk. Nesta seção, você criará um controle hospedado Contêiner da Barra de Ferramentas que aparecerá acima do aplicativo cliente.

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	Contêiner da Barra de Ferramentas do Contoso
   Tipo de Componente do USD	Contêiner da Barra de Ferramentas
   Grupo de Exibição	ToolbarPanel

   

6. Clique em Salvar.

Passo 3: Adicionar uma barra de ferramentas e a anexá-la ao contêiner da barra de ferramentas

Nesta etapa, você criará uma barra de ferramentas e anexará a barra de ferramentas ao controle hospedado de contêiner de barra de ferramentas na etapa 2. Isso é feito para exibir a barra de ferramentas em seu aplicativo agente.

1. Entre no Microsoft Dynamics 365.

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

3. Clique em Barras de Ferramentas.

4. Clique em Novo.

5. Na página Nova Barra de Ferramentas, digite Barra de Ferramentas Principal do Contoso, na caixa Nome e clique em Salvar.

6. Anexe a barra de ferramentas ao controle hospedado do contêiner da barra de ferramentas criado na etapa 2. Na barra de navegação, clique na seta para baixo ao lado de Barra de ferramentas principal do Contoso e clique em Controles hospedados.

7. Na página seguinte, clique em Adicionar Controle Hospedado Existente, digite Contoso Main Toolbar Container na barra de pesquisa e, em seguida, pressione ENTER ou clique no ícone de pesquisa.

8. No resultado da pesquisa, clique em Contêiner da Barra de Ferramentas Principal do Contoso para adicioná-lo.

9. Clique em Salvar.

Passo 4: Adicionar botões da barra de ferramentas e chamadas de ação para exibir os registros do Dynamics 365.

Nesta etapa, você adicionará botões à barra de ferramentas e anexará chamadas de ação aos botões para que, quando clicarem no botão, registros de Dynamics 365 apropriados sejam exibidos nos controles hospedados que foram criados na etapa 1. Você configurará o botão de pesquisa para que ao clicar no botão ele exiba a conta e os itens de submenu de contato, e ao clicar no botão ele exiba os registros de Dynamics 365 respectivos.

1. Depois de salvar a barra de ferramentas no passo 3, a área Botões fica disponível. Na área Botões, clique em + no canto direito para adicionar um botão.

2. Na página Novo Botão da Barra de Ferramentas, especifique os seguintes valores:

   Campo	Valor
   Nome	Botão de Pesquisa do Contoso
   Texto do Botão	PESQUISAR
   Dica de ferramenta	Pesquise contas e contatos Dynamics 365
   Pedido	1

   

3. Clique em Salvar.

4. Na barra de navegação, clique na seta para baixo ao lado do Botão de Pesquisa do Contoso e clique em Botões da Barra de Ferramentas.

   Dica

   Agora você está adicionando botões secundários da barra de ferramentas a um botão da barra de ferramentas já existente para criar uma estrutura de submenu.

5. Na página seguinte, clique em Adicionar Novo Botão da Barra de Ferramentas.

6. Na página Novo botão da barra de ferramentas, especifique os seguintes valores.

   Campo	Valor
   Nome	Botão de Pesquisa de conta do Contoso
   Texto do Botão	Conta
   Pedido	1 Dica O campo Ordem define a posição dos botões na barra de ferramentas. Os botões são organizados da esquerda para a direita ou de cima para baixo em ordem crescente.

   

7. Clique em Salvar.

8. Agora, você adicionará duas chamadas de ação: a primeira para exibir os registros das contas no controle hospedado criados no passo 1 e a segunda no controle hospedado do Gerenciador Global do Contoso para exibir o controle hospedado da conta.

   Na área Ações, clique em + no canto direito para adicionar uma chamada de ação.

9. Na caixa de pesquisa na área Ações, pressione ENTER ou clique no ícone de pesquisa.

10. Na caixa resultados da pesquisa, clique em Nova no canto direito inferior para criar uma chamada de ação para este botão da barra de ferramentas.

    

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

    Campo	Valor
    Nome	Chamada de Ação do Contoso: Conta de Pesquisa
    Pedido	1
    Controle Hospedado	Pesquisa de contas do Contoso
    Ação	Encontrar
    Dados	conta

    

12. Clique em Salvar. A nova chamada de ação é adicionada ao botão Botão de Pesquisa de conta do Contoso.

13. Adicione outra chamada de ação no botão para definir o foco no controle hospedado que exibe os registros da conta no aplicativo cliente. Na área Ações, clique em + no canto direito para adicionar uma chamada de ação.

14. Na caixa resultados da pesquisa, clique em Nova no canto direito inferior para criar uma chamada de ação para este botão da barra de ferramentas.

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

    Campo	Valor
    Nome	Chamada de Ação do Contoso: Exibir Pesquisa de Conta
    Pedido	2
    Controle Hospedado	Gerenciador Global do Contoso
    Ação	ShowTab
    Dados	Pesquisa de contas do Contoso

    

16. Clique em Salvar. A nova chamada de ação é adicionada ao botão Botão de Pesquisa de conta do Contoso.

17. Navegue até o botão da barra de ferramentas Botão de Pesquisa do Contoso para adicionar um botão secundário para pesquisar e exibir os contatos. Na barra de navegação, clique na seta para baixo ao lado do Botão de Pesquisa do Contoso e selecione Botões da Barra de Ferramentas.

18. Na página seguinte, clique em Adicionar Novo Botão da Barra de Ferramentas.

19. Na página Novo Botão da Barra de Ferramentas, especifique os seguintes valores:

    Campo	Valor
    Nome	Botão de Pesquisa de contato do Contoso
    Texto do Botão	Contato
    Pedido	2 Dica O campo Ordem define a posição dos botões na barra de ferramentas. Os botões são organizados da esquerda para a direita ou de cima para baixo em ordem crescente.

    

20. Clique em Salvar.

21. Agora, você adicionará duas chamadas de ação: a primeira para exibir os registros de contato no controle hospedado criados no passo 1 e a segunda no controle hospedado do Gerenciador Global do Contoso para exibir o controle hospedado dos contatos.

    Na área Ações, clique em + no canto direito para adicionar uma chamada de ação.

22. Na caixa de pesquisa na área Ações, pressione ENTER ou clique no ícone de pesquisa.

23. Na caixa resultados da pesquisa, clique em Nova no canto direito inferior para criar uma chamada de ação para este botão da barra de ferramentas.

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

    Campo	Valor
    Nome	Chamada de Ação do Contoso: Contato
    Pedido	1
    Controle Hospedado	Pesquisa de Contados do Contoso
    Ação	Encontrar
    Dados	contato

    

25. Clique em Salvar. A nova chamada de ação é adicionada ao botão da barra de ferramentas Botão de Pesquisa de contato do Contoso.

26. Adicione outra chamada de ação no botão para definir o foco no controle hospedado que exibe os registros dos contatos no aplicativo cliente. Na área Ações, clique em + no canto direito para adicionar uma chamada de ação.

27. Na caixa resultados da pesquisa, clique em Nova no canto direito inferior para criar uma chamada de ação para este botão da barra de ferramentas.

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

    Campo	Valor
    Nome	Chamada de Ação do Contoso: Exibir Pesquisa de Contatos
    Pedido	2
    Controle Hospedado	Gerenciador Global do Contoso
    Ação	ShowTab
    Dados	Pesquisa de Contados do Contoso

    

29. Clique em Salvar. A nova chamada de ação é adicionada ao botão da barra de ferramentas Botão de Pesquisa de contato do Contoso.

Etapa 5: Adicione os controles na configuração

Neste passo, você adicionará as chamadas de ação, os controles hospedados e barra de ferramentas criados 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: Conta de Pesquisa	Chamada de Ação
Chamada de Ação do Contoso: Exibir Pesquisa de Conta	Chamada de Ação
Chamada de Ação do Contoso: Contato	Chamada de Ação
Chamada de Ação do Contoso: Exibir Pesquisa de Contatos	Chamada de Ação
Pesquisa de contas do Contoso	Controle Hospedado
Pesquisa de Contados do Contoso	Controle Hospedado
Contêiner da Barra de Ferramentas do Contoso	Controle Hospedado
Barra de Ferramentas Principal do Contoso.	Barra de Ferramentas

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 próxima página, clique em Adicionar chamada de ação existente, digite “Contoso Action Call” na barra de pesquisa e pressione ENTER ou clique no ícone de pesquisa.

7. As chamadas de ação listadas anteriormente são exibidas nos resultados da pesquisa. Adicione essas chamadas de ação.

8. Da mesma forma, adicione os controles hospedados e a barra de ferramentas, clicando na seta para baixo ao lado de Configuração do Contoso e clicando em Controles Hospedados e em Barras de Ferramentas, respectivamente.

9. Clique em Salvar.

Etapa 6: Teste o aplicativo

Inicie o aplicativo cliente Unified Service Desk e conecte-se à instância do Dynamics 365 na qual o Unified Service Desk foi configurado, usando as mesmas credenciais do usuário que foram 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

O agente do aplicativo agora terá um botão PESQUISAR na área da barra de ferramentas, com dois botões secundários (Conta e Contato) exibidos ao clicar na seta para baixo.

Clique em Conta ou Contato no botão PESQUISAR para exibir os respectivos registros da instância Dynamics 365 em guias separadas no aplicativo cliente Unified Service Desk.

Conclusão

Neste passo a passo, você aprendeu como exibir registros do Dynamics 365 no aplicativo cliente Unified Service Desk. Você também aprendeu como filtrar acesso aos controles Unified Service Desk com a configuração.

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 4: Exibir um registro do Microsoft Dynamics 365 em uma sessão no aplicativo 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
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