Um eine Vorlage mit anderen Daten wiederzuverwenden, deklarieren Sie zunächst die Felder, die sie akzeptiert. Mit Parameters können Sie jedes Feld benennen, seinen Typ auswählen und einen Standardwert angeben.
Beginnen Sie mit einem einfachen Feld, verbinden Sie es mit HTML und öffnen Sie dann Payload, um die resultierende Datenstruktur zu überprüfen.
1. Fügen Sie ein Feld in Schema hinzu
Öffnen Sie Parameters, wählen Sie Schema und wählen Sie Hinzufügen. Benennen Sie das neue Feld in den Namen um, den Sie verwenden möchten, z. B. recipient.
| Typ | Geeignete Daten |
|---|---|
| Text | Namen, Adressen, Referenzen oder formatierte Zeichenfolgen. |
| Nummer | Mengen oder numerische Werte. |
| Boolescher Wert | true / false. |
| Objekt | Eine benannte Gruppe von Feldern. |
| Array | Eine Liste von Elementen mit derselben Struktur. |
Color und Asset sind reine Propstypen im aktuellen Editor und erscheinen daher nicht in der Parameters-Typenliste.
2. Standard und Erforderlich festlegen
Geben Sie Standard auf der Feldkarte ein, um einen Wert bereitzustellen, wenn der Anrufer das Feld auslässt. Das erforderliche Steuerelement im Kartenkopf schaltet den Erforderlich-Status des Felds um.
Verwenden Sie Werte des deklarierten Typs: Eine Zahl verwendet 2 und ein Boolescher Wert verwendet true oder false. Die Zeichenfolge "2" ist keine Zahl. Eine leere Zeichenfolge ist immer noch ein bereitgestellter Wert und kein ausgelassenes Feld.
Fügen Sie eine Beschreibung hinzu, um jemandem, der die Vorlage verwendet, den Zweck, die Einheiten oder das erwartete Format des Werts zu erklären.
3. Verbinden Sie das Feld mit dem Inhalt
Jede Karte enthält einen EMBED-Ausdruck. Fügen Sie für recipient dies in HTML eines Abschnitts ein:
<p>{{ params.recipient }}</p>recipient muss mit dem Namen Schema übereinstimmen. Wenn Sie das Feld später umbenennen, aktualisieren Sie sowohl den HTML-Ausdruck als auch die der Vorlage bereitgestellten Daten.
{{ params.recipient }}4. Holen Sie sich die Struktur von Payload
Wechseln Sie zu Payload, um das aus den deklarierten Feldern und Standardwerten erstellte Objekt zu überprüfen:
{
"recipient": "Tembuilder",
"copies": 2,
"showNotes": true
}Dies ist das Datenobjekt der Vorlage. Verwenden Sie dieselbe Struktur, wenn Sie Daten in Run eingeben. Bei der API-Integration gehört das Objekt in das parameters-Feld der Anfrage. Informationen zu den Anforderungsfeldern und Endpunkten finden Sie in der Render-API-Referenz](/docs/de/developers/render-reference/).
Fahren Sie für verschachtelte Felder und Listen fort mit Objekte, Arrays und Tabellen.
{ "recipient": "Tembuilder", "copies": 2, "showNotes": true}