Template Troubleshooting

eBECAS/EDMISS Next Generation Templates feature provides a powerful and flexible way to generate documents efficiently. While it is designed to handle a wide range of formatting and data merging needs, there may be cases where certain expressions or configurations require troubleshooting.

If an error occurs while merging a template, the system will display a message explaining the issue. Most errors are easy to resolve, though some may require extra attention.

Here are some common issues and their solutions.

Issue: Starting and Ending Handlebars Do Not Match

This error occurs when the opening {{ and closing }} brackets of a bookmark are not properly matched, usually due to an issue with the closing brackets }}.

Solution

Navigate to the Edit page of the template where the error occurs.
Ensure that all bookmark fields have a matching closing tag.
After making the necessary corrections, save the template and run a test to ensure the error is resolv

Issue: Reached Unparseable Token in Expression

This error occurs when the template engine detects invalid content inside a bookmark{{ ... }}, preventing it from being processed correctly. This usually happens due to:

Unexpected content inside a bookmark field
Another bookmark field nested within an existing one

These formatting issues can disrupt the template’s structure, leading to parsing errors during processing.

Solution

Navigate to the Edit page of the template where the error occurs.
In the HTML Editor, click on the Source Code button to view the template’s raw HTML.
Locate the elements containing the bookmark fields {{ ... }}.
Ensure that each bookmark field is a single word, including both {{ and }}, without spaces, additional HTML tags, or any other content.
After making the corrections, save the template and test it to confirm the issue is resolved.

[Example] HTML code is inserted between ‘{{offers-course_start’ and ‘}}’

Issue: Reached End of Template Before the Expression was Closed

This error occurs when a bookmark field or bookmark helpers that manage blocks in a template (such as Conditional Block helper and Grid Wrapper helper) is left unclosed, preventing the template from being processed correctly. It typically happens when:

A bookmark field is inserted without }}
- For example, {{offers-course_start.
A closing helper tag(such as {{/each}} and {{/checkif}}) is missing.

Solution

Navigate to the Edit page of the template where the error occurs.
Ensure that all bookmark fields have a matching closing tag.
Ensure bookmark helpers that manage blocks in a template (such as Conditional Block helper and Grid Wrapper helper) have the closing helper tags.
1. To check whether a bookmark helper requires a closing tag, insert the same helper through the Bookmark Panel and review its structure.
After making the corrections, save the template and test it to confirm the issue is resolved.