Usar o FetchXML para consultar dados

  • 10 minutos

FetchXML é uma linguagem de consulta que a Microsoft desenvolveu para permitir que você execute operações de consulta complexas em dados do Microsoft Dataverse. Fornece consideravelmente mais opções de filtragem do que os conectores OData e permite ver os rótulos dos dados de referência, como rótulos de conjuntos de opções ou campos de pesquisa.

Você pode executar consultas FetchXML usando os seguintes métodos:

  • API Web do Dataverse

  • Serviço da organização

Também é possível aplicar um filtro personalizado do FetchXML a um campo de pesquisa em um aplicativo baseado em modelo. Essa abordagem permite cenários de pesquisa mais complexos que você não pode realizar imediatamente com facilidade. Para obter mais informações sobre como concluir esse processo, consulte a Referência da API de cliente addCustomFilter.

Exemplo de consulta FetchXML

O exemplo de consulta a seguir recupera os campos accountid e name da tabela de contas:

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
   </entity>
</fetch>

Se você precisar filtrar esses dados, por exemplo, por estado, poderá fazer algo como a seguinte consulta de exemplo:

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
      <filter type='and'>
        <condition attribute='address1_stateorprovince' operator='eq' value='WA' />
      </filter>
   </entity>
</fetch>

Ferramentas para ajudar a criar suas consultas

Se você estiver consultando dados e tiver um aplicativo baseado em modelo que inclua as tabelas que deseja consultar, o método mais simples para compor consultas FetchXML é usar a Localização Avançada, que contém uma função Download FetchXML. Você está limitado à interface do usuário para quais filtros e dados relacionados pode extrair, mas, em geral, é um excelente ponto de partida; portanto, você não precisa criar o XML por conta própria.

Captura de tela da função Download FetchXML na Localização Avançada.

Outra ferramenta notável criada pela comunidade é chamada FetchXML Builder. Com essa ferramenta, você pode criar FetchXML de formas que a Localização Avançada não pode criar (agregações, junções externas, consultas "has no" e atributos de entidades vinculadas de vários níveis). Ela também fornece uma infinidade de outros recursos, que podem ser encontrados no site do FetchXML Builder.

Mais recursos

Para obter mais detalhes sobre a linguagem de consulta FetchXML, examine a seção Usar FetchXML para consultar dados, que abrange vários tópicos avançados, como manipulação de paginação, consulta de dados hierárquicos e muito mais.