Wie füge ich Bedingungen zu einer Vorlage hinzu

In DocuGenerate können Sie Ihren Vorlagen ganz einfach bedingte Logik hinzufügen. Diese Funktion ermöglicht es Ihnen, Ihre Dokumente basierend auf bestimmten Bedingungen in Ihren JSON-Daten anzupassen und so einen völlig neuen Level der Personalisierung zu erreichen.

Bedingungen erstellen

Um eine bedingte Anweisung in Ihrer Vorlage zu erstellen, verwenden Sie die Tags [#bedingung] und [/bedingung], um den Anfang und das Ende der Bedingung anzugeben. Für das Ende der Bedingung kann auch die Kurzform [/] verwendet werden. Zusätzlich können Sie Negationsanweisungen mit dem Starttag [^bedingung] definieren.

Hier ist ein Beispiel für bedingte Anweisungen:

[#client]
Client's name: [client_name]
[/client]
[^client]
No client found
[/client]

In dieser Syntax:

• [#client] und [/client] geben Anfang und Ende des Abschnitts an, der angezeigt wird, wenn die client-Bedingung wahr ist. Der Tag [client_name] in diesem Abschnitt wird durch den entsprechenden Wert aus den JSON-Daten ersetzt.

• [^client] und [/client] geben Anfang und Ende des Abschnitts an, der angezeigt wird, wenn die client-Bedingung falsch ist. In diesem Fall wird der Text No client found angezeigt.

Wenn Ihre JSON-Daten beispielsweise so aussehen:

[{
  "client": true,
  "client_name": "Railway Company"
}]

ODER

[{
  "client": {
    "client_name": "Railway Company"
  }
}]

Generiert die Vorlage folgende Ausgabe:

Client's name: Railway Company

Wenn der Wert von client jedoch false, null, ”“ (leere Zeichenfolge), 0 (die Zahl Null) oder [] (leeres Array) wäre, lautete die Ausgabe:

No client found

Ausdrücke hinzufügen

Wenn Sie komplexere bedingte Anweisungen mit logischen und mathematischen Ausdrücken erstellen möchten, müssen Sie die erweiterte Syntax in Ihrer Vorlage verwenden.

Logische Ausdrücke umfassen UND (&&), ODER (||) und relationale Operationen, mit denen Sie Bedingungen erstellen können, die mehrere Kriterien erfordern. Der folgende Ausdruck prüft beispielsweise, ob das Alter größer als 18 ist und das Land US ist:

[#age > 18 && country == "US"]
This content is only visible to users who are over 18 and reside in US.
[/]

Verwenden Sie in Ihren Bedingungen doppelte Anführungszeichen (") um Zeichenfolgen und doppelte Gleichheitszeichen (==) für Vergleiche.

Mathematische Ausdrücke ermöglichen es Ihnen, Operationen innerhalb der Bedingung auszuführen. Der folgende Ausdruck prüft beispielsweise, ob das Gehalt größer als das 1,5-fache des Durchschnittsgehalts ist:

[#salary > average_salary * 1.5]
Content for those whose salary is greater than 1.5 times the average salary.
[/]

Mit bedingter Logik können Sie dynamische, flexible Vorlagen erstellen, die sich an Ihre Daten anpassen.