Sie können den Inhalt eines Contentblocks von einer Variablen abhängig machen. Variablen werden in Vorlagen definiert und erhöhen die Flexibilität, wenn eine Vorlage in einer Journey verwendet wird. Durch die Einstellung variabler Werte können Sie das endgültige Erscheinungsbild und die Wirkung des Inhalts beeinflussen.
Beispiel: Sie möchten eine multifunktionale Schaltfläche erstellen, deren Größe und Ausrichtung Sie anpassen können. Dazu erstellen Sie einen Contentblock für die Schaltfläche und definieren zwei Variablen, zum Beispiel:
– Farbe
– Ausrichtung
Wenn Sie die Vorlage verwenden, geben Sie diese Variablen ein, um zu kontrollieren, wie die Schaltfläche angezeigt wird.
Vorlagenvariablen
Eine Vorlagenvariable existiert auf der Vorlagenebene. Wenn Sie eine Vorlagenvariable in einem Contentblock verwenden, gilt der für diese Variable ausgewählte Wert für alle Contentblöcke in der Vorlage, die die gleiche Variable nutzen.
Für die Verwendung einer vorhandenen Vorlagenvariablen im Contentblock wird die folgende Syntax verwendet:
[%[VARIABLE.Name]%]
Der gesamte Inhalt zwischen diesen <sg:conditional>-Tags hängt von dem Wert ab, den Sie für die Variable festgelegt haben.
Lokale Variablen
Eine lokale Variable wird direkt in einem Contentblock definiert und verwendet. Verwenden Sie eine lokale Variable, wenn die Variable noch nicht in der Vorlage vorhanden ist.
Definieren Sie eine lokale Variable
Verwenden Sie die folgende Syntax:
<sg:var name="" type="" value="" alias="" description="" />Sie können die folgenden Variableneigenschaften definieren:
- Name – Der interne Name der Variablen.
- Typ – Bestimmt den erwarteten Wert und wie er in der Schnittstelle erscheint:
- Text: Text-Feld
- Farbe: Farbwähler
- Boolesch: Kontrollkästchen
- Standardwert (optional) – Wird automatisch angewandt, wenn die Variable genutzt wird.
- Alias (optional) – Bezeichnung, die in den Eigenschaften des Contentblocks erscheint. Wenn keine Angaben gemacht werden, wird der Variablenname verwendet.
- Beschreibung (optional) – Hilfstext, der unter dem Variablenfeld in den Contentblock-Eigenschaften angezeigt wird.
Beispiele für Typen von Variable
<sg:var name="MyText" type="Text" value="mytext" alias="my_alias" description="my_description" />
<sg:var name="Mycolor" type="Color" value="#0000FF" alias="my_alias" description="my_description" />
<sg:var name="MyName" type="Number" value="75" alias="my_alias" description="my_description" />
<sg:var name="MyBoolean" type="Boolean" value="TRUE" alias="my_alias" description="my_description" />
<sg:var name="MyDecimal" type="Decimal" value="0,01" alias="my_alias" description="my_description" />
<sg:var name="MyDateTime" type="Datetime" value="2019-10-17 10:00" alias="my_alias" description="my_description" />
<sg:var name="MyDate" type="Date" value="2019-10-17" alias="my_alias" description="my_description" />
<sg:var name="MyTime" type="Time" value="10:00" alias="my_alias" description="my_description" />
<sg:var name="My_image" type="image" value="" />
Anzeige von Variablen in der Benutzeroberfläche
Wenn ein Contentblock Variablen enthält:
- Erscheinen Boolesche Variablen als Umschalter.
- Erscheinen Textvariablen als Textfelder.
- Erscheinen Farbvariablen erscheinen als Farbwähler.
Der Alias und die Beschreibung helfen den Benutzern zu verstehen, wie jede Variable konfiguriert wird.
Beispiel:
Auf der linken Seite enthält der Contentblock, der im Kapitel Bibliothek erstellt wurde, drei Variablen: Boolesch, Text und Farbe.
Wenn Sie den Contentblock in einer Nachricht verwenden, zeigt das Eigenschaftsfenster rechts alle drei Variablen (Boolesch als Umschalter, Text als Textfeld, Farbe als Farbwähler) mit ihrem Alias und ihrer Beschreibung an. 
Definieren Sie mehrere Variablen-Optionen
Sie können <sg:option> verwenden, um eine Liste der zulässigen Werte für eine Variable zu definieren.
<sg:var name="MyValues" type="text" value="option2">
<sg:option value="option1">Option 1</sg:option>
<sg:option value="option2">Option 2</sg:option>
</sg:var> Beispiel 1: Farbauswahl auf Basis von Variablen
In diesem Beispiel definiert eine Farbvariable die Hintergrundfarbe des Vorlagen-Headers:
– Der Contentblock enthält eine Variable mit zwei möglichen Optionen:
– Wenn Sie den Contentblock in einer Vorlage verwenden, erscheint die Farbvariable in den Contentblock-Eigenschaften.
– Sie können zwischen den beiden Farboptionen umschalten.
Wenn Sie den Contentblock in einer Vorlage verwenden, wird die Farbvariable in den Eigenschaften der Contentblock-Komponente aufgeführt. Es werden 2 Farboptionen angezeigt, zwischen denen umgeschaltet werden kann.
Im Stil-Dialog des Vorlagen-Headers wird durch Hinzufügen von „Hintergrundfarbe: [Name der Farbvariablen]'“ als benutzerdefinierter Stil die ausgewählte Option der sg:var-Farbvariablen im Contentblock als Hintergrundfarbe auf den Header der Nachricht angewendet (der aktuell lila ist).
Wenn Sie zur anderen Farboption wechseln:
– Wird der Vorlagen-Header automatisch aktualisiert.
– Wird jeder Abschnitt der Vorlage, der die Variable verwendet, ebenfalls aktualisiert.
Beispiel 2: Bildvariable
Sie können eine Variable vom Typ Bild zu einem Contentblock hinzufügen und in einem Bild-Tag darauf verweisen. Wenn Sie den Contentblock in einer Nachricht verwenden, können Sie ein Bild für diese Variable auswählen.
In der Nachricht kann ein Bild für diese Variable ausgewählt werden:
Hinweis: Lokale Variablen werden im Contentblock definiert. Für jede Instanz des Contentblocks, die einer Vorlage hinzugefügt wird, müssen Sie den Wert der Variablen festlegen. Auf diese Weise kann ein und derselbe Contentblock mehrfach mit unterschiedlichen Erscheinungsbildern wiederverwendet werden.
Vorlagenvariablen werden einmal auf der Vorlagenebene definiert. Der ausgewählte Wert gilt für alle Contentblöcke, die diese Variable verwenden.
Weitere Informationen zur Verwendung von Contentblöcken mit Variablen finden Sie in diesem Thema.
