VocApp-ValSetChanges/ValSetMenu

Changes from a Value Set Selection

The figure at right shows the various options that can be selected when a Value Set node is selected in the Value Set Navigator window, and the right mouse button is clicked. In each case, the menu selection starts a process to define changes to be applied to the selected value set. (NOTE: The first selection Create Value Set actually creates a value set as a child (sub-type) of the selected value set.) These selections are intended to cover all possible operations on a value set node. In aggregate, the functions provided include: Create or Delete a Value Set; Add or Remove codes from a Value Set; Bind, but not unbind the Value Set to a Concept Domain; and Add or Remove references from the Value Set to child value sets Further, in several cases, these operations are redundant or partially so. For example, both Create Value Set and Bind Concept Domain to Value Set allow a value set to be bound to a concept domain, but only in Create Value Set can one also define a new concept domain.

Menu selections from a value set node

Add Value Set References

Although "reference" is a generic term, the only kind of value set reference included in the Vocabulary Maintenance Language, and in the underlying Access data base tables, is a parent-child relationship wherein the reference is from the parent to the child. This action will allow the user to select one or more value sets to be added as children to the parent Value Set selected in the Value Set Navigator.

Within the Value Set Navigator select the Value Set node that is to be the parent of the Value Set references you wish to establish. Right click on the selected node Select Add Value Set References (see menu at right)	Add VS References: Menu
	Add VS References: Search on start of VS name and select one or more from list
	Add VS References: List of Value Sets to be added as children; for each select to add as Abstract or Specializable
	Add VS References: Review current list of references to add and confirm with "Finish"

Remove Value Set References

Although "reference" is a generic term, the only kind of value set reference included in the Vocabulary Maintenance Language, and in the underlying Access data base tables, is a parent-child relationship wherein the reference is from the parent to the child. This action will remove one or more parent-to-child references from the parent Value Set selected in the Value Set Navigator.

CAUTIONS: Removing a value set reference leaves the value set and its code content in limbo. They remain part of the Code System and part of the Value Set definitions, but will not be exposed because there is no longer a parent under which they will appear. In general, a code system reference should only be removed in one of two circumstances: Where the child value set is already listed under two or more parents and the objective is to remove and not replace one of the references; or Where the goal is to move the child value set to a different parent. In this case, you will need to prepare a two-step change proposal that: Removes the parent child reference here, and Adds a value set reference from a new parent to the same child. For any other purpose, the Delete Value Set function is probably more appropriate.

Process sequence to Remove reference

Within the Value Set Navigator select the Value Set node that is the parent of the Value Set reference you wish to remove. Right click on the selected node Select Remove Value Set References (see menu at right)	Remove VS References: Menu
The wizard will present a Value Set References page (as at right) listing all of the child references held by the parent value set node you selected in the navigator. Select the child node(s) whose reference(s) you wish to remove. Multiple selections may be made by judicious use of Shift-click and Control-click in addition to just Click. When the selection list is complete, click Next (not Finish).	Remove VS References: Select child reference(s) to remove from list
The wizard presents the Value Set References to Remove page as at right. This page lists all of the selections made in the step above. Verify that this list is correct. If you need to make changes, you can click Back and you will be returned to the selection page with the previous selection showing. You can then use Control-click to add to or remove from the previous selection(s). The Cancel button will stop the change wizard, with no entries added to the proposal file. When the listed elements meet your expectations, conclude the removal steps by clicking Finish.	Remove VS References: Review list to be removed, and verify with "Finish"