End-to-end scenario

End-to-end

Gebruik dit scenario als doelvorm voor een eerste werkende implementatie. Dit is het hele pad in één overzicht; elke stap staat uitgebreider in de unit of gids waar hij bij hoort.

Scenario

1. Een gedeelde catalogus installeert de starttemplate in de tenant die gaat genereren.
2. Een auteur controleert de template, de voorbeelden en de herbruikbare onderdelen in de Suite.
3. De auteur publiceert de goedgekeurde versie en deployt hem naar de omgeving die de zaak gaat gebruiken.
4. Een Valtimo-zaak bereikt de stap waar het document nodig is.
5. Valtimo stuurt de zaakinformatie naar Epistola, gemapt op de velden die de template verwacht.
6. Epistola genereert de PDF en meldt de uitkomst terug aan het proces.
7. De zaak wacht op die uitkomst en maakt de PDF daarna beschikbaar aan de gebruiker.
8. De gebruiker reviewt het document vanuit de zaaktaak, en downloadt het wanneer hij het bestand nodig heeft.

Waar het pad meer werk is dan het lijkt

• Publiceren en deployen zijn twee beslissingen. Publiceren zet een versie vast; deployen legt vast dat deze variant actief is in een omgeving. Wanneer de zaak een omgeving gebruikt, bepaalt de deployment uit welke versie hij genereert, en activeren gebeurt per variant — één variant deployen doet de andere niet mee.
• De template moet bij de genererende tenant komen. Dat is een catalogusimport of een abonnement, niet iets wat de verbinding regelt. Twee tenants zien elkaars templates niet doordat de plugin is geconfigureerd.
• Een omgeving is optioneel, en dat kan verrassen. Een zaak die geen omgeving noemt, genereert uit de laatst gepubliceerde versie. Dat is handig, en het betekent dat wat een zaak oplevert kan veranderen zodra iemand opnieuw publiceert.
• De PDF in het zaakdossier krijgen is een stap extra. De download maakt het bestand standaard beschikbaar als tijdelijke resource met een korte levensduur, en het in de zaak opslaan doet Valtimo’s Documenten API-component zolang die resource er nog is. Epistola neemt het niet voor je op in het zaakdossier.
• Een ontbrekende deployment mislukt niet bij het insturen. De meeste ontbrekende voorwaarden worden geweigerd zodra de zaak het verzoek stuurt, maar een versie die nooit naar de genoemde omgeving is gedeployed wordt geaccepteerd en mislukt later. Behandel een mislukte generatie als een echte uitkomst die het proces moet afhandelen — routeer de mislukking naar retry of handmatige review.

Houd de splitsing duidelijk

Zo blijft de workflow begrijpelijk: Valtimo bezit de zaak, Epistola bezit het document. Zaakbehandeling, beslissingen en gebruikerstoegang blijven in Valtimo; de template, de inhoud en het renderen blijven in Epistola.