Consultar dados usando pesquisas de entidade 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

Pesquisas de entidade são definições FetchXML que consultam os serviços Web do Microsoft Dynamics 365 para retornar dados. Você também pode usar parâmetros de substituição dentro das consultas FetchXML em uma pesquisa de entidade. Pesquisas de entidades podem ser usadas em regras de navegação de janela como uma origem para acessar os dados que não são exibidos no formulário e como um destino para pesquisar os dados usando uma chamada de serviço web para o Dynamics 365, e depois preencher os dados de contexto do Unified Service Desk de modo que possam ser usados nos parâmetros de substituição. Você também pode usar pesquisas de entidade na ação FazerPesquisa para que o controle hospedado do Gerenciador global procure os dados.

Você define uma pesquisa de entidade na área Pesquisas de entidade (Configurações > Unified Service Desk > Pesquisas de entidade) no Dynamics 365. Para definir uma pesquisa de entidade, você precisa especificar três coisas: um nome, a entidade à qual se aplica a pesquisa e a consulta FetchXML que representa a consulta para recuperar os dados do servidor.

A seguinte consulta FetchXML retorna o nome e detalhes do endereço de uma conta com base em uma ID do cliente disponível de uma ocorrência:

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">
  <entity name="account">
    <attribute name="name" />
    <attribute name="emailaddress1" />
    <attribute name="telephone1" />   
    <attribute name="address1_line1" />
    <attribute name="address1_city" />
    <attribute name="address1_stateorprovince" />
    <attribute name="address1_postalcode" />
   <attribute name="address1_country" />
   <attribute name="msdyusd_facebook"/>
   <attribute name="msdyusd_twitter"/>
    <order attribute="name" descending="false" />
    <filter type="and">
      <condition attribute="accountid" operator="eq" value="{[[incident.customerid.Id]x]}" />
    </filter>
  </entity>
</fetch>

Esta é a aparência da definição de pesquisa de entidade:

Importante

Ao definir consultas FetchXML em uma pesquisa de entidade, você só deve retornar os campos necessários para a finalidade. Isso minimiza o impacto na rede, limitando o tamanho da solicitação e dos dados que são retornados, otimizando, assim, o uso do recurso.

Os desenvolvedores também podem reutilizar uma definição de pesquisa de entidades existente nos códigos para pesquisar registros no Dynamics 365.Para obter mais informações:Reutilizar definição de Pesquisa de Entidade em seu código personalizado

Confira Também

Reutilizar definição de Pesquisa de Entidade em seu código personalizado
Usar regras de navegação de janela no Unified Service Desk
Chamadas de ação
Aprenda a usar o Unified Service Desk
Passo a passo: Usar o adaptador de escuta genérica para o roteamento de eventos CTI

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais