The metamodel is the entirety of model, object, and connector types, along with all their attributes and other properties. For administrators, the Metamodel Viewer is a valuable tool for obtaining an overview of the various metamodel elements and gaining a better understanding of the structure of the metamodel.
The Metamodel Viewer consists of two panes, the metamodel catalogue, and the workspace:
The metamodel catalogue is the left pane of the Metamodel Viewer. It provides three different views on the metamodel: the Library View, the Class Hierarchy View, and the Global View.
The workspace is the right pane of the Metamodel Viewer. When you select a metamodel element in the metamodel catalogue (any view), its attributes are shown in the workspace.
The Metamodel Catalogue
The metamodel catalogue provides three different views on the metamodel:
The Library View offers a structural view of the library. For every library, its model types, their classes and relation classes plus the end points of the relation classes are shown.
Class Hierarchy View
This view displays all available classes of the metamodel in their hierarchical order (inheritance hierarchy).
The list contains a collection of all metamodel elements. The topmost hierarchy level is a list of all element types, each in turn containing a list of all elements of the appropriate type. There is no further diversification.
Switch between Views
Switch between views by selecting an option at the top of the page.
Select an element in the catalogue to show its attributes in the workspace.
Choose Element Type
When you are in the Global View, you can apply a filter to hone in on the specific element types (e.g. attributes, classes, etc.) that you need:
- At the top of the metamodel catalogue, click Select library, and then select an element type from the list below the library name.
Show Language Independent Names and IDs
To show language independent names and IDs in the metamodel catalogue:
- At the top of the metamodel catalogue, click More, and then choose the columns you want.
The workspace in the Metamodel Viewer presents the attributes of the selected metamodel element from the metamodel catalogue. The following columns are displayed by default:
The name of the attribute is visible on the user interface, for example in a Notebook. An attribute will usually have a name for every language ADONIS supports.
The language-independent name uniquely identifies the attribute. It also appears on the user interface in all languages where the attribute name is undefined.
The data structure of the attribute. Depending on the attribute type, totally different content may be stored in the attribute: text of various length, integer and floating-point numbers, dates, times, internal and external references, tables, and much more.
The unique identifier of the attribute.
Some columns are hidden by default:
Attributes can have default values. These values apply automatically when an instance with this attribute is created.
This column indicates whether the attribute is a class attribute or not. Class attributes apply to a class as a whole, rather than to its individual instances. For example, they may include the graphical representation of a class or the info text associated with a particular model type. These attributes cannot be edited in the instances derived from these elements. If the attribute is not a class attribute, it will become an instance attribute, which can be edited in the instances (models, objects, etc.).
This is a property for attributes used as instance attributes and consequently is not available when an attribute is a class attribute. If the attribute is context-specific, it can hold different values for each distinct model context. Otherwise, the attribute will have a single global value that applies to all model contexts.
This column indicates whether the value of this attribute is restricted to be language independent or not. If this property is enabled, the attribute value is the same in all languages. Otherwise, each language variant can have its own, distinctive value.
System attributes are required for various platform components and are not considered by the Change History mechanism.
This property indicates whether the attribute is relevant for global filter mechanisms. This property is currently available only for Coordinated Universal Time (UTC) and ENUMLIST_TREE attributes.
Show or Hide Columns
To change which columns are displayed:
- At the top right of the workspace, click More, and then choose the columns you want.
Show More Information
You can view additional information about an attribute in the workspace:
- Simply click on the attribute you want to learn more about.
A dialogue box will appear, displaying the properties of the attribute. This dialogue box will provide you with additional information that is not available in the table in the workspace:
If the selected attribute is an enumeration (= a predefined set of values you can choose from), the value range (both language independent values and language-specific values) is displayed.
Evaluation of the Value Not Set
This property is only available for numeric attributes (integer, double,...) and attributes of type Coordinated Universal Time (UTC). The customizing option for the evaluation specifies whether an attribute value that has no value set should be evaluated as an absolute minimum / maximum value. This can e.g. be the case when comparing two numbers in the analysis component. If Disabled is checked, a fallback to the library default value is done.
Show or Hide Notebook Chapters
Within the workspace, you can display attributes either in a flat list or in a hierarchical structure, based on the chapters within the Notebook of the metamodel element. To show or hide Notebook chapters:
- At the top right of the workspace, click More, and then click Show chapters.
To help you quickly find what you want, both the catalogue on the left and the workspace on the right offer a search function. To filter data in a column:
- In the Search box at the top of the column, type the text you want to search for.
When you open the Metamodel Viewer, a library check will be automatically performed to detect problems within the library. To view the results:
- At the bottom of the page, click Library Checks.
A list asserts, errors, warnings and infos will be displayed, grouped by component. You can expand the hierarchy of components and entries to locate the specific message you are looking for, or you can utilise the filter options located at the top of the columns to narrow down the results based on your criteria.