ART Value Set Editor

Revision as of 13:13, 2 December 2014 by Kheitmann (talk | contribs)

Value set editor

Creating new value sets

Editors of a project may create new value sets through the value set form.

Clicking on the TemplateEditor-plusbutton.png button opens the value set creation dialog. You have four options to populate a new value set:

  • Browse and use existing code systems like LOINC, etc.
  • Entering codes on your own manually
  • Use complete code systems (OID)
  • Add codes as exceptions, e.g. nullFlavors

Adding a Value Set is simple. If you have the corresponding permissions, the TemplateEditor-plusbutton.png button appears above the list of value sets (1).

Adding a Value Set

Value Set Editor Dialog

The Value Set Editor Dialog has three main parts:

  • metadata for the Value Set (1)
  • a selector to choose from Source Code System (2)
  • the Value Set Content (3).

The Value Set Content has four parts:

  • Complete Code Systems (references with the Code System OID)
  • Values, i.e. Coded Concepts from official/proprietary existing code systems
  • Value Sets to be included in the Value Set
  • Exceptional Coded Concepts

Value Set Editor Dialog

Value Set Metadata

Value Sets have a couple of metadata to be determined:

  • a display name (1)
  • a busines name (2)
  • a full text description, optional (3)

The Value Set id is automatically derived from the Value Set Ids of the project (4).

Value Set Metadaten

Source Code System Selection

To select codes from a browsable Code System choose the desired System from the Source Code System Selection menu. A browser opens if clicking on "Select"

Source Code System Selection

Value Set Code System Browser

The Code System Browsers are more or less all equally designed: you type in a search term and get the results displayed. Selecting a concept (1) and clicking on "Add to valueset" (2) adds the corresponding Coded Concept to the Value Set (in the background). You can select another concept and add it until done.

Value Set Code System Browser

Value Set with Values

Once the selection of Coded Concepts for a Value Set is finished and the Code System Browser dialog is closed, the Coded Concepts chosen so far appear in the "Values" section of the Value Set Content area.

If you want to enter codes manually press the * button next to the "Values" Heading. This adds a new first row in the Values area and you can edit Level, Type, Code, Display name, Codesystem and Description.

The items have the following meaning:

  • Level of hierarchy
  • Type of node, either a selectable leaf node (L), a specializable head of a hierarchy (S), an abstract value as a head of a hierarchy (cannot be selected but is displayed as a grouper) or deprecated (D)
  • Code
  • Display Name
  • Code System OID
  • A full text description

Clicking on the + or - next to a row adds a new row under the selected row or deletes the row.

Value Set Values

Value Set with Exceptions

The same mechanism is used to allow adding Exceptional Concepts (like nullFlavors in HL7 v3/FHIR) to the Value Set Content. For that purpose simply click on "Add as exception" in the Code System Browser.

The corresponding value set contains Values and Exceptions.

Value Set Exceptions

Including other defined Value Sets in a Value Set

Including another Value Set

Results

Value Set with exceptions, ready for use

Value set associations

With a valueset association it is possible to create a link between a dataset concept and a valueset. The workflow for setting up a valueset associations:

  • Go to datasets
  • Create a concept in the dataset with the type 'Code' and save it
  • Go to Terminology - tab Terminology associations
  • Select in the left concept tree the just created concept
  • Choose on the left of the 'valueset associations' the button: “Add”
  • Select the valueset to associate with
  • Make a choice:
    • Creating a static associations: associate to this version valueset (whereby the version is determined by the date of the valueset). In this choice some changes/version are possibly not associated with the dataset concept.
    • Creating dynamic associations: associate to this version valueset. If there is a new version valueset the dataset concept will still be associated with the latest version of the valueset.
  • Go to datasets, select the concept. Now it will display that there is a valueset association created and also on which date and time it is created.
  • When clicking on the link behind 'valueset associations' you'll be directed to the valueset itself.