Documenten genereren

Epistola zet een template en data om in een PDF. De workflow bestaat uit twee duidelijke fasen: preview tijdens het maken en productie-generatie vanuit een goedgekeurde, gepubliceerde versie.

Preview tijdens het bewerken

Preview rendert de huidige draft met het geselecteerde data-voorbeeld. Open de preview vanuit de editor om tekst, expressies, opmaak, pagina-einden, optionele inhoud, tabellen, afbeeldingen en herhaalde secties te controleren. De preview wordt bijgewerkt terwijl je bewerkt en is bedoeld voor auteurs; het is niet het productiedocument.

Wissel tijdens het werken tussen meerdere voorbeelden. Test lange waarden, lege optionele waarden, beide uitkomsten van condities en korte en lange herhaalde data, zodat layoutproblemen vóór publicatie zichtbaar worden.

Een productieversie voorbereiden

Gebruik deze levenscyclus voor documenten die voor echte zaken worden gegenereerd:

Bewerk de draft en richt het datacontract en de voorbeelden in.
Preview met representatieve data.
Los validatie-, kwaliteits- en layoutproblemen op.
Publiceer de goedgekeurde versie.
Deploy of activeer die versie in de doelomgeving.

Productie-aanroepers gebruiken een gepubliceerde versie, nooit een onafgemaakte draft. Met varianten ondersteunt één template verschillende talen, doelgroepen of layouts met hetzelfde documentdoel.

Eén document genereren

Een gekoppeld systeem, zoals Valtimo, stuurt data die bij het datacontract van de template past. De geselecteerde variant en de gepubliceerde versie bepalen de layout en expressies van de PDF. Details over integratie en authenticatie staan in de API-documentatie; deze pagina beschrijft de documentlevenscyclus.

Meerdere documenten genereren

Gebruik batchgeneratie wanneer dezelfde template voor meerdere records moet worden gerenderd. Een batchaanvraag maakt een gevolgde job aan die van verwerking naar voltooiing of mislukking gaat. Houd de job in de gaten en beoordeel mislukte items afzonderlijk; één ongeldig record hoeft onderzoek van de andere records niet te verhinderen.

Het resultaat onderzoeken

Controleer bij ontbrekende of onverwachte uitvoer:

Of alle verplichte data aanwezig is en bij het datacontract past.
Of de bedoelde variant en omgeving zijn geselecteerd.
Of de versie in die omgeving gepubliceerd en actief is.
Of expressies, conditieblokken en herhalingen zonder fouten previewen.
Of fonts, afbeeldingen, pagina-einden, headers en footers correct worden gerenderd.
Of mislukte batchitems met hun eigen foutdetails zijn onderzocht.

Uitvoer

Epistola genereert momenteel PDF-documenten. De bestandsnaam en wat er na generatie gebeurt—download, opslag of koppeling aan een zaak—worden bepaald door het gekoppelde systeem of de workflow die het document heeft aangevraagd.