HL7 Czech Health information exchange Implementation Guide
0.0.1 - ci-build Czechia flag

HL7 Czech Health information exchange 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/HIE/ and changes regularly. See the Directory of published versions

Resource Profile: CZ MHD Folder Comprehensive

Official URL: https://hl7.cz/fhir/hie/StructureDefinition/cz-mhd-folder-comprehensive Version: 0.0.1
Draft as of 2026-10-15 Computable Name: CZ_Folder

A profile on the List resource for MHD use as a Folder with Comprehensive Metadata

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

NameFlagsCard.TypeDescription & Constraints    Filter: doco
List C 0..* MhdList A list is a curated collection of resources
Constraints: lst-1, lst-2, lst-3
List.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
List.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for extension.extension:designationType 1..* CodeableConcept Clinical code of the List
URL: https://profiles.ihe.net/ITI/MHD/StructureDefinition/ihe-designationType
List.Slices for identifier 0..* Identifier Business identifier
Slice: Unordered, Open by value:use

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for identifier.identifier:uniqueId 0..1 UniqueIdIdentifier Business identifier
List.Slices for identifier.identifier:entryUUID 0..* EntryUUIDIdentifier Business identifier
List.status This element is a modifier element. This element is included in summaries. 1..1 code current | retired | entered-in-error
Binding: ListStatus (required): The current state of the list.
List.mode This element is a modifier element. This element is included in summaries. 1..1 code working | snapshot | changes
Binding: ListMode (required): The processing mode that applies to this list.
Required Pattern: working
List.title This element is included in summaries. 1..1 string Descriptive name for the list
Example General: Dr. Jane's Patients
List.code This element is included in summaries. 1..1 CodeableConcept What the purpose of this list is
Binding: MHD List Types ValueSet (required)
Required Pattern: At least the following
List.code.id 0..1 string Unique id for inter-element referencing
List.code.extension 0..* Extension Additional content defined by implementations
List.code.coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
List.code.coding.id 0..1 string Unique id for inter-element referencing
List.code.coding.extension 0..* Extension Additional content defined by implementations
List.code.coding.system 1..1 uri Identity of the terminology system
Fixed Value: https://profiles.ihe.net/ITI/MHD/CodeSystem/MHDlistTypes
List.code.coding.version 0..1 string Version of the system - if relevant
List.code.coding.code 1..1 code Symbol in syntax defined by the system
Fixed Value: folder
List.code.coding.display 0..1 string Representation defined by the system
List.code.coding.userSelected 0..1 boolean If this coding was chosen directly by the user
List.code.text 0..1 string Plain text representation of the concept
List.subject This element is included in summaries. 1..1 Reference(Patient (CZ core)) If all resources have the same subject
List.note 0..1 Annotation Comments about the list

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
List.status Base required ListStatus 📍4.0.1 FHIR Std.
List.mode Base required ListMode 📍4.0.1 FHIR Std.
List.code Base required MHD List Types ValueSet 📦4.2.2 Mobile access to Health Documents v4.2

Constraints

Id Grade Path(s) Description Expression
dom-2 error List If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error List If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error List If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error List If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice List A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
lst-1 error List A list can only have an emptyReason if it is empty emptyReason.empty() or entry.empty()
lst-2 error List The deleted flag can only be used if the mode of the list is "changes" mode = 'changes' or entry.deleted.empty()
lst-3 error List An entry date can only be used if the mode of the list is "working" mode = 'working' or entry.date.empty()

This structure is derived from MhdList

