3.1. Logical Models

Logical Models represent data structures, and contain data elements and their constraints and relationships. They allow data requirements to be described from a functional perspective. In this IG, the functional dataset and the underlying use cases for the information models that are not present in ART-DECOR, are represented by FHIR Logical Models (note that this link redirects to the R5 specification, as there is no dedicated page for Logical Models in the STU3 specification). These use FHIR to capture the data structures (namely by specifying a StructureDefinition and underlying ElementDefinitions, for each data structure), but they are not (directly) attached to FHIR resources.

The Logical Models contain all functional concepts, including corresponding data type, terminology binding (if applicable) and an id.

  • For each concept, an id is assigned by MedMij. These ids are also added as mappings in the FHIR profiles, and therefore form the linking pin between Logical Models and FHIR profiles.
  • For each concept it is indicated whether it is repeating (i.e. by setting its maximum cardinality to 1 or *). Moreover, for each concept it is indicated whether it is (conditionally) required by setting the minimum cardinality to 1 (or adding a constraint which specifies when the concept is required).
  • The FHIR data types are used in the Logical Models, even though these might bring 'physical' constraints, formats, etc. into the abstract logical data models which are not intended or applicable on the logical level. For instance, elements of the Attachment data type need to satisfy the att-1 constraint, which states that the element SHALL have a contentType, provided the element has non-empty data. Even though this constraint makes sense on a technical level, the aforementioned attributes contentType and data are not present in a logical data model. Therefore, such constraints may be 'ignored' in the Logical Models; instead, these constraints are taken into account in the corresponding FHIR profiles.
  • Since the Logical Models defined in this IG are meant to represent the use case, .abstract is set to false.
  • For all Logical Models the scope is implicitly set to a single patient. This relation is not explicitly modeled, similar to the approach of the zibs.

3.1.1. Nursing Report

A report documenting a patient contact in a long-term healthcare nursing setting. The report can be recorded by different types of health professionals and is not necessarily written by a nurse.

