Tags
RV
This article lists the errors that may occur when a Word template is validated by Causeway Field after being imported by a user.
Each error is classified as follows:
Critical — prevents report generation.
Non-critical — report generation is still possible, but the output may not match the user’s intentions.
For some critical loop-related errors, the validator cannot always determine whether the error is located in the previous tag or the following tag. The tag that is reported may therefore be an adjacent one.
Critical errors
Error type | Error case | Example |
Critical error | Any unidentified error that prevents report generation. | All other cases not listed here. |
Unopened loop | The :start tag is missing or unrecognised. An :end tag or table closing tag has no corresponding opening tag. | ##repeat_section_OaEgojXr:end## with no corresponding :start tag. |
Unclosed loop | The :end tag is missing or unrecognised. A :start tag or table opening tag has no corresponding closing tag. | ##repeat_section_OaEgojXr:start## with no corresponding :end tag. |
Invalid loop position | The opening and closing tags are not located in the same container, for example when one is inside a table and the other is outside it. | :start tag inside a table and :end tag outside the table. |
Closing tag does not match the opening tag | The opening and closing tags of nested loops are not placed in the correct order. | ##a:start## ##b:start## ##text## ##a:end## ##b:end## |
Image tags on the same line | Two image tags are placed on the same line. | ##tag:image## ##tag2:image## |
Repeated loop opening tag | The same opening tag appears twice in a row. | ##repeat_section_x:start## ##repeat_section_x:start## |
Repeated loop closing tag | The same closing tag appears twice in a row. | ##repeat_section_x:end## ##repeat_section_x:end## |
Reversed nested loop | A nested loop is opened before its parent loop, in reverse order. | ##child:start## ##parent:start## … ##parent:end## ##child:end## |
Non-critical errors
Other possible errors that do not prevent template validation by Causeway Field:
Error type | Error case | Example |
Unknown tag | The tag does not exist in any widget in the form. | ##text_ipoohKfO## is not present in the form. |
Missing suffix | A mandatory suffix is missing. | ##section##, ##image##, ##array## |
Invalid suffix | The suffix does not match the tag type or contains a spelling mistake, for example :title or :user. | ##ab_choice_D8tpEydV:titel## |
Default tag with suffix | A suffix has been added to a default tag or metadata tag, such as username or asset_name. | ##username:title## |
Missing suffix separator | A word corresponding to a suffix is detected, such as title, user or image, but the : character is missing. | ##section_yvRaV5Rqtitle## |
Invalid image suffix | The image type is not recognised or the image dimensions are missing. | ##image_LIRQ0gMF:image300300## |
Unsupported widget type | The widget type is not supported. This currently applies to PDF tags. | Standalone PDF tag: ##pdf_tag## |
Outside the loop block | A loop tag is located outside the loop block to which it belongs. This check is currently disabled. | — |
Not part of the loop | A task tag is not contained within the iteration to which it belongs. This check is currently disabled. | ##ref_section:start## ##ref_task## ##ref_section:end##, where ref_task does not belong to the section. |
Incomplete tag | A malformed tag, for example with a missing # character, still matches an existing tag. | #section:title##, ##section:ti |