Mapping syntax for tables defining models

Alfabet models are defined in a way different from ARIS models. Alfabet models do not always reference the objects they contain. Instead, the objects reference the models in which they are represented. Therefore, the import definition needs to specify where to find the model items: see items subelement.

<table name="BUSINESSPROCESSMODEL" arisgroupname="Business processes" aristype="MT_VAL_ADD_CHN_DGM" cxntypes="CT_IS_PRCS_ORNT_SUPER" isgroup="true">

<items table="BUSINESSPROCESS" property="model" symbol="ST_VAL_ADD_CHN_SML_2">

<attr alfabet="name" aris="AT_NAME" />

<attr alfabet="description" aris="AT_DESC" />

<attr alfabet="id" aris="AT_ID" />

<attr alfabet="version" aris="AT_REL_1" />

<cxn property="aris_guid" arisguid="unique" /> <!-- if used, use as unique ID and fix/check alfabet ID -->

<cxn property="diagrams" /> <!-- what is this? views? []BusinessProcessDiagram -->

<cxn property="documents" /> <!-- cannot be mapped -->

</table>

Table element

The use of this element is the same as described here. However, the overview-model XML property cannot be used in this context.

XML properties

name

name

Alfabet table name, for example, VALUENODE.

aristype

aristype

API name of an ARIS model type.

arisgroupname

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.

check-master (optional)

check-master

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.

condition (optional)

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.

cxntypes (optional)

cxntypes

Comma-separated list of API names that are to be shown for the ARIS connection types contained in the model. These names are shown only if the corresponding connections exist between the objects contained in the model.

'attr' subelement

Maps an Alfabet property value, for example , String, Date, etc. Reference or ReferenceArray properties are not allowed here.

<attr alfabet="StartDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_START" />

attr XML property

Defines the handling of attributes.

If at least one attr subelement is specified, this restricts the list of attributes imported into ARIS to the list of attr elements listed here.

alfabet

Name of the Alfabet property.

condition

Property that has to be checked against the value. Only if the value of the property equals the given value is the attribute imported.

value

Value to be checked against the value of the condition XML property for conditional attribute import.

aris XML property

API name of the ARIS attribute.

An empty string (""): not mapped/ignored.

<attr alfabet="EndDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_END" />

<attr alfabet="StartDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_START" />

<attr alfabet="EndDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_END" />

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.

All XML properties

attr

attr XML property

Defines the handling of attributes.

If at least one attr subelement is specified, this restricts the list of attributes imported into ARIS to the list of attr elements listed here.

alfabet

alfabet

Name of the Alfabet property.

aris

aris XML property

API name of the ARIS attribute.

An empty string (""): not mapped/ignored.

XML properties for conditional attribute import

condition

condition

Property that has to be checked against the value. Only if the value of the property equals the given value is the attribute imported.

value

value

Value to be checked against the value of the condition XML property for conditional attribute import.

'items' subelement of a table element

XML properties

table (optional)

table

Table name.

If omitted: The model elements are to be found in the model properties (<cxn>).

If used: The model provides no reference to the objects it contains. Therefore, additional information is required to indicate in which table to find these objects. This can be a list of item elements if the model references to more than one table.

property

property

Property name.

If the 'table' property is used: property of the table containing the connection to the model.

Otherwise: property of the element which contains the model items.

symbol

symbol

API name for the symbol type of the ARIS object used in the assigned model, for example, ST_VAL_ADD_CHN_SML_2.