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.
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.
3. Connectez le champ au contenu
Chaque carte comprend une expression EMBED. Pour recipient, insérez ceci dans le HTML d’une section :
<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.
{{ params.recipient }}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 :
{
"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 pour les champs de requête et les points de terminaison.
Pour les champs et listes imbriqués, continuez avec Objets, tableaux et tables.
{ "recipient": "Tembuilder", "copies": 2, "showNotes": true}