HL7 Czech PS Implementation Guide
0.0.1 - ci-build
HL7 Czech PS Implementation Guide
0.0.1 - ci-build
HL7 Czech PS Implementation Guide, published by HL7 Czech Republic. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7-cz/ps/ and changes regularly. See the Directory of published versions
Below is a browsable diagram showing how the Social History model is realized by the HL7 FHIR profiles defined in this guide. The mapping covers substance use including alcohol, tobacco, drugs, and other addictions.
| Social History (Logical Model) | Relationship | FHIR Target | |||
|---|---|---|---|---|---|
| Source Element | Display | Equivalence | Target (Resource.Profile) | Target Element | Comments |
| substanceUse | A.2.7 - Social History | equivalent | (Composition.cz-composition-ps) | Composition.section:sectionSocialHistory | |
| substanceUse.alcoholUse | A.2.6.1.1 Alcohol | equivalent | (Composition.cz-composition-ps) | Composition.section:sectionSocialHistory.entry:entry:alcoholUse.ofType(Observation) | |
| substanceUse.tobaccoUse | A.2.6.1.2 Tobacco use | equivalent | (Composition.cz-composition-ps) | Composition.section:sectionSocialHistory.entry:tobaccoUse.ofType(Observation) | |
| substanceUse.drugUse | A.2.6.1.3 Drugs | equivalent | (Composition.cz-composition-ps) | Composition.section:sectionSocialHistory.entry:drugUse.ofType(Observation) | |
| Alcohol Use (Logical Model) | Relationship | FHIR Target | |||
|---|---|---|---|---|---|
| Source Element | Display | Equivalence | Target (Resource.Profile) | Target Element | Comments |
| alcoholUse.status | A.2.6.1.1.1 Status | equivalent | (Observation.cz-observation-alcoholUse-ps) | Observation.valueCodeableConcept | Use valueCodeableConcept to represent the current alcohol use status (e.g., current/former/never). |
| alcoholUse.periodAndQuantity | A.2.6.1.1.2 Period and quantity | equivalent | (Observation.cz-observation-alcoholUse-ps) | Observation.effectivePeriod | Use effectivePeriod to capture the time interval the reported alcohol use applies to. |
| alcoholUse.periodAndQuantity | A.2.6.1.1.2 Period and quantity | equivalent | (Observation.cz-observation-alcoholUse-ps) | Observation.component[x].valueQuantity | Represent amount/frequency as component(s). Each component SHALL have component.code defining what is measured (e.g., units/week, drinks/day) and valueQuantity with UCUM units where possible. Multiple components may be used. |
| alcoholUse.comment | A.2.6.1.1.3 Comment | equivalent | (Observation.cz-observation-alcoholUse-ps) | Observation.note | |
| Tobacco Use (Logical Model) | Relationship | FHIR Target | |||
|---|---|---|---|---|---|
| Source Element | Display | Equivalence | Target (Resource.Profile) | Target Element | Comments |
| tobaccoUse.status | A.2.6.1.2.1 Status | equivalent | (Observation.cz-observation-tobaccoUse-ps) | Observation.valueCodeableConcept | Smoking status as a coded value (e.g., current/former/never). |
| tobaccoUse.periodAndQuantity.period | A.2.6.1.2.2 Period and quantity - period | equivalent | (Observation.cz-observation-tobaccoUse-ps) | Observation.effectivePeriod | Time interval the reported tobacco use applies to. |
| tobaccoUse.periodAndQuantity.quantity | A.2.6.1.2.2 Period and quantity - quantity | equivalent | (Observation.cz-observation-tobaccoUse-ps) | Observation.component.valueQuantity | Average amount as component(s); each component SHALL define component.code (e.g., cigarettes/day) and use UCUM where possible. |
| tobaccoUse.comment | A.2.6.1.2.3 Comment | equivalent | (Observation.cz-observation-tobaccoUse-ps) | Observation.note | |
| Drug Use (Logical Model) | Relationship | FHIR Target | |||
|---|---|---|---|---|---|
| Source Element | Display | Equivalence | Target (Resource.Profile) | Target Element | Comments |
| drugUse.status | A.2.6.1.3.1 Status | equivalent | (Observation.cz-observation-drugUse-ps) | Observation.valueCodeableConcept | Current status of drug use/dependence as coded value (e.g., current/former/never). |
| drugUse.periodAndQuantity.period | A.2.6.1.3.2 Period and quantity - period | equivalent | (Observation.cz-observation-drugUse-ps) | Observation.effectivePeriod | Time interval the reported drug use applies to. |
| drugUse.periodAndQuantity.quantity | A.2.6.1.3.2 Period and quantity - quantity | equivalent | (Observation.cz-observation-drugUse-ps) | Observation.component.valueQuantity | Represent administered amount/average quantity as component(s). Each component SHALL carry component.code (what is quantified) and valueQuantity with UCUM units where possible. |
| drugUse.substanceType | A.2.6.1.3.3 Substance type | equivalent | (Observation.cz-observation-drugUse-ps) | Observation.component.valueCodeableConcept | Record the substance type as a component (component.code identifies 'substance'; valueCodeableConcept contains the substance code, e.g., ICD-10/SNOMED CT). |
| drugUse.routeOfAdministration | A.2.6.1.3.4 Route of administration | equivalent | (Observation.cz-observation-drugUse-ps) | Observation.component.valueCodeableConcept | Route(s) of administration as component(s) (repeatable). component.code identifies 'route'; valueCodeableConcept holds the route code. |
| drugUse.comment | A.2.6.1.3.5 Comment | equivalent | (Observation.cz-observation-drugUse-ps) | Observation.note | |
| Other Addictions (Logical Model) | Relationship | FHIR Target | |||
|---|---|---|---|---|---|
| Source Element | Display | Equivalence | Target (Resource.Profile) | Target Element | Comments |
| otherAddictions | A.2.6.1.4 Other addictions | equivalent | (Observation.cz-observation-otherAddictions-ps) | Observation.valueCodeableConcept | Create one Observation per entry. Use valueCodeableConcept for ICD-10/SNOMED coding; if only free text is available, populate CodeableConcept.text (and optionally Observation.note). |