EHDS Logical Information Models
0.2.0 - ci-build

EHDS Logical Information Models, published by Xt-EHR. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/Xt-EHR/xt-ehr-common/ and changes regularly. See the Directory of published versions

Logical Model: EHDSSubstanceUse - Detailed Descriptions

Draft as of 2025-09-24

Definitions for the EHDSSubstanceUse logical model.

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

0. EHDSSubstanceUse
Definition

Statement about using a substance (such as tobacco, alcohol, drugs, etc).


Base definition for all types defined in FHIR type system.

ShortSubstance use modelBase for all types and resources
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. EHDSSubstanceUse.header
Definition

Common header for all patient-related data

ShortCommon header for all patient-related data
Control1..1
TypeBase
4. EHDSSubstanceUse.header.subject
Definition

Patient/subject information

ShortPatient/subject information
Control1..1
Typehttps://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSPatient
6. EHDSSubstanceUse.header.identifier
Definition

Business identifier for the object

ShortBusiness identifier for the object
NoteThis is a business identifier, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
8. EHDSSubstanceUse.header.authorship
Definition

Resource authoring details

ShortResource authoring details
Control1..*
TypeBase
10. EHDSSubstanceUse.header.authorship.author[x]
Definition

Author(s) by whom the resource was/were authored. Multiple authors could be provided.

ShortAuthor(s) by whom the resource was/were authored. Multiple authors could be provided.
Control1..1
TypeChoice of: https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSHealthProfessional, https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSOrganisation, https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSDevice
[x] NoteSeeChoice of Data Typesfor further information about how to use [x]
12. EHDSSubstanceUse.header.authorship.datetime
Definition

Date and time of authoring/issuing

ShortDate and time of authoring/issuing
Control1..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. EHDSSubstanceUse.header.lastUpdate
Definition

Date and time of the last update to the resource (may be used for technical corrections).

ShortDate and time of the last update to the resource (may be used for technical corrections).
Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. EHDSSubstanceUse.header.status
Definition

Status of the resource or document

ShortStatus of the patient’s alcohol use.
Control1..1
Binding

SNOMED CT

TypeCodeableConcept
18. EHDSSubstanceUse.header.statusReason[x]
Definition

Reason for the current status of the resource.

ShortReason for the current status of the resource.
Control0..1
TypeChoice of: CodeableConcept, string
[x] NoteSeeChoice of Data Typesfor further information about how to use [x]
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
20. EHDSSubstanceUse.header.language
Definition

Language in which the resource is written. Language is expressed by the IETF language tag.

ShortLanguage in which the resource is written. Language is expressed by the IETF language tag.
Control0..1
Binding

BCP 47

TypeCodeableConcept
22. EHDSSubstanceUse.period
Definition

Time period for which this observation about substance use is applicable

ShortTime period for which this observation about substance use is applicable
Control0..1
TypePeriod
24. EHDSSubstanceUse.frequencyAndQuantity
Definition

The extent of the patient’s alcohol use in units of alcohol per time period.

ShortThe extent of the patient’s alcohol use in units of alcohol per time period.
Control0..1
TypeBase
26. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition

Quantity (volume per time unit).

ShortQuantity (volume per time unit).
Control1..1
TypeQuantity
28. EHDSSubstanceUse.frequencyAndQuantity.period
Definition

Time period of alcohol use.

ShortTime period of alcohol use.
Control0..1
TypePeriod
30. EHDSSubstanceUse.substanceType
Definition

Type of substance

ShortType of substance
Control0..1
Binding

SNOMED CT

TypeCodeableConcept
32. EHDSSubstanceUse.routeOfAdministration
Definition

Route(s) of administration

ShortRoute(s) of administration
Control0..*
Binding

EDQM

TypeCodeableConcept
34. EHDSSubstanceUse.note
Definition

Textual comment.

ShortTextual comment.
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

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

0. EHDSSubstanceUse
Definition

Statement about using a substance (such as tobacco, alcohol, drugs, etc).

ShortSubstance use model
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. EHDSSubstanceUse.header
4. EHDSSubstanceUse.header.status
ShortStatus of the patient’s alcohol use.
Binding

SNOMED CT

6. EHDSSubstanceUse.period
Definition

Time period for which this observation about substance use is applicable

ShortTime period for which this observation about substance use is applicable
Control0..1
TypePeriod
8. EHDSSubstanceUse.frequencyAndQuantity
Definition

