Definition Nodes and built-in Building Blocks

Definition Nodes

Definition nodes are the elements to define a Report Type. A definition node has the following attributes;

Attribute	Description	Example
`id`
`buildingBlock`	The type of the building block to be produced
`children`	A list (array) of children (definition nodes)
`parameters`	The list of parameters that configure the building block. See below list of building blocks for important parameters to be used.
`slot`	The slot to be produced into the parent node should produce a LayoutBB that selects a layout via the style parameter Word: the slots are defined within the word layout component and referenced by name Online: the number of slots of a style are built-in and the slots are referenced by order	"slot": "{left}"
`enabled`	Wheter the node should be produced. This can be used to conditionally produce or suppress parts of the report	"enabled": "=params.ShowChapterXY"
`iterateOver`, `iterateInto`	`iterateOver`: the values for which this node and all its children and subchildren should be produced, with the parameter named in `iterateInto` set to the corresponding value. Defaults to no iteration. `iterateInto`: The name of the parameter which should be set to the current iteration value. Defaults to not setting any parameter.	"buildingBlock": "SectionBB", "iterateOver": [ "de", "en", "fr" ], "iterateInto": "reportLanguage", "parameters": { "mainTitle": { "text": "Iterate node test for {1}", "args": [ "=params.reportLanguage" ] } }

Built-in Building Blocks

BuildingBlock	Description	Parameters	Example
*	Common parameters for all building blocks	`mainTitle` `subTitle` `style`: sets the style used to visualise (has a dependency on node types and channels) `tags`: an array of tags. Current tags used by the online channel are `SolidChrome`, `DarkChrome`, `LightChrome` to set the chrome (background) `Screen:` to define an entity of nodes to be shown together in fullscreen mode
`ParagraphBB`	Creates a paragraph. Word reports will not show children of a paragraph node mainTitle, subTitle will not be visualised	`content` `theme` `style`: names a paragraph style
`SectionBB`		`style`: names a paragraph `theme` `styleinsertSectionPageBreak`: wheter to insert a section break (new page). Only affecting word reports.
`NoOpBB`	This building block has no effect on the visual output but just produces it’s children. It can be used to set common parameters for a list of blocks
`HeaderBB`	Like `NoOpBB` does not produce any output itself but produces it’s children. Word reports will place the output into the header story (of the current section)
`FooterBB`	Like `NoOpBB` does not produce any output itself but produces it’s children. Word reports will place the output into the footer story (of the current section)
`LayoutBB`	This building block produces it’s children and places them in the specified “slots”. Children are expected to have the attribute `slot`set.	`style:` see examples	for word reporting select a lacout component defined in the template: "style": "CS_C_CoverOverview" for online reports select one of the predefined styles: "style": "CS_W_Block2x1"
`MetricsBB`	Online only, for complex arrangements of data For word reports use a specialised LayoutBB instead
`ToggleBB`	A building block that allows a list of children to be toggled through in online reporting. every child is expected to have a `toggleTitle` set in parameters. This will control the title for the button used to toggle. Word reports will just place all children in a flow design, Same as NoOpBB would do.