Typically, a merge block is used to repeat content based on data rows of a specific table or child table. Merge blocks can be also used to group elements for various reasons. One reason could be the conditional rendering of merge blocks.
This article describes how to add a merge block programmatically using the method and how to set filters and sorting instructions. Additionally, block merging conditions are introduced to specify whether a merge block is rendered or not.
In this article, the following simple data structure is used as the data source:
On loading, a new data object is created and loaded into the which is designed for handling all existing kinds of data sources used together with the class. The available merge block table names are listed in a combo box.
There are three conditions in the merge block defined:
- Sorting: The table is sorted ascending by the column Price.
- Filtering: Only rows are rendered where the column Price is greater than 500.
- Conditions: The whole block is only rendered, if the column Name of the parent table is Test Report.
These new merge block settings can be used to handle data shaping in the template directly and to render parts of a document conditionally based on merge field values in the data source. No custom event handling is required anymore to set the conditions for a merge block.
Test this on your own and download a trial version of TX Text Control X16.