OpenEHR Base package
0.1.0 - First Draft International flag

OpenEHR Base package, published by openEHR + HL7. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/openehr-fhir/base-spec/ and changes regularly. See the Directory of published versions

Logical Model: DV_CODED_TEXT - Detailed Descriptions

Page standards status: Informative Maturity Level: 3

Definitions for the DV-CODED-TEXT logical model.

Guidance on how to interpret the contents of this table can be foundhere

0. DV_CODED_TEXT
Definition

A text item whose value must be the rubric from a controlled terminology, the key (i.e. the 'code') of which is the _defining_code_ attribute. In other words: a DV_CODED_TEXT is a combination of a CODE_PHRASE (effectively a code) and the rubric of that term, from a terminology service, in the language in which the data were authored.

Since DV_CODED_TEXT is a subtype of DV_TEXT, it can be used in place of it, effectively allowing the type DV_TEXT to mean a text item, which may optionally be coded.

Misuse: If the intention is to represent a term code attached in some way to a fragment of plain text, DV_CODED_TEXT should not be used; instead use a DV_TEXT and a TERM_MAPPING to a CODE_PHRASE.


Base definition for all types defined in FHIR type system.

ShortA text item whose value must be the rubric from a controlled terminology, the key (i.Base for all types and resources
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
InvariantsValid_value: Valid value must not be empty (value.empty().not())
Mappings_valid: Mappings valid must not be empty (mappings /= void implies mappings.empty().not())
Formatting_valid: Formatting valid must not be empty (formatting /= void implies formatting.empty().not())
2. DV_CODED_TEXT.CR
Definition

Carriage return character.

ShortCarriage return character.
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
4. DV_CODED_TEXT.LF
Definition

Line feed character.

ShortLine feed character.
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. DV_CODED_TEXT.Local-terminology-id
Definition

Predefined terminology identifier to indicate it is local to the knowledge resource in which it occurs, e.g. an archetype

ShortPredefined terminology identifier
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
8. DV_CODED_TEXT.value
Definition

Displayable rendition of the item, regardless of its underlying structure. For DV_CODED_TEXT, this is the rubric of the complete term as provided by the terminology service.

ShortDisplayable rendition of the item, regardless of its underlying structure.
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
10. DV_CODED_TEXT.hyperlink
Definition

DEPRECATED: this field is deprecated; use markdown link/text in the _value_ attribute, and "markdown" as the value of the _formatting_ field.

Original usage, prior to RM Release 1.0.4: Optional link sitting behind a section of plain text or coded term item.

ShortDEPRECATED: this field is deprecated; use markdown link/text in the `_value_` attribute, and `"markdown"` as the value of the `_formatting_` field.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-URI
Is Modifierfalse
12. DV_CODED_TEXT.formatting
Definition

If set, contains one of the following values:

  • "plain": use for plain text, possibly containing newlines, but otherwise unformatted (same as Void);
  • "plain_no_newlines": use for text containing no newlines or other formatting;
  • "markdown": use for markdown formatted text, strongly recommended in the format of the CommonMark specification.

DEPRECATED usage: contains a string of the form "name:value; name:value..." , e.g. "font-weight : bold; font-family : Arial; font-size : 12pt;". Values taken from W3C CSS2 properties lists for background and font .

ShortIf set, contains one of the following values: * `"plain"`: use for plain text, possibly containing newlines, but otherwise unformatted (same as Void); * `"plain_no_newlines"`: use for text containing no newlines or other formatting; * `"markdown"`: use for markdown formatted text, strongly recommended in the format of the CommonMark specification.
Control0..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. DV_CODED_TEXT.mappings
Definition

Terms from other terminologies most closely matching this term, typically used where the originator (e.g. pathology lab) of information uses a local terminology but also supplies one or more equivalents from well known terminologies (e.g. LOINC).

ShortTerms from other terminologies most closely matching this term, typically used where the originator (e.
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/TERM-MAPPING
Is Modifierfalse
16. DV_CODED_TEXT.language
Definition

Optional indicator of the localised language in which the value is written. Coded from openEHR Code Set languages . Only used when either the text object is in a different language from the enclosing ENTRY, or else the text object is being used outside of an ENTRY or other enclosing structure which indicates the language.

ShortOptional indicator of the localised language in which the value is written.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse
18. DV_CODED_TEXT.encoding
Definition

Name of character encoding scheme in which this value is encoded. Coded from openEHR Code Set character sets . Unicode is the default assumption in openEHR, with UTF-8 being the assumed encoding. This attribute allows for variations from these assumptions.

ShortName of character encoding scheme in which this value is encoded.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse
20. DV_CODED_TEXT.defining-code
Definition

The term of which the _value_ attribute is the textual rendition (i.e. rubric).

ShortThe term of which the `_value_` attribute is the textual rendition (i.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse

Guidance on how to interpret the contents of this table can be foundhere

0. DV_CODED_TEXT
Definition

A text item whose value must be the rubric from a controlled terminology, the key (i.e. the 'code') of which is the _defining_code_ attribute. In other words: a DV_CODED_TEXT is a combination of a CODE_PHRASE (effectively a code) and the rubric of that term, from a terminology service, in the language in which the data were authored.

Since DV_CODED_TEXT is a subtype of DV_TEXT, it can be used in place of it, effectively allowing the type DV_TEXT to mean a text item, which may optionally be coded.

Misuse: If the intention is to represent a term code attached in some way to a fragment of plain text, DV_CODED_TEXT should not be used; instead use a DV_TEXT and a TERM_MAPPING to a CODE_PHRASE.

ShortA text item whose value must be the rubric from a controlled terminology, the key (i.
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. DV_CODED_TEXT.defining-code
Definition

The term of which the _value_ attribute is the textual rendition (i.e. rubric).

ShortThe term of which the `_value_` attribute is the textual rendition (i.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse

Guidance on how to interpret the contents of this table can be foundhere

0. DV_CODED_TEXT
Definition

A text item whose value must be the rubric from a controlled terminology, the key (i.e. the 'code') of which is the _defining_code_ attribute. In other words: a DV_CODED_TEXT is a combination of a CODE_PHRASE (effectively a code) and the rubric of that term, from a terminology service, in the language in which the data were authored.

Since DV_CODED_TEXT is a subtype of DV_TEXT, it can be used in place of it, effectively allowing the type DV_TEXT to mean a text item, which may optionally be coded.

Misuse: If the intention is to represent a term code attached in some way to a fragment of plain text, DV_CODED_TEXT should not be used; instead use a DV_TEXT and a TERM_MAPPING to a CODE_PHRASE.

ShortA text item whose value must be the rubric from a controlled terminology, the key (i.
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
InvariantsValid_value: Valid value must not be empty (value.empty().not())
Mappings_valid: Mappings valid must not be empty (mappings /= void implies mappings.empty().not())
Formatting_valid: Formatting valid must not be empty (formatting /= void implies formatting.empty().not())
2. DV_CODED_TEXT.CR
Definition

Carriage return character.

ShortCarriage return character.
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
4. DV_CODED_TEXT.LF
Definition

Line feed character.

ShortLine feed character.
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. DV_CODED_TEXT.Local-terminology-id
Definition

Predefined terminology identifier to indicate it is local to the knowledge resource in which it occurs, e.g. an archetype

ShortPredefined terminology identifier
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
8. DV_CODED_TEXT.value
Definition

Displayable rendition of the item, regardless of its underlying structure. For DV_CODED_TEXT, this is the rubric of the complete term as provided by the terminology service.

ShortDisplayable rendition of the item, regardless of its underlying structure.
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
10. DV_CODED_TEXT.hyperlink
Definition

DEPRECATED: this field is deprecated; use markdown link/text in the _value_ attribute, and "markdown" as the value of the _formatting_ field.

Original usage, prior to RM Release 1.0.4: Optional link sitting behind a section of plain text or coded term item.

ShortDEPRECATED: this field is deprecated; use markdown link/text in the `_value_` attribute, and `"markdown"` as the value of the `_formatting_` field.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-URI
Is Modifierfalse
12. DV_CODED_TEXT.formatting
Definition

If set, contains one of the following values:

  • "plain": use for plain text, possibly containing newlines, but otherwise unformatted (same as Void);
  • "plain_no_newlines": use for text containing no newlines or other formatting;
  • "markdown": use for markdown formatted text, strongly recommended in the format of the CommonMark specification.

DEPRECATED usage: contains a string of the form "name:value; name:value..." , e.g. "font-weight : bold; font-family : Arial; font-size : 12pt;". Values taken from W3C CSS2 properties lists for background and font .

ShortIf set, contains one of the following values: * `"plain"`: use for plain text, possibly containing newlines, but otherwise unformatted (same as Void); * `"plain_no_newlines"`: use for text containing no newlines or other formatting; * `"markdown"`: use for markdown formatted text, strongly recommended in the format of the CommonMark specification.
Control0..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. DV_CODED_TEXT.mappings
Definition

Terms from other terminologies most closely matching this term, typically used where the originator (e.g. pathology lab) of information uses a local terminology but also supplies one or more equivalents from well known terminologies (e.g. LOINC).

ShortTerms from other terminologies most closely matching this term, typically used where the originator (e.
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/TERM-MAPPING
Is Modifierfalse
16. DV_CODED_TEXT.language
Definition

Optional indicator of the localised language in which the value is written. Coded from openEHR Code Set languages . Only used when either the text object is in a different language from the enclosing ENTRY, or else the text object is being used outside of an ENTRY or other enclosing structure which indicates the language.

ShortOptional indicator of the localised language in which the value is written.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse
18. DV_CODED_TEXT.encoding
Definition

Name of character encoding scheme in which this value is encoded. Coded from openEHR Code Set character sets . Unicode is the default assumption in openEHR, with UTF-8 being the assumed encoding. This attribute allows for variations from these assumptions.

ShortName of character encoding scheme in which this value is encoded.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse
20. DV_CODED_TEXT.defining-code
Definition

The term of which the _value_ attribute is the textual rendition (i.e. rubric).

ShortThe term of which the `_value_` attribute is the textual rendition (i.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse