# Définir les paramètres de rendu

Ajoutez des champs, choisissez les types, définissez les valeurs par défaut et utilisez Payload pour préparer les données du modèle.

Pour réutiliser un modèle avec des données différentes, déclarez d'abord les champs qu'il accepte. **Parameters** vous permet de nommer chaque champ, de choisir son type et de fournir une valeur par défaut.

Commencez avec un champ simple, connectez-le à HTML, puis ouvrez Payload pour inspecter la structure de données résultante.

## 1. Ajouter un champ dans Schema

Ouvrez **Parameters**, sélectionnez **Schema** et choisissez **Ajouter**. Renommez le nouveau champ avec le nom que vous souhaitez utiliser, tel que `recipient`.

| Tapez | Données appropriées |
| --- | --- |
| Texte | Noms, adresses, références ou chaînes formatées. |
| Numéro | Grandeurs ou valeurs numériques. |
| Booléen | `true` / `false`. |
| Objet | Un groupe nommé de champs. |
| Tableau | Une liste d'éléments avec la même structure. |

**Color** et **Asset** sont des types prop uniquement dans l'éditeur actuel, ils n'apparaissent donc pas dans la liste des types Parameters.

<figure class="doc-sim data-assets-illustration" aria-label="Parameters → Ajouter → Schema">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Parameters</strong><span class="sim-control sim-focus">＋ Ajouter</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>destinataire</b><span class="ds-type">Texte <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">PAR DÉFAUT</small><span class="sim-input">Tembuilder</span><span class="sim-embed">{{ params.recipient }}</span></div></div></div></div>
<figcaption>Parameters → Ajouter → Schema</figcaption>
</figure>

## 2. Définir les valeurs par défaut et obligatoires

Saisissez **Par défaut** sur la carte de champ pour fournir une valeur lorsque l'appelant omet le champ. Le contrôle requis dans l’en-tête de la carte fait basculer le statut **Obligatoire** du champ.

Utiliser les valeurs du type déclaré : un Nombre utilise `2`, et un Booléen utilise `true` ou `false`. La chaîne `"2"` n'est pas un nombre. Une chaîne vide est toujours une valeur fournie et non un champ omis.

Ajoutez une description pour expliquer l'objectif, les unités ou le format attendu de la valeur à une personne utilisant le modèle.

<figure class="doc-sim data-assets-illustration" aria-label="Le nom, le type, la valeur par défaut et l'obligation apparaissent sur la même carte de champ">
<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>destinataire <em>*</em></b><span class="ds-type">Texte <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">PAR DÉFAUT</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>Par défaut</span><small>Utilisé lorsque le champ est omis</small></div><div><span>Obligatoire</span><small>Marque un champ obligatoire</small></div></div></div>
<figcaption>Le nom, le type, la valeur par défaut et l'obligation apparaissent sur la même carte de champ</figcaption>
</figure>

## 3. Connectez le champ au contenu

Chaque carte comprend une expression **EMBED**. Pour `recipient`, insérez ceci dans le HTML d'une section :

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

`recipient` doit correspondre au nom Schema. Si vous renommez le champ ultérieurement, mettez à jour l'expression HTML et les données fournies au modèle.

<figure class="doc-sim data-assets-illustration" aria-label="Copiez l'expression EMBED dans la section HTML">
<div class="sim-stage"><div class="sim-prop-card ds-field"><div class="sim-prop-name"><b>destinataire</b><span class="ds-type">Texte <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">PAR DÉFAUT</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>Copiez l'expression EMBED dans la section HTML</figcaption>
</figure>

## 4. Obtenez la structure de Payload

Basculez vers **Payload** pour inspecter l'objet construit à partir des champs déclarés et des valeurs par défaut :

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

Il s'agit de l'objet de données du modèle. Utilisez la même structure lors de la saisie de données dans **Run**. Pour l'intégration API, l'objet appartient au champ `parameters` de la requête ; voir la [référence du rendu API](/docs/fr/developers/render-reference/) pour les champs de requête et les points de terminaison.

Pour les champs et listes imbriqués, continuez avec [Objets, tableaux et tables](/docs/fr/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>
