Document Definition DataObjects

Document Definition DataObjects (hereafter DD DataObjects) are DataObjects in line with the modelled DDs in a particular environment.
A DD DataObjects represents all the documents of a DD. The relationship between a DD DataObjects and a DD from structural point of view is not 1-1 as we decided to split a DD 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).

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.