Daten & Varianten
Docs/Daten & Varianten

Parameters oder props?

Wählen Sie, wo Vorlageninhalte gespeichert und Daten für jedes Dokument bereitgestellt werden sollen.

4 Minuten Lesezeit4 Abschnitte
Auf dieser Seite

Beim Bearbeiten einer Vorlage werden sowohl Props als auch Parameters angezeigt. Beide liefern Werte für den Inhalt, dienen jedoch unterschiedlichen Zwecken: Einer speichert Werte, die zur Vorlage gehören, während der andere Daten für jedes Dokument empfängt.

Wenn Sie sie getrennt halten, können Sie das Design an einem Ort bearbeiten und mit anderen Daten wiederverwenden, ohne den Editor bei jedem Durchlauf erneut öffnen zu müssen.

1. Wählen Sie, wo ein Wert hingehört

Verwenden Sie Props für mit der Vorlage gespeicherte Werte, wie Überschriften, Beschriftungen, Farben und Logos. Verwenden Sie Parameters für Daten, die pro Lauf bereitgestellt werden, z. B. einen Empfänger, eine Referenznummer oder eine Artikelliste.

Wert Wo es hingehört
Ein „Empfänger“-Label Eine Prop im Abschnitt, in dem sie angezeigt wird.
Der Name des Empfängers Ein Parameter.
Eine gemeinsame Farbe oder ein gemeinsames Logo Eine Global-Prop.
Eine Liste von Elementen Ein Array-Parameter.
Ein Etikett mit englischen/vietnamesischen Versionen Eine Prop mit variantenspezifischen Werten.
Props
ÜberschriftText
WERTDokumenttitel{{ props.heading }}
Parameters
EmpfängerText
STANDARDTembuilder{{ params.recipient }}
Props werden mit der Vorlage gespeichert · Parameters empfängt Daten für jeden Lauf

2. Props gehören zu dem Teil, das Sie bearbeiten

Wählen Sie einen Abschnitt, eine Kopf- oder Fußzeile in Structure aus und öffnen Sie dann Props. Wählen Sie Prop hinzufügen, um einen Wert hinzuzufügen. Zu den verfügbaren Typen gehören „Text“, „Zahl“, „Boolescher Wert“, „Array“, „Objekt“, „Farbe“ und „Asset“.

Lesen Sie in HTML dieses Teils die Prop mit {{ props.heading }}. Für eine gemeinsam genutzte Global-Prop verwenden Sie {{ global.props.propName }}.

Verschiedene Abschnitte können props mit demselben Namen haben. Überprüfen Sie den Abschnittsnamen über der Props-Liste, um zu sehen, welchen Teil Sie bearbeiten.

Structure → Abschnitt → Props
Abschnitt+ Prop hinzufügen
ÜberschriftText
WERTDokumenttitel{{ props.heading }}
Wählen Sie einen Abschnitt aus, um dessen Props zu bearbeiten

3. Parameters liefert Daten für jeden Lauf

Öffnen Sie Parameters → Schema, um Feldnamen, Typen und Standardeinstellungen zu deklarieren. Verwenden Sie {{ params.recipient }} in HTML, um das Feld recipient zu lesen.

Überprüfen Sie das Datenobjekt in Payload und verwenden Sie dann diese Struktur, wenn Sie Daten in Run eingeben. Durch die Angabe eines neuen Werts werden die Daten des Laufs geändert, nicht die in der Vorlage gespeicherten props.

Siehe Eingabedaten deklarieren zum Hinzufügen von Feldern zu einer Vorlage.

Parameters+ Hinzufügen
SchemaPayload
EmpfängerText
STANDARDTembuilder{{ params.recipient }}
{ "recipient": "Tembuilder" }
Parameters → Empfänger → params.recipient

4. Kombinieren Sie sie in HTML

Zum Beispiel speichert heading eine Abschnittsüberschrift als Prop, während recipient den Namen des Lesers als Parameter erhält:

<h1>{{ props.heading }}</h1>
<p>{{ params.recipient }}</p>

Bearbeiten Sie heading in Props, um die Überschrift der Vorlage zu ändern. Geben Sie ein anderes recipient an, um das Design für eine andere Person wiederzuverwenden.

Informationen zu mehreren Etiketten- oder Farbsätzen in einer Vorlage finden Sie unter Vorlagenvarianten.

<h1>{{ props.heading }}</h1><p>{{ params.recipient }}</p>
→
TembuilderDokumenttitel

Tembuilder

Vorlagentext und Eingabedaten erscheinen zusammen im Dokument

Weitere Informationen zu Bedingungen, Umfang, Escapezeichen und erweiterten Beispielen finden Sie in der SyntaxreferenzHandlebars](/docs/de/data/handlebars/).

Dokumentation durchsuchen