Consultas con List

XxxD.List(client) es la forma de leer las filas de una sección desde .NET. Encadenas un filtro por campo, con su tipo, y terminas con una lectura que dice cuántas filas esperas.

using static DemoUp.MyDinaup.SectionsD;

// Un listado: los 50 expedientes más recientes de un cliente.
var expedientes = await ExpedientesD.List(client)
    .ReferenciaClienteIDIs(clienteId)
    .OrderByDescending(ExpedientesD.ExpedientesES.FechaDato_UTC)
    .ReadUpToAsync(50);

// Un cálculo: todos los impuestos. Si hay más de 200, lanza.
var impuestos = await ImpuestosD.List(client).ReadAllAsync(maxRows: 200);

Los nombres salen de tu esquema: ExpedientesD y ReferenciaClienteIDIs son un ejemplo. Los tuyos están en tu paquete MyDinaup.

Antes de empezarCopiar el enlace a este apartado

• Un DinaupClientC conectado: Cliente Dinaup.
• Tu paquete {Empresa}.MyDinaup generado con una versión reciente: trae List en cada sección.

Cómo termina una consultaCopiar el enlace a este apartado

Toda consulta acaba en una de estas lecturas. El nombre dice qué pasa si hay más filas de las que pides.

• ReadAllAsync() y CountAsync() sin número cuentan hasta 10.000. Ninguna lectura pide más de 1.000.000.
• Desde el 80 % de maxRows, la lectura deja un aviso en el log con el método que lee. Sube el número o estrecha el filtro antes de que lance.
• Si ReadAllAsync lanza por el tope, no la cambies por ReadUpToAsync: faltaría una fila sin que nadie lo vea.
• El servidor devuelve 2.000 filas por petición. La lectura pide las páginas que necesita.

FiltrosCopiar el enlace a este apartado

Cada campo de la sección tiene sus filtros, con el nombre del campo delante. Todos los filtros de una consulta se cumplen a la vez.

var pendientes = await VentasD.List(client)
    .ReferenciaClienteIDIs(clienteId)
    .FechaFrom(new DateTime(2026, 1, 1))
    .TotalAtLeast(100m)
    .ReadUpToAsync(100);

Reglas que lanzan antes de llamar al servidor:

• Un id vacío en IDIs o un texto vacío en Is. Para «sin valor», usa IsEmpty.
• Dos Is sobre el mismo campo. Para «uno u otro», usa In.
• Between con el mínimo mayor que el máximo.

Uno u otro grupoCopiar el enlace a este apartado

Or() empieza otro grupo de filtros. Una fila entra si cumple los filtros de antes de Or() o los de después.

var avisos = await TareasD.List(client)
    .EstadoIs(EstadoTareaE.Bloqueada)
    .Or()
    .FechaLimiteBefore(DateTime.UtcNow)
    .ReadUpToAsync(200);

Buscar y filtrar a manoCopiar el enlace a este apartado

• Search("texto") busca como el buscador de Dinaup y se suma a los demás filtros.
• Where(new FilterCondition(campo, operador, valor)) cubre una condición que los filtros generados no tienen. Prefiere los generados: comprueban el tipo.

Orden, páginas y camposCopiar el enlace a este apartado

Sin orden, las filas llegan por fecha de alta, de la más antigua a la más nueva. «Las 10 últimas» es OrderByDescending(…).ReadUpToAsync(10).

Eliminados y archivadosCopiar el enlace a este apartado

• List(client) deja fuera los registros eliminados. ListIncludingDeleted(client) los trae.
• Los archivados quedan fuera, como en los informes. IncludingArchived() los trae, en las secciones que tienen campo de archivado.
• GetByIdAsync y un filtro por el campo de archivado encuentran un archivado sin pedir nada más.

Cuando fallaCopiar el enlace a este apartado

List o un informeCopiar el enlace a este apartado

GetRowsAsync con RowsRequestParameters sigue funcionando, pero no dice cuántas filas espera y corta sin avisar. En código nuevo, usa List.