Uso di FetchXML per eseguire query sui dati

Completato

FetchXML è un linguaggio di query sviluppato da Microsoft per consentire l'esecuzione di operazioni di query complesse sui dati di Microsoft Dataverse. Fornisce molte più opzioni di filtro rispetto ai connettori OData e consente di vedere le etichette dei dati di riferimento, quali le etichette del set di opzioni o i campi di ricerca.

È possibile eseguire query FetchXML usando i seguenti metodi:

• API Web Dataverse

• Servizio organizzazione

È anche possibile applicare un filtro FetchXML personalizzato a un campo di ricerca in un'app basata su modello. Questo approccio consente scenari di ricerca più complessi che non è facile ottenere in modo predefinito. Per altre informazioni su come completare questo processo, consultare addCustomFilter (riferimento API client).

Query FetchXML di esempio

La seguente query di esempio recupera i campi accountid e name dalla tabella account:

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

Se è necessario filtrare i dati, ad esempio per stato, è possibile eseguire una query simile al seguente esempio:

<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>

Strumenti che semplificano la creazione delle query

Se si eseguono query sui dati ed è presente un'app basata su modello che include le tabelle su cui si desidera eseguire le query, il metodo più semplice per comporre le query FetchXML consiste nell'usare la Ricerca avanzata che contiene la funzione Scarica FetchXML. L'interfaccia utente limita i filtri che è possibile usare e i dati correlati che si possono ottenere, ma spesso è un ottimo punto di partenza per non dover creare il codice XML.

Un altro strumento utile creato dalla community è denominato FetchXML Builder. Con questo strumento è possibile compilare FetchXML in modi che la Ricerca avanzata non può fare (aggregazioni, outer join, query di tipo "non ha" e attributi da entità collegate a più livelli). Fornisce anche numerose altre funzionalità descritte sul relativo sito Web: FetchXML Builder.

Altre risorse

Per ulteriori dettagli sul linguaggio di query FetchXML, consultare la sezione Uso di FetchXML per eseguire query sui dati che illustra diversi argomenti avanzati tra cui la gestione della paginazione, l'esecuzione di query su dati gerarchici e molto altro.