Usar FetchXML para consultar datos

  • 10 minutos

FetchXML es un lenguaje de consulta que Microsoft desarrolló para permitirle realizar operaciones de consulta complejas con datos de Microsoft Dataverse. Proporciona considerablemente más opciones de filtrado que los conectores OData y le permite ver las etiquetas de los datos de referencia, como las etiquetas del conjunto de opciones o los campos de búsqueda.

Puede ejecutar consultas FetchXML con los siguientes métodos:

  • API web de Dataverse

  • Servicio de organización

También puede aplicar un filtro FetchXML personalizado a un campo de búsqueda en una aplicación basada en modelo. Este enfoque permite escenarios de búsqueda más complejos que no pueden lograrse fácilmente desde el primer momento. Para obtener más información sobre cómo completar este proceso, consulte la publicación Referencia de la API de cliente addCustomFilter.

Consultas de ejemplo de FetchXML

La siguiente consulta de ejemplo recupera los campos accountid y name de la tabla de la cuenta:

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

Si necesita filtrar estos datos, por ejemplo, por estado, puede hacerlo como en la siguiente consulta de ejemplo:

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

Herramientas para ayudarle a crear consultas

Si está consultando datos y tiene una aplicación basada en modelo que incluye las tablas que desea consultar, el método más simple para la composición de consultas FetchXML es utilizar Búsqueda avanzada, que contiene una función Descargar FetchXML. Está limitado a la interfaz de usuario en cuanto a los filtros y los datos relacionados que puede extraer, pero con frecuencia es un excelente primer paso para no tener que componer el XML usted mismo.

Captura de pantalla de Descargar FetchXML en Búsqueda avanzada

Otra herramienta notable creada por la comunidad se llama FetchXML Builder. Con esta herramienta, puede crear FetchXML de formas que la Búsqueda avanzada no puede (agregados, combinaciones externas, consultas "no tiene" y atributos de entidades vinculadas de varios niveles). También proporciona una gran cantidad de otras características, que puede encontrar en el sitio web FetchXML Builder.

Más recursos

Para obtener más detalles en profundidad sobre el lenguaje de consulta de FetchXML, revise la sección Usar FetchXML para consultar datos, que abarca varios temas avanzados, como el control de la paginación, la consulta de datos jerárquicos y mucho más.