EHDS Logical Information Models
0.1.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.1.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/tree/main and changes regularly. See the Directory of published versions

Logical Model: EHDSSubstanceUse - Detailed Descriptions

Draft as of 2025-07-25

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

ShortSubject
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

ShortAuthorship
Control1..*
TypeBase
10. EHDSSubstanceUse.header.authorship.author[x]
Definition

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

ShortAuthor
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 the issuing the document/resource by its author.

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 document/information

ShortDate and time of the last update to the resource
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

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
Control0..1
Binding

BCP 47

TypeCodeableConcept
22. EHDSSubstanceUse.header.version
Definition

Business version of the resource.

ShortVersion
NoteThis is a business version Id, not a resource version Id (see discussion)
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
24. EHDSSubstanceUse.presentedForm
Definition

A narrative easy-to-read representation of the full data set, e.g. PDF-version of a document

ShortA narrative easy-to-read representation of the full data set, e.g. PDF-version of a document
Control0..*
Typehttps://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSAttachment
26. 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
28. 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
30. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition

Quantity (volume per time unit).

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

Time period of alcohol use.

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

Type of substance

ShortType of substance
Control0..1
Binding

SNOMED CT

TypeCodeableConcept
36. EHDSSubstanceUse.routeOfAdministration
Definition

Route(s) of administration

ShortRoute(s) of administration
Control0..*
Binding

EDQM

TypeCodeableConcept
38. 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

ShortSubject
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

ShortAuthorship
Control1..*
TypeBase
10. EHDSSubstanceUse.header.authorship.author[x]
Definition

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

ShortAuthor
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 the issuing the document/resource by its author.

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 document/information

ShortDate and time of the last update to the resource
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

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
Control0..1
Binding

BCP 47

TypeCodeableConcept
22. EHDSSubstanceUse.header.version
Definition

Business version of the resource.

ShortVersion
NoteThis is a business version Id, not a resource version Id (see discussion)
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
24. EHDSSubstanceUse.presentedForm
Definition

A narrative easy-to-read representation of the full data set, e.g. PDF-version of a document

ShortA narrative easy-to-read representation of the full data set, e.g. PDF-version of a document
Control0..*
Typehttps://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSAttachment
26. 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
28. 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
30. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition

Quantity (volume per time unit).

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

Time period of alcohol use.

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

Type of substance

ShortType of substance
Control0..1
Binding

SNOMED CT

TypeCodeableConcept
36. EHDSSubstanceUse.routeOfAdministration
Definition

Route(s) of administration

ShortRoute(s) of administration
Control0..*
Binding

EDQM

TypeCodeableConcept
38. EHDSSubstanceUse.note
Definition

Textual comment.

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