12.1.2.3. Tips and Tricks for Customizing Templates

To customize templates with advanced features, the following tips and tricks may be useful.

1. Conditional Blocks

Users can utilize conditional blocks to hide a section in the Word or PDF document.

To add a conditional block, use the following format:

<conditional @attributeName>
block content
</conditional>

*Use @attributeName to access the entity (domain object) and @@attributeName to access the form entity (form object).

To avoid extra line breaks, it’s best to add the conditional tags directly next to your content.

For example:

<conditional @attributeName>Content Line1
Content Line2
Content Line3</conditional>

Conditional Blocks: Examples

2. Watermarks

To add watermarks, insert <conditionalWatermark @attributeName/> anywhere in the document.

!Please note that if more than one watermark is added, only the last one will be processed. All other tags, however, will be removed from the resulting Word or PDF document.

*As with other conditional tags, use @attributeName to access the entity (domain object) and @@attributeName to access the form entity (form object).

3. Column Sorting in Grids

To sort a grid according to an attribute (or column), add either of the following symbols in the first cell of the first row (header row most of the time):

• ^attributeName for ascending

• ~attributeName for descending

!Currently, we only support sorting by one attribute.

*Please note that when generating a template in the Form Designer, this sorting tag will be automatically added to the grid according to the grid control configuration.