Common patterns of terminology use in archetypes and templates

Text elements for narrative text

No use of archetype internal value sets or external terminology value set.

Data type: DV_TEXT with no constraints.

Example: "Description" elements in many archetypes. 

Text element for a choice of coding (preferred) but where we know that free text may have to be entered

Data type: DV_TEXT with no constraints, and coding with terminology mentioned in comment.

Intent: DV_TEXT will be constrained to DV_CODED_TEXT when coding is used, in a specialisation, template or application.

Examples: Problem/diagnosis name, Medication name.

Text element for coding where there's a set value set that will never change

Data type: DV_CODED_TEXT with an internal value set.

Example: Laterality (left/right).

Text element for coding where we have a fair idea about what the value set could be, but there could be local use cases or mandated national code sets

Data type: Choice of DV_TEXT with no constraints/DV_CODED_TEXT with an internal value set, OR Choice of DV_TEXT with no constraints/DV_CODED_TEXT with an external terminology value set (usually only in national archetypes).

Intent: In specialisations or templates where a local value set is needed, the DV_CODED_TEXT with an internal value set is removed, and the DV_TEXT is constrained to DV_CODED_TEXT and an external terminology value set added.

Example use case: Where coding is definitely preferred but there are exceptions where the value is not yet coded or cannot be coded e.g experimental drugs, foreign products not on national dictionary.

Example: "Overall test status" in OBSERVATION.laboratory_test_result.