Catalogus documentsjabloon: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Newline)
(Variabele teksten)
Regel 79: Regel 79:
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
 
|
 
|
<i>De oude methode (t/m versie 3.21) is hier in te zien: [http://wiki.zaaksysteem.nl/Documentsjablonen_variabele_teksten Documentsjablonen Variabele teksten].</i>
+
<p>
<br>
+
  <i>
<br>
+
    De oude methode (t/m versie 3.21) is hier in te zien:
In de sjablonen kan een gedeelte van het sjabloon afhankelijk van een waarde in de zaak getoond of verborgen worden.
+
    [http://wiki.zaaksysteem.nl/Documentsjablonen_variabele_teksten Documentsjablonen Variabele teksten].
<ol>
+
  </i>
<li>Zet de cursor op de juiste plek of selecteer het blok tekst en selecteer in het menu Insert - Section...</li>
+
</p>
<li>Zet de cursor in de sectie en selecteer in het menu Insert - Script...</li>
+
 
<li>Verander de waarde van 'Script type' in 'zttscript'</li>
+
<p>
<li>Selecteer de 'Text' optie en vul in: show_when { voorbeeld_magicstring == "voorbeeld waarde" }</li>
+
  In de sjablonen kan een gedeelte van het sjabloon afhankelijk van een waarde in de zaak getoond of verborgen worden.
</ol>
+
 
 +
  <ol>
 +
    <li>Zet de cursor op de juiste plek of selecteer het blok tekst en selecteer in het menu Insert - Section...</li>
 +
    <li>Zet de cursor in de sectie en selecteer in het menu Insert - Script...</li>
 +
    <li>Verander de waarde van 'Script type' in 'zttscript'</li>
 +
    <li>Selecteer de 'Text' optie en vul in: <pre>show_when { voorbeeld_magicstring == "voorbeeld waarde" }</pre></li>
 +
  </ol>
 +
</p>
  
 
Voorbeeld inrichting:
 
Voorbeeld inrichting:
Regel 119: Regel 126:
 
|[[bestand:Sjablonen variabel script dialog.png|thumb|Dialoog voor scripts]]
 
|[[bestand:Sjablonen variabel script dialog.png|thumb|Dialoog voor scripts]]
 
|}
 
|}
 +
 
= Variabele newline iteratie =
 
= Variabele newline iteratie =
 
Newline iteratie en variabele teksten maken beide gebruik van secties met daarin een zttscript. Het is daarom mogelijk om deze te combineren met het volgende script:
 
Newline iteratie en variabele teksten maken beide gebruik van secties met daarin een zttscript. Het is daarom mogelijk om deze te combineren met het volgende script:

Versie van 11 jun 2015 om 13:49

Algemeen

Een van de unieke functionaliteiten van zaaksysteem.nl is dat het een eigen sjablonengenerator heeft op basis van LibreOffice. Dit maakt het mogelijk om geautomatiseerd documenten aan te maken op basis van een sjabloon. Denk hierbij aan een ontvangstbevestiging of een beschikking. Documentsjablonen worden centraal in de Catalogus beheerd, en in een Zaaktype geselecteerd om te gebruiken.

Nieuwe documentsjablonen worden gemaakt door documenten op te maken en deze op te slaan als een ODT-bestand. Je kunt hiervoor LibreOffice gebruiken (indien er geen mogelijkheid is tot het installeren van LibreOffice kan er ook gebruik gemaakt worden van de portable LibreOffice app), maar ook Microsoft Office 2010 kan documenten opslaan in dit formaat.

Een documentsjabloon werkt met ‘magicstrings’. Dit zijn de variabele die verwijzen naar de waarden van Kenmerken binnen een zaak, die het zaaksysteem kan invullen tijdens het genereren van een document.

Iteratie

De oude methode (t/m versie 3.21) is hier in te zien: Documentsjablonen - Iteratie.

Iteratie zorgt ervoor dat informatie voor de magicstrings niet uit de zaak zelf wordt opgehaald, maar uit alle Gerelateerde zaken. Dit kan vervolgens op drie manieren worden weergegeven:

  • Inline itereren: Op één regel, gescheiden door <komma><spatie>
  • Tekstblok newline itereren: Een tekstblok dat geïtereerd wordt voor elke gerelateerde zaak, gescheiden door <enter>
  • Tabel itereren: Eén tabelrij itereren om één tabel te vormen met informatie uit de gerelateerde zaken

