Admin: Automated edit (via update-page on MediaWiki MCP Server)

2026-07-06T04:00:32Z

Automated edit (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 09:30, 6 July 2026
Line 50:		Line 50:

	Value sets are shared terminology and are not gated by the usual role-based permissions. Any authenticated user can read and search them — listing, retrieval, code lookup, expansion, validation, and the personal favourites and recent-views actions are all open — because they power the code pickers everyone relies on while documenting care. Creating, updating, or deleting a value set is restricted to superusers (<code>is_superuser</code>); no organization role grants write access, which is why system-defined value sets are not editable by deployments.		Value sets are shared terminology and are not gated by the usual role-based permissions. Any authenticated user can read and search them — listing, retrieval, code lookup, expansion, validation, and the personal favourites and recent-views actions are all open — because they power the code pickers everyone relies on while documenting care. Creating, updating, or deleting a value set is restricted to superusers (<code>is_superuser</code>); no organization role grants write access, which is why system-defined value sets are not editable by deployments.

			{{Navbox definitions}}

	{{Related}}		{{Related}}

Admin: OHC identity seed

2026-07-04T22:43:25Z

OHC identity seed

New page

{{Doc header
|type=concept
|domain=definitions
|title=Value Set
|order=3
|introduced=3.0
|concept=Concepts/Observation Definition
|reference=References/Value Set
}}

A '''value set''' is a curated, named list of the answer options allowed for a coded field — the menu of choices behind a dropdown in a form. It is how Care keeps clinical data consistent: instead of free text, a question pulls from an agreed set of codes, so the same finding is recorded the same way every time.

== What it represents ==

In Care's FHIR-aligned model, a value set maps to the '''ValueSet''' resource. It captures:

* '''A set of allowed concepts''' — the codes a field may use, drawn from one or more standard code systems such as SNOMED CT, LOINC, or ICD
* '''Composition rules''' — clauses that ''include'' or ''exclude'' whole branches of a code system, rather than spelling out every code by hand
* '''Publication status''' — whether the set is a draft, in active use, or retired
* '''Origin''' — whether it ships with the platform or was authored for your deployment

A value set is not a list of codes frozen in a column. It stores the ''rules'' for what belongs, and the member codes are resolved live against a terminology server each time the set is searched. Edit the rules and the available choices change immediately — there is nothing to rebuild. This is also what separates it from a [[Concepts/Questionnaire|questionnaire]]: the questionnaire decides ''which questions are asked''; the value set decides ''what answers each coded question accepts''.

== Lifecycle ==

A value set moves through publication states that signal how much to trust it:

<syntaxhighlight lang="text">draft → active → retired
(unknown)</syntaxhighlight>
* '''draft''' — authored but not yet ready for use; safe to edit and refine
* '''active''' — published and in use by forms and coded fields
* '''retired''' — no longer recommended; kept for history but not chosen for new work
* '''unknown''' — status has not been established

== Types ==

Value sets come in two kinds, and the distinction decides who may change them:

* '''System-defined''' — shipped and maintained by the platform as shared terminology. Deployments treat these as read-only, and their identifiers are reserved with a <code>system-</code> prefix.
* '''Deployment-authored''' — created locally to capture terminology specific to your facility or program. This is where a deployment adds its own pick-lists.

== How it connects ==

* '''Forms''' — a [[Concepts/Questionnaire|questionnaire]] references a value set to constrain a coded answer, so the form only accepts valid options.
* '''Definitions''' — clinical definitions such as an [[Concepts/Observation Definition|observation definition]] bind their coded fields to a value set, anchoring what counts as a valid result.
* '''Code systems''' — a value set does not invent codes; it selects from external standard vocabularies, keeping Care interoperable with the wider health ecosystem.
* '''Personalization''' — users can favorite frequently used codes, and Care remembers recently picked ones. This speeds up data entry, but it sits on top of the value set as personal preference, not part of its definition.

== Permissions ==

Value sets are shared terminology and are not gated by the usual role-based permissions. Any authenticated user can read and search them — listing, retrieval, code lookup, expansion, validation, and the personal favourites and recent-views actions are all open — because they power the code pickers everyone relies on while documenting care. Creating, updating, or deleting a value set is restricted to superusers (<code>is_superuser</code>); no organization role grants write access, which is why system-defined value sets are not editable by deployments.

{{Related}}

Concepts/Value Set - Revision history

Admin: Automated edit (via update-page on MediaWiki MCP Server)

Admin: OHC identity seed