Vorlagen-Assistent

Sie können Rich-Text-Inhaltssteuerelementen Formatvorlagen zuweisen, um sie immer entsprechend zu formatieren.

Gehen Sie hierzu wie folgt vor:

Die folgende Tabelle bietet eine Übersicht über Formatierungstags, die zur Anpassung der Dokumentausgabe mit dem Vorlagen-Assistenten verwendet werden können:

Zeilenumbruch

[n/]

Text[n/]Text

Fettdruck

[b] … [/b]

[b]Text[/b]

Unterstreichung

[u] … [/u]

[u]Text[/u]

Kursivdruck

[i] … [/i]

[i]Text[/i]

Tabstopp

[t/]

Zentriert

[hcenter] … [/hcenter]

[hcenter] Text Text [/hcenter]

Rechtsbündig

[hend] … [/hend]

[hend] Text Text [/hend]

Blocksatz

[hdistribute] … [/hend]

[hdistribute] Text Text [/hdistribute]

Großbuchstaben

| Upcase

{{Text | Upcase }}

Hyperlink

[a target="linkTargetUri"] … [/a]

Für normale Hyperlinks:

[a target="https://{{Entity.Property.Value}}";] {{Entity.Property.Label}}[/a]

Für E-Mails:

{% if Entity.Property.Value %}[a target="mailto:{{Entity.Property.Value}}"][u]{{Entity.Property.Value}}[/a][/u]{% endif %}

Im Folgenden finden Sie ein Beispiel für die Verwendung von Formatierungstags:

Die Labels aus dem folgenden Code-Auszug werden in Großbuchstaben und fett dargestellt.

Die Values hingegen erscheinen in Standardformatierung ohne Großbuchstaben.

Zusätzlich wird der Datensatz mithilfe von Zeilenumbrüchen auf drei Zeilen verteilt.

Der folgende Auszug zeigt die Konfiguration für dieses Beispiel:

{{User.First_Name.Value}} {{User.Last_Name.Value}}[n/][b]{{User.Phone.Label | Upcase }}:[/b] {{User.Phone.Value}}[n/][b]{{User.Email.Label | Upcase }}:[/b] {{User.Email.Value}}

Das Ergebnis für einen Benutzer namens empower Admin wäre folgendes:

If-Bedingungen können verwendet werden, um die Anzeige von Werten flexibler zu gestalten.

Beispielsweise können Sie definieren, dass das Label für mobile_phone nur angezeigt wird, wenn eine Mobiltelefonnummer im Profil eingetragen ist.

If-Bedingungen bestehen immer aus einem öffnenden und einem schließenden Tag, jeweils in doppelte geschweifte Klammern eingeschlossen.

Das Muster lautet wie folgt:

{% if [CONDITION] %} … {% endif %}

Die folgende Tabelle bietet eine Übersicht über mögliche Vergleichsoperatoren:

Gleich

==

Ungleich

!=

Größer als

>

Kleiner als

<

Größer als oder gleich

>=

Kleiner als oder gleich

<=

Im Folgenden finden Sie ein Beispiel für die Verwendung von if-Bedingungen:

Wenn für eine Property im ausgewählten Profil kein Wert eingetragen ist, kann durch eine if-Bedingung verhindert werden, dass diese Property im Dokument angezeigt wird.

Der folgende Auszug zeigt ein Beispiel für eine solche if-Bedingung, bei der das Label für mobile_phone nicht angezeigt wird, wenn keine Mobiltelefonnummer im Profil eingegeben ist:

{% if User.Mobile_Phone.Value != null %}{{User.Mobile_Phone.Label}}: {{User.Mobile_Phone.Value}}{% endif %}

Else if-Bedingungen können innerhalb von if-Bedingungen verwendet werden. Falls die if-Bedingung nicht greift, wird die else if-Bedingung innerhalb des if-Blocks geprüft.

Es gibt keine Begrenzung für die Anzahl der verwendeten else if-Bedingungen.

Das Muster für eine else if-Bedingung lautet wie folgt:

{% if [CONDITION] %} … {% elseif %} … {% endif %}

Im Folgenden finden Sie ein Beispiel für die Verwendung von else if-Bedingungen:

Falls die primäre Option nicht verfügbar oder nicht eingetragen ist, wird eine alternative Option gewählt. Ist keine der beiden Optionen verfügbar, wird die Bezeichnung ausgelassen.

Der folgende Auszug zeigt die else if-Bedingung für dieses Beispiel.

{% if User.Mobile_Phone.Value != null %}{{User.Mobile_Phone.Label}}: {{User.Mobile_Phone.Value}}{% elseif User.Phone.Value != null %}{{User.Phone.Label}}: {{User.Phone.Value}}{% else %}{% endif %}

In diesem Beispiel bleibt der else-Teil leer. Wenn hier ein Wert angegeben wird, wird dieser Wert verwendet.

Für Listen mit mehreren Einträgen desselben Typs (z. B. Geschäftsführer) können for-Schleifen verwendet werden. Diese bestehen aus einem öffnenden und einem schließenden Tag in doppelten geschweiften Klammern.

Innerhalb der for-Schleife geben Sie eine Variable ein, die die Werte Ihrer Liste repräsentiert. Diese Variable wird in doppelte geschweifte Klammern gesetzt.

Das Muster lautet wie folgt:

{% for [VAR] in [ENTITY VARIABLE] %}{{VAR}}{% endfor %}

Typischerweise werden for-Schleifen für Properties vom Typ Array verwendet, z. B. für folgende Unternehmensinformationen:

