rustedf.cloud
Menú

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:

  • @page fija 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: avoid evita 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.

← Todos los artículos