Skip to main content

Get help for ARIS

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 must specify the model items: see items sub-element.

    <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

    Alfabet table name, for example, VALUENODE.

  • aristype

    API name of an ARIS model type.

  • arisgroupname

    Name of the ARIS database group. If the entire table is imported, arisgroupname is the name of the subgroup that is created for the table content. If arisgroupname is empty or not specified, no subgroup will be created.

  • check-master (optional)

    Checks for the existence of the specified Alfabet property, such as ARIS_GUID, maintained for an Alfabet object with the ARIS GUID of the corresponding ARIS object. If the ARIS database contains this GUID, the related ARIS object is 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 the object has been deleted in Alfabet.

  • condition (optional)

    Defines a conditional mapping based on the property referenced by the condition attribute of the condition element. For example, if the property referenced in the class element is Stereotype (<class ... condition="Stereotype">) and a condition element specifies "BOT" as the value to be matched (<condition ... value="BOT"/>), then all objects that have a "BOT" stereotype are mapped according to what the condition element defines, and NOT according to what the class element defines. They could, for example, be stored in a different database group or get a different symbol.

  • cxntypes (optional)

    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' sub-element

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

<attr alfabet="StartDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_START" />
<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 sub-element of the <cxn> element (see below), the property is mapped to an attribute of the connection.

XML properties

  • attr

    Defines the handling of attributes. If at least one attr sub-element 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.

  • aris

    API name of the ARIS attribute. An empty string (""): not mapped/ignored.

XML properties for conditional attribute import

  • 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 that is checked against the value of the condition XML property for conditional attribute import.

'items' sub-element of a table element

XML properties

  • table (optional)

    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 more than one table.

  • 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

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