Versions Compared

Key

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

This chapter gives an introduction to what a report type is and how to create your own report types.

...

View a report type

  • as a tree structure of definition nodes

  • inspect parameter settings for each node

  • see messages (warnings)

  • see a (static) preview of a building block

Change settings of a report type

  • ID

  • Output format (Word, HTML) and (if Word) a stylesheet (word template file)

Add building blocks as siblings or childs of existing nodes

Hover over an existing node and press “Add Child Nodes” or “Add Sibling Nodes”

Select one or more (by ctrl-click) building blocks from the catalog to be added to the report type:

Copy & paste definition nodes

Copy a definition node (including all children):

Clipboard will contain the JSON-representation of the copied definition node:

Code Block
languagejson
{
    "buildingBlock": "SectionBB",
    "parameters": {
        "mainTitle": "[Performance]",
        "insertSectionPageBreak": true,
        "hideBenchmark": "=!!params.hideBenchmarkInPerformance",
        "style": "CS_TOC1"
    },
    "enabled": "=!(params.hideChapters.includes('Performance'))",
    "id": "1_performance",
    "children": [
        {
            "buildingBlock": "SectionBB",
            "parameters": {
                "mainTitle": "[Performance_overview]",
                "style": "CS_TOC2"
            },
            "enabled": "=!(params.hideChapters.includes('Performance.Overview'))",
            "id": "1_1_perf_overview",
            "children": [

Paste the block(s) to an existing node either as child or as sibling (right-click menu on node)

Re-order nodes

Nodes can be reordered by drag & drop. Use the gray handle on the left side of any node:

Search for nodes

Use the top right search box to find nodes in the report type. Click on a search result to navigate to the respective node

Navigate the report type

Use the breadcrumbs to navigate up in the tree

Use the level numbers above the tree to expand or collapse the tree to the required level.

Find and inspect warnings and errors

Use the messages panel to find warnings and errors of the selected node and all it’s subnodes:

Click on a message to navigate to the node that provoked the error and switch back to the properties panel to inspect the issue:

Edit parameter values

To customize the usage of a building block in a definition nodes, we want to set parameter values. The “Properties” panel allows to set the parameters that are requested by the building block.

Several parameter types are supported by specific parameter editor controls like Date, Boolean, Enumerations (e.g. periodLength), Segmentation, arrays of Segmentation or Enumerations etc.

Parameter values can be set to an expression by activating the expression mode:

and entering a valid expression (see chapter Using Expressions for Parameter Values)

Note

Setting or modifying parameter values not known by the current building block can be done by use of the “Code view”

Use the code view

Use the code view for more complex parameter editing:

Code view is based on the “Monaco” editor (same as in Visual Studio Code) so it supports

  • Json code coloring and syntax checking

  • Search & replace

  • Copy & paste

  • Move selection (alt-up/alt-down) or duplicate selection (shift-alt-up / shift-alt-down)

  • etc.

When switching back to the “Properties” panel, all changed parameters / properties are updated in the respective parameter editing controls.

Note

Currently the composer prevents the navigation away of a definition node that has incorrect Json syntax. Please always fix any errors before continuing working with other nodes.

...

...