NameFlagsCard.TypeDescription & Constraints    Filter: doco
List MhdList
List.extension 1..* Extension Extension
List.Slices for extension Content/Rules for all slices
List.Slices for extension.extension:designationType 1..* DesignationType Clinical code of the List
List.Slices for identifier 0..* Identifier Business identifier
Slice: Unordered, Open by value:use
Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for identifier.identifier:uniqueId 0..1 UniqueIdIdentifier Business identifier
List.Slices for identifier.identifier:entryUUID 0..* EntryUUIDIdentifier Business identifier
List.title 1..1 string Descriptive name for the list
List.code 1..1 CodeableConcept What the purpose of this list is
Required Pattern: At least the following
List.code.coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
List.code.coding.system 1..1 uri Identity of the terminology system
Fixed Value: https://profiles.ihe.net/ITI/MHD/CodeSystem/MHDlistTypes
List.code.coding.code 1..1 code Symbol in syntax defined by the system
Fixed Value: folder
List.subject 1..1 Reference(Patient (CZ core)) If all resources have the same subject
List.encounter 0..0 Context in which list created
List.source 0..0 Who and/or what defined the list contents (aka Author)
List.orderedBy 0..0 What order the list has
List.note 0..1 Annotation Comments about the list
List.entry
List.entry.flag 0..0 Status/Workflow information about this item
List.entry.deleted 0..0 If this item is actually marked as deleted
List.entry.date 0..0 When item added to list
List.entry.item 1..1 Reference(DocumentReference) Actual entry
List.emptyReason 0..0 Why list is empty

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: doco
List C 0..* MhdList A list is a curated collection of resources
Constraints: lst-1, lst-2, lst-3
List.id This element is included in summaries. 0..1 id Logical id of this artifact
List.meta This element is included in summaries. 0..1 Meta Metadata about the resource
List.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
List.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
List.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
List.contained 0..* Resource Contained, inline Resources
List.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for extension.extension:designationType 1..* CodeableConcept Clinical code of the List
URL: https://profiles.ihe.net/ITI/MHD/StructureDefinition/ihe-designationType
List.Slices for identifier 0..* Identifier Business identifier
Slice: Unordered, Open by value:use

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for identifier.identifier:uniqueId 0..1 UniqueIdIdentifier Business identifier
List.Slices for identifier.identifier:entryUUID 0..* EntryUUIDIdentifier Business identifier
List.status This element is a modifier element. This element is included in summaries. 1..1 code current | retired | entered-in-error
Binding: ListStatus (required): The current state of the list.
List.mode This element is a modifier element. This element is included in summaries. 1..1 code working | snapshot | changes
Binding: ListMode (required): The processing mode that applies to this list.
Required Pattern: working
List.title This element is included in summaries. 1..1 string Descriptive name for the list
Example General: Dr. Jane's Patients
List.code This element is included in summaries. 1..1 CodeableConcept What the purpose of this list is
Binding: MHD List Types ValueSet (required)
Required Pattern: At least the following
List.code.id 0..1 string Unique id for inter-element referencing
List.code.extension 0..* Extension Additional content defined by implementations
List.code.coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
List.code.coding.id 0..1 string Unique id for inter-element referencing
List.code.coding.extension 0..* Extension Additional content defined by implementations
List.code.coding.system 1..1 uri Identity of the terminology system
Fixed Value: https://profiles.ihe.net/ITI/MHD/CodeSystem/MHDlistTypes
List.code.coding.version 0..1 string Version of the system - if relevant
List.code.coding.code 1..1 code Symbol in syntax defined by the system
Fixed Value: folder
List.code.coding.display 0..1 string Representation defined by the system
List.code.coding.userSelected 0..1 boolean If this coding was chosen directly by the user
List.code.text 0..1 string Plain text representation of the concept
List.subject This element is included in summaries. 1..1 Reference(Patient (CZ core)) If all resources have the same subject
List.date This element is included in summaries. 0..1 dateTime When the list was prepared
List.note 0..1 Annotation Comments about the list
List.entry C 0..* BackboneElement Entries in the list
List.entry.id 0..1 string Unique id for inter-element referencing
List.entry.extension 0..* Extension Additional content defined by implementations
List.entry.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
List.entry.item 1..1 Reference(DocumentReference) Actual entry

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
List.language Base preferred Common Languages 📦4.0.1 FHIR Std.
List.status Base required ListStatus 📍4.0.1 FHIR Std.
List.mode Base required ListMode 📍4.0.1 FHIR Std.
List.code Base required MHD List Types ValueSet 📦4.2.2 Mobile access to Health Documents v4.2

Constraints

Id Grade Path(s) Description Expression
dom-2 error List If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error List If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error List If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error List If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice List A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
lst-1 error List A list can only have an emptyReason if it is empty emptyReason.empty() or entry.empty()
lst-2 error List The deleted flag can only be used if the mode of the list is "changes" mode = 'changes' or entry.deleted.empty()
lst-3 error List An entry date can only be used if the mode of the list is "working" mode = 'working' or entry.date.empty()

