Catalogus documentsjabloon: verschil tussen versies
(→Variabele teksten) |
|||
| Regel 2: | Regel 2: | ||
= Algemeen = | = Algemeen = | ||
=== Interne documentgenerator LibreOffice === | === Interne documentgenerator LibreOffice === | ||
| − | Zaaksysteem.nl heeft een interne documentgenerator van [https://www.libreoffice.org/ LibreOffice]. Dit maakt het mogelijk om geautomatiseerd documenten aan te maken op basis van een sjabloon, zoals bijvoorbeeld een ontvangstbevestiging of beschikking. Documentsjablonen worden centraal in de [ | + | Zaaksysteem.nl heeft een interne documentgenerator van [https://www.libreoffice.org/ LibreOffice]. Dit maakt het mogelijk om geautomatiseerd documenten aan te maken op basis van een sjabloon, zoals bijvoorbeeld een ontvangstbevestiging of beschikking. Documentsjablonen worden centraal in de [[Catalogus|Catalogus]] beheerd en worden aan [[Catalogus_zaaktype|Zaaktypen]] toegevoegd, zodat deze in zaken gebruikt kunnen worden. |
Nieuwe documentsjablonen worden gemaakt door documenten op te maken en deze op te slaan als een ODT-bestand. Je kunt hiervoor [https://www.libreoffice.org/ LibreOffice] gebruiken (indien er geen mogelijkheid is tot het installeren van LibreOffice kan er ook gebruik gemaakt worden van de [http://portableapps.com/apps/office/libreoffice_portable portable LibreOffice app]), maar ook Microsoft Office 2010 kan documenten opslaan in dit formaat. | Nieuwe documentsjablonen worden gemaakt door documenten op te maken en deze op te slaan als een ODT-bestand. Je kunt hiervoor [https://www.libreoffice.org/ LibreOffice] gebruiken (indien er geen mogelijkheid is tot het installeren van LibreOffice kan er ook gebruik gemaakt worden van de [http://portableapps.com/apps/office/libreoffice_portable 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 [ | + | Een documentsjabloon werkt met ‘magicstrings’. Dit zijn de variabele die verwijzen naar de waarden van [[Catalogus_kenmerk|Kenmerken]] binnen een zaak, die het zaaksysteem kan invullen tijdens het genereren van een document. |
=== Externe documentgenerator Xential === | === Externe documentgenerator Xential === | ||
| − | Zaaksysteem.nl heeft ook een koppeling met de documentgenerator [https://www.xential.nl/ Xential]. Zie voor meer informatie het [ | + | Zaaksysteem.nl heeft ook een koppeling met de documentgenerator [https://www.xential.nl/ Xential]. Zie voor meer informatie het [[Koppelprofiel_Xential|Koppelprofiel Xential]]. |
= Iteratie = | = Iteratie = | ||
| − | <i>De oude methode (t/m versie 3.21) is hier in te zien: [ | + | <i>De oude methode (t/m versie 3.21) is hier in te zien: [[Documentsjablonen_iteratie|Documentsjablonen - Iteratie]].</i> |
<br> | <br> | ||
<br> | <br> | ||
| − | Iteratie zorgt ervoor dat informatie voor de magicstrings niet uit de zaak zelf wordt opgehaald, maar uit alle [ | + | Iteratie zorgt ervoor dat informatie voor de magicstrings niet uit de zaak zelf wordt opgehaald, maar uit alle [[Zaakdossier_relaties|Gerelateerde zaken]]. Dit kan vervolgens op drie manieren worden weergegeven:<br> |
<ul> | <ul> | ||
<li>Inline itereren: Op één regel, gescheiden door <komma><spatie></li> | <li>Inline itereren: Op één regel, gescheiden door <komma><spatie></li> | ||
| Regel 86: | Regel 86: | ||
</pre> | </pre> | ||
| − | Zie voor de mogelijke vergelijkingen: [ | + | Zie voor de mogelijke vergelijkingen: [[Rekenen_en_Vergelijkingen|Rekenen en Vergelijkingen]] |
| Regel 99: | Regel 99: | ||
<i> | <i> | ||
De oude methode (t/m versie 3.21) is hier in te zien: | De oude methode (t/m versie 3.21) is hier in te zien: | ||
| − | [ | + | [[Documentsjablonen_variabele_teksten|Documentsjablonen Variabele teksten]]. |
</i> | </i> | ||
</p> | </p> | ||
| Regel 118: | Regel 118: | ||
=== Mogelijke vergelijkingen === | === Mogelijke vergelijkingen === | ||
| − | Zie voor de mogelijke vergelijkingen: [ | + | Zie voor de mogelijke vergelijkingen: [[Rekenen_en_Vergelijkingen_Samenvatting|Rekenen en Vergelijkingen]] of [[Rekenen_en_Vergelijkingen|Rekenen en vergelijkingen uitgebreid]] |
=== Voorbeeld === | === Voorbeeld === | ||
| Regel 166: | Regel 166: | ||
Effectief houd dit in dat er altijd geïtereerd wordt. | Effectief houd dit in dat er altijd geïtereerd wordt. | ||
| − | Let op: Dit is niet hetzelfde als [ | + | Let op: Dit is niet hetzelfde als [[Catalogus_documentsjabloon#Iteraties_filteren|Iteraties filteren]]. De magicstrings in de 'show_when'-voorwaarde verwijzen naar de zaak zelf en niet naar de gerelateerde en/of deelzaken. |
= Tips = | = Tips = | ||
Versie van 19 aug 2016 om 10:16
Inhoud
Algemeen
Interne documentgenerator LibreOffice
Zaaksysteem.nl heeft een interne documentgenerator van LibreOffice. Dit maakt het mogelijk om geautomatiseerd documenten aan te maken op basis van een sjabloon, zoals bijvoorbeeld een ontvangstbevestiging of beschikking. Documentsjablonen worden centraal in de Catalogus beheerd en worden aan Zaaktypen toegevoegd, zodat deze in zaken gebruikt kunnen worden.
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.
Externe documentgenerator Xential
Zaaksysteem.nl heeft ook een koppeling met de documentgenerator Xential. Zie voor meer informatie het Koppelprofiel Xential.
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.related_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.
Let op: De iteraties worden gescheiden door een return (enter). |
Tabel
In de sjablonen kan een tekstblok herhaald worden voor elk van de gerelateerde of deelzaken die de zaak heeft.
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. Iteraties filterenIn sommige gevallen is het niet wenselijk dat alle zaken worden meegenomen bij de iteratie. Daarom kan er aan een iteratie een voorwaarde meegegeven worden, zodat enkel zaken die aan die voorwaarde voldoen geïtereerd worden.
iterate case.related_cases { case.zaaktype == "Vergadering" }
iterate case.related_cases { mor_categorie == "Afval" }
Zie voor de mogelijke vergelijkingen: Rekenen en Vergelijkingen
|
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.
Mogelijke vergelijkingenZie voor de mogelijke vergelijkingen: Rekenen en Vergelijkingen of Rekenen en vergelijkingen uitgebreid Voorbeeld
|
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. In het bovenstaande voorbeeld wordt eerst gekeken of het iteratie blok opzich getoond moet worden, en wordt vervolgens pas de iteratie uitgevoerd. Zou de volgorde van de instructies omgedraaid zijn wordt eerst een volledige iteratie gedaan, en wordt het originele tekstblok verborgen. Effectief houd dit in dat er altijd geïtereerd wordt.
Let op: Dit is niet hetzelfde als Iteraties filteren. De magicstrings in de 'show_when'-voorwaarde verwijzen naar de zaak zelf en niet naar de gerelateerde en/of deelzaken.
Tips
Paginaovergang
| Door variabele tekstblokken te gebruiken is het vrijwel onmogelijk om een paginaovergang goed in te richten. De paginaovergang zal vaak erg lelijk zijn: titel en tekst gescheiden, tabellen in tweeën geknipt, etc. De oplossing hiervoor is om deze teksten in frames te zetten. Deze frames kunnen niet over meerdere pagina's heen vallen en een paragraaf zal daarom netjes als één geheel naar de volgende pagina springen.
Het beste resultaat kan bereikt worden door deze frames:
|
