Consulta de datos mediante FetchXML en Dataverse

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

Nota

También puede usar FetchXML para definir vistas para aplicaciones controladas por modelos y algunas funcionalidades de informes. En este artículo no se incluyen elementos y atributos para esos casos de uso. Obtenga más información sobre cómo personalizar vistas de aplicaciones basadas en modelos con código.

Redacción de una consulta FetchXML

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. En el ejemplo siguiente se 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 top atributo , Dataverse devuelve hasta 5000 filas de tablas estándar y 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.

Recuperación de datos con FetchXML

Para obtener los resultados de la consulta, envíe la 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	Tarea
Seleccionar columnas	Especifique qué columnas de datos se deben devolver.
Unir tablas	Especifica qué tablas relacionadas 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	Optimización del rendimiento.

Herramientas de la Comunidad

Hay herramientas gratuitas para redactar y probar solicitudes FetchXML:

• XrmToolboxFetchXmlBuilder
• Power Platform ToolboxFetchXML Studio

Nota

Microsoft no admite herramientas creadas por la comunidad. Si tiene preguntas o problemas con las herramientas de la comunidad, póngase en contacto con el publicador de la herramienta.

Uso de FetchXML como parámetro de mensaje

También puede usar FetchXML como parámetro para las operaciones de Dataverse, como los mensajes siguientes:

Nombre de mensaje	SDK para la clase de solicitud .NET	Operación de API web
BackgroundSendEmail	SolicitudDeEnvíoDeCorreoEnSegundoPlano	Acción BackgroundSendEmail
BulkDetectDuplicates	BulkDetectDuplicatesRequest	BulkDetectDuplicates acción
FullTextSearchKnowledgeArticle	SolicitudDeBusquedaDeTextoCompletoArticuloDeConocimiento	Acción FullTextSearchKnowledgeArticle
FetchXmlToQueryExpression	FetchXmlToQueryExpressionRequest	Función FetchXmlToQueryExpression
SendBulkMail	SendBulkMailRequest	Acción SendBulkMail
Rollup	RollupRequest	Función Rollup

Pasos siguientes

Aprende a seleccionar columnas.

Seleccionar columnas

Obtenga información sobre cómo recuperar datos mediante FetchXML.

Recuperar datos con FetchXml.