Publiceer en deploy

Publiceer en deploy

Publiceren en deployen zijn twee aparte beslissingen. Publiceren bevriest een concept tot een versie die buiten de editor gebruikt mag worden. Deployen bepaalt in welke omgeving die versie mag draaien.

Voor publicatie

Controleer dat:

• De PDF-preview klopt voor de belangrijkste voorbeelden.
• Verplichte velden duidelijk zijn.
• Optionele tekst werkt zoals verwacht.
• Het juiste theme, de juiste fonts en gedeelde fragmenten worden gebruikt.
• Waarschuwingen begrepen en geaccepteerd zijn.

Je kunt ook twee versies naast elkaar vergelijken als gerenderde PDF’s met dezelfde voorbeelddata, wanneer je precies wilt zien wat er is veranderd.

Publiceren kan worden geblokkeerd om redenen die niets met het document zelf te maken hebben. Elke stencil die de template gebruikt, moet eerst gepubliceerd zijn, en als het datacontract is gewijzigd op een manier die bestaande data breekt, stopt Epistola en moet je het contract eerst expliciet publiceren. Compatibele contractwijzigingen worden samen met de versie gepubliceerd, dus die vragen geen extra stap.

Wat publiceren bevriest

Een gepubliceerde versie is een snapshot: de documentinhoud, het opgeloste theme en de fonts waarvan het afhangt worden vastgelegd, zodat dezelfde data later hetzelfde document oplevert. Gepubliceerde versies kunnen daarom niet worden bewerkt, en er is geen manier om een publicatie terug te draaien: om iets te wijzigen publiceer je een nieuwe versie.

Publiceren zet de versie niet meteen aan het werk, maar het is ook niet onzichtbaar: een aanroeper die geen versie en geen omgeving noemt, krijgt de nieuwste gepubliceerde versie. Het kiezen van een omgeving bepaalt welke versie in die fase draait.

Deploy naar de juiste omgeving

Omgevingen zijn de fasen waarin een document kan draaien, meestal test, acceptatie en productie, en elke variant heeft maximaal één actieve versie per omgeving. De deploymentmatrix toont dit als een raster — één rij per variant, één kolom per omgeving — met de actieve versie in elke cel. Een andere versie kiezen activeert die meteen, en de cel leegmaken haalt de deployment weg. Terugschakelen naar een eerdere gepubliceerde versie is hoe je terugrolt; gepubliceerde versies worden nooit aangepast om een deployment te repareren.

Een concept deployen publiceert het tegelijk, omdat alleen een gepubliceerde versie actief kan zijn.

Gebruik eerst test of acceptatie wanneer een ander systeem de template gaat aanroepen. Ga pas naar productie wanneer de gekoppelde workflow met realistische data is gecontroleerd.

Wanneer opnieuw publiceren?

Publiceer een nieuwe versie voor wijzigingen die gebruikers moeten goedkeuren of die gegenereerde output veranderen. Kleine conceptwijzigingen zijn onzichtbaar tot je publiceert, omdat een concept nooit automatisch wordt gekozen.

Auteurschap en publiceren zijn aparte rechten: auteurs werken aan concepten, terwijl een publicatierol publiceert, deployt en archiveert. Omgevingen worden door beheerders ingesteld, zodat auteurs werk kunnen voorbereiden zonder te kunnen veranderen wat productie draait.

Archiveren zet een versie op non-actief met behoud voor audit. Een versie kan alleen worden gearchiveerd als die in geen enkele omgeving actief is, dus haal hem eerst uit de deployments.