/
Dictionary

Dictionary

Dictionary is a space where terms and definitions (members and their descriptions) are located and organised into four sections:

  • domains;

  • hierarchies;

  • dimensions;

  • members.

The relations between members are represented in the HIERARCHIES and provided with a context by the DIMENSIONS.

 

Creating a domain

There are two types of domains:

  • explicit domain - a collection of semantically similar, well-defined elements (members);

  • typed domain - restricts the elements and characterises them by a basic data type (e.g string, boolean, integer).

The “typed domain” is mostly used when the full membership of a domain is unknown, unknowable, or is frequently updated.

To create a domain click on the 3 dots next to DOMAINS, hover over Create and then select the type of domain you wish to add. This is the way to add all the elements in the dictionary.

 

Each domain requires a code, a label, and an owner.

Creating a Typed domain additionally requires an indication of the data type (e.g. string, int,eager, monetary etc.), this will restrict the filer to the selected data type when entering a domain member.

If you click on a specific domain, ATOME: Matter will filter only elements in this domain. When the domain is selected all new concepts (hierarchies, dimensions, and members) will automatically be assigned to that domain.

List of available data types:

  • Boolean - either a True or False value;

  • Date - dates in an accepted date representation (e.g. 21.10.2021);

  • Integer - a whole/counting number (without a fractional component) that can be positive, negative, or zero;

  • Monetary - whole and fractional numbers that can be positive, negative, or zero;

  • Percentage - data represented as percentages ( % );

  • Text - any type of data represented in a text format;

  • Decimal - exact numeric data type defined by its precision (total number of digits) and scale (number of digits to the right of the decimal point) e.g. 12345.67890;

  • LEI - Legal Entity Identifier; a 20-character alpha-numeric code based on the ISO 17442 standard, which is unique to each legal entity;

  • ISIN - International Securities Identification Number; a 12-digit alpha-numeric code that uniquely identifies specific security;

  • Per-share - indicator, where the denominator is a “share” and nominator, is defined by a metric;

  • Shares - datatype for share-based on financial concepts;

  • Pure - type for dimensionless numbers such as percentage change, growth rates, and other ratios where the numerator and denominator have the same units;

  • Area - datatype for indicating surface area;

  • Text block - Text block elements are used to disclose narrative information;

  • Duration - data specified in days, hours, minutes, seconds, and milliseconds;

  • Custom - custom data type is chosen by the user that allows taxonomies to be loaded when the data type is not recognized by ATOME: Matter;

  • Boolean true - boolean data type but only with true values.

Domains can be united in a Union Domain (in DPM 2.0 referred to as a Super Category). Union Domain has all attributes of a regular domain but in addition in has a list of its united Domains. Hierarchies of the Union Domain can use members of any of its united Domains, while Members and Hierarchies of united Domains can be assigned with Dimensions of union Domain when used on Axes and Ordinate Categorisations in Tables.

United domains are indicated on the definition of a union domain:

Metric

If you create a new empty model version, only one element - a Metric domain member - is created by default.

Creating a member

Members are enumerated elements of a domain. You can create members in explicit domains and Metrics. The difference is that for metric members you need to select the data type from the drop-down list. To create a member in the specific domain you must first click on this domain.

Metric should be defined on at least one of the axes to make a table reportable. For more details please check section: Tables - creating an axis.

To learn how to create enumeration metric members check the sub page on the topic here: click to open the link

Creating a hierarchy

Hierarchies are sets of the relationship between domain or metric members.

Hierarchies can be used in reporting frameworks in the following ways:

  • Users can drag and drop hierarchies to the table and create a row/column structure;

  • Users can drag and drop hierarchies to the table and create a hierarchy reference. In this case, hierarchy reference is only a link to the hierarchy so whenever the hierarchy is changed there is no need to update the template structure;

  • Hierarchies can be used as a list of allowed options for a metric.

Hierarchies can be created by clicking the 3 dots next to HIERARCHIES and choosing between the member/metric hierarchy.

 

After a hierarchy root was created you can click 3 dots next to it and choose Add child. The Child is a metric/domain member based on the type of hierarchy to which it was added.

Metric/domain members used in a hierarchy are Hierarchy Nodes. They may have different label than the underlying metric/domain members (if missing then it outputs to XLS/XBRL/DB it is inherited from the underlying metric/domain member), can have a sign and weight indicating basic arithmetic relations between nodes in a hierarchy. Each child metric/member may be also marked as Nonusable in a hierarchy node (and as a result not being selectable in the drop-down).

After adding the Child it will also appear in the list of members.

A Hierarchy Node can be also created by drag-and-drop an existing member into the hierarchy or a Parent Hierarchy Node.

Copy a hierarchy

It is also possible to copy a hierarchy within one domain. For example, to copy a hierarchy GA1 All Regions that belongs to domain GA Geographical Areas we need to click 3 dots next to a hierarchy and choose Copy.

 

After this, click 3 dots next a domain and choose Paste.

 

After this a copy of a chosen hierarchy GA1 All Regions will appear attached to the same domain with a _copy in the name.

 

Creating a dimension

Dimensions provide context of domain members or typed domain application. To create a dimension in a specific domain you must first click on this domain. You can assign multiple dimensions to each domain while a dimension can only be assigned to one domain:

Domain → Dimensions → one-to-many

Dimension → Domain → one-to-one

For example, one domain with Geographical Areas can include many countries.

 

Each dimension requires a label, code, owner and defined domain. Likewise, the hierarchies and default member can be defined for the dimension.

 

Related content