Lijsten toevoegen aan een sjabloon

Het toevoegen van dynamische lijsten aan uw DocuGenerate-sjablonen is een uitstekende manier om repetitieve data te organiseren en weer te geven in een overzichtelijk formaat. Met DocuGenerate kunt u lussen (loops) maken over arrays in uw JSON-data om lijsten te creëren. Arrays kunnen primitieve datatypes of geneste objecten bevatten.

Lussen over primitieve types

Als uw JSON-data een array van primitieve data bevat, zoals tekenreeksen of getallen, kunt u een lijst maken met een eenvoudige lusstructuur in uw sjabloon.

Hier is een voorbeeld van de sjabloonsyntax:

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

In dit voorbeeld geven [#items] en [/items] het begin en einde van de lus aan. U kunt ook [/] gebruiken als verkorte versie om het einde van de lus aan te geven. De [.] binnen de lus is de plek waar elk item uit de array wordt geplaatst.

Als uw JSON-data er bijvoorbeeld als volgt uitziet:

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

Ziet de gegenereerde lijst er in uw document zo uit:

- Cars
- Trains

Lussen over geneste objecten

U kunt ook een lus maken over een array van geneste objecten. In dat geval heeft u binnen de lus toegang tot de eigenschappen van elk object.

Hier is een voorbeeld van de sjabloonsyntax:

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

In dit voorbeeld geven [#items] en [/items] opnieuw het begin en einde van de lus aan. De [name]: [quantity] binnen de lus is de plek waar de eigenschappen name en quantity van elk item worden geplaatst.

Als uw JSON-data er bijvoorbeeld als volgt uitziet:

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

Ziet de gegenereerde lijst er in uw document zo uit:

- Cars: 10
- Trains: 20

Samengevat: door lijsten aan uw sjablonen toe te voegen, kunt u repetitieve data efficiënt weergeven, of het nu gaat om primitieve types of geneste objecten.