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/stakeholder-consultation-D7-3 and changes regularly. See the Directory of published versions

## Logical Model: EHDSSubstanceUse - Detailed Descriptions

Draft as of 2025-08-25

Definitions for the EHDSSubstanceUse logical model.

- Key Elements Table
- Differential Elements Table
- Snapshot Elements Table

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.
Short | Substance use modelBase for all types and resources
Control | 0..*
Is Modifier | false
Logical Model | Instances 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
Short | Common header for all patient-related data
Control | 1..1
Type | Base
4. EHDSSubstanceUse.header.subject
Definition | Patient/subject information
Short | Subject
Control | 1..1
Type | https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSPatient
6. EHDSSubstanceUse.header.identifier
Definition | Business identifier for the object
Short | Business identifier for the object
Note | This is a business identifier, not a resource identifier (see discussion)
Control | 0..*
Type | Identifier
8. EHDSSubstanceUse.header.authorship
Definition | Resource authoring details
Short | Authorship
Control | 1..*
Type | Base
10. EHDSSubstanceUse.header.authorship.author[x]
Definition | Author(s) by whom the resource was/were authored. Multiple authors could be provided.
Short | Author
Control | 1..1
Type | Choice 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] Note | SeeChoice 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.
Short | Date and time of authoring/issuing
Control | 1..1
Type | dateTime
Primitive Value | This 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
Short | Date and time of the last update to the resource
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
16. EHDSSubstanceUse.header.status
Definition | Status of the resource
Short | Status of the patient’s alcohol use.
Control | 1..1
Binding | SNOMED CT
Type | CodeableConcept
18. EHDSSubstanceUse.header.statusReason[x]
Definition | Reason for the current status of the resource.
Short | Reason for the current status of the resource.
Control | 0..1
Type | Choice of: CodeableConcept, string
[x] Note | SeeChoice of Data Typesfor further information about how to use [x]
Primitive Value | This 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.
Short | Language
Control | 0..1
Binding | BCP 47
Type | CodeableConcept
22. EHDSSubstanceUse.header.version
Definition | Business version of the resource.
Short | Version
Note | This is a business version Id, not a resource version Id (see discussion)
Control | 0..1
Type | string
Primitive Value | This 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
Short | A narrative easy-to-read representation of the full data set, e.g. PDF-version of a document
Control | 0..*
Type | https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSAttachment
26. EHDSSubstanceUse.period
Definition | Time period for which this observation about substance use is applicable
Short | Time period for which this observation about substance use is applicable
Control | 0..1
Type | Period
28. EHDSSubstanceUse.frequencyAndQuantity
Definition | The extent of the patient’s alcohol use in units of alcohol per time period.
Short | The extent of the patient’s alcohol use in units of alcohol per time period.
Control | 0..1
Type | Base
30. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition | Quantity (volume per time unit).
Short | Quantity (volume per time unit).
Control | 1..1
Type | Quantity
32. EHDSSubstanceUse.frequencyAndQuantity.period
Definition | Time period of alcohol use.
Short | Time period of alcohol use.
Control | 0..1
Type | Period
34. EHDSSubstanceUse.substanceType
Definition | Type of substance
Short | Type of substance
Control | 0..1
Binding | SNOMED CT
Type | CodeableConcept
36. EHDSSubstanceUse.routeOfAdministration
Definition | Route(s) of administration
Short | Route(s) of administration
Control | 0..*
Binding | EDQM
Type | CodeableConcept
38. EHDSSubstanceUse.note
Definition | Textual comment.
Short | Textual comment.
Control | 0..1
Type | string
Primitive Value | This 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).
Short | Substance use model
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. EHDSSubstanceUse.header
4. EHDSSubstanceUse.header.status
Short | Status of the patient’s alcohol use.
Binding | SNOMED CT
6. EHDSSubstanceUse.period
Definition | Time period for which this observation about substance use is applicable
Short | Time period for which this observation about substance use is applicable
Control | 0..1
Type | Period
8. EHDSSubstanceUse.frequencyAndQuantity
Definition | The extent of the patient’s alcohol use in units of alcohol per time period.
Short | The extent of the patient’s alcohol use in units of alcohol per time period.
Control | 0..1
Type | Base
10. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition | Quantity (volume per time unit).
Short | Quantity (volume per time unit).
Control | 1..1
Type | Quantity
12. EHDSSubstanceUse.frequencyAndQuantity.period
Definition | Time period of alcohol use.
Short | Time period of alcohol use.
Control | 0..1
Type | Period
14. EHDSSubstanceUse.substanceType
Definition | Type of substance
Short | Type of substance
Control | 0..1
Binding | SNOMED CT
Type | CodeableConcept
16. EHDSSubstanceUse.routeOfAdministration
Definition | Route(s) of administration
Short | Route(s) of administration
Control | 0..*
Binding | EDQM
Type | CodeableConcept
18. EHDSSubstanceUse.note
Definition | Textual comment.
Short | Textual comment.
Control | 0..1
Type | string
Primitive Value | This 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).
Short | Substance use model
Control | 0..*
Is Modifier | false
Logical Model | Instances 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
Short | Common header for all patient-related data
Control | 1..1
Type | Base
4. EHDSSubstanceUse.header.subject
Definition | Patient/subject information
Short | Subject
Control | 1..1
Type | https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSPatient
6. EHDSSubstanceUse.header.identifier
Definition | Business identifier for the object
Short | Business identifier for the object
Note | This is a business identifier, not a resource identifier (see discussion)
Control | 0..*
Type | Identifier
8. EHDSSubstanceUse.header.authorship
Definition | Resource authoring details
Short | Authorship
Control | 1..*
Type | Base
10. EHDSSubstanceUse.header.authorship.author[x]
Definition | Author(s) by whom the resource was/were authored. Multiple authors could be provided.
Short | Author
Control | 1..1
Type | Choice 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] Note | SeeChoice 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.
Short | Date and time of authoring/issuing
Control | 1..1
Type | dateTime
Primitive Value | This 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
Short | Date and time of the last update to the resource
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
16. EHDSSubstanceUse.header.status
Definition | Status of the resource
Short | Status of the patient’s alcohol use.
Control | 1..1
Binding | SNOMED CT
Type | CodeableConcept
18. EHDSSubstanceUse.header.statusReason[x]
Definition | Reason for the current status of the resource.
Short | Reason for the current status of the resource.
Control | 0..1
Type | Choice of: CodeableConcept, string
[x] Note | SeeChoice of Data Typesfor further information about how to use [x]
Primitive Value | This 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.
Short | Language
Control | 0..1
Binding | BCP 47
Type | CodeableConcept
22. EHDSSubstanceUse.header.version
Definition | Business version of the resource.
Short | Version
Note | This is a business version Id, not a resource version Id (see discussion)
Control | 0..1
Type | string
Primitive Value | This 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
Short | A narrative easy-to-read representation of the full data set, e.g. PDF-version of a document
Control | 0..*
Type | https://www.xt-ehr.eu/specifications/fhir/StructureDefinition/EHDSAttachment
26. EHDSSubstanceUse.period
Definition | Time period for which this observation about substance use is applicable
Short | Time period for which this observation about substance use is applicable
Control | 0..1
Type | Period
28. EHDSSubstanceUse.frequencyAndQuantity
Definition | The extent of the patient’s alcohol use in units of alcohol per time period.
Short | The extent of the patient’s alcohol use in units of alcohol per time period.
Control | 0..1
Type | Base
30. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition | Quantity (volume per time unit).
Short | Quantity (volume per time unit).
Control | 1..1
Type | Quantity
32. EHDSSubstanceUse.frequencyAndQuantity.period
Definition | Time period of alcohol use.
Short | Time period of alcohol use.
Control | 0..1
Type | Period
34. EHDSSubstanceUse.substanceType
Definition | Type of substance
Short | Type of substance
Control | 0..1
Binding | SNOMED CT
Type | CodeableConcept
36. EHDSSubstanceUse.routeOfAdministration
Definition | Route(s) of administration
Short | Route(s) of administration
Control | 0..*
Binding | EDQM
Type | CodeableConcept
38. EHDSSubstanceUse.note
Definition | Textual comment.
Short | Textual comment.
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension