Generador de informes PDF en C#: tabla paginada con totales
Publicado el 3 min de lectura
Un informe son filas que no caben en una página. Necesita una tabla que lleve su cabecera a la hoja siguiente, un total al final y un “Página 2 de 5” en cada página. En C# eso es más un trabajo de maquetación que de código, y resulta más fácil cuando la maquetación es HTML y CSS que ya conoces. Esta guía construye uno con la API de rustedf.cloud y un cliente tipado como el de la guía de C# y ASP.NET Core.
Los datos
Envía las filas como una lista y los importes como texto:
using System.Globalization;
public sealed record SaleRow(string Product, int Quantity, string Amount);
var rows = sales .Select(s => new SaleRow( s.Product, s.Quantity, s.Total.ToString("0.00", CultureInfo.InvariantCulture))) .ToList();Un importe escrito como "1234.50" se formatea para el lector con el filtro currency, y así
se evitan las sorpresas de la coma flotante. System.Text.Json renombra las propiedades de un
record (Product pasa a product), por lo que la plantilla usa los nombres en minúsculas.
La plantilla
Las reglas de página, la tabla y el bucle son todo HTML y CSS:
<style> @page { size: A4; margin: 20mm; @bottom-right { content: "Página " counter(page) " de " counter(pages); } } th { text-align: left; border-bottom: 1pt solid #000; } td { padding: 3pt 0; border-bottom: 0.5pt solid #ccc; } .number { text-align: right; } tr { break-inside: avoid; }</style>
<h1>{{ title }}</h1><p>{{ generated | date(style="long") }}</p>
<table> <thead> <tr><th>Producto</th><th class="number">Cant.</th><th class="number">Importe</th></tr> </thead> <tbody> {% for row in rows %} <tr> <td>{{ row.product }}</td> <td class="number">{{ row.quantity | number }}</td> <td class="number">{{ row.amount | currency(code="EUR") }}</td> </tr> {% endfor %} </tbody></table>
<p><strong>Total {{ total | currency(code="EUR") }}</strong></p>Tres detalles hacen el trabajo de un informe:
@pagefija el papel y el margen, y la caja de margen inferior contiene el número de página. No cuentas páginas: el total se rellena cuando todo el documento ya está maquetado.- La fila de cabecera de una tabla se repite en cada página que ocupa la tabla, así que los títulos de las columnas acompañan a los datos.
break-inside: avoidevita que una fila se parta entre dos páginas.
Renderiza y lee el número de páginas
Guarda la plantilla en un archivo o en un recurso incrustado y envíala como html, junto con
los datos:
public async Task<(byte[] Pdf, int Pages)> RenderReportAsync( string html, object data, CancellationToken cancellationToken = default){ using var response = await http.PostAsJsonAsync( "v1/render", new { html, data, locale = "es-ES", title = "Informe de ventas" }, cancellationToken);
if (!response.IsSuccessStatusCode) { var body = await response.Content.ReadFromJsonAsync<ErrorBody>(cancellationToken); throw new InvalidOperationException( body?.Error?.Message ?? $"Falló el renderizado ({(int)response.StatusCode})"); }
var pages = int.Parse(response.Headers.GetValues("X-Pages").First()); return (await response.Content.ReadAsByteArrayAsync(cancellationToken), pages);}
var data = new{ title = "Ventas de octubre", generated = DateTime.UtcNow.ToString("yyyy-MM-dd"), rows, total = rows.Sum(r => decimal.Parse(r.Amount, CultureInfo.InvariantCulture)) .ToString("0.00", CultureInfo.InvariantCulture),};
var (pdf, pages) = await client.RenderReportAsync(template, data);La cabecera X-Pages indica cuántas páginas tiene el informe, de modo que puedes mostrarlo o
rechazar un informe demasiado largo sin abrir el archivo.
El html se envía de nuevo en cada petición. Si el mismo informe se genera a menudo, guarda la
plantilla en tu cuenta y envía solo los datos con template_id; consulta
Generar con una plantilla guardada.
Cuando el informe es largo
Un informe que crece choca con los límites del plan, y cada límite tiene su respuesta:
| Estado | code |
Qué ocurrió |
|---|---|---|
| 413 | payload_too_large |
La petición o los datos superan un límite de tamaño. |
| 422 | invalid_template |
La plantilla falló, o el informe tiene más páginas de las que permite tu plan. |
| 504 | render_timeout |
El informe tardó más que el límite de tiempo de tu plan. |
Dos límites valen para data en cualquier plan: como máximo 200.000 valores y 32 niveles de
profundidad. Suma y agrupa en tu base de datos y envía el resultado; un informe de cien mil
líneas suele necesitar un resumen y un enlace al detalle, no todas las líneas.
Comprueba la maquetación
Envía el mismo cuerpo a POST /v1/validate mientras construyes el informe. Devuelve lo que el
servicio no pudo usar y el número de páginas, sin PDF y sin crédito. En tus pruebas, añade
"strict": true para que un informe que empiece a usar algo no admitido falle con
422 strict_mode_rejected en lugar de perderlo en silencio.
Lee HTML y CSS admitidos, Idiomas y formato y Errores y límites. Para las reglas de página en detalle, consulta Números de página, encabezado y pie en un PDF.
Sigue leyendo
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura
Código e integraciones
Convertir una página web a PDF en C# sin navegador headless
Descarga una página con HttpClient y convierte su HTML en PDF con una llamada a la API en C#. Qué páginas admite, cuáles no y cómo comprobarlo de antemano.
3 min de lectura
Código e integraciones
Guardar un PDF en C#: en disco, como descarga o en blob storage
Guarda el PDF que devuelve una llamada de renderizado en C#: escríbelo en disco, envíalo como descarga en ASP.NET Core, usa un enlace firmado o súbelo al storage.
2 min de lectura
Código e integraciones
Generar miles de PDF en C#: ritmo, 429 y reintentos seguros
Genera un lote de PDF en C# sin avalancha de errores 429: controla el ritmo, repite solo lo seguro, reanuda una ejecución parada y para si se acaban los créditos.
3 min de lectura