Vinculaciones de campos de datos y formato

Una vinculación de campo de datos conecta un elemento de la plantilla con un campo de su esquema de datos. Cuando ShipPDF previsualiza o genera el documento, reemplaza la vinculación por el valor del campo. Después puedes dar formato a ese valor sin cambiar los datos de origen.

Por ejemplo, un elemento de texto puede combinar una etiqueta con dos vinculaciones:

Factura {{invoice.number}} · Total {{invoice.total}}

Con INV-1042 y 1250 en los datos, el texto generado puede ser Factura INV-1042 · Total $1,250.00 después de aplicar formato de moneda a invoice.total.

Vincula un campo

Abre una plantilla y selecciona Campos de datos en el inspector. Puedes crear una vinculación de dos maneras:

• Arrastra un campo hasta un elemento de texto o un encabezado de tabla.
• Edita el valor de un elemento de texto, código QR o código de barras, escribe {{ y elige un campo del menú.

Dentro de un elemento de texto, cada vinculación aparece como una pastilla de campo. Puedes combinar texto estático y varias pastillas en el mismo elemento. Selecciona una pastilla para cambiar el formato de esa aparición del campo.

El selector solo muestra los campos válidos en la ubicación seleccionada. Así evita vincular un campo fuera del bucle o la fila de tabla donde existe su valor.

Vinculaciones por elemento

Comprende el alcance de las vinculaciones

Los campos de la raíz del esquema de datos están disponibles en todo el documento. Una colección crea el alcance de un elemento cuando la usa una tabla o un bucle. Dentro de ese alcance, vincula los campos de la fila o el elemento actual.

Con este esquema:

invoice                  Objeto
|-- number               Cadena
`-- items                Colección
    |-- description      Cadena
    |-- quantity         Número
    `-- unit_price       Número

invoice.number es una vinculación de raíz. Cuando un bucle o una tabla usa invoice.items, su contenido se puede vincular a description, quantity y unit_price del elemento actual. Primero debes entrar en una colección anidada mediante otro bucle para que sus campos estén disponibles.

Los encabezados y pies de página también proporcionan los campos Número de página y Total de páginas. Úsalos para crear texto como Página 2 de 6 en páginas explícitas y páginas de desbordamiento.

Da formato al valor de un campo

Selecciona una pastilla de campo en un valor de texto o abre los ajustes del campo vinculado en el inspector. Elige un Formato y configura las opciones que aparecen para ese tipo de campo.

El formato pertenece a esa aparición de la vinculación. Un mismo número puede aparecer como una cantidad sin formato en un lugar y como moneda en otro. El formato solo cambia el texto representado; no cambia el esquema, los Datos predeterminados ni el JSON de la solicitud.

Ejemplos de números

El formato de porcentaje trata el valor de origen como una fracción: envía 0.25 para mostrar 25%.

Patrones de fecha

ShipPDF incluye patrones habituales como yyyy-MM-dd, dd/MM/yyyy, MMM d, yyyy y d MMMM yyyy. Para crear un patrón personalizado, usa estos elementos:

Escribe las palabras literales entre comillas simples. Con la configuración regional es-ES, el valor "2026-10-02" y el patrón d 'de' MMMM 'de' yyyy se muestran como 2 de octubre de 2026.

Formato de listas

Elige una coma, un punto y coma, una línea nueva, un espacio, ningún separador o uno personalizado. También puedes dar formato a cada elemento. Por ejemplo, una lista de cadenas con borrador y enviado puede usar mayúsculas y un punto y coma para mostrar BORRADOR; ENVIADO.

Previsualiza y valida las vinculaciones

Usa Ver vista previa del PDF para comprobar las vinculaciones con los Datos predeterminados de la plantilla. Antes de publicar, prueba también datos con texto largo, colecciones vacías, números grandes y valores opcionales ausentes.

El editor informa de las vinculaciones no válidas cuando se elimina un campo, está fuera del alcance actual o usa un formato que ya no corresponde a su tipo. Revisa las vinculaciones afectadas después de cambiar nombres o tipos de campo, o el origen de un bucle o una tabla.

Al generar un documento, conserva los tipos del esquema en los valores JSON. Envía los números como números JSON, los booleanos como true o false, y las colecciones o listas como arreglos. Un valor opcional ausente puede usar los Datos predeterminados; un null explícito no restaura el valor predeterminado y puede fallar la validación del esquema.

Próximos pasos

• Define campos y valores de previsualización en Esquema de datos y datos predeterminados.
• Consulta los bloques de contenido y diseño disponibles en Elementos.
• Aprende cómo continúa el contenido repetido en Páginas y desbordamiento.
• Genera un documento con datos de una solicitud mediante el inicio rápido.