Reference set view

Viewing reference sets

Reference sets are grouped by type in the reference set view. The categories can be collapsed and expanded by clicking on the triangles. It's also possible to create folders within a category to group several reference sets for easier navigation (e.g. B2i examples folder in screenshot).

The reference set view can be linked to the editor using the button in the tool bar, clicking the button again will unlink the view.

Reference sets organized by category

Right-clicking a reference set will bring up the context menu.

Context menu in Reference set view

Reference set icons also indicate their included components (e.g. SNOMED CT concept, ATC concept, description, etc.) via a small indicator (a "decorator") on the bottom right of their icon.

Decorator indicates that the reference set contains SNOMED CT concepts

The module of a concept is indicated by a small decorator on the top right of the concept icon. National extensions can be identified by a small flag of the country.

Singapore and B2i flags indicating the reference set provenance

Creating a new reference set

There are different ways to create a reference set:

Click on the respective button in the toolbar to bring up a wizard for the chosen type.

You can also use the context menu in the reference set view: Right-click on the folder of the type you would like to create. Make sure you are right-clicking a folder (e.g. Attribute value type) and not a reference set, since this will bring up a different context menu.

Creating a reference set from the view

Alternatively, you can use File > New > Snow Owl > Reference set in the main menu. This will bring up a dialog where you can pick the type of reference set.

Reference set wizard

Specify the following settings in the wizard:

Reference set wizard for creating a simple type reference set

Selecting the referenced component of an attribute-value type reference set

Hit finish to create an empty reference set in which you can add members. You can see that the reference set was added to the reference set view.

Validating a reference sets

Reference sets can be validated to ensure that all referenced components are active. The validation can be invoked by right-clicking the reference set in the navigator.

Invoke validate reference set action from context

The validation errors are displayed in the Problems view, and error-decorators are also added to the reference sets and reference set members where erroneous components are found.

Validation error markers on reference set in Reference set navigator

The problems view displays additional information about the erroneous members. Note that in this example, the refset member is active (indicating that this component is a current part of the refset), however the referenced component itself (Infection by Babesia equi) is inactive.

Erroneous reference set member in problems view

Erroneous reference set member in editor

Cloning a reference set

It's possible to constrain or extend a reference set by creating a clone of it and adding modifications either manually or by using lexical or semantic queries. The master reference set will remain the same, while various versions can be created with the clone mechanism for modifications.

The clone action can be invoked by right-clicking the reference set in the Reference Set navigator.

Invoke Clone reference set action from context menu

Enter the name of the new reference set, an ID is automatically generated. Click Finish to create a clone.

Creating a new reference set by cloning

Deleting a reference set

Reference sets can be deleted directly from the reference set view by right-clicking a reference set and choosing the delete option.

Delete reference set action

After choosing a reference set to be deleted, a confirmation window displays the SNOMED CT components that will be affected by the deletion. Only unpublished reference sets can be deleted.

Delete reference set confirmation