Wie füge ich Listen zu einer Vorlage hinzu

Das Hinzufügen dynamischer Listen zu Ihren DocuGenerate-Vorlagen ist eine hervorragende Möglichkeit, wiederholende Daten übersichtlich darzustellen. Mit DocuGenerate können Sie über Arrays in Ihren JSON-Daten iterieren, um Listen zu erstellen. Arrays können primitive Datentypen oder verschachtelte Objekte enthalten.

Iteration über primitive Typen

Wenn Ihre JSON-Daten ein Array primitiver Daten enthalten, wie Zeichenfolgen oder Zahlen, können Sie eine Liste mit einer einfachen Schleifenstruktur in Ihrer Vorlage erstellen.

Hier ein Beispiel der Vorlagensyntax:

[#items]
- [.]
[/items]

In diesem Beispiel geben [#items] und [/items] Anfang und Ende der Schleife an. Sie können auch [/] als Kurzform für das Ende der Schleife verwenden. Das [.] innerhalb der Schleife ist der Platz, an dem jedes Element aus dem Array eingefügt wird.

Wenn Ihre JSON-Daten beispielsweise so aussehen:

[{
  "items": [
    "Cars",
    "Trains"
  ]
}]

Sieht die generierte Liste in Ihrem Dokument so aus:

- Cars
- Trains

Iteration über verschachtelte Objekte

Sie können auch über ein Array verschachtelter Objekte iterieren. In diesem Fall können Sie auf die Eigenschaften jedes Objekts innerhalb der Schleife zugreifen.

Hier ein Beispiel der Vorlagensyntax:

[#items]
- [name]: [quantity]
[/items]

In diesem Beispiel geben [#items] und [/items] wiederum Anfang und Ende der Schleife an. Das [name]: [quantity] innerhalb der Schleife ist der Platz, an dem die Eigenschaften name und quantity jedes Elements eingefügt werden.

Wenn Ihre JSON-Daten beispielsweise so aussehen:

[{
  "items": [{
    "name": "Cars",
    "quantity": "10"
  }, {
    "name": "Trains",
    "quantity": "20"
  }]
}]

Sieht die generierte Liste in Ihrem Dokument so aus:

- Cars: 10
- Trains: 20

Zusammenfassend ermöglicht das Hinzufügen von Listen zu Ihren Vorlagen die effiziente Darstellung wiederholender Daten, egal ob es sich um primitive Typen oder verschachtelte Objekte handelt.