Skip to main content
Version: 3.1

Valueset

Definition​

A valueset in Care is a named list of allowed codes that you can use again in many places. For example, a valueset holds all the codes for a type of allergy. Other parts of Care point to a valueset by name instead of listing each code by hand. A Choice question in a questionnaire and a diagnosis code in a condition both get their codes from a valueset.

Key Attributes​

ComponentsWhat it captures
NameThe name of the valueset. Care requires this.
SlugA short identifier that is unique in Care. Care requires this.
DescriptionText that explains the purpose of the valueset. This is optional.
StatusThe stage of the valueset in its life. Care requires this.
Include rulesThe rules that add codes to the valueset.
Exclude rulesThe rules that remove codes from the valueset.
SystemShows if the valueset comes with Care. Care sets this value.

Include rules and exclude rules​

Together, the include rules and the exclude rules decide which codes belong to the valueset.

Each rule selects one code system, for example LOINC, SNOMED, or UCUM. A rule can also give a version of that code system. The rule then does one of two things:

  • The rule lists the exact codes to use.
  • The rule sets a filter, for example all codes that are a type of X.

Status​

StatusDescription
ActiveThe valueset is ready for use in Care.
DraftThe valueset is still in preparation.
RetiredThe valueset is no longer for use.
UnknownThe stage of the valueset is not known.

Who can change a valueset​

Only a superuser can create, change, or retire a valueset. Any signed-in user can search a valueset and use its codes, for example to answer a question in a form.

Note: The valueset pages show the same controls to every user. Care accepts a change only from a superuser.