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 Nombre lógico de la tabla para configurar el atributo entidad name.
Liminar el número de filas
Para limitar el número de filas devueltas, utilice el atributo elemento de búsqueda top. Sin el atributo top, Dataverse devuelve hasta 5000 filas.
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 Fetch distinct 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.
Aprenda a recuperar datos con FetchXml.
Nota
¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)
La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).