Referencia de Pestaña Datos

Guía de referencia para gestionar mapeos, cálculos y fuentes de datos en el Diseñador de Plantillas.

La Pestaña Datos del Diseñador de Plantillas es donde define la lógica detrás de su documento. Conecta su diseño visual con sus fuentes de datos reales (Excel/CSV) y gestiona la lógica de negocio como cálculos y agrupación.

Resumen de secciones

La Pestaña Datos está organizada en las siguientes secciones:

  1. Mapeos: Conecta columnas del archivo de datos con variables de la plantilla.
  2. Cálculos: Crea nuevas variables usando fórmulas.
  3. Agrupación (Obligatorio): Define cómo las filas se dividen en documentos PDF separados.
  4. Enlace de datos: Une datos de transacciones con datos maestros (estilo VLOOKUP).
  5. Configuración de salida: Establece la convención de nombres para los PDFs generados.
  6. Fuentes de datos: Carga datos de ejemplo para vista previa y mapeo.

1. Mapeos

Los mapeos permiten que la plantilla "lea" valores de las columnas de su archivo de datos.

  • Datos de transacción (icono de recibo): Representa sus datos principales (ej., facturas, filas de ventas). Estos datos normalmente varían con cada fila.
  • Datos maestros (icono de persona): Representa datos de referencia (ej., lista de clientes, catálogo de productos). Estos datos suelen ser estáticos o se unen por un ID.

Al cargar una fuente de datos (ver Fuentes de datos más abajo), los mapeos se crean a menudo automáticamente. También puede agregarlos manualmente.

2. Cálculos

Los cálculos le permiten crear nuevas variables derivadas de datos existentes. Úselos para calcular montos, impuestos o combinar campos de texto.

Ejemplo: Para calcular un precio total a partir de UnitPrice y Quantity:

  • Nombre: TotalAmount
  • Fórmula: {{UnitPrice}} * {{Quantity}}

Una vez creado, {{TotalAmount}} estará disponible como variable en su diseño.

Agregación (Suma)

Para totales a nivel de grupo, puede usar el tipo sum en lugar de una fórmula. Esto suma automáticamente un campo en todas las filas del grupo:

  • Tipo: sum
  • Campo: La variable a sumar (ej., TotalAmount)

Esto es útil para calcular subtotales, totales generales u otros valores agregados de líneas de detalle.

Redondeo

Los cálculos admiten una opción de Redondeo para controlar cómo se redondean los resultados numéricos:

  • floor: Redondea hacia abajo al entero más cercano (ej., 10.9 → 10)
  • ceil: Redondea hacia arriba al entero más cercano (ej., 10.1 → 11)
  • round: Redondeo estándar al entero más cercano (ej., 10.5 → 11)

Esto es particularmente útil para cálculos de impuestos y formato de monedas.

3. Agrupación

Este ajuste es obligatorio. La Clave de agrupación determina cómo se procesan múltiples filas.

  • Modo de fila única: Si cada fila de sus datos representa un documento único, seleccione una columna de ID único (ej., InvoiceID).
  • Modo de múltiples filas: Si sus datos contienen múltiples filas para un solo documento (ej., una factura con 5 líneas de detalle), seleccione la columna que identifica el documento (ej., InvoiceID). El motor agrupará estas 5 filas en un solo PDF.

4. Enlace de datos

Use esta sección para unir Datos Maestros a sus Datos de Transacción, similar a VLOOKUP en Excel.

  • Valor de coincidencia (Datos de importación): La columna en sus datos de transacción que actúa como "Clave Foránea" (ej., CustomerID).
  • Clave de búsqueda (Datos maestros): La columna de ID único en sus datos maestros (ej., CustomerID).

¿Por qué usar esto? Si sus datos de transacción solo tienen CustomerID "C001", pero desea imprimir la dirección completa del cliente en la factura, enlace sus Datos Maestros. El sistema extraerá automáticamente la dirección asociada con "C001".

5. Configuración de salida

  • Regla de nombre de PDF: Define el nombre del archivo PDF generado.
  • Predeterminado: {{InvoiceNo}}.pdf

Puede usar variables para crear nombres dinámicos, como Factura_{{InvoiceNo}}_{{Date}}.pdf.

6. Fuentes de datos

Esta sección le ayuda a verificar mapeos y previsualizar la correcta conexión. Aunque el mapeo manual es posible, cargar sus archivos de datos reales reduce significativamente los errores.

Formatos compatibles

  • Archivos CSV (.csv)
  • Archivos Excel (.xlsx, .xls)

Cómo usar

  1. Haga clic en Cargar datos de transacciones o Cargar datos maestros.
  2. Seleccione su archivo desde el selector de archivos.
  3. Aparecerá un cuadro de diálogo de Vista previa de datos.
  4. Revise los datos y haga clic en Cargar. El sistema propondrá automáticamente mapeos para todas las columnas encontradas en el archivo.