This structure is derived from MhdList

Summary

Mandatory: 4 elements
Prohibited: 7 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of List.identifier

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
List C 0..* MhdList A list is a curated collection of resources
Constraints: lst-1, lst-2, lst-3
List.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
List.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for extension.extension:designationType 1..* CodeableConcept Clinical code of the List
URL: https://profiles.ihe.net/ITI/MHD/StructureDefinition/ihe-designationType
List.Slices for identifier 0..* Identifier Business identifier
Slice: Unordered, Open by value:use

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for identifier.identifier:uniqueId 0..1 UniqueIdIdentifier Business identifier
List.Slices for identifier.identifier:entryUUID 0..* EntryUUIDIdentifier Business identifier
List.status This element is a modifier element. This element is included in summaries. 1..1 code current | retired | entered-in-error
Binding: ListStatus (required): The current state of the list.
List.mode This element is a modifier element. This element is included in summaries. 1..1 code working | snapshot | changes
Binding: ListMode (required): The processing mode that applies to this list.
Required Pattern: working
List.title This element is included in summaries. 1..1 string Descriptive name for the list
Example General: Dr. Jane's Patients
List.code This element is included in summaries. 1..1 CodeableConcept What the purpose of this list is
Binding: MHD List Types ValueSet (required)
Required Pattern: At least the following
List.code.id 0..1 string Unique id for inter-element referencing
List.code.extension 0..* Extension Additional content defined by implementations
List.code.coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
List.code.coding.id 0..1 string Unique id for inter-element referencing
List.code.coding.extension 0..* Extension Additional content defined by implementations
List.code.coding.system 1..1 uri Identity of the terminology system
Fixed Value: https://profiles.ihe.net/ITI/MHD/CodeSystem/MHDlistTypes
List.code.coding.version 0..1 string Version of the system - if relevant
List.code.coding.code 1..1 code Symbol in syntax defined by the system
Fixed Value: folder
List.code.coding.display 0..1 string Representation defined by the system
List.code.coding.userSelected 0..1 boolean If this coding was chosen directly by the user
List.code.text 0..1 string Plain text representation of the concept
List.subject This element is included in summaries. 1..1 Reference(Patient (CZ core)) If all resources have the same subject
List.note 0..1 Annotation Comments about the list

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
List.status Base required ListStatus 📍4.0.1 FHIR Std.
List.mode Base required ListMode 📍4.0.1 FHIR Std.
List.code Base required MHD List Types ValueSet 📦4.2.2 Mobile access to Health Documents v4.2

Constraints

Id Grade Path(s) Description Expression
dom-2 error List If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error List If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error List If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error List If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice List A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
lst-1 error List A list can only have an emptyReason if it is empty emptyReason.empty() or entry.empty()
lst-2 error List The deleted flag can only be used if the mode of the list is "changes" mode = 'changes' or entry.deleted.empty()
lst-3 error List An entry date can only be used if the mode of the list is "working" mode = 'working' or entry.date.empty()

Differential View

This structure is derived from MhdList

NameFlagsCard.TypeDescription & Constraints    Filter: doco
List MhdList
List.extension 1..* Extension Extension
List.Slices for extension Content/Rules for all slices
List.Slices for extension.extension:designationType 1..* DesignationType Clinical code of the List
List.Slices for identifier 0..* Identifier Business identifier
Slice: Unordered, Open by value:use
Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for identifier.identifier:uniqueId 0..1 UniqueIdIdentifier Business identifier
List.Slices for identifier.identifier:entryUUID 0..* EntryUUIDIdentifier Business identifier
List.mode 1..1 code working | snapshot | changes
Required Pattern: working
List.title 1..1 string Descriptive name for the list
List.code 1..1 CodeableConcept What the purpose of this list is
Required Pattern: At least the following
List.code.coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
List.code.coding.system 1..1 uri Identity of the terminology system
Fixed Value: https://profiles.ihe.net/ITI/MHD/CodeSystem/MHDlistTypes
List.code.coding.code 1..1 code Symbol in syntax defined by the system
Fixed Value: folder
List.subject 1..1 Reference(Patient (CZ core)) If all resources have the same subject
List.encounter 0..0 Context in which list created
List.source 0..0 Who and/or what defined the list contents (aka Author)
List.orderedBy 0..0 What order the list has
List.note 0..1 Annotation Comments about the list
List.entry
List.entry.flag 0..0 Status/Workflow information about this item
List.entry.deleted 0..0 If this item is actually marked as deleted
List.entry.date 0..0 When item added to list
List.entry.item 1..1 Reference(DocumentReference) Actual entry
List.emptyReason 0..0 Why list is empty

