Mapping sets

Mapping sets view

A mapping set is a collection of terminology maps. A terminology map creates an association between two terminology components from two different terminologies. The Mapping sets view (also called mapping sets navigator) lists the mapping sets. It works similar to other views:

Mapping sets view

The mapping set perspective displays the mapping set view on the left side of the screen. If you are using a different perspective (e.g. authoring perspective), go to Window > Show View > Other > Snow Owl > Mapping sets to bring up the mapping sets view.

Creating and deleting mapping sets

To create a new top-level mapping set click on Add new top level mapping set in the view's toolbar. If you want to create a mapping set in a folder right-click on the parent folder and select Add new mapping set from the context menu.

Mapping sets view - context menu

In the wizard, you have to specify the following mandatory text fields.

Click Finish to proceed, and enter a commit comment.

Creating a new mapping set

The new mapping set is now displayed in the mapping set view, the editor is automatically opened. You can specify additional information (e.g. purpose, source URI) on the Properties tab.

To delete a mapping set right-click it in the view and chose Delete mapping set from the context menu. Confirm the deletion plan, and enter a commit comment.

Organizing mapping sets

Mapping sets can be organized in folders and subfolders.

You can also use the context menu to remove and rename folders. If you want to move a mapping set simply drag and drop it from one folder to another.

Mapping set editor

Double-click a mapping set in the view to open the mapping set editor. The editor consists of three tabs: Mappings, Properties, and Metadata.

Mappings tab

By default, the following information is displayed in the columns on the mappings tab.

Mapping set editor, default setting

You can set the preferences of the mapping editor to display or hide columns. The following information can also be displayed in the editor.

Mapping set editor, customized setting

The text field allows filtering members, similar to the reference set editor.

Filtering mappings

You can change information by clicking on the cell: Enter new information or select an option from the drop-down menu.

Changing correlation of a mapping

Mapping terms

Mappings can be made from the different terminology views or from the search results by dragging them into the editor.

Go to a terminology view (e.g. ATC view), mark the concept or code you want to add, and drag it into the mapping sets editor. The term that is dragged first into the editor will be the map source.

To add a target drag a concept to the area of the map source until it is highlighted (see screenshot), then drop it. If you want to add another map source drag the concept into the editor without highlighting one of the existing members.

Adding map target

You can also add concepts from the search view: Mark the result you want to add and drag it into the mapping set editor. If you want to add all search results, use the shortcut CTRL+A to mark all results, then drag them into the editor. This will create new map targets. To add only selected results, press CDM and click the result you want to add, then drag your selection in the editor.

When a component is added to a Mapping Set the following rules apply:

Mapping sets are capable of representing one-to-many mappings by multiple maps. It is possible to add the same source multiple times, with different mapping targets. If the same source with the same target is added, a validation message is displayed.

The same map source is mapped to multiple targets

Changing and removing mappings

If you want to change a mapping right-click on the mapping to bring up the context menu

Adding members to a mapping from context menu

If you want to change a mapping drag the new target concept to the mapping until it is highlighted. A message will ask you to confirm the change.

Changing an existing mapping

A warning dialog will inform you if you are trying to add a member that already exists in the mapping set.

To inactivate a mapping click on the cell and chose inactivate from the drop-down menu. Alternatively you can right-click the member and use the context menu. You can activate members the same way. The button in the view's toolbar allows to show or hide inactive members.

Properties Tab: Information about the mapping set

Name, definition, and source are mandatory properties that need to be specified when creating a mapping set. Additional information about the mapping set (e.g. definition) can be entered or modified on the properties tab.

Information about the mapping set

Metadata tab: Defining Groups and Keywords

Different groupings can be defined on the metadata tab. It's also possible to assign keywords so that retrieval requests can find the relevant groups, and they may assign OIDs for these groups.

Right-click a group and use the context menu to add a new group or to remove a selected group. You can also use the button on the top to add groups .

Once a group is highlighted, information can be entered and modified in the table on the right side.

To define a keyword, use the botton in the toolbar , a default text (e.g keyword 1) will appear in the table. You can enter your keyword by overwriting the default text. You can also create a new keyword by right-clicking on the table, and selecting Add new keyword.

To remove a keyword, right-click on the keyword and select Remove selected keywords from the context menu. You can also highlight several keyword and delete them at once.

Metadata tab in Mapping set edit

Validation rules for mapping sets

The following validation rules are enforced when creating a new mapping sets

Name, Definition, Purpose, Version, and Source fields are mandatory

Validation for mandatory fields when creating a new mapping set

The following items have to be unique

Validation for unique folder name

Members pointing to missing concepts are indicated by a small question mark decorator.

Decorator indicating missing concepts

Customizing the mapping set editor

It is possible to select the desired columns of the Mapping set editor's table. The Preferences page can be access from File > Preferences > Snow Owl > Editor tables > Mapping set editor. You can also right-click on the table header of the mapping set editor, and selecting Table Preferences.

Table preferences

On the Preferences page, the following options can be selected:

Click OK to change the settings. Note: After setting the preferences, the editor needs to be reopened to take effect.

Preferences page for mapping set editor

Searching mapping sets

Searching for mapping sets was integreated in the quick search, filter search, and advanced search. For information please refer to the Browsing and Searching section.

Importing and exporting mapping sets

Mapping sets can be imported from, and exported to an Excel spreadsheet. For information please refer to the Importing, Exporting, and Publishing section.