In DocuGenerate kunt u eenvoudig voorwaardelijke logica toevoegen aan uw sjablonen. Met deze functie kunt u uw documenten aanpassen op basis van specifieke voorwaarden in uw JSON-data, wat een geheel nieuw niveau van maatwerk en personalisatie aan uw output toevoegt.
Om een voorwaardelijke instructie in uw sjabloon te maken, gebruikt u de tags [#voorwaarde] en [/voorwaarde] om het begin en einde van de voorwaarde aan te geven. Voor het einde van de voorwaarde kan ook de verkorte vorm [/] worden gebruikt. Daarnaast kunt u negatie-instructies definiëren met de starttag [^voorwaarde].
Hier is een voorbeeld van hoe u voorwaardelijke instructies maakt:
[#client]
Client's name: [client_name]
[/client]
[^client]
No client found
[/client]
In deze syntax:
[#client] en [/client] geven het begin en einde aan van het gedeelte dat wordt weergegeven als de client-voorwaarde waar is. De tag [client_name] in dit gedeelte wordt vervangen door de bijbehorende waarde uit de JSON-data.
[^client] en [/client] geven het begin en einde aan van het gedeelte dat wordt weergegeven als de client-voorwaarde onwaar is. In dat geval wordt de tekst No client found weergegeven.
Als uw JSON-data er bijvoorbeeld als volgt uitziet:
[{
"client": true,
"client_name": "Railway Company"
}]
OF
[{
"client": {
"client_name": "Railway Company"
}
}]
Het sjabloon genereert dan de volgende output:
Client's name: Railway Company
Als de waarde van client echter false, null, ”“ (lege tekenreeks), 0 (het getal nul) of [] (lege array) zou zijn, zou de output zijn:
No client found
Als u complexere voorwaardelijke instructies wilt maken met logische en wiskundige expressies, moet u de uitgebreide syntax in uw sjabloon gebruiken.
Logische expressies omvatten EN (&&), OF (||) en relationele bewerkingen, waarmee u voorwaarden kunt maken die aan meerdere criteria moeten voldoen. Het volgende voorbeeld controleert bijvoorbeeld of de leeftijd groter is dan 18 en het land US is:
[#age > 18 && country == "US"]
This content is only visible to users who are over 18 and reside in US.
[/]
Vergeet niet dubbele aanhalingstekens (") rond tekenreeksen in uw voorwaarden te gebruiken, en dubbele is-gelijk-tekens (==) voor vergelijkingen.
Wiskundige expressies stellen u in staat om bewerkingen uit te voeren binnen de voorwaarde. Het volgende voorbeeld controleert bijvoorbeeld of het salaris groter is dan 1,5 keer het gemiddelde salaris:
[#salary > average_salary * 1.5]
Content for those whose salary is greater than 1.5 times the average salary.
[/]
Met voorwaardelijke logica kunt u dynamische, flexibele sjablonen maken die zich aanpassen aan uw data.