Contar filas mediante FetchXml

Utilice el atributo elemento de búsqueda booleano returntotalrecordcount para especificar que el resultado incluya un recuento de todos los registros que cumplen con los criterios del filtro, hasta 5000. Utilícelo cuando recupere resultados paginados para estimar el número total de páginas que se mostrarán.

No puede aplicar el atributo de topelemento de búsqueda junto con returntotalrecordcount.

El comportamiento que puede esperar depende de si utiliza el SDK para .NET o la web API.

SDK para .NET

Cuando el valor del atributo returntotalrecordcount es true, el EntityCollection devuelto por el método RetrieveMultiple incluye valores para las siguientes propiedades:

Property	Description
TotalRecordCount	El número total de registros hasta 5000; de lo contrario, el valor es -1.
TotalRecordCountLimitExceeded	true si los resultados de la consulta exceden el recuento total de registros; de lo contrario, false.

API web

Establecer el valor del atributo returntotalrecordcount en true tiene el mismo resultado que configurar la opción de consulta OData $count . Puede agregar &$count=true a su consulta de FetchXml para obtener los mismos resultados. Obtenga más información sobre la opción de consulta OData $count.

Cuando establece el returntotalrecordcount atributo (o usa la $count opción de consulta), los datos devueltos incluyen la @odata.count anotación con el número total de registros que coinciden con los criterios de filtro, hasta 5000 para tablas estándar y 500 para tablas elásticas.

Si incluye cualquiera de estos encabezados de solicitud:

Prefer: odata.include-annotations="Microsoft.Dynamics.CRM.totalrecordcount,Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded"
   OR for all annotations:
Prefer: odata.include-annotations="*"

Se devolverán las siguientes anotaciones:

Property	Description
@Microsoft.Dynamics.CRM.totalrecordcount	El número total de registros hasta 5000; de lo contrario, el valor es -1. El valor es el mismo que la anotación @odata.count.
@Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded	true si los resultados de la consulta exceden el recuento total de registros; de lo contrario, false.

El valor (TotalRecordCountLimitExceeded o @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) es útil cuando necesita calcular cuántas solicitudes paginadas más necesita enviar para obtener todos los resultados cuando (TotalRecordCount o @Microsoft.Dynamics.CRM.totalrecordcount) es igual al tamaño máximo de página para el tipo de tabla con la que está trabajando.

Si el tamaño de su página es menor que el máximo y (TotalRecordCount o @Microsoft.Dynamics.CRM.totalrecordcount) es igual o menor que el máximo, puede calcular cuántas solicitudes paginadas más debe enviar para obtener todos los registros.

Cuando (TotalRecordCountLimitExceeded o @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) es true y (TotalRecordCount o @Microsoft.Dynamics.CRM.totalrecordcount) es igual al máximo, no se puede realizar este cálculo.

Propina

Si desea obtener un recuento total de registros sin filtro, use el mensaje RetrieveTotalRecordCount con la API web función RetrieveTotalRecordCount o con la clase de SDK para .NET RetrieveTotalRecordCountRequest. Los datos recuperados serán de una instantánea dentro de las últimas 24 horas.

Pasos siguientes

Aprenda a optimizar el rendimiento.

Optimizar el rendimiento