Value domains

Value domain view

Open the value domains perspective by clicking on the respective button in the toolbar. If you want to use a different perspective you can open the value domains view from the main menu: Window > Show View > Other > Snow Owl > Value Domains.

The value domain view (also called value domain navigator) works similar to other views:

Value domain view with filter search

Creating and deleting value domains

To create a new value domain click on Add new value domain in the view's toolbar. Alternatively you can right-click on the parent folder and select Add new value domain from the context menu.

On the first page of the wizard, you have to specify the following mandatory text fields.

Click Finish to proceed, and enter a commit comment. The new value domain is now displayed in the value domain view, the editor is automatically opened.

Creating a new value domain

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

Importing and exporting value domains is discussed in the Importing, exporting and publishing section.

Organizing value domains

Value domains 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 value domain simply drag and drop it from one folder to another.

Adding a new subfolder in the value domain navigator

Value domain editor

Double click-a value domain in the view to open the value domain editor. The editor consists of three tabs: Members, Properties, and Metadata.

Members tab

The Members tab displays the following information:

A toggle button allows switching the view between hierarchical and flat list modes. The clock button allows to show or hide inactive members. You can sort the content by clicking on the header of the column. Double-clicking a member opens the respective editor.

Value domain editor, flat list

The hierarchical view is similar to the concept navigators. Terminologies are organized in separate folders and can be easily distinguished by their icons. Click on a node to expand or collapse the tree, double-click a concept to open it in the editor. The minus button in the toolbar closes all nodes.

Value domain editor, hierarchical view in members tab

Adding value domain members

New value domain members can be added from the different terminology views or from the search results.

Adding members to a value domain from context menu

Members can be added this way from SNOMED CT, ATC, ICD-10, ICD-10-AM, LOINC, and local code systems. When a component is added to a Value Domain the following rules apply:

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

Warning dialog

Removing, inactivating, activating members

Use the context menu to remove or inactivate selected members by right-clicking on the member/members. The button in the view's toolbar allows to show or hide inactive members. If you select an inactive member, the context menu will display an option for activating the selected member. Alternatively, you can activate or inactivate members by clicking on the respective cell in the table.

Inactivating a value domain members

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

Filtering value domain members

Properties tab: Information about the value domain

Additional information about the value domain (e.g. definition) can be entered on the properties tab. You can also modify existing information.

Information about the value domain

Metadata tab: Defining groupings 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 2) 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.

Adding a new keyword on Metadata tab

Validation rules for value domains

The following validation rules are enforced when creating a new value domain

Name, Definition and Source fields are mandatory

Creating a new value domain

The following items have to be unique

Message about redundant value domain members

Members pointing to missing concepts are allowed with a warning. A small question mark decorator indicates that these concepts have not been imported.

Decorator indicating missing concepts

The reason for inactivation has to be specified when the status of a value domain is changed to inactive.

Validating reason for inactivation