Genereren document mislukt

[#1]

Het komt regelmatig voor dat het genereren van een document mislukt nadat er een nieuwe template is aangemaakt of als een bestaande template is aangepast.

In de meeste gevallen is dit te wijten aan objecten die in de template staan die niet worden ondersteund door Docs. Deze objecten komen vaak mee met Word-documenten die als uitgangspunt worden gebruikt voor een template. Doordat ze niet worden ondersteund zijn ze ook niet zichtbaar in de Template Editor, waardoor het vaak niet duidelijk is wat de oorzaak is dat het document niet wordt gegenereerd.

Als een dergelijk object direct tegen een samenvoegveld aan staat dan kan dit problemen opleveren, omdat de Document Generator dan niet in staat is om het samenvoegveld te vervangen met een waarde. Het kan zelfs voorkomen dat het genereren van een document met exact dezelfde template de ene keer wel goed gaat en de andere keer niet. Vaak heeft dit te maken met de uitlijning van de paragraaf waar het samenvoegveld in staat, omdat de lengte van het samenvoegveld de overige tekst in de paragraaf  in meer of mindere mate doet opschuiven.

De eenvoudigste manier om vast te stellen wat het probleem veroorzaakt is om de template ter controle te exporteren naar Word en dan met Alt-F9 de veldcodes zichtbaar maken. Bijvoorbeeld:

In dit voorbeeld staan er FORMTEXT-objecten achter de huisnummertoevoeging, de woonplaats en de datum. Hoogstwaarschijnlijk is dit een bestaand document waarbij oorsponkelijk invulvelden werden gebruikt, en die nu zijn vervangen door samenvoegvelden in de template. Doordat in dit geval de FORMTEXT-objecten zijn achtergebleven in de template kan dit voor problemen zorgen.

Het is mogelijk dat een template die eerst wel naar behoren werkte ineens problemen oplevert. Omdat de objecten niet zichtbaar zijn in de Template Editor kan het zijn dat een bepaalde aanpassing het onzichtbare object verschuift en deze tegen een samenvoegveld aan komt te staan. Vanaf dat moment kan het aanmaken van het document daardoor mislukken. De niet-ondersteunde objecten kunnen ook problemen opleveren als het document wordt opgevraagd in andere formaten, zoals PDF, RTF of HTML. Bij het wegschrijven van het document in dit formaat vindt er conversie plaats die ook kan mislukken doordat er een niet-ondersteund object in het document staat.

Soms is een template waarbij dit probleem optreedt zo vaak aangepast dat de structuur van het document zodanig is beschadigd dat deze nauwelijks meer te herstellen is. Het is dan aan te raden om de versie die nog wel werkte als uitgangspunt te nemen en daar de niet-ondersteunde objecten uit te halen.

Naast FORMTEXT-objecten zijn er een aantal andere objecten die soortgelijk problemen opleveren:

• FILLIN
• MACROBUTTON
• PRIVATE
• SET DATE
• DOCPROPERTY
• DOCVARIABLE
• PRIVATE
• TIME
  
• SDTRUN
  

Alle objecten worden in Word met een grijze achtergrond weergegeven als met Alt-F9 de veldcodes worden opgevraagd. Op die manier is vaak eenvoudig te controleren om welke objecten het gaat. 

Op dit moment worden alleen de volgende objecten ondersteund:

• MERGEFIELD
• IF
• DATE

Alle andere objecten worden in principe niet ondersteund en kunnen tot problemen leiden. Het is niet zo dat deze objecten helemaal niet in de template mogen staan, zolang de Document Generator ze kan negeren. Dat is het geval als ze niet direct tegen een samenvoegveld aan staan, maar ook als ze niet tegen kaders in tabellen, kopteksten of voetteksten staan.

Ons advies is om alle niet-ondersteunde objecten uit de template te verwijderen om ook in de toekomst problemen te voorkomen.