Im Folgenden finden Sie ein Beispiel für die Verwendung von solchen for-Schleifen:

Eine Liste mit Einträgen für Geschäftsführer wird erstellt. Die Liste wird durch eine Bezeichnung eingeleitet und durch Zeilenumbrüche getrennt.

Der folgende Auszug zeigt die Konfiguration für dieses Beispiel:

{{Company.Managing_Directors.Label}}:[n/]{% for MD in Company.Managing_Directors.Value %}{{MD}}[n/]{% endfor %}

Das Ergebnis für ein Unternehmen mit den Geschäftsführern empower Admin und empower User wäre:

Falls die Einträge mehrere Properties enthalten, fügen Sie nach den Variablen einen Punkt hinzu und spezifizieren Sie dann die Property und den Typ (Label oder Value):

{% for [VAR] in [ENTITY VARIABLE] -%} {{VAR.PROPERTY.Label}}: {{VAR.PROPERTY.Value}}, {% endfor %}

Im Folgenden finden Sie ein Beispiel für die Verwendung von solchen for-Schleifen:

Eine Liste mit Einträgen zur Bankverbindung soll erstellt werden, wobei jeder Eintrag drei Eigenschaften enthält:

Der folgende Auszug zeigt die Konfiguration für dieses Beispiel:

{% for BI in Company.Banking_Information.Value %}{{BI.Name.Value}}: {{BI.IBAN.Label}}: {{BI.IBAN.Value}}, {{BI.BIC.Label}}: {{BI.BIC.Value}}{% endfor %}

Das Ergebnis für die Bankverbindung eines Unternehmens könnte wie folgt aussehen:

Einträge lassen sich mit Zeilenumbrüchen, Trennzeichen, Kommas etc. trennen.

Sie können Formatierungstags verwenden, um jede Eigenschaft individuell zu formatieren.

Beispielsweise kann der Bankname fett dargestellt werden, während die restlichen Einträge unformatiert bleiben.

Nutzen Sie das unless-Tag, um eine alternative Formatierung anzuwenden, z. B. beim letzten Listeneintrag.

Das Muster für diese Konfiguration lautet wie folgt:

{% for [VAR] in %}{{VAR}}{% unless %} ... {% endunless %}{% endfor %}

Im Folgenden finden Sie ein Beispiel für die Verwendung von solchen for-Schleifen:

Ein Komma soll zwischen den Listeneinträgen gesetzt werden.

Nach dem letzten Listeneintrag soll kein Komma eingefügt werden.

Der folgende Auszug zeigt die Konfiguration für dieses Beispiel:

{{Company.Managing_Directors.Label}}: {% for MD in Company.Managing_Directors.Value -%}{{MD}}{% unless forloop.last %},{% endunless %}{% endfor %}

Das Ergebnis für ein Unternehmen mit den Geschäftsführern empower Admin und empower User wäre:

Filter sind spezielle Funktionen zur Anpassung und Formatierung von Daten in Vorlagen.

Filter werden wie folgt angewandt:

{{ [VARIABLE NAME] | [FILTER NAME]: Argument }}

Die folgende Tabelle zeigt übliche Filter, die mit empower^® verwendet werden:

Capitalize

Erster Buchstabe wird großgeschrieben.

{{ [PROPERTY NAME] | Capitalize }}

Upcase

Alle Buchstaben werden großgeschrieben.

{{ [PROPERTY NAME] | Upcase }}

Downcase

Alle Buchstaben werden kleingeschrieben.

{{ [PROPERTY NAME] | Downcase }}

Replace

Teilstrings werden ersetzt.

{{ [PROPERTY NAME] | Replace: "cats", "dogs" }}

Size

Definiert die Anzahl an Zeichen in einem String oder Array.

{{ [PROPERTY NAME] | Size }}

Strip

Führende und nachfolgende Leerzeichen werden entfernt.

{{ [PROPERTY NAME] | Strip }}

Geben Sie vor dem senkrechten Strich den Property-Namen und den Typ (Label oder Value) der zu filternden Property an.

Sie können mehrere Filter können kombinieren, indem Sie sie mit dem senkrechten Strich trennen.

Das Muster für einen solchen Filter lautet wie folgt:

{{ [VARIABLE NAME] | Filter1 | Filter2 }}

Im Folgenden finden Sie Beispiele für die Verwendung von solchen Filter:

Ein Filter wird verwendet, um sicherzustellen, dass die Zeichen $% als Zeichenumbruch übertragen werden.

Das ist nützlich, wenn mehrere Werte in einem String enthalten sind, die in mehreren Zeilen angezeigt werden sollen.

Der folgende Auszug zeigt die Konfiguration für dieses Beispiel:

{{Location.Address.Value.Street.Value | Replace: "\$\%", "[n/]"}}

Der String für Straße würde in der Unternehmensverwaltung wie folgt aussehen:

Das Ergebnis in der Vorlage wäre:

Es soll eine benutzerdefinierte Variable erstellt werden, die die Zeichenanzahl zweier Werte addiert und entscheidet, ob diese in einer Zelle oder in getrennten Zeilen dargestellt werden:

Der folgende Auszug zeigt die Konfiguration für dieses Beispiel:

{% assign charLength = Location.Website.Value.size | Plus: Location.Email.Value.size %}{{Location.Website.Value}}{% if charLength >46 %}[n/]{% else %}, {% endif %}{{Location.Email.Value}}

Das Ergebnis für eine Kombination mit weniger oder gleich 46 Zeichen wäre folgendes:

Das Ergebnis für eine Kombination mit mehr als 46 Zeichen wäre folgendes: