# Definir parámetros de renderizado

Agregue campos, elija tipos, establezca valores predeterminados y use Payload para preparar datos de plantilla.

Para reutilizar una plantilla con datos diferentes, primero declara los campos que acepta. **Parameters** le permite nombrar cada campo, elegir su tipo y proporcionar un valor predeterminado.

Comience con un campo simple, conéctelo a HTML, luego abra Payload para inspeccionar la estructura de datos resultante.

## 1. Agregue un campo en Schema

Abra **Parameters**, seleccione **Schema** y elija **Agregar**. Cambie el nombre del nuevo campo por el nombre que desee utilizar, como `recipient`.

| Tipo | Datos adecuados |
| --- | --- |
| Texto | Nombres, direcciones, referencias o cadenas formateadas. |
| Número | Cantidades o valores numéricos. |
| Booleano | `true` / `false`. |
| Objeto | Un grupo de campos con nombre. |
| Matriz | Una lista de elementos con la misma estructura. |

**Color** y **Recurso** son tipos de Props únicamente en el editor actual, por lo que no aparecen en la lista de tipos Parameters.

<figure class="doc-sim data-assets-illustration" aria-label="Parameters → Agregar → Schema">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Parameters</strong><span class="sim-control sim-focus">＋ Agregar</span></div><div class="sim-tabs"><span class="sim-active">Schema</span><span>Payload</span></div><div class="sim-prop-card ds-field"><div class="sim-prop-name"><b>destinatario</b><span class="ds-type">Texto <svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div class="sim-prop-value"><small class="sim-label">PREDETERMINADO</small><span class="sim-input">Tembuilder</span><span class="sim-embed">{{ params.recipient }}</span></div></div></div></div>
<figcaption>Parameters → Agregar → Schema</figcaption>
</figure>

## 2. Establecer predeterminado y obligatorio

Ingrese **Predeterminado** en la tarjeta de campo para proporcionar un valor cuando la persona que llama omite el campo. El control requerido en el encabezado de la tarjeta alterna el estado **Obligatorio** del campo.

Utilice valores del tipo declarado: un Número usa `2` y un Booleano usa `true` o `false`. La cadena `"2"` no es un número. Una cadena vacía sigue siendo un valor proporcionado, no un campo omitido.

Agregue una descripción para explicar el propósito, las unidades o el formato esperado del valor a alguien que use la plantilla.

<figure class="doc-sim data-assets-illustration" aria-label="Nombre, tipo, Predeterminado y Obligatorio aparecen en la misma tarjeta de campo">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Schema</strong></div><div class="sim-prop-card ds-field"><div class="sim-prop-name"><b>destinatario <em>*</em></b><span class="ds-type">Texto <svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div class="sim-prop-value"><small class="sim-label">PREDETERMINADO</small><span class="sim-input sim-focus">Tembuilder</span><span class="sim-embed">{{ params.recipient }}</span></div></div></div><div class="ds-rows"><div><span>Predeterminado</span><small>Se utiliza cuando se omite el campo</small></div><div><span>Requerido</span><small>Marca un campo obligatorio</small></div></div></div>
<figcaption>Nombre, tipo, Predeterminado y Obligatorio aparecen en la misma tarjeta de campo</figcaption>
</figure>

## 3. Conecte el campo al contenido

Cada tarjeta incluye una expresión **EMBED**. Para `recipient`, inserte esto en el HTML de una sección:

```handlebars
<p>{{ params.recipient }}</p>
```

`recipient` debe coincidir con el nombre Schema. Si cambia el nombre del campo más adelante, actualice tanto la expresión HTML como los datos proporcionados a la plantilla.

<figure class="doc-sim data-assets-illustration" aria-label="Copie la expresión EMBED en la sección HTML">
<div class="sim-stage"><div class="sim-prop-card ds-field"><div class="sim-prop-name"><b>destinatario</b><span class="ds-type">Texto <svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div class="sim-prop-value"><small class="sim-label">PREDETERMINADO</small><span class="sim-input">Tembuilder</span><span class="sim-embed">{{ params.recipient }}</span></div></div><div class="ds-code sim-focus"><code>{{ params.recipient }}</code></div></div>
<figcaption>Copie la expresión EMBED en la sección HTML</figcaption>
</figure>

## 4. Obtener la estructura de Payload

Cambie a **Payload** para inspeccionar el objeto creado a partir de los campos declarados y los valores predeterminados:

```json
{
  "recipient": "Tembuilder",
  "copies": 2,
  "showNotes": true
}
```

Este es el objeto de datos de la plantilla. Utilice la misma estructura al ingresar datos en **Run**. Para la integración API, el objeto pertenece al campo `parameters` de la solicitud; consulte la [Referencia de renderizado API](/docs/es/developers/render-reference/) para conocer los campos de solicitud y los puntos finales.

Para listas y campos anidados, continúe con [Objetos, matrices y tablas](/docs/es/data/arrays-objects/).

<figure class="doc-sim data-assets-illustration" aria-label="Schema → Payload → Run">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Parameters</strong></div><div class="sim-tabs"><span>Schema</span><span class="sim-active">Payload</span></div><div class="ds-code sim-focus"><code>{</code><code>  "recipient": "Tembuilder",</code><code>  "copies": 2,</code><code>  "showNotes": true</code><code>}</code></div></div></div>
<figcaption>Schema → Payload → Run</figcaption>
</figure>
