How Do I Use Clean Template?

Running this tool will make changes to your template such as fixing expressions, or helping by upgrading any code changes between versions. Make sure to try it first on a copy of your original template. It creates a new template which it scrubs, closes your existing template, opens the new scrubbed template, deletes the old file, and renames the new file to the name of the original file. (Version 10 and later. This replaced Convert Tags)

For information on using Clean Template on batches of templates, see the pages for each Engine: 

.NET and RESTful Engines

Java Engine


Click on the Clean Template tool:

You will be prompted with:

Setting the correct value in the "Template version 9 or earlier" checkbox is critical. Check this box if the template you are cleaning was created in version 9 or earlier of the Designer. Do not check this box it if the template was created in version 10 or later. (What this does is tell Clean Template if the Tags use select/evaluate/value (version 9 and earlier) or the Tags use select only (version 10 and later.) 

This scrubbing includes:

  1. All Tags are written in the default format.

  2. All Tag properties are updated to the latest syntax.

  3. Selects that have ...'${var}'... are converted to ...${var}... (removing the ' that is no longer needed with setParameter).

Fixing Expressions

Any old templates that have select expressions that do not start with the '=' may fail to correctly determine the type of select expression. 

 To fix this, in the Clean Template window check the box next to "Attempt to fix expressions"

By checking this box, the Designer will attempt to fix unrecognized expressions during the template cleaning.


Add your comment

E-Mail me when someone replies to this comment