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: INSTRUCTION - Detailed Descriptions

Page standards status: Informative Maturity Level: 3

Definitions for the INSTRUCTION logical model.

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

0. INSTRUCTION
Definition

Used to specify actions in the future. Enables simple and complex specifications to be expressed, including in a fully-computable workflow form. Used for any actionable statement such as medication and therapeutic orders, monitoring, recall and review. Enough details must be provided for the specification to be directly executed by an actor, either human or machine.

Not to be used for plan items which are only specified in general terms.


Base definition for all types defined in FHIR type system.

ShortUsed to specify actions in the future.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
InvariantsLinks_valid: Links valid must be present (links.exists() implies links.empty().not())
Archetyped_valid: Archetyped valid must satisfy exclusive conditions (is_archetype_root() xor archetype_details .empty())
Archetype_node_id_valid: Archetype node id valid must not be empty (archetype_node_id.empty().not())
Subject_validity: Subject validity must satisfy conditional constraints (subject_is_self() implies subject.generating_type = “PARTY_SELF”)
Other_participations_valid: Other participations valid must be present (other_participations.exists() implies other_participations.empty().not())
Is_archetype_root: Is archetype root (is_archetype_root())
Activities_valid: Activities valid must be present (activities.exists() implies activities.empty().not())
2. INSTRUCTION.name
Definition

Runtime name of this fragment, used to build runtime paths. This is the term provided via a clinical application or batch process to name this EHR construct: its retention in the EHR faithfully preserves the original label by which this entry was known to end users.

ShortRuntime name of this fragment, used to build runtime paths.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-TEXT
Is Modifierfalse
4. INSTRUCTION.archetype-node-id
Definition

Design-time archetype identifier of this node taken from its generating archetype; used to build archetype paths. Always in the form of an at-code, e.g. at0005. This value enables a 'standardised' name for this node to be generated, by referring to the generating archetype local terminology.

At an archetype root point, the value of this attribute is always the stringified form of the _archetype_id_ found in the _archetype_details_ object.

ShortDesign-time archetype identifier of this node taken from its generating archetype; used to build archetype paths.
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. INSTRUCTION.uid
Definition

Optional globally unique object identifier for root points of archetyped structures.

ShortOptional globally unique object identifier for root points of archetyped structures.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/UID-BASED-ID
Is Modifierfalse
8. INSTRUCTION.links
Definition

Links to other archetyped structures (data whose root object inherits from ARCHETYPED, such as ENTRY, SECTION and so on). Links may be to structures in other compositions.

ShortLinks to other archetyped structures (data whose root object inherits from `ARCHETYPED`, such as `ENTRY`, `SECTION` and so on).
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/LINK
Is Modifierfalse
10. INSTRUCTION.archetype-details
Definition

Details of archetyping used on this node.

ShortDetails of archetyping used on this node.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/ARCHETYPED
Is Modifierfalse
12. INSTRUCTION.feeder-audit
Definition

Audit trail from non-openEHR system of original commit of information forming the content of this node, or from a conversion gateway which has synthesised this node.

ShortAudit trail from non-openEHR system of original commit of information forming the content of this node, or from a conversion gateway which has synthesised this node.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/FEEDER-AUDIT
Is Modifierfalse
14. INSTRUCTION.language
Definition

Mandatory indicator of the localised language in which this Entry is written. Coded from openEHR Code Set languages .

ShortMandatory indicator of the localised language in which this Entry is written.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse
16. INSTRUCTION.encoding
Definition

Name of character set in which text values in this Entry are encoded. Coded from openEHR Code Set character sets.

ShortName of character set in which text values in this Entry are encoded.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse
18. INSTRUCTION.other-participations
Definition

Other participations at ENTRY level.

ShortOther participations at `ENTRY` level.
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/PARTICIPATION
Is Modifierfalse
20. INSTRUCTION.workflow-id
Definition

Identifier of externally held workflow engine data for this workflow execution, for this subject of care.

ShortIdentifier of externally held workflow engine data for this workflow execution, for this subject of care.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/OBJECT-REF
Is Modifierfalse
22. INSTRUCTION.subject
Definition

Id of human subject of this ENTRY, e.g.:

  • organ donor
  • foetus
  • a family member
  • another clinically relevant person.
ShortId of human subject of this `ENTRY`, e.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/PARTY-PROXY
Is Modifierfalse
24. INSTRUCTION.provider
Definition

Optional identification of provider of the information in this ENTRY, which might be:

  • the patient
  • a patient agent, e.g. parent, guardian
  • the clinician
  • a device or software

Generally only used when the recorder needs to make it explicit. Otherwise, Composition composer and other participants are assumed.

ShortOptional identification of provider of the information in this `ENTRY`, which might be: * the patient * a patient agent, e.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/PARTY-PROXY
Is Modifierfalse
26. INSTRUCTION.protocol
Definition

