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
| Draft as of 2025-12-29 |
<ConceptMap xmlns="http://hl7.org/fhir">
<id value="socialHistory2FHIR-cz-ps"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: ConceptMap socialHistory2FHIR-cz-ps</b></p><a name="socialHistory2FHIR-cz-ps"> </a><a name="hcsocialHistory2FHIR-cz-ps"> </a><p>Mapping from (not specified) to (not specified)</p><br/><p><b>Group 1 </b>Mapping from <a href="StructureDefinition-LogSocialHistoryCzEn.html">A.2.6 Social History</a> to <a href="StructureDefinition-cz-composition-ps.html">Composition (CZ PS)</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td></tr><tr><td>substanceUse (A.2.7 - Social History)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Composition.section:sectionSocialHistory</td></tr><tr><td>substanceUse.alcoholUse (A.2.6.1.1 Alcohol)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Composition.section:sectionSocialHistory.entry:entry:alcoholUse.ofType(Observation)</td></tr><tr><td>substanceUse.tobaccoUse (A.2.6.1.2 Tobacco use)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Composition.section:substanceUse.entry:tobaccoUse.ofType(Observation)</td></tr><tr><td>substanceUse.drugUse (A.2.6.1.3 Drugs)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Composition.section:substanceUse.entry:drugUse.ofType(Observation)</td></tr></table><hr/><p><b>Group 2 </b>Mapping from <a href="StructureDefinition-LogSocialHistoryCzEn.html">A.2.6 Social History</a> to <a href="StructureDefinition-cz-observation-alcoholUse-ps.html">Observation – Alcohol Use (CZ PS)</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>alcoholUse.status (A.2.6.1.1.1 Status)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.valueCodeableConcept</td><td>Use valueCodeableConcept to represent the current alcohol use status (e.g., current/former/never).</td></tr><tr><td>alcoholUse.periodAndQuantity (A.2.6.1.1.2 Period and quantity)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.effectivePeriod</td><td>Use effectivePeriod to capture the time interval the reported alcohol use applies to.</td></tr><tr><td>alcoholUse.periodAndQuantity (A.2.6.1.1.2 Period and quantity)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.component[x].valueQuantity</td><td>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.</td></tr><tr><td>alcoholUse.comment (A.2.6.1.1.3 Comment)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.note</td><td/></tr></table><hr/><p><b>Group 3 </b>Mapping from <a href="StructureDefinition-LogSocialHistoryCzEn.html">A.2.6 Social History</a> to <a href="StructureDefinition-cz-observation-tobaccoUse-ps.html">Observation – Tobacco Use (CZ PS)</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>tobaccoUse.status (A.2.6.1.2.1 Status)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.valueCodeableConcept</td><td>Smoking status as a coded value (e.g., current/former/never).</td></tr><tr><td>tobaccoUse.periodAndQuantity.period (A.2.6.1.2.2 Period and quantity - period)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.effectivePeriod</td><td>Time interval the reported tobacco use applies to.</td></tr><tr><td>tobaccoUse.periodAndQuantity.quantity (A.2.6.1.2.2 Period and quantity - quantity)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.component.valueQuantity</td><td>Average amount as component(s); each component SHALL define component.code (e.g., cigarettes/day) and use UCUM where possible.</td></tr><tr><td>tobaccoUse.comment (A.2.6.1.2.3 Comment)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.note</td><td/></tr></table><hr/><p><b>Group 4 </b>Mapping from <a href="StructureDefinition-LogSocialHistoryCzEn.html">A.2.6 Social History</a> to <a href="StructureDefinition-cz-observation-drugUse-ps.html">Observation – Drug Use (CZ PS)</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>drugUse.status (A.2.6.1.3.1 Status)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.valueCodeableConcept</td><td>Current status of drug use/dependence as coded value (e.g., current/former/never).</td></tr><tr><td>drugUse.periodAndQuantity.period (A.2.6.1.3.2 Period and quantity - period)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.effectivePeriod</td><td>Time interval the reported drug use applies to.</td></tr><tr><td>drugUse.periodAndQuantity.quantity (A.2.6.1.3.2 Period and quantity - quantity)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.component.valueQuantity</td><td>Represent administered amount/average quantity as component(s). Each component SHALL carry component.code (what is quantified) and valueQuantity with UCUM units where possible.</td></tr><tr><td>drugUse.substanceType (A.2.6.1.3.3 Substance type)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.component.valueCodeableConcept</td><td>Record the substance type as a component (component.code identifies 'substance'; valueCodeableConcept contains the substance code, e.g., ICD-10/SNOMED CT).</td></tr><tr><td>drugUse.routeOfAdministration (A.2.6.1.3.4 Route of administration)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.component.valueCodeableConcept</td><td>Route(s) of administration as component(s) (repeatable). component.code identifies 'route'; valueCodeableConcept holds the route code.</td></tr><tr><td>drugUse.comment (A.2.6.1.3.5 Comment)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.note</td><td/></tr></table><hr/><p><b>Group 5 </b>Mapping from <a href="StructureDefinition-LogSocialHistoryCzEn.html">A.2.6 Social History</a> to <a href="StructureDefinition-cz-observation-otherAddictions-ps.html">Observation – Other Addictions (CZ PS)</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>otherAddictions (A.2.6.1.4 Other addictions)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Observation.valueCodeableConcept</td><td>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).</td></tr></table></div>
</text>
<url value="https://hl7.cz/fhir/ps/ConceptMap/socialHistory2FHIR-cz-ps"/>
<version value="0.0.1"/>
<name value="SocialHistory2FHIRCzPs"/>
<title value="ConceptMap: Social History to FHIR Patient Summary (CZ)"/>
<status value="draft"/>
<experimental value="true"/>
<date value="2025-12-29T14:27:43+00:00"/>
<publisher value="HL7 Czech Republic"/>
<contact>
<name value="HL7 Czech Republic"/>
<telecom>
<system value="url"/>
<value value="https://www.hl7.cz/"/>
</telecom>
</contact>
<description value="PS Social History Model to this guide mapping"/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="CZ"/>
<display value="Czechia"/>
</coding>
</jurisdiction>
<group>
<source
value="https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn"/>
<target
value="https://hl7.cz/fhir/ps/StructureDefinition/cz-composition-ps"/>
<element>
<code value="substanceUse"/>
<display value="A.2.7 - Social History"/>
<target>
<code value="Composition.section:sectionSocialHistory"/>
<display value="Composition.section:sectionSocialHistory"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="substanceUse.alcoholUse"/>
<display value="A.2.6.1.1 Alcohol"/>
<target>
<code
value="Composition.section:sectionSocialHistory.entry:entry:alcoholUse.ofType(Observation)"/>
<display
value="Composition.section:sectionSocialHistory.entry:entry:alcoholUse.ofType(Observation)"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="substanceUse.tobaccoUse"/>
<display value="A.2.6.1.2 Tobacco use"/>
<target>
<code
value="Composition.section:substanceUse.entry:tobaccoUse.ofType(Observation)"/>
<display
value="Composition.section:substanceUse.entry:tobaccoUse.ofType(Observation)"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<code value="substanceUse.drugUse"/>
<display value="A.2.6.1.3 Drugs"/>
<target>
<code
value="Composition.section:substanceUse.entry:drugUse.ofType(Observation)"/>
<display
value="Composition.section:substanceUse.entry:drugUse.ofType(Observation)"/>
<equivalence value="equivalent"/>
</target>
</element>
</group>
<group>
<source
value="https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn"/>
<target
value="https://hl7.cz/fhir/ps/StructureDefinition/cz-observation-alcoholUse-ps"/>
<element>
<code value="alcoholUse.status"/>
<display value="A.2.6.1.1.1 Status"/>
<target>
<code value="Observation.valueCodeableConcept"/>
<display value="Observation.valueCodeableConcept"/>
<equivalence value="equivalent"/>
<comment
value="Use valueCodeableConcept to represent the current alcohol use status (e.g., current/former/never)."/>
</target>
</element>
<element>
<code value="alcoholUse.periodAndQuantity"/>
<display value="A.2.6.1.1.2 Period and quantity"/>
<target>
<code value="Observation.effectivePeriod"/>
<display value="Observation.effectivePeriod"/>
<equivalence value="equivalent"/>
<comment
value="Use effectivePeriod to capture the time interval the reported alcohol use applies to."/>
</target>
</element>
<element>
<code value="alcoholUse.periodAndQuantity"/>
<display value="A.2.6.1.1.2 Period and quantity"/>
<target>
<code value="Observation.component[x].valueQuantity"/>
<display value="Observation.component[x].valueQuantity"/>
<equivalence value="equivalent"/>
<comment
value="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."/>
</target>
</element>
<element>
<code value="alcoholUse.comment"/>
<display value="A.2.6.1.1.3 Comment"/>
<target>
<code value="Observation.note"/>
<display value="Observation.note"/>
<equivalence value="equivalent"/>
</target>
</element>
</group>
<group>
<source
value="https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn"/>
<target
value="https://hl7.cz/fhir/ps/StructureDefinition/cz-observation-tobaccoUse-ps"/>
<element>
<code value="tobaccoUse.status"/>
<display value="A.2.6.1.2.1 Status"/>
<target>
<code value="Observation.valueCodeableConcept"/>
<display value="Observation.valueCodeableConcept"/>
<equivalence value="equivalent"/>
<comment
value="Smoking status as a coded value (e.g., current/former/never)."/>
</target>
</element>
<element>
<code value="tobaccoUse.periodAndQuantity.period"/>
<display value="A.2.6.1.2.2 Period and quantity - period"/>
<target>
<code value="Observation.effectivePeriod"/>
<display value="Observation.effectivePeriod"/>
<equivalence value="equivalent"/>
<comment value="Time interval the reported tobacco use applies to."/>
</target>
</element>
<element>
<code value="tobaccoUse.periodAndQuantity.quantity"/>
<display value="A.2.6.1.2.2 Period and quantity - quantity"/>
<target>
<code value="Observation.component.valueQuantity"/>
<display value="Observation.component.valueQuantity"/>
<equivalence value="equivalent"/>
<comment
value="Average amount as component(s); each component SHALL define component.code (e.g., cigarettes/day) and use UCUM where possible."/>
</target>
</element>
<element>
<code value="tobaccoUse.comment"/>
<display value="A.2.6.1.2.3 Comment"/>
<target>
<code value="Observation.note"/>
<display value="Observation.note"/>
<equivalence value="equivalent"/>
</target>
</element>
</group>
<group>
<source
value="https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn"/>
<target
value="https://hl7.cz/fhir/ps/StructureDefinition/cz-observation-drugUse-ps"/>
<element>
<code value="drugUse.status"/>
<display value="A.2.6.1.3.1 Status"/>
<target>
<code value="Observation.valueCodeableConcept"/>
<display value="Observation.valueCodeableConcept"/>
<equivalence value="equivalent"/>
<comment
value="Current status of drug use/dependence as coded value (e.g., current/former/never)."/>
</target>
</element>
<element>
<code value="drugUse.periodAndQuantity.period"/>
<display value="A.2.6.1.3.2 Period and quantity - period"/>
<target>
<code value="Observation.effectivePeriod"/>
<display value="Observation.effectivePeriod"/>
<equivalence value="equivalent"/>
<comment value="Time interval the reported drug use applies to."/>
</target>
</element>
<element>
<code value="drugUse.periodAndQuantity.quantity"/>
<display value="A.2.6.1.3.2 Period and quantity - quantity"/>
<target>
<code value="Observation.component.valueQuantity"/>
<display value="Observation.component.valueQuantity"/>
<equivalence value="equivalent"/>
<comment
value="Represent administered amount/average quantity as component(s). Each component SHALL carry component.code (what is quantified) and valueQuantity with UCUM units where possible."/>
</target>
</element>
<element>
<code value="drugUse.substanceType"/>
<display value="A.2.6.1.3.3 Substance type"/>
<target>
<code value="Observation.component.valueCodeableConcept"/>
<display value="Observation.component.valueCodeableConcept"/>
<equivalence value="equivalent"/>
<comment
value="Record the substance type as a component (component.code identifies 'substance'; valueCodeableConcept contains the substance code, e.g., ICD-10/SNOMED CT)."/>
</target>
</element>
<element>
<code value="drugUse.routeOfAdministration"/>
<display value="A.2.6.1.3.4 Route of administration"/>
<target>
<code value="Observation.component.valueCodeableConcept"/>
<display value="Observation.component.valueCodeableConcept"/>
<equivalence value="equivalent"/>
<comment
value="Route(s) of administration as component(s) (repeatable). component.code identifies 'route'; valueCodeableConcept holds the route code."/>
</target>
</element>
<element>
<code value="drugUse.comment"/>
<display value="A.2.6.1.3.5 Comment"/>
<target>
<code value="Observation.note"/>
<display value="Observation.note"/>
<equivalence value="equivalent"/>
</target>
</element>
</group>
<group>
<source
value="https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn"/>
<target
value="https://hl7.cz/fhir/ps/StructureDefinition/cz-observation-otherAddictions-ps"/>
<element>
<code value="otherAddictions"/>
<display value="A.2.6.1.4 Other addictions"/>
<target>
<code value="Observation.valueCodeableConcept"/>
<display value="Observation.valueCodeableConcept"/>
<equivalence value="equivalent"/>
<comment
value="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)."/>
</target>
</element>
</group>
</ConceptMap>