Skip to content

Datasource

Every report is based upon a specific set of data which we will refer to as datasource. In BizzStream data equals documents and documents are based upon, or instances of, document definitions.
When constructing reports we define the datasource of a report by making use of so called DataObjects.

DataObjects are strongly related to Document Definitions which represent a set of documents but are not entirely the same: from structural point of view we decided to split a Document Definition into two or more dataobjects, respectively;

  • a DataObject representing the header fields of a Document Definition and
  • a DataObject representing a specific LineGroup within a Document Definition.

For instance, in case an administrator modelled a Document Definition 'menuItem' with a LineGroup 'ingredients', the DataObjects that we can use as datasource for our reports are, respectively:

  • menuItem
  • menuItem_ingredients

The name of the DataObject is constructed out of the combination documentdefinition.name + (documentdefinition.lineName).

Application

DataObjects can be selected in the ReportDesigner editor ( ) in the left sidebar of the ExpressView / Dashboard and in the categories tab of the advancedReport type.

Relationships

DataObjects represent the datasource that will be used as a base for a report. When constructing a report we are not able to select groundless any DataObject as datasource for a report. The ground rule is to choose one DataObject as point of departure and add related DataObjects at will. A relation is enforced by the interface of the Report designer which disables all non-related DataObjects after selecting a DataObject.

By default the header and line dataobjects are related to each other.

DataSource types

A Document Definition can be enabled for analytics with or without history tracking (see document definition article). If the 'History tracking' option has been checked, a DataObject for historical data information is also available to use as datasource:

Historical (header or LineGroup) DataObjects represent all the mutations in time of a particular document where the actual DataObjects represent the data of the current (actual) document.