doco Documentation for this format

Snapshot ViewView

NameFlagsCard.TypeDescription & Constraints    Filter: doco
List C 0..* MhdList A list is a curated collection of resources
Constraints: lst-1, lst-2, lst-3
List.id This element is included in summaries. 0..1 id Logical id of this artifact
List.meta This element is included in summaries. 0..1 Meta Metadata about the resource
List.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
List.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
List.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
List.contained 0..* Resource Contained, inline Resources
List.Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for extension.extension:designationType 1..* CodeableConcept Clinical code of the List
URL: https://profiles.ihe.net/ITI/MHD/StructureDefinition/ihe-designationType
List.Slices for identifier 0..* Identifier Business identifier
Slice: Unordered, Open by value:use

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
List.Slices for identifier.identifier:uniqueId 0..1 UniqueIdIdentifier Business identifier
List.Slices for identifier.identifier:entryUUID 0..* EntryUUIDIdentifier Business identifier
List.status This element is a modifier element. This element is included in summaries. 1..1 code current | retired | entered-in-error
Binding: ListStatus (required): The current state of the list.
List.mode This element is a modifier element. This element is included in summaries. 1..1 code working | snapshot | changes
Binding: ListMode (required): The processing mode that applies to this list.
Required Pattern: working
List.title This element is included in summaries. 1..1 string Descriptive name for the list
Example General: Dr. Jane's Patients
List.code This element is included in summaries. 1..1 CodeableConcept What the purpose of this list is
Binding: MHD List Types ValueSet (required)
Required Pattern: At least the following
List.code.id 0..1 string Unique id for inter-element referencing
List.code.extension 0..* Extension Additional content defined by implementations
List.code.coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
List.code.coding.id 0..1 string Unique id for inter-element referencing
List.code.coding.extension 0..* Extension Additional content defined by implementations
List.code.coding.system 1..1 uri Identity of the terminology system
Fixed Value: https://profiles.ihe.net/ITI/MHD/CodeSystem/MHDlistTypes
List.code.coding.version 0..1 string Version of the system - if relevant
List.code.coding.code 1..1 code Symbol in syntax defined by the system
Fixed Value: folder
List.code.coding.display 0..1 string Representation defined by the system
List.code.coding.userSelected 0..1 boolean If this coding was chosen directly by the user
List.code.text 0..1 string Plain text representation of the concept
List.subject This element is included in summaries. 1..1 Reference(Patient (CZ core)) If all resources have the same subject
List.date This element is included in summaries. 0..1 dateTime When the list was prepared
List.note 0..1 Annotation Comments about the list
List.entry C 0..* BackboneElement Entries in the list
List.entry.id 0..1 string Unique id for inter-element referencing
List.entry.extension 0..* Extension Additional content defined by implementations
List.entry.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
List.entry.item 1..1 Reference(DocumentReference) Actual entry

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
List.language Base preferred Common Languages 📦4.0.1 FHIR Std.
List.status Base required ListStatus 📍4.0.1 FHIR Std.
List.mode Base required ListMode 📍4.0.1 FHIR Std.
List.code Base required MHD List Types ValueSet 📦4.2.2 Mobile access to Health Documents v4.2

Constraints

Id Grade Path(s) Description Expression
dom-2 error List If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error List If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error List If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error List If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice List A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
lst-1 error List A list can only have an emptyReason if it is empty emptyReason.empty() or entry.empty()
lst-2 error List The deleted flag can only be used if the mode of the list is "changes" mode = 'changes' or entry.deleted.empty()
lst-3 error List An entry date can only be used if the mode of the list is "working" mode = 'working' or entry.date.empty()

This structure is derived from MhdList

Summary

Mandatory: 4 elements
Prohibited: 7 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of List.identifier

 

Other representations of profile: CSV, Excel, Schematron