Inline

Input Output
Gerelateerde zaken
De volgende zaken zijn verwerkt: [[iterate:case.child_cases:zaaknummer]].
De volgende zaken zijn verwerkt: 2462, 2463, 2465, 2467.
Deelzaken
De volgende zaken zijn verwerkt: [[iterate:case.child_cases:zaaknummer]].
De volgende zaken zijn verwerkt: 2462, 2463, 2465, 2467.

Newline

In de sjablonen kan een tabellenrij herhaald worden voor elk van de gerelateerde of deelzaken die de zaak heeft.
  1. Zet de cursor op de juiste plek of selecteer het blok tekst en selecteer in het menu Insert - Section...
  2. Zet de cursor in de sectie en selecteer in het menu Insert - Script...
  3. Verander de waarde van 'Script type' in 'zttscript'
  4. Selecteer de 'Text' optie en vul in:
    • Voor gerelateerde zaken:
      iterate case.related_cases
    • Voor deelzaken:
      iterate case.child_cases

Let op: De iteraties worden gescheiden door een return (enter).

Dialoog voor scripts
Voorbeeld zakenoverzicht
Voorbeeld itererend tekstblok

Tabel

In de sjablonen kan een tekstblok herhaald worden voor elk van de gerelateerde of deelzaken die de zaak heeft.
  1. Maak een tabel die één rij hoog is
  2. Zet de cursor op een willekeurige plek in de tabel en selecteer in het menu Insert - Script...
  3. Verander de waarde van 'Script type' in 'zttscript'
  4. Selecteer de 'Text' optie en vul in:
    • Voor gerelateerde zaken:
      iterate case.related_cases
    • Voor deelzaken:
      iterate case.child_cases

Tabellen hebben over het algemeen een titelrij, maar omdat een itererende tabel uit maar één rij mag bestaan kan deze niet in dezelfde tabel opgenomen worden. De oplossing is eenvoudig: Maak twee tabellen van elk één rij; één voor de titels en één voor de iteratie. Plak deze vervolgens tegen elkaar door de enters ertussen uit te verwijderen.

Dialoog voor scripts

Variabele teksten

De oude methode (t/m versie 3.21) is hier in te zien: Documentsjablonen Variabele teksten.

In de sjablonen kan een gedeelte van het sjabloon afhankelijk van een waarde in de zaak getoond of verborgen worden.

  1. Zet de cursor op de juiste plek of selecteer het blok tekst en selecteer in het menu Insert - Section...
  2. Zet de cursor in de sectie en selecteer in het menu Insert - Script...
  3. Verander de waarde van 'Script type' in 'zttscript'
  4. Selecteer de 'Text' optie en vul in:
    show_when { voorbeeld_magicstring == "voorbeeld waarde" }

Voorbeeld inrichting:

Sjabloon

Beste meneer [aanvrager_naam],

Sectie 1 met: Uw aanvraag is [beoordeling_compleet]. U kunt uw aanvraag volgen op uw persoonlijke internetpagina.
Sectie 2 met: Uw aanvraag is [beoordeling_compleet]. U kunt de ontbrekende documenten toevoegen via uw persoonlijke internetpagina.

Script

Sectie 1 met: show_when { beoordeling_compleet == "ontvankelijk" }
Sectie 2 met: show_when { beoordeling_compleet == "niet ontvankelijk" }

Output

Bij ontvankelijk:
Beste meneer Piet Friet,

Uw aanvraag is ontvankelijk. U kunt uw aanvraag volgen op uw persoonlijke internetpagina.

Bij niet ontvankelijk:
Beste meneer Piet Friet,

Uw aanvraag is niet ontvankelijk. U kunt de ontbrekende documenten toevoegen via uw persoonlijke internetpagina.

Dialoog voor scripts

Variabele newline iteratie

Newline iteratie en variabele teksten maken beide gebruik van secties met daarin een zttscript. Het is daarom mogelijk om deze te combineren met het volgende script:

show_when { voorbeeld_magicstring == "voorbeeld_waarde" }
iterate case.child_cases

Let op: De volgorde is hier van belang.