Prev Next

Configuration

Each Integration Provider comes with a set of default mapping values that determines firstly what type of local element is created in Enterprise Architect, and secondly which fields are copied to the new element. These mappings are configurable for each client model.

Permission

Users must have the 'Configure External Data Sources' permission to access this functionality.

Access

Integration window toolbar

'Hamburger' Menu > Configure

Type Mapping

The 'Type Mapping' dialog defines the element type that will be created when users select the 'Create Local Element' option for an external element.

Type mapping

To create a new mapping:

  1. Click on the New button, then click on the 'External Type' drop-down arrow and select the type of the element to map from the external source.
  2. Click on the 'Toolset' drop-down arrow and select the appropriate Enterprise Architect Toolset, then click on the 'Type' drop-down arrow and select the Enterprise Architect element type that the external element type maps to.
  3. If appropriate, also click on the 'Stereotype' drop-down arrow and select the stereotype for the extended Enterprise Architect element type that the external element type maps to.
  4. Click on the Save button.

Note that if the external element type has been linked as an <<ExternalReference>> element, any Type Mapping settings are ignored; see the Linking Items Help topic.

Field Mapping

The 'Field Mapping' dialog defines the element fields that will be updated for a mapped element when users select the 'Create Local Element' option. You display this dialog by clicking on the Configure Field Mapping button on the 'Type Mapping' dialog, having mapped an external element type to an Enterprise Architect element (or selected an existing mapped element type).

Configuration options for mapping of external item's fields to local Enterprise Architect element properties

The process generally maps the fields for a specific type of element; however, if you want to map certain fields for all types of element, click on the 'External Type' drop-down arrow on the 'Field Mapping' dialog, and select the value 'Default'.

To map the fields:

  1. Click on the New button, then click on the 'External Field' drop-down arrow and select the name of the field to map from the external source.
  2. Click on the 'Internal Field' drop-down arrow and select the appropriate Enterprise Architect field name that the external element field maps to.
  3. If the internal field is a Tagged Value field, also click on the 'Tagged Value' drop-down arrow and select the Tagged Value that the external element field maps to.
  4. Click on the Save button.

Notes

  • Each mapping can be reset to default values by clicking on the Reset to Defaults button
  • If no type mapping is defined for a given element type, then the mapping for type 'Default' will be used