Template Grid (Document Template)

Last modified: December 19, 2023

1 Introduction

The template grid shows a list of objects in a tile view. For example, a template grid can show a list of products. The template grid has a lot in common with the data grid. The main difference is that the objects are shown in templates (a sort of small data view) instead of rows.

2 Appearance Properties

2.1 Enable Striping

With striping enabled you can set the contents of even and uneven template grid rows individually. This way you can create a striping effect by varying color for the 2 different row styles.

2.2 Number of Columns

This defines the amount of columns the template grid will contain.

3 Common Properties

Name

The internal name of the widget. You can use this to give sensible names to widgets. The name property also appears in the generated HTML: the widget DOM element automatically includes the class mx-name-{NAME}, which can be useful for Selenium testing.

4 Data Source Properties

The data source properties determine which objects will be shown in the template grid. The list of objects in the template grid is constrained by the following mechanisms:

  1. For top-level template grids, the objects passed in the microflow calling the document export action are shown.
  2. For nested template grids, if an entity path is used, only the objects reachable by following the path from the containing object are shown.
  3. For nested template grids, if a microflow is used, the objects returned by the microflow are shown.

4.1 Entity (Path)

The entity (path) property specifies from which entity instances will be shown in the template grid. A top-level template grid is always connected to an entity. A nested template grid can either be connected to an entity or to an entity path starting in the entity of the containing data view. The entity path can follow associations irrespective of type and ownership.

4.2 Microflow

When a nested template grid is connected to an entity, a microflow is needed to retrieve the data. The input parameter of these microflows is always the object of the containing data view and the output is a list of objects with the type of the nested template grid.