id0..1string
extensionC0..*Extension
ReportTitle0..1string
ReportDateTime1..1dateTime
PerformerC1..1Reference(MedMijCoreLmHealthcareProvider | MedMijCoreLmHealthProfessional)
ReportContent1..1string
Mapping nameConcept idLogical elementComments
lz-dataset-100-rc3-20260811lz-dataelement-1NursingReportNursingReport
lz-dataset-100-rc3-20260811lz-dataelement-2NursingReport.ReportTitleReportTitle
lz-dataset-100-rc3-20260811lz-dataelement-3NursingReport.ReportDateTimeReportDateTime
lz-dataset-100-rc3-20260811lz-dataelement-4NursingReport.PerformerPerformer
lz-dataset-100-rc3-20260811lz-dataelement-19NursingReport.ReportContentReportContent
SNOMED11591000146107NursingReportpatiƫntcontactverslag
<StructureDefinition xmlns="http://hl7.org/fhir">
<id value="lz-lm-NursingReport" />
<status value="empty" />
--- We have skipped the narrative for better readability of the resource ---
</text>
<url value="http://medmij.nl/fhir/StructureDefinition/lz-lm-NursingReport" />
<use value="official" />
<system value="urn:ietf:rfc:3986" />
<value value="urn:oid:2.16.528.1.1023.3.4.1" />
</identifier>
<version value="1.0.0-rc.3" />
<name value="LzLmNursingReport" />
<title value="NursingReport" />
<status value="active" />
<publisher value="MedMij" />
<name value="MedMij" />
<system value="email" />
<value value="info@medmij.nl" />
<use value="work" />
</telecom>
</contact>
<description value="A report documenting a patient contact in a long-term healthcare nursing setting. The report can be recorded by different types of health professionals and is not necessarily written by a nurse." />
<purpose value="This LogicalModel represents the NursingReport Clinical Information Model (CIM) for patient use cases in the context of Long-term Healthcare. It is based on the [ANW v2024.1](https://nuts-foundation.gitbook.io/bolts/anw/v2024.1#id-5.2-wegschrijven-van-informatie) specification." />
<copyright value="Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise." />
<fhirVersion value="3.0.2" />
<identity value="lz-dataset-100-rc3-20260811" />
<name value="Dataset Langdurige Zorg MedMij 1.0.0-rc.3 20260811" />
</mapping>
<identity value="SNOMED" />
<uri value="http://snomed.info/sct" />
<name value="SNOMED CT" />
</mapping>
<kind value="logical" />
<abstract value="false" />
<type value="lz-lm-NursingReport" />
<baseDefinition value="http://hl7.org/fhir/StructureDefinition/Element" />
<derivation value="specialization" />
<element id="lz-lm-NursingReport">
<path value="lz-lm-NursingReport" />
<short value="Nursing report" />
<definition value="A report documenting a patient contact in a long-term healthcare nursing setting. The report can be recorded by different types of health professionals and is not necessarily written by a nurse." />
<alias value="Dagrapportage" />
<identity value="lz-dataset-100-rc3-20260811" />
<map value="lz-dataelement-1" />
<comment value="NursingReport" />
</mapping>
<identity value="SNOMED" />
<map value="11591000146107" />
<comment value="patiëntcontactverslag" />
</mapping>
</element>
<element id="lz-lm-NursingReport.ReportTitle">
<path value="lz-lm-NursingReport.ReportTitle" />
<short value="Report title" />
<definition value="The title of the nursing report." />
<comment value="The title should be human readable and clear to the patient." />
<alias value="RapportageTitel" />
<min value="0" />
<max value="1" />
<code value="string" />
</type>
<identity value="lz-dataset-100-rc3-20260811" />
<map value="lz-dataelement-2" />
<comment value="ReportTitle" />
</mapping>
</element>
<element id="lz-lm-NursingReport.ReportDateTime">
<path value="lz-lm-NursingReport.ReportDateTime" />
<short value="Report date time" />
<definition value="The date/time on which the nursing report is registered." />
<alias value="RapportageDatumTijd" />
<min value="1" />
<max value="1" />
<code value="dateTime" />
</type>
<identity value="lz-dataset-100-rc3-20260811" />
<map value="lz-dataelement-3" />
<comment value="ReportDateTime" />
</mapping>
</element>
<element id="lz-lm-NursingReport.Performer">
<path value="lz-lm-NursingReport.Performer" />
<short value="Performer" />
<definition value="The health professional or organization who registered the nursing report." />
<alias value="Uitvoerder" />
<min value="1" />
<max value="1" />
<code value="Reference" />
<targetProfile value="http://medmij.nl/fhir/StructureDefinition/medmij-core-lm-HealthProfessional" />
</type>
<code value="Reference" />
<targetProfile value="http://medmij.nl/fhir/StructureDefinition/medmij-core-lm-HealthcareProvider" />
</type>
<identity value="lz-dataset-100-rc3-20260811" />
<map value="lz-dataelement-4" />
<comment value="Performer" />
</mapping>
</element>
<element id="lz-lm-NursingReport.ReportContent">
<path value="lz-lm-NursingReport.ReportContent" />
<short value="Report content" />
<definition value="The content of the nursing report." />
<alias value="RapportageInhoud" />
<min value="1" />
<max value="1" />
<code value="string" />
</type>
<identity value="lz-dataset-100-rc3-20260811" />
<map value="lz-dataelement-19" />
<comment value="ReportContent" />
</mapping>
</element>
</differential>
</StructureDefinition>
{
"resourceType": "StructureDefinition",
"id": "lz-lm-NursingReport",
"text": {
"status": "empty",
--- We have skipped the narrative for better readability of the resource ---
},
"url": "http://medmij.nl/fhir/StructureDefinition/lz-lm-NursingReport",
{
"use": "official",
"system": "urn:ietf:rfc:3986",
"value": "urn:oid:2.16.528.1.1023.3.4.1"
}
],
"version": "1.0.0-rc.3",
"name": "LzLmNursingReport",
"title": "NursingReport",
"status": "active",
"publisher": "MedMij",
"contact": [
{
"name": "MedMij",
"telecom": [
{
"system": "email",
"value": "info@medmij.nl",
"use": "work"
}
]
}
],
"description": "A report documenting a patient contact in a long-term healthcare nursing setting. The report can be recorded by different types of health professionals and is not necessarily written by a nurse.",
"purpose": "This LogicalModel represents the NursingReport Clinical Information Model (CIM) for patient use cases in the context of Long-term Healthcare. It is based on the [ANW v2024.1](https://nuts-foundation.gitbook.io/bolts/anw/v2024.1#id-5.2-wegschrijven-van-informatie) specification.",
"copyright": "Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise.",
"fhirVersion": "3.0.2",
"mapping": [
{
"identity": "lz-dataset-100-rc3-20260811",
"name": "Dataset Langdurige Zorg MedMij 1.0.0-rc.3 20260811"
},
{
"identity": "SNOMED",
"uri": "http://snomed.info/sct",
"name": "SNOMED CT"
}
],
"kind": "logical",
"abstract": false,
"type": "lz-lm-NursingReport",
"baseDefinition": "http://hl7.org/fhir/StructureDefinition/Element",
"derivation": "specialization",
"element": [
{
"id": "lz-lm-NursingReport",
"path": "lz-lm-NursingReport",
"short": "Nursing report",
"definition": "A report documenting a patient contact in a long-term healthcare nursing setting. The report can be recorded by different types of health professionals and is not necessarily written by a nurse.",
"alias": [
"Dagrapportage"
],
"mapping": [
{
"identity": "lz-dataset-100-rc3-20260811",
"map": "lz-dataelement-1",
"comment": "NursingReport"
},
{
"identity": "SNOMED",
"map": "11591000146107",
"comment": "patiëntcontactverslag"
}
]
},
{
"id": "lz-lm-NursingReport.ReportTitle",
"path": "lz-lm-NursingReport.ReportTitle",
"short": "Report title",
"definition": "The title of the nursing report.",
"comment": "The title should be human readable and clear to the patient.",
"alias": [
"RapportageTitel"
],
"min": 0,
"max": "1",
"type": [
{
"code": "string"
}
],
"mapping": [
{
"identity": "lz-dataset-100-rc3-20260811",
"map": "lz-dataelement-2",
"comment": "ReportTitle"
}
]
},
{
"id": "lz-lm-NursingReport.ReportDateTime",
"path": "lz-lm-NursingReport.ReportDateTime",
"short": "Report date time",
"definition": "The date/time on which the nursing report is registered.",
"alias": [
"RapportageDatumTijd"
],
"min": 1,
"max": "1",
"type": [
{
"code": "dateTime"
}
],
"mapping": [
{
"identity": "lz-dataset-100-rc3-20260811",
"map": "lz-dataelement-3",
"comment": "ReportDateTime"
}
]
},
{
"id": "lz-lm-NursingReport.Performer",
"path": "lz-lm-NursingReport.Performer",
"short": "Performer",
"definition": "The health professional or organization who registered the nursing report.",
"alias": [
"Uitvoerder"
],
"min": 1,
"max": "1",
"type": [
{
"code": "Reference",
"targetProfile": "http://medmij.nl/fhir/StructureDefinition/medmij-core-lm-HealthProfessional"
},
{
"code": "Reference",
"targetProfile": "http://medmij.nl/fhir/StructureDefinition/medmij-core-lm-HealthcareProvider"
}
],
"mapping": [
{
"identity": "lz-dataset-100-rc3-20260811",
"map": "lz-dataelement-4",
"comment": "Performer"
}
]
},
{
"id": "lz-lm-NursingReport.ReportContent",
"path": "lz-lm-NursingReport.ReportContent",
"short": "Report content",
"definition": "The content of the nursing report.",
"alias": [
"RapportageInhoud"
],
"min": 1,
"max": "1",
"type": [
{
"code": "string"
}
],
"mapping": [
{
"identity": "lz-dataset-100-rc3-20260811",
"map": "lz-dataelement-19",
"comment": "ReportContent"
}
]
}
]
}
}