This file defines the general mapping for models, connections, and assignments. It handles the data transfer between ARIS and Alfabet. Generally, Alfabet tables are mapped to ARIS objects. Alfabet tables are mapped using the table XML property. The import of an entire table or the import/connection of a single Alfabet object is performed using the following import definition.
ARIS API name of an object type, a model type, or a symbol type.
condition
Defines a conditional mapping based on a property's value. The example above shows a mapping that is based on the Stereotype property. If the value is specified and corresponds to one of the values listed as a value in the condition elements below, it is mapped according to what the condition element defines, and NOT according to what the table element defines.
arisgroupname
Name of the ARIS database group.
If the entire table is imported, arisgroupname is the name of the subgroup to be created for the table content.
If arisgroupname is empty or not specified, no subgroup will be created.
ARIS API name of the ARIS object type to be used. If an ARIS symbol type is specified here, the object type is derived from the symbol. In addition, the default symbol of the imported item is set to this symbol type.
arisgroupname
Optionally overwrites the default group name of the <table> element for items meeting this condition.
value
Property value specifying that this condition is to be applied.
condition
Defines a conditional mapping based on a property's value. The example above shows a mapping that is based on the Stereotype property. If the value is specified and corresponds to one of the values listed as a value in the condition elements below, it is mapped according to what the condition element defines, and NOT according to what the table element defines.
Checks for the existence of the provided Alfabet attribute, and searches the ARIS database for an object with this GUID. If available, the ARIS object is identified and used as the master instead of the Alfabet object, for example,
check-master="ARIS_GUID"
The attributes and properties of the master object are not overwritten by the import and a master is not removed if theobject has been deleted in Alfabet.
Defines a conditional mapping based on a property's value. The example above shows a mapping that is based on the Stereotype property. If the value is specified and corresponds to one of the values listed as a value in the condition elements below, it is mapped according to what the condition element defines, and NOT according to what the table element defines.
ARIS API name of the ARIS object type to be used. If an ARIS symbol type is specified here, the object type is derived from the symbol. In addition, the default symbol of the imported item is set to this symbol type.
Adds an occurrence of the superior object to the assigned model.
The default setting is false.
If you change it to true, an occurrence of the superior object will be added to the assigned model. Therefore, the parent-symbol attribute is mandatory.
In this case, the value of the "StartDate" property is written to the aris attribute "AT_EVALUATION_START" only if the alfabet property "Status" has the value "Evaluation", etc.
When used as a subelement of the <cxn> element (see below), the property is mapped to an attribute of the connection.
Specifies whether or not the import forces the target/source object of a referenced object to exist in the database. If the value is set to true, the target/source object will be created using the mapping definition of the referenced object. Only if the target/source object exists will a connection be imported. Whether the target object or the source object must exist depends on the value specified in the srctotarge XML property
Creates an occurrence of the target object and the corresponding connection in the overview model if the overview-model property is specified at the table element.
The value corresponds to the symbol type number (see API name).
Creates an occurrence of the target object and the corresponding connection in the assigned model if the table element has an assigned subelement.
The value corresponds to the symbol type number (see API name).
'assign' subelement of a 'cxn' element
Creates an assignment to a model either in addition to a connection, instead of a connection, or to a model if the referenced item is a model derived from an additional Alfabet table.
Adds an occurrence of the superior object to the assigned model.
The default setting is false.
If you change it to true, an occurrence of the superior object will be added to the assigned model. Therefore, the parent-symbol attribute is mandatory.
Optionally defines in which database group the assigned model is created. source is the group of the table element, target is the group of the connected element.
Value source (default value):
Database group where the source table element of the assignment is stored.
Value target:
Database group where the connected table element of the assignment is stored.
'foreignattr' subelement of a 'cxn' element
Adds attributes from an additional Alfabet table to the imported ARIS item.
Name of the property of the additional table that refers to the current table element, for example, Owner.
In example 3 of the mapping examples, the foreignattr element, which is a list of attr elements, is accepted. This list defines the attributes to be imported.
Example 1
This example shows how a table is mapped to an object definition and how (value) properties are mapped to ARIS attributes. Additionally, it is possible to create an overview model and place an occurrence of each object from this table into the model. A Reference or ReferenceArray property can be mapped to a connection, an assignment, or to a connection plus an assignment. Value properties can be mapped to a connection, an assignment, or to both at the same time. Value properties can be assigned to a created connection instead of being assigned to the object itself.
In the following example, the foreignattr property, which is a list of attr properties, is accepted. This list defines the attributes to be imported. The example shows the usage of foreign attributes and attribute conditions. Foreign attributes are read from the additional Alfabet table.
<foreignattr table="TIMESTATUS" property="Owner"> <!-- Select * from TIMESTATUS where Owner = '<our AlfabetID>'. Will be written after processing "normal" attr-Elements, so will probably overwrite them -->
property
Name of the property of the additional table that refers to the current table element, for example, Owner.