Consultar datos mediante FetchXML

FetchXml es un lenguaje de consulta propio basado en XML que se utiliza para recuperar datos de Dataverse. Consulte referencia de FetchXml para conocer los elementos utilizados para recuperar datos.

Nota

FetchXml también se utiliza para definir vistas para aplicaciones basadas en modelos y algunas capacidades de generación de informes. Los elementos y atributos para esos casos de uso no se incluyen aquí. Obtenga más información sobre cómo personalizar vistas de aplicaciones basadas en modelos con código.

Componer una consulta

Todas las consultas se basan en una sola tabla. El elemento raíz es fetch. Utilice el elemento de entidad para seleccionar la tabla de la que la consulta recupera datos. El siguiente ejemplo representa una consulta FetchXml simple:

<fetch top='5'>
  <entity name='account'>
      <attribute name='name' />
  </entity>
</fetch>

Esta consulta devuelve el Nombre de columna de las primeras cinco filas de la Tabla de cuentas, utilizando el LogicalName de la tabla para configurar el atributo entidadname.

Liminar el número de filas

Para limitar el número de filas devueltas, utilice el atributo elemento de búsquedatop. Sin el atributo top, Dataverse devuelve hasta 5000 filas de tablas estándar, 500 filas de tablas elásticas.

Alternativamente, especifique una cantidad de registros para devolver usando la paginación. No use el atributo top cuando solicita páginas de datos. Aprenda a solicitar resultados paginados

No puede usar top cuando solicita un recuento de filas usando el atributo returntotalrecordcount. Aprender a contar filas

Devolver resultados distintos

Utilice el atributo elemento de Fetchdistinct para solicitar que la consulta excluya cualquier valor duplicado en los resultados.

Si usa el atributo distinct, debe agregar al menos un elemento de orden para tener una paginación consistente.

Cuando utiliza el atributo distinct, los resultados devueltos no incluyen valores de clave principal para cada registro porque representan una agregación de todos los valores distintos.

Recuperar datos

Para obtener resultados de su consulta, debe enviar su solicitud a Dataverse. Aprenda a recuperar datos de Dataverse mediante FetchXml

Refinar la consulta

Después de seleccionar la tabla con la que comenzar la consulta, refine la consulta para obtener los datos que necesita. Los siguientes artículos explican cómo completar su consulta.

Artículo	Task
Seleccionar columnas	Especifique qué columnas de datos se deben devolver.
Unir tablas	Especificar el número de tablas relacionada para devolver en los resultados.
Ordenar filas	Especifique el orden de clasificación de las filas que se deben devolver.
Filtrar filas	Especifique qué filas de datos se deben devolver.
Resultados de página	Especifique cuántas filas de datos se devolverán con cada solicitud.
Agregar datos	Cómo agrupar y agregar los datos devueltos.
Recuento del número de filas	Cómo obtener un recuento del número de filas devueltas.
Optimizaciones del rendimiento	Cómo optimizar el rendimiento

Herramientas de la Comunidad

XrmToolbox FetchXmlBuilder es una herramienta gratuita para componer y probar solicitudes de FetchXml.

Nota

Las herramientas creadas por la comunidad no reciben soporte de Microsoft. Si tiene preguntas o problemas con las herramientas de la comunidad, comuníquese con el creador de la herramienta.

Utilice FetchXml como parámetro de mensaje

También utiliza FetchXml como parámetro para operaciones de Dataverse como los siguientes mensajes:

Nombre de mensaje	SDK para la clase de solicitud .NET	Operación de API web
BackgroundSendEmail	BackgroundSendEmailRequest	Acción BackgroundSendEmail
BulkDetectDuplicates	BulkDetectDuplicatesRequest	Acción BulkDetectDuplicates
FullTextSearchKnowledgeArticle	FullTextSearchKnowledgeArticleRequest	Acción FullTextSearchKnowledgeArticle
FetchXmlToQueryExpression	FetchXmlToQueryExpressionRequest	Función FetchXmlToQueryExpression
SendBulkMail	SendBulkMailRequest	Acción SendBulkMail
Rollup	RollupRequest	Función Rollup

Pasos siguientes

Aprender a seleccionar columnas.

Seleccionar columnas

Aprenda a recuperar datos con FetchXml.

Recuperar datos con FetchXml