Verás Props y Parameters al editar una plantilla. Ambos proporcionan valores al contenido, pero tienen diferentes propósitos: uno almacena valores que pertenecen a la plantilla, mientras que el otro recibe datos para cada documento.
Mantenerlos separados le permite editar el diseño en un solo lugar y reutilizarlo con datos diferentes, sin volver a abrir el editor para cada ejecución.
1. Elija dónde pertenece un valor
Utilice Props para valores guardados con la plantilla, como encabezados, etiquetas, colores y logotipos. Utilice Parameters para los datos proporcionados por ejecución, como un destinatario, un número de referencia o una lista de elementos.
| Valor | Dónde pertenece |
|---|---|
| Una etiqueta de “Destinatario” | Un accesorio en la sección que lo muestra. |
| El nombre del destinatario | Un parámetro. |
| Un color o logotipo compartido | Un accesorio Global. |
| Una lista de elementos | Un parámetro de matriz. |
| Una etiqueta con versiones en inglés/vietnamita | Un accesorio con valores específicos de variante. |
2. Props pertenece a la parte que estás editando
Seleccione una sección, encabezado o pie de página en Structure, luego abra Props. Seleccione Agregar propiedad para agregar un valor. Los tipos disponibles incluyen Texto, Número, Booleano, Matriz, Objeto, Color y Activo.
En HTML de esa parte, lee el accesorio con {{ props.heading }}. Para un accesorio Global compartido, utilice {{ global.props.propName }}.
Diferentes secciones pueden tener props con el mismo nombre. Verifique el nombre de la sección encima de la lista Props para ver qué parte está editando.
3. Parameters suministra datos para cada ejecución
Abra Parameters → Schema para declarar nombres, tipos y valores predeterminados de campos. Utilice {{ params.recipient }} en HTML para leer el campo recipient.
Inspeccione el objeto de datos en Payload, luego use esa estructura al ingresar datos en Run. Proporcionar un nuevo valor cambia los datos de la ejecución, no el props guardado en la plantilla.
Consulte Declarar datos de entrada para agregar campos a una plantilla.
{ "recipient": "Tembuilder" }4. Combínalos en HTML
Por ejemplo, heading almacena el encabezado de una sección como accesorio, mientras que recipient recibe el nombre del lector como parámetro:
<h1>{{ props.heading }}</h1>
<p>{{ params.recipient }}</p>Edite heading en Props para cambiar el encabezado de la plantilla. Proporcione un recipient diferente para reutilizar el diseño para otra persona.
Para varios conjuntos de etiquetas o colores en una plantilla, consulte Variantes de plantilla.
<h1>{{ props.heading }}</h1><p>{{ params.recipient }}</p>Tembuilder
Consulte la referencia de sintaxis Handlebars para conocer condiciones, alcance, escape y ejemplos avanzados.