Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Structure

{mainTitle}

{subTitle}


group importance primary

group importance primary

group importance secondary

group importance secondary


importance secondary

importance primary

importance secondary

importance primary

importance primary

importance primary

Behavior

Column groups are produced by copying the template cells including their formatting and adding them to the produced table.

...

If there are multiple columns in a column group

...

the importance and level can be specified in the format: group? importance (primary|secondary|number) level (primary|secondary|number). By using a number more importances than the default two (0 and 1) can be specified.

...

, the column group is merged across all column cells.

To specify the formatting of a column group, it should be placed in its own row directly above the columns. For each column there has to be a column group above it, even if it specifies the same importance. This is so that during production the algorithm can look up the correct column group based on the column. In the case where multiple column groups with the same importance are defined, the last one is used.

The syntax for specifying a column group cell is: group importance <importance>. Where importance can be either primary, secondary or a positive number.

Column groups are only shown when certain criteria is met. The table style has to have column groups defined. If that is true it depends on the value of VerticalTableNode.headerGroupsHideIfNoLabels. If it isn’t specified or set to true and no column groups are defined in the data, then the column groups row is not produced.

Info

Why is the row header name missing in the example structure?

The row header name, that is, the column for the row headers, is on the column level and described in the rows chapter.

Examples

Example 1: A simple case where column groups exist in the data and the style is set

View file
nameabstract-report-example_simple_column_group.json
View file
nameoutput-example_simple_column_group.docx
View file
nametemplate-example_simple_column_group.docx

Example 2: The data has no column groups but headerGroupsHideIfNoLabels is set to false

View file
nameoutput-example_headerGroupsHideIfNoLabels_false.docx
View file
nameabstract-report-example_headerGroupsHideIfNoLabels_false.json
View file
nametemplate-example_headerGroupsHideIfNoLabels_false.docx

Example 3: The style defines importances as positive numbers

View file
nametemplate-example_number_importances.docx
View file
nameabstract-report-example_number_importances.json
View file
nameoutput-example_number_importances.docx