The extent of the patient’s alcohol use in units of alcohol per time period.

ShortThe extent of the patient’s alcohol use in units of alcohol per time period.
Control0..1
TypeBase
10. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition

Quantity (volume per time unit).

ShortQuantity (volume per time unit).
Control1..1
TypeQuantity
12. EHDSSubstanceUse.frequencyAndQuantity.period
Definition

Time period of alcohol use.

ShortTime period of alcohol use.
Control0..1
TypePeriod
14. EHDSSubstanceUse.substanceType
Definition

Type of substance

ShortType of substance
Control0..1
Binding

SNOMED CT

TypeCodeableConcept
16. EHDSSubstanceUse.routeOfAdministration
Definition

Route(s) of administration

ShortRoute(s) of administration
Control0..*
Binding

EDQM

TypeCodeableConcept
18. EHDSSubstanceUse.note
Definition

Textual comment.

ShortTextual comment.
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

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

0. EHDSSubstanceUse
Definition

Statement about using a substance (such as tobacco, alcohol, drugs, etc).

ShortSubstance use model
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. EHDSSubstanceUse.header
Definition

Common header for all patient-related data

ShortCommon header for all patient-related data
Control1..1
TypeBase
4. EHDSSubstanceUse.header.subject
Definition

Patient/subject information

ShortPatient/subject information
Control1..1
Typehttps://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSPatient
6. EHDSSubstanceUse.header.identifier
Definition

Business identifier for the object

ShortBusiness identifier for the object
NoteThis is a business identifier, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
8. EHDSSubstanceUse.header.authorship
Definition

Resource authoring details

ShortResource authoring details
Control1..*
TypeBase
10. EHDSSubstanceUse.header.authorship.author[x]
Definition

Author(s) by whom the resource was/were authored. Multiple authors could be provided.

ShortAuthor(s) by whom the resource was/were authored. Multiple authors could be provided.
Control1..1
TypeChoice of: https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSHealthProfessional, https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSOrganisation, https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSDevice
[x] NoteSeeChoice of Data Typesfor further information about how to use [x]
12. EHDSSubstanceUse.header.authorship.datetime
Definition

Date and time of authoring/issuing

ShortDate and time of authoring/issuing
Control1..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
14. EHDSSubstanceUse.header.lastUpdate
Definition

Date and time of the last update to the resource (may be used for technical corrections).

ShortDate and time of the last update to the resource (may be used for technical corrections).
Control0..1
TypedateTime
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
16. EHDSSubstanceUse.header.status
Definition

Status of the resource or document

ShortStatus of the patient’s alcohol use.
Control1..1
Binding

SNOMED CT

TypeCodeableConcept
18. EHDSSubstanceUse.header.statusReason[x]
Definition

Reason for the current status of the resource.

ShortReason for the current status of the resource.
Control0..1
TypeChoice of: CodeableConcept, string
[x] NoteSeeChoice of Data Typesfor further information about how to use [x]
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
20. EHDSSubstanceUse.header.language
Definition

Language in which the resource is written. Language is expressed by the IETF language tag.

ShortLanguage in which the resource is written. Language is expressed by the IETF language tag.
Control0..1
Binding

BCP 47

TypeCodeableConcept
22. EHDSSubstanceUse.period
Definition

Time period for which this observation about substance use is applicable

ShortTime period for which this observation about substance use is applicable
Control0..1
TypePeriod
24. EHDSSubstanceUse.frequencyAndQuantity
Definition

The extent of the patient’s alcohol use in units of alcohol per time period.

ShortThe extent of the patient’s alcohol use in units of alcohol per time period.
Control0..1
TypeBase
26. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition

Quantity (volume per time unit).

ShortQuantity (volume per time unit).
Control1..1
TypeQuantity
28. EHDSSubstanceUse.frequencyAndQuantity.period
Definition

Time period of alcohol use.

ShortTime period of alcohol use.
Control0..1
TypePeriod
30. EHDSSubstanceUse.substanceType
Definition

Type of substance

ShortType of substance
Control0..1
Binding

SNOMED CT

TypeCodeableConcept
32. EHDSSubstanceUse.routeOfAdministration
Definition

Route(s) of administration

ShortRoute(s) of administration
Control0..*
Binding

EDQM

TypeCodeableConcept
34. EHDSSubstanceUse.note
Definition

Textual comment.

ShortTextual comment.
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension