/ Zoeken

Zoek in Epistola

Vind documentatie, integratiehandleidingen, tourstappen, blogposts en pagina's.

DocumentatieIntegratiesTourBlogPagina
↑↓↵esc

In ontwikkeling — Het Leren-gedeelte wordt uitgebreid; alfa-, beta- en previewmogelijkheden worden waar relevant gelabeld.
← Terug naar Leren

Bewerk in de visuele editor

Bouw de documentinhoud, voeg herbruikbare onderdelen toe, vul met voorbeelddata en preview de PDF.

authoringeditor

Bewerk het document

De visuele editor is waar de template een document wordt. Je bouwt het op uit blokken op een canvas, rangschikt de structuur in een boom en controleert het resultaat in een PDF-preview naast je werk. Het canvas toont je structuur; de preview toont hoe de gegenereerde PDF er echt uitziet.

Stappen

  1. Open de template en het concept, en kies een voorbeeld met realistische data.
  2. Voeg de blokken toe die je nodig hebt vanuit het palet.
  3. Voeg velden in waar zaakinformatie moet verschijnen.
  4. Rangschik het document in de structuurboom en style blokken in de inspector.
  5. Gebruik stencils voor standaardfragmenten die veel templates delen.
  6. Preview de PDF, los op wat niet klopt en sla op.

De werkruimte

  • Blokkenpalet — voeg content-, layout-, logica- en paginablokken toe.
  • Canvas — bewerk de inhoud en opmaak van het geselecteerde blok.
  • Structuurboom — bekijk de volgorde van het document en verplaats blokken.
  • Inspector — stel eigenschappen en styling in voor het geselecteerde blok of de tabelcel.
  • PDF-preview — het gerenderde document, dat kort na elke wijziging bijwerkt. Sleep de scheiding om het formaat aan te passen, of sluit het paneel terwijl je aan de structuur werkt.

Blokken

Tekst en koppen ondersteunen uitgebreide opmaak: vet, cursief, onderstreept, doorgestreept en sub- en superscript (die elkaar uitsluiten). Lijsten komen in decimale, letter- en Romeinse formaten, met markers als disc, cirkel, vierkant of streepje; met Tab schuif je een item een niveau dieper terwijl Shift-Tab het weer omhoog haalt. Met Shift+Enter voeg je een harde regelafbreking in een blok toe in plaats van een nieuw blok.

Tabellen tonen records in kolommen; het invoegdialoog gaat tot 50 rijen en 20 kolommen, en daarna kun je rijen of kolommen toevoegen. Afzonderlijke cellen — of een selectie van cellen — kunnen hun eigen achtergrond, uitlijning en randen hebben. Afbeeldingen en QR-codes zijn beheerde content in plaats van geplakte schermafbeeldingen, zodat ze onderhoudbaar blijven; een QR-code kan tot 2.500 bytes aan data bevatten. Scheidingslijnen, containers en kolommen zorgen voor visuele groepering en paginaopmaak.

Voorwaardelijke blokken tonen of verbergen hun inhoud op basis van een expressie. Loops herhalen inhoud voor elk item in een array, en een datalijst toont een array als een opgemaakte lijst met de markeringsstijl die je kiest.

Paginablokken werken op paginaniveau. Een document kan maximaal twee paginakoppen hebben — de eerste geldt voor pagina één, de tweede loopt door op latere pagina’s — en je kunt ze omwisselen door ze binnen de kopzone te slepen. Er is één voettekst, die op de eerste pagina verborgen kan blijven. Het adresblok positioneert ontvangergegevens voor een vensterenvelop; er is er maximaal één per document, en het hoort direct na de kop, omdat content ervoor het venstergebied kan overlappen.

Het juiste blok kiezen

Begin met tekst voor tekst die nooit verandert, en gebruik een veld alleen waar het document zaakgegevens ophaalt. Gebruik een tabel wanneer de data een set records in kolommen is, en een datalijst wanneer elk item in een array één regel in een lijst moet worden; ze lijken op elkaar, maar lossen verschillende problemen op.

Voorwaardelijke blokken, loops en datalijsten bestaan voor content waarvan de zichtbaarheid of herhaling van de data afhangt. Als er niets varieert, zijn gewone blokken eenvoudiger en beter te onderhouden.

Bewaar standaardfragmenten in een stencil in plaats van ze tussen templates te kopiëren, en gebruik paginablokken alleen wanneer de positie of herhaling van content aan de gedrukte pagina vastzit.

Content bij elkaar houden op de pagina

De meeste blokken hebben twee opties voor paginastroom: een blok bij elkaar houden zodat het niet over een paginagrens wordt gesplitst, en het bij het volgende blok houden zodat er geen paginabreuk tussen valt. Een handtekening, een korte tabel of een kop die bij het blok eronder hoort zijn de gebruikelijke kandidaten. Beide stel je in de inspector in, naast de andere eigenschappen van het blok. Blokken die niet over een pagina gesplitst kunnen worden — afbeeldingen, QR-codes en scheidingslijnen — bieden ze niet.

Data erin krijgen

Velden en voorbeelden komen uit het datacontract, dat buiten de visuele editor wordt ingesteld. De veldkiezer biedt de velden die het contract vastlegt, tot vijf niveaus diep; binnen een loop zijn de velden van het item beschikbaar via de alias van de loop, en paginablokken kunnen het huidige paginanummer en het totale aantal pagina’s gebruiken.

Expressies schrijf je in JSONata, met een builder-modus voor het kiezen van velden en een code-modus voor geavanceerdere logica. Het expressiedialoog toont het resultaat met het voorbeeld dat je hebt geselecteerd.

Herbruikbare onderdelen

Stencils voegen een onderhouden fragment toe — een handtekening, een juridische alinea, een footer in huisstijl — als een bewerkbare kopie in het document. Omdat de inhoud deel wordt van de template, verandert een latere stencilrelease nooit stilletjes een versie die je al hebt gepubliceerd. Stencils kunnen niet worden genest.

Opslaan en undo

Je werk wordt automatisch opgeslagen terwijl je bewerkt, en met Ctrl+S sla je direct op. Undo en redo werken apart voor structuurwijzigingen en voor rich-text-bewerkingen, dus een zin ongedaan maken maakt niet ook het blok ongedaan dat je net verplaatste. Als je weggaat met niet-opgeslagen wijzigingen, waarschuwt de browser. Opslaan bewaart een concept; publiceren is een aparte stap, buiten de editor, zodra het document is goedgekeurd.

Als het geselecteerde voorbeeld niet overeenkomt met het contract, meldt de preview het probleem in plaats van te renderen.

Controles voor je publiceert

  • Past de preview goed op de pagina?
  • Worden lange namen, adressen en herhaalde regels goed afgehandeld?
  • Verschijnt en verdwijnt optionele tekst correct?
  • Blijven blokken die niet mogen splitsen — een handtekening, een korte tabel — bij elkaar?
  • Kloppen kop- en voetteksten, ook op de eerste pagina?
  • Zijn standaardfragmenten nog actueel?
  • Gebruikt het document het juiste theme en font?

Publiceer pas wanneer de preview leesbaar is met de belangrijkste voorbeelden.

Zelf proberen

Open de editor met een demo-template

Hiervoor is een gratis account nodig. Zo werkt het

Meer over dit onderwerp