Migratie van iText5 naar iText7

• Migratie van iText5 naar iText7
• • Wat is iText?
  • Waarom migreert VLOK van versie 5 naar versie 7?
  • Wat zijn de gevolgen voor uw sjablonen? Welke actie is nodig?
  • Hoe kan de toepassingsbeheerder LB tijdens de overgangsperiode conversie via versie 5 en 7 vergelijken?
  • Timing migratie
  • Hoe lost u gekende migratie problemen op?

Wat is iText?

De documentenmodule van VLOK gebruikt een html-editor om documenten aan te maken en te bewerken. Op het moment van ondertekenen of als u een voorbeeld toont, zet VLOK het document om naar een pdf. Voor deze conversie gebruikt VLOK de iText bibliotheek.

Waarom migreert VLOK van versie 5 naar versie 7?

Migratie is noodzakelijk omdat versie 5 niet langer ondersteund wordt door de leverancier. Versie 7 sluit beter aan bij de nieuwe standaarden en is daarom meer future-proof.

Concreet is versie 7 noodzakelijk om mails te kunnen opladen in de documentmodule.

Zie voor een uitgebreide vergelijking tussen de verschillende versies.

Wat zijn de gevolgen voor uw sjablonen? Welke actie is nodig?

Versie 7 converteert meer natuurgetrouw html naar pdf dan versie 5.  Dit betekent dat tips en trics die VLOK toepastte om de conversie via versie 5 toonbaar te maken niet langer nodig zijn.  

In de praktijk kan dit het gevolg hebben dat uw sjablonen niet meer 100% geconverteerd worden zoals u verwacht. 

• Het ontwikkelteam en Wonen in Vlaanderen hebben via een testtool de conversie van de sjablonen tussen versie 5 en versie 7 vergeleken en waar aangewezen de programmatie aangepast om veel voorkomende problemen op te lossen.

• Verschillen die nu nog voorkomen hebben voornamelijk te maken met de html code zelf en zijn niet op te lossen via programmatie.

Daarom is het noodzakelijk dat een toepassingsbeheerder van het lokaal bestuur tijdens een overgangsperiode beide conversies met elkaar vergelijkt en de sjablonen wijzigt indien nodig.

Hoe kan de toepassingsbeheerder LB tijdens de overgangsperiode conversie via versie 5 en 7 vergelijken?

1. Klik op Sjablonen beheren in het hoofdmenu  

2. Selecteer het documenttype (DT). en het te vergelijke sjabloon.

   Zie voor meer info: Hoe beheer ik sjablonen en pas ze aan aan de huisstijl van mijn organisatie?

3. Selecteer de renderversie die u wenst, iText 5 of 7, sla op via  en toon een voorbeeld via .
   
   

4. Wijzig het sjabloon indien nodig zodat het correct wordt geconverteerd via versie 7

5. Geef feedback via 'Contacteer ons' rechtsboven indien u problemen niet opgelost krijgt.  Zie voor workarounds voor veel voorkomende problemen hieronder.

Timing migratie

Vanaf 30 juni 2021 zal VLOK alle sjablonen converteren via versie 7. Om de overgang vlot te laten verlopen voorzien we voldoende tijd voor de toepassingsbeheerders om conversies te vergelijken en sjablonen aan te passen.

• Vanaf 23 april 2021 kunnen de toepassingsbeheerders van de pilootgroepgemeenten documenten converteren zowel met de verouderde versie 5 als de nieuwe versie 7.

• We verzamelen hun feedback via 'Contacteer ons' en passen programmatie aan indien nodig.

• Vanaf 27 mei 2021 kunnen alle toepassingsbeheerders conversies vergelijken en sjablonen aanpassen.

• Vanaf 30 juni 2021 zal VLOK alle sjablonen converteren via versie 7. Bij pertinente problemen kan de toepassingsbeheerder Wonen de conversie voor een bepaald sjabloon nog terugdraaien

Hoe lost u gekende migratie problemen op?