Description of the method (i.e. how) the information in this entry was arrived at. For OBSERVATIONs, this is a description of the method or instrument used. For EVALUATIONs, how the evaluation was arrived at. For INSTRUCTIONs, how to execute the Instruction. This may take the form of references to guidelines, including manually followed and executable; knowledge references such as a paper in Medline; clinical reasons within a larger care process.

ShortDescription of the method (i.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/ITEM-STRUCTURE
Is Modifierfalse
28. INSTRUCTION.guideline-id
Definition

Optional external identifier of guideline creating this Entry if relevant.

ShortOptional external identifier of guideline creating this Entry if relevant.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/OBJECT-REF
Is Modifierfalse
30. INSTRUCTION.narrative
Definition

Mandatory human-readable version of what the Instruction is about.

ShortMandatory human-readable version of what the Instruction is about.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-TEXT
Is Modifierfalse
32. INSTRUCTION.expiry-time
Definition

Optional expiry date/time to assist determination of when an Instruction can be assumed to have expired. This helps prevent false listing of Instructions as Active when they clearly must have been terminated in some way or other.

ShortOptional expiry date/time to assist determination of when an Instruction can be assumed to have expired.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-DATE-TIME
Is Modifierfalse
34. INSTRUCTION.wf-definition
Definition

Optional workflow engine executable expression of the Instruction.

ShortOptional workflow engine executable expression of the Instruction.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-PARSABLE
Is Modifierfalse
36. INSTRUCTION.activities
Definition

List of all activities in Instruction.

ShortList of all activities in Instruction.
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/ACTIVITY
Is Modifierfalse

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

0. INSTRUCTION
Definition

Used to specify actions in the future. Enables simple and complex specifications to be expressed, including in a fully-computable workflow form. Used for any actionable statement such as medication and therapeutic orders, monitoring, recall and review. Enough details must be provided for the specification to be directly executed by an actor, either human or machine.

Not to be used for plan items which are only specified in general terms.

ShortUsed to specify actions in the future.
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
InvariantsActivities_valid: Activities valid must be present (activities.exists() implies activities.empty().not())
2. INSTRUCTION.narrative
Definition

Mandatory human-readable version of what the Instruction is about.

ShortMandatory human-readable version of what the Instruction is about.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-TEXT
Is Modifierfalse
4. INSTRUCTION.expiry-time
Definition

Optional expiry date/time to assist determination of when an Instruction can be assumed to have expired. This helps prevent false listing of Instructions as Active when they clearly must have been terminated in some way or other.

ShortOptional expiry date/time to assist determination of when an Instruction can be assumed to have expired.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-DATE-TIME
Is Modifierfalse
6. INSTRUCTION.wf-definition
Definition

Optional workflow engine executable expression of the Instruction.

ShortOptional workflow engine executable expression of the Instruction.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-PARSABLE
Is Modifierfalse
8. INSTRUCTION.activities
Definition

List of all activities in Instruction.

ShortList of all activities in Instruction.
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/ACTIVITY
Is Modifierfalse

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

0. INSTRUCTION
Definition

Used to specify actions in the future. Enables simple and complex specifications to be expressed, including in a fully-computable workflow form. Used for any actionable statement such as medication and therapeutic orders, monitoring, recall and review. Enough details must be provided for the specification to be directly executed by an actor, either human or machine.

Not to be used for plan items which are only specified in general terms.

ShortUsed to specify actions in the future.
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
InvariantsLinks_valid: Links valid must be present (links.exists() implies links.empty().not())
Archetyped_valid: Archetyped valid must satisfy exclusive conditions (is_archetype_root() xor archetype_details .empty())
Archetype_node_id_valid: Archetype node id valid must not be empty (archetype_node_id.empty().not())
Subject_validity: Subject validity must satisfy conditional constraints (subject_is_self() implies subject.generating_type = “PARTY_SELF”)
Other_participations_valid: Other participations valid must be present (other_participations.exists() implies other_participations.empty().not())
Is_archetype_root: Is archetype root (is_archetype_root())
Activities_valid: Activities valid must be present (activities.exists() implies activities.empty().not())
2. INSTRUCTION.name
Definition

Runtime name of this fragment, used to build runtime paths. This is the term provided via a clinical application or batch process to name this EHR construct: its retention in the EHR faithfully preserves the original label by which this entry was known to end users.

ShortRuntime name of this fragment, used to build runtime paths.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-TEXT
Is Modifierfalse
4. INSTRUCTION.archetype-node-id
Definition

Design-time archetype identifier of this node taken from its generating archetype; used to build archetype paths. Always in the form of an at-code, e.g. at0005. This value enables a 'standardised' name for this node to be generated, by referring to the generating archetype local terminology.

At an archetype root point, the value of this attribute is always the stringified form of the _archetype_id_ found in the _archetype_details_ object.

ShortDesign-time archetype identifier of this node taken from its generating archetype; used to build archetype paths.
Control1..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
6. INSTRUCTION.uid
Definition

Optional globally unique object identifier for root points of archetyped structures.

ShortOptional globally unique object identifier for root points of archetyped structures.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/UID-BASED-ID
Is Modifierfalse
8. INSTRUCTION.links
Definition

Links to other archetyped structures (data whose root object inherits from ARCHETYPED, such as ENTRY, SECTION and so on). Links may be to structures in other compositions.

ShortLinks to other archetyped structures (data whose root object inherits from `ARCHETYPED`, such as `ENTRY`, `SECTION` and so on).
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/LINK
Is Modifierfalse
10. INSTRUCTION.archetype-details
Definition

Details of archetyping used on this node.

ShortDetails of archetyping used on this node.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/ARCHETYPED
Is Modifierfalse
12. INSTRUCTION.feeder-audit
Definition

Audit trail from non-openEHR system of original commit of information forming the content of this node, or from a conversion gateway which has synthesised this node.

ShortAudit trail from non-openEHR system of original commit of information forming the content of this node, or from a conversion gateway which has synthesised this node.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/FEEDER-AUDIT
Is Modifierfalse
14. INSTRUCTION.language
Definition

Mandatory indicator of the localised language in which this Entry is written. Coded from openEHR Code Set languages .

ShortMandatory indicator of the localised language in which this Entry is written.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse
16. INSTRUCTION.encoding
Definition

Name of character set in which text values in this Entry are encoded. Coded from openEHR Code Set character sets.

ShortName of character set in which text values in this Entry are encoded.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/CODE-PHRASE
Is Modifierfalse
18. INSTRUCTION.other-participations
Definition

Other participations at ENTRY level.

ShortOther participations at `ENTRY` level.
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/PARTICIPATION
Is Modifierfalse
20. INSTRUCTION.workflow-id
Definition

Identifier of externally held workflow engine data for this workflow execution, for this subject of care.

ShortIdentifier of externally held workflow engine data for this workflow execution, for this subject of care.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/OBJECT-REF
Is Modifierfalse
22. INSTRUCTION.subject
Definition

Id of human subject of this ENTRY, e.g.:

  • organ donor
  • foetus
  • a family member
  • another clinically relevant person.
ShortId of human subject of this `ENTRY`, e.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/PARTY-PROXY
Is Modifierfalse
24. INSTRUCTION.provider
Definition

Optional identification of provider of the information in this ENTRY, which might be:

  • the patient
  • a patient agent, e.g. parent, guardian
  • the clinician
  • a device or software

Generally only used when the recorder needs to make it explicit. Otherwise, Composition composer and other participants are assumed.

ShortOptional identification of provider of the information in this `ENTRY`, which might be: * the patient * a patient agent, e.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/PARTY-PROXY
Is Modifierfalse
26. INSTRUCTION.protocol
Definition

Description of the method (i.e. how) the information in this entry was arrived at. For OBSERVATIONs, this is a description of the method or instrument used. For EVALUATIONs, how the evaluation was arrived at. For INSTRUCTIONs, how to execute the Instruction. This may take the form of references to guidelines, including manually followed and executable; knowledge references such as a paper in Medline; clinical reasons within a larger care process.

ShortDescription of the method (i.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/ITEM-STRUCTURE
Is Modifierfalse
28. INSTRUCTION.guideline-id
Definition

Optional external identifier of guideline creating this Entry if relevant.

ShortOptional external identifier of guideline creating this Entry if relevant.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/OBJECT-REF
Is Modifierfalse
30. INSTRUCTION.narrative
Definition

Mandatory human-readable version of what the Instruction is about.

ShortMandatory human-readable version of what the Instruction is about.
Control1..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-TEXT
Is Modifierfalse
32. INSTRUCTION.expiry-time
Definition

Optional expiry date/time to assist determination of when an Instruction can be assumed to have expired. This helps prevent false listing of Instructions as Active when they clearly must have been terminated in some way or other.

ShortOptional expiry date/time to assist determination of when an Instruction can be assumed to have expired.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-DATE-TIME
Is Modifierfalse
34. INSTRUCTION.wf-definition
Definition

Optional workflow engine executable expression of the Instruction.

ShortOptional workflow engine executable expression of the Instruction.
Control0..1
Typehttp://openehr.org/fhir/StructureDefinition/DV-PARSABLE
Is Modifierfalse
36. INSTRUCTION.activities
Definition

List of all activities in Instruction.

ShortList of all activities in Instruction.
Control0..*
Typehttp://openehr.org/fhir/StructureDefinition/ACTIVITY
Is Modifierfalse