Mapping Configuration

General

The Mapping Configuration is used to define which attributes from codebeamer work items are mapped to attributes from Enterprise Architect elements (and also vice versa).

The configuration is maintained via it's own dialog, which can be accessed via the addin menu point "Configure Mapping for Package". It is also automatically invoked when starting an import/export for a package which does not yet have a fully configured mapping.

Here is an explanation of the different section in the mapping user interface:

UI Section	Title
	Reference to EA The package in EA, which is associated with the tracker in codebeamer. The associated package is always the one the mapping configuration UI has been started from, and cannot be changed later on.
	Reference to codebeamer The codebeamer Project and Tracker. You can type in the name of the tracker / project you are searching for, which will reduce the list of available elements. Searching for Projects and Trackers If you want to find a specific codebeamer project or tracker quickly, just click into the combo box and start typing the name. A filter will be applied and the list will offer all matching projects or trackers:
	Mapping Settings Direction Either import from codebeamer to EA, or export from EA to codebeamer. If you select "Export to codebeamer" you can additionally choose to export diagrams to codebeamer.  Mapping Template A mapping template provides examples mappings that can be loaded. Loading a template will reset the type and attribute mappins. LemonTree.Connect will not save which template was loaded for which package. You can only load the type and attribute mappings from the provided templates. Please note that the configuration is only loaded after the "Load" button on the right is clicked. Also, doing so will erase any customizations you have made to your current configuration! By default, templates will be loaded from the paths: C:\Program Files (x86)\LieberLieber\codebeamerEAAddin\mapping\Export C:\Program Files (x86)\LieberLieber\codebeamerEAAddin\mapping\Import To customize templates and load them from an additional location, check out the guide "Create custom mapping templates". EA Connector for Trace Link LemonTree.Connect type that is used for exporting the traceability between architecture and requirements.  codebeamer Field for Trace Link The reference field in codebeamer that is corresponding to the trace link coming from EA.
	Type Mappings A list of which codebeamer tracker item types are mapped to which EA element types (optionally with stereotypes). For a detailed explanation, see the chapter "Type Mapping".
	Attribute Mappings A list of which codebeamer fields mapped to which EA element attributes. The attributes in EA can be either element properties or tagged values. For a detailed explanation, see the chapter "Attribute Mapping".

Trace Link Configuration

The Trace Link Configuration determines how traceability links are realized in Enterprise Architect. The provided selection is between various types of connectors provided by Enterprise Architect, and has implications for both the import and the export of functionalities:

• On Import, traceability links in the Enterprise Architect model are realized as connectors of the selected type between the imported elements
• On Export, traceability links in codebeamer are established based on connectors of the selected type in the Enterprise Architect model

LemonTree.Connect currently supports the following trace link types:

• Traces
  • EA Trace (15.1 and lower)
    EA versions 15.1 and lower used an UML "Abstraction" for trace links.
  • EA Trace (15.2 and lower)
    All EA versions higher than 15.1 use an UML "Dependency" for trace links.
• SysML Links
  • SysML Copy
  • SysML Derive
  • SysML Refine
  • SysML Satisfy
  • SysML Trace
  • SysML Verify
• Standard UML Links
  • UML Dependency
  • UML Realization

Use multiple Link Mappings

If you want to use more than one link mappings you have to change the raw mapping configuration stored as XML in the configured package. Open the tagged value "config" of the configured package and add a mapping rule for each link mapping you want to use. Only the first one will be shown in the Mapping Configuration Dialog.

If you want to use trace and dependency links, your mapping could for example look like this:

  <!-- Trace -->
  <mappingRule>
    <matchingRule>
      <externalProperty name="_linkField" value="17" />
      <myumlProperty name="_objectType" value="Dependency" />
      <myumlProperty name="_stereotype" value="EAUML::trace" />
    </matchingRule>
    <properties />
  </mappingRule>
  <!-- Dependency -->
  <mappingRule>
    <matchingRule>
      <externalProperty name="_linkField" value="17" />
      <myumlProperty name="_objectType" value="Dependency" />
    </matchingRule>
    <properties />
  </mappingRule>

Type and Attribute Mappings

It is possible to create a mapping for a codebeamer tracker item type.

A mapping consists of the following entries:

• Type Mapping
  Defines which codebeamer tracker item type is mapped to which EA element type

• (one or many) Attribute Mappings
  Defines which attributes from a tracker item are mapped to which attributes from an EA element

If you select a Type Mapping in the configuration UI, the list of attributes will always show the attributes related to the selected Type Mapping:

Type Mapping

The type configuration establishes a list of one-to-one relations between a specific codebeamer element type and its UML equivalent in the Enterprise Architect model.

Supported EA Element Types

Here is a list of the current supported EA Element Types:

• AcceptEventAction
• ActionInputPin
• Activity
• ActivityParameterNode
• Actor
• Artifact
• CallBehaviorAction
• CallOperationAction
• Component
• Class
• DataType
• Device
• DeploymentSpecification
• ExecutionEnvironment
• Enumeration
• InstanceSpecification
• Interaction
• Interface
• Node
• OpaqueAction
• Operation
• Package
• Property
• Port
• Requirement
• SendSignalAction
• Signal
• State
• StateMachine
• SysML Block
• SysML Constraint Block
• SysML Full Port
• SysML Interface Block
• SysML Proxy Port
• SysML Requirement
• SysML Test Case
• Trigger
• UseCase

Differences between EA and UML Element Types

Since our technology is based on UML, we also use the UML names of the element types. However, EA uses a different name for some of the offered element types.
To see which types are not called the same in the Mapping UI as in EA, check the table listed below:

SysML Element Types

With the release of the version 2.3.1, SysML Types are now supported in a much more convient way. To use SysML element types, all you have to do is to select them from the list of types:

Generic Type Mapping "TrackerItem"

The first entry in the list of available codebeamer types is called "TrackerItem".
This type is used as a generic type mapping, which applies to every item found in the codebeamer tracker.

However, if you also define a type mapping, which refers to a codebeamer type stored in the field "Categories", all elements with the corresponding type will be taken into account.

For example:
A tracker consists of five tracker items:

• Item 1: Category = "–"
• Item 2: Category = "Functional"
• Item 3: Category = "Non-Functional"
• Item 4: Category = Folder
• Item 5: Category = Folder

The type mapping is defined as follows:

This mapping will create EA Packages for the items "Item4" and "Item5". Every other element, no matter the type, will be created as EA Requirement.

Filter out unwanted tracker item types

It is possible to only import a specific set of tracker item types. You can do that by not configuring a "generic tracker item mapping", as it is described above.

For example:
A tracker consists of five tracker items:

• Item 1: Category = "–"
• Item 2: Category = "Functional"
• Item 3: Category = "Non-Functional"
• Item 4: Category = Info
• Item 5: Category = Info

The type mapping is defined as follows:

|codebeamer Type|EA Type| Functional|Requirement Non-Functional|Requirement

This mapping will only import the tracker items "Item2" and "Item3", since there is no default type mapping, that considers tracker items with other types.

Special Case "Requirement"

The basis for LemonTree.Connect and the mapping to EA element is UML. Since Requirement elements are not standard UML but EA is providing them, a special mapping entry has to be introduced.

Attribute Mapping

The attribute mapping defines which attributes from a codebeamer element are mapped to which attributes of an EA element (and vice versa).

Currently, the following attributes are supported:

• (Tagged Value) (custom attributes that are created as tagged values)
• Alias
• Author
• Classifier (the instance classifier, property type, port type, etc. of an element)
• Complexity
• Created Date
• Lower Bound (LowerBound of the Multiplicity for some element types )
• Modified Date
• Multiplicity (some element types use a different Multiplicity attribute)
  Name
• Notes
• Phase
• Primitive Type (simple types that can be select in EA such as int, bool, long, etc.)
• Status ¹
• Stereotype
• Upper Bound (UpperBound of the Multiplicity for some elements)
• Version

Use Tagged Values for Attribute Mappings

In order to use a tagged value for an attribute mapping, simply select the (Tagged Value) entry from the list of available EA Attributes. This will enable a textbox, where you can enter the name of the tagged value that shall be considered in the mapping:
e

Mapping the Classifier of exported elements

If the classifier of an element is used in an export mapping, a special field configuration is needed in codebeamer to properly display the classifier field.

In codebeamer, you have to create two custom fields for the classifier, one (hidden) field to hold the raw data (name + id of the referenced element) and one to display the proper name of the classifier element.
To configure these two fields, check the guide "Displaying the Classifier of an exported element in codebeamer with a calculated field".

In EA, you have to map classifier on an element to the internal classifier field, for example:

Mandatory Attribute Mapping for the "Open in codebeamer" Feature

It is possible to open a tracker item directly in codebeamer, by either double clicking the representative element in EA, or selecting the menu Specialize > LemonTree.Connect codebeamer > Open in codebeamer.

To enable this feature, an attribute mapping for the codebeamer field "Uri" has to be created. If you create a custom mapping, LemonTree.Connect will automatically create this mapping entry for you.
Every new attribute mapping that will be created, consists of the following mappings:

• Summary → Name
• Description → Notes
• Uri → Uri (Tagged Value)

Using the "Status" property of Requirements in EA

In order to save and visualize the status property of requirements in EA properly, the attribute mapping has to be done in a specific way. 

If you want the importer to write the status of the codebeamer item into the EA status property, you have to create an attribute mapping that looks like this:

Choose "(Tagged Value) for the EA Attribute and insert the following string into the "Tagged Value" textbox:

EA Specifics 1.0::requirement::Status

However, we recommend not using the status property from EA or Polarion for attribute mappings. In both tools, the status properties have predefined values, which should be set directly in the tool, with the allowed values and they might be related to specific workflows and / or state transitions.