Versions Compared

Key

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

...

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

Code Block
languagejson
"slot": "{left}"

enabled

Wheter the node should be produced. This can be used to conditionally produce or suppress parts of the report

Code Block
languagejson
"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.

Code Block
languagejson
"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.

Note
  • 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 slotset.

  • style: see examples

for word reporting select a lacout component defined in the template:

Code Block
languagejson
"style": "CS_C_CoverOverview"

for online reports select one of the predefined styles:

Code Block
languagejson
"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.

Info

Word reports will just place all children in a flow design, Same as NoOpBB would do.