Configure Mappings Dialog

You can configure role-based mapping themes for flexible mapping in the Beamer tool window in this dialog.

Purpose

You can edit and create mapping themes that are used in the Beamer tool window in this dialog.

Call

To open the Configure Mappings dialog, click on Configure... in the Beamer tool window.

You can edit and create mapping themes in this dialog.

Structure

The dialog consists of the configured mapping theme overview on the left-hand side and the corresponding details and mappings in two tabs.

Mapping Themes List

The overview lists existing mapping themes as user-defined or model-wide configurations.

You can manage configurations here. (see "Managing Mapping Themes")
Details Tab

As details, you enter a name and description for the theme in the supported interface languages and assign the roles that should have access to the contained mappings.
Mappings Tab

For the definition of all mappings of the theme, you determine the source and target roots in the model and select a relationship stereotype for the mappings along with the relationship direction.

For the individual mappings, you define the stereotype of the initial element and the stereotypes of possible derived elements as well as the action type.

The individual mappings are mixed up within the theme and are then distributed to the source stereotype and mode. If, when you release the edge on a target element, it is not clear what sort of element should be created, the possible create templates are offered in a list so that you can select the target.

Managing Mapping Themes

A mapping theme can initially be stored as a user-defined configuration under a name.

The Edit Model-Wide Configurations privilege enables an existing user-specific mapping theme to be prepared so that it can be made into a mapping theme across all models that can be used by all users.

List of Stored Mapping Themes

You can enter a name pattern in the <Filter> field above the structure content to restrict the entries displayed there.

Icons split configurations into two groups:

Model-wide configuration

User-defined configuration

A tool tip appears for each entry when you hover over it with the mouse; it shows information, e.g. for creating model-wide configurations.

An asterisk next to the name indicates unsaved changes.

A selected saved mapping theme can be edited.
Command Toolbar

The following commands can be used to manage the mapping themes.
- New
  
  Creates a new user specific configuration. It will be saved with the current settings, and it will be loaded then.
- Rename
  
  Rename the selected configuration. Renaming a configuration which has pending changes is not possible. Renaming a model-wide configuration requires the privilege 'Edit Model-Wide Configurations'.
- Delete
  
  Delete the selected configuration. Deleting a model-wide configuration requires the privilege 'Edit Model-Wide Configurations'.
- Copy
  
  Create a user specific copy of the selected configuration. The copy is loaded. Copying is not possible when the loaded configuration has no pending changes.
- Deploy
  
  Create a model-wide application configuration from the selected user-specific configuration. After deployment as a model-wide configuration, the user-specific configuration is deleted. The selected configuration must not have pending changes. The privilege 'Edit Model-Wide Configurations' is required.
- Save
  
  Save the current settings to the selected configuration. If a model-wide configuration is selected, you need the privilege 'Edit Model-Wide Configurations', otherwise you can choose a name for saving the configuration user-specifically. The saved configuration is then considered loaded.
- Save As
  
  Save the current settings into a new or existing configuration, model-wide or user-specific. Saving a model-wide configuration requires the privilege 'Edit Model-Wide Configurations'. The saved configuration is then considered loaded.
- Discard Changes (for directly editable configurations)
  
  Discards the changes on the edited configuration.
- View Content
  
  Opens a dialog which allows viewing the configuration as text. Changes are not possible.
- Edit Content (replaces View Content for defective configurations)
  
  Opens a dialog which allows editing the configuration as text. In this way can a configuration be repaired that cannot be loaded anymore.
  
  Proceed carefully as invalid structure changes may make the configuration unusable.

Defining a Mapping Theme

Context

The definition of a mapping theme encompasses the naming and description of the theme as well as the definition of the actual mappings of output elements of a source root to the derived elements of a target root. The source root and target root must be in the same Innovator model.

You can create a new mapping theme or even a mapping from the corresponding duplicate.

When you assign the access rights, you define which roles in the model are allowed to make the actual mappings.

All of the relationships configured for the elements of the source root are available for selection for the mappings.

A selection of relationship direction is offered in accordance with the relationship type.

All elements of the source root for which the selected relationship type can be modeled in accordance with the configuration are available for selection as source elements.

All action types are always available as the action. The action type dictates the effects of a mapping.

Restriction

The use of the action types in a mapping theme must ensure a unique effect in both mapping modes in the Beamer tool window.

It only makes sense to define different mappings of the same initial stereotype in a mapping theme if one action is used exclusively and uniquely per mode. The simultaneous use of concurrent action types in a mode (e.g. CopyLink and Move) can cause unexpected results.

To enable concurrent actions on the same initial stereotype, separate mapping themes must be defined.

All elements of the source root for which the selected relationship type can be modeled in accordance with the configuration are available for selection as derived elements.

How to proceed

Click on New.

A user-defined configuration with the Mapping Theme name specification is created in the Mapping Themes list.
Enter the name and description for the mapping theme in the Details tab.
To make the name and description available for the German Innovator interface, too, activate the Localize name and description check box and enter a name and description in German.
In the Execution Rights list, activate the check boxes of the roles in the model which the mapping theme should be available for.
Jump to the Mappings tab.
Click on Selection of the root package.to define the source root of the source elements.

The Select source root dialog appears.
Select the source root and confirm with OK.
You define the target root for the derived elements in the same way.
Click on Selection of the relationship stereotype. to define the stereotype for the mappings.

The Select relation dialog appears.
Select the relationship stereotype and confirm with OK.
In the drop-down list of the same name, select the relationship direction.
To define a mapping, click on Define new mapping.

A new entry with the name specification CopyLink action type is created in the Mappings list.
Click on Select the stereotype of the source elements. to define the initial element's stereotype for this mapping.

The Select source dialog appears.
Select the initial element's stereotype and confirm with OK.
Select the action type of this mapping in the Action column.
Click on Select the stereotypes of the target elements to define one or more stereotypes of the derived elements for this mapping.

The Select targets dialog appears.
Select one or more stereotypes of the derived elements and confirm with OK.
To define further mappings, repeat steps 12 to 17.
Confirm your definitions for the mapping theme with Save.

Copying a Mapping Theme

Context

Duplicate the mapping theme if you want to use a mapping theme as a template or split a mapping theme that is too complex.

Then make the required changes.

How to proceed

Select the mapping theme that you want to copy.
Click on Copy.

An identical copy of the selected mapping theme is added to the Mapping Themes list. Use a suffix to make the name unique.
Change the name and description for the mapping theme in the Details tab.
In the Execution Rights list, activate the check boxes of the roles in the model which the mapping theme should be available for.
Jump to the Mappings tab.
Make all required changes.

Proceed as described in "Defining a Mapping Theme" (from step 6).

Deleting a Mapping Theme

How to proceed

Select the mapping theme that you want to delete.
Click on Delete.

A dialog appears.
Confirm the security question with OK or cancel with Cancel.