HL7 Europe Base and Core FHIR IG
2.0.1-ci - ci-build 150

HL7 Europe Base and Core FHIR IG, published by HL7 Europe. This guide is not an authorized publication; it is the continuous build for version 2.0.1-ci built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/base-r5/ and changes regularly. See the Directory of published versions

Change Log

This page summarizes the main changes applied to this version of the guide.

From 2.0.0 to 2.0.1

  • Profile and constraint updates
    • FHIR-58774: Set the cardinality of BodyStructure.extension:includedStructure to 1..* in the R4 profile, aligning it with the cross-version extension definition and with the R5 BodyStructure.includedStructure element.
    • FHIR-57206: Added OrganizationEuCore to the reference targets of CompositionEuCore.attester:legalAuthenticator.party.
    • FHIR-56556: Added Substance and BiologicallyDerivedProduct to the reference targets of MedicalTestResultEuCore.focus.
    • FHIR-55515: Made the periodOfLife extension available beyond Immunization, so that a life stage can be recorded where an exact date is not known: on Condition.onset[x] and Condition.abatement[x], on Procedure.performed[x] (occurrence[x] in R5), and on AllergyIntolerance.onset[x] and its abatement extension. The slice sits on the dateTime choice, following the resolution that names dateTime as the preferred datatype where an element offers several; as the extension is bound by datatype rather than by element, Age, Period and Range remain available without a slice of their own.
  • Technical corrections
    • FHIR-57342: Corrected the slicing of DiagnosticReportEuCore.performer. It used a profile discriminator on the path $this; on a Reference element that expression yields the reference itself and not the referenced resource, so the slices could not be discriminated and strict validators rejected the profile and everything derived from it. The discriminator path is now resolve(), as it already was on the resultsInterpreter slicing in the same profile. The defect was introduced with the profile (FHIR-53481) and is present in 2.0.0.
    • FHIR-56849: Corrected the component.extension:value-r5 slice in MedicalTestResultEuCore. It used the cross-version extension Observation.value, whose context is limited to Observation and therefore does not allow Observation.component. It now uses Observation.component.value, which has the matching context. Added the constraint obs-value-2 on Observation.component, mirroring obs-value-1, so that component.value[x] and component.extension:value-r5 cannot be used simultaneously.
    • FHIR-56515: Set Observation.performer.extension:performerFunction to 0..1 in MedicalTestResultEuCore. The slice allowed 0..* although the event-performerFunction extension is itself defined as 0..1, so a second occurrence was never valid. Added a comment that a Practitioner(Role) acting in multiple roles has to be listed as performer multiple times.
  • Terminology
    • FHIR-56527: Bound BodyStructure.morphology to the new MorphologyEuVs instead of the FHIR value set SNOMEDCTMorphologicAbnormalities. The latter is based on < 49755003 |Abnormal tissue appearance|, whereas SNOMED CT recommended the wider < 118956008 |Body structure, altered from its original anatomical structure| in its feedback on Xt-EHR D7.1. The new hierarchy subsumes the previous one, so no code that was valid before falls outside the value set.
    • FHIR-56526: Added the SNOMED CT codes Left and Right to SiteQualifierEuVs, as they can be used both as a laterality and as a site qualifier. This reverses the removal made for FHIR-51391, following the discussion with the Orders & Observations WG. Added Apical, Central and Peripheral as well, completing pairs the value set already builds on: Basal was present without its counterpart, and Central / Peripheral follows the same pattern as Superficial / Deep.
  • Editorial and documentation updates
    • FHIR-58742: Aligned the guide with version 1.0.0 of the Xt-EHR EHDS logical models. Updated the model links from 0.3.0 to 1.0.0, renamed the mapping page of the medication summary model to EHDSMedicationUse to FHIR MedicationStatement Mapping, and reviewed the model map pages against the new model version: corrected relationship labels, added the missing EHDSPatient.deceased[x] and changeType rows, renamed EHDSObservation.component.code to component.type and mapped EHDSAddress.country to the country code.
  • Examples
    • FHIR-58774: Added a BodyStructure example covering more than one included structure, multiple site qualifiers and a business identifier.

From 2.0.0-ballot to 2.0.0

  • Profile and constraint updates
    • FHIR-55554: Removed DiagnosticReportComposition extension from the R5 profile.
    • FHIR-55522: Relaxed a constraint in DiagnosticReportEuCore to align with IPS.
    • FHIR-55541: Removed the category slice from DiagnosticReportEuCore.
    • FHIR-55542: Added EU core profile references for performer and resultInterpreter in DiagnosticReportEuCore.
    • FHIR-55548: Removed the procedure-targetBodyStructure extension.
    • FHIR-53896 / FHIR-55503: Removed constraint on subject.reference.
    • FHIR-53897: Removed constraint on patient.reference.
    • FHIR-55387: Renamed FlagEuCore to FlagPatientEuCore.
    • Updated Immunization profile to align with model maps.
    • FHIR-55458: Renamed attester slice resultValidator.
    • FHIR-55526: Set Composition.attester.party cardinality to 1.. for validator and legalAuthenticator.
    • MedicalTestResultEuCore: Temporarily removed the R5 value[x] extension to fix extension errors.
    • FHIR-55424: Removed category slice in MedicalTestResultEuCore.
    • FHIR-55639: Added missing target elements referenced by model maps and reviewed all profiles.
    • FHIR-56415: fixed misalignemnt between MedicalTestResultEuCore and LaboratoryObservations.
  • Editorial and documentation updates
    • FHIR-55553: Partial typo fixes.
    • FHIR-55461: Editorial updates across multiple pages.
    • FHIR-53895: Fixed the Location mapping page header.
    • FHIR-53894: Fixed the EHDSOrganisation page header.
    • FHIR-55533: Updated descriptions in core profiles.
    • FHIR-55536: Harmonized profile titles.
    • FHIR-55452: Clarified the role of base and core profiles in the introduction page.
    • FHIR-55454: Moved the EHDSBodyStructure model and related map under the Entity group.
    • FHIR-55741: Normalized relationships in model map tables.
  • EHDS model and mapping alignment (Xt-EHR 0.3.0)
    • Revised the Flag model map and fixed links to model version 0.3.0.
    • FHIR-55532: Aligned model map pages with the updated model version.
    • Added the Xt-EHR 0.3.0 model and refactored EHDS-to-FHIR mappings based on the updated model.

From 0.1.0 to 2.0.0-ballot

  • Added new profiles and model to profile maps
    • DiagnosticReport (FHIR-53481)
    • Composition (FHIR-53480)
    • AllergyIntolerance; Condition; Procedure; Flag; Immunization; Medication; MedicationStatement; MedicationRequest (FHIR-53197)
    • Medication/MedicationStatement/Immunization content (target profiles, revised mappings, removal of basedOn in Medication diff).
    • Medical Test Result observation profile (FHIR-53573)
  • Updated the EHDS model links to the published versions (FHIR-53124)
  • Changed dependency to the xver-r5 package for the cross-version extensions
  • Extended logical models and maps: grouped/reorganized model map landing pages, refactored the HTML/XML layout of the mapping pages, merged tables in the HCP model with the resource column (FHIR-53197 + others).
  • Added examples for the profiles (FHIR-53197 + others).
  • Moved the bodySite extension to Condition.bodySite and Procedure.bodySite (FHIR-53124)
  • General maintenance:
    • aligned the versioning with the new HL7 EU guidelines (version bumped to 2.0.0) (FHIR-53618)
    • Updated Known Issues and Change Log pages

From 0.1.0-ballot to 0.1.0

  • Updated IPS dependency to version 2.0.0 (FHIR-51370).
  • Removed scoped references from base profiles (FHIR-51879; FHIR-51321; FHIR-51318).
  • Added page for missing data and removed data-absent-reason extensions (FHIR-51374).
  • Removed EHIC from this version (FHIR-51267).
  • Added explanations about Address.line extensions usage (FHIR-50782; FHIR-51880).
  • Revised index and introduction pages with extended explanations about core and base profiles (FHIR-51199).
  • Replaced iso21090-SC-coding extension with iso21090-codedString (FHIR-51664, R4).
  • Added minimal guidance for sex/gender-related extensions (FHIR-50969).
  • Fixed HL7 Europe copyright statement (FHIR-50968).
  • Added introductory text about extensions for the AddressEu profile (FHIR-51269).
  • Removed references to IPS datatypes from base profiles (FHIR-51272).
  • Defined Patient Animal as a core profile derived from Patient Base (FHIR-51402; FHIR-51569).
  • Removed unused value sets (FHIR-51989).
  • Added EHDS models and mappings to profiles (FHIR-51222).
  • Harmonized display names across artifacts (FHIR-51375).
  • Updated laterality value set to use left/right/bilateral (FHIR-51391).
  • Added gender-identity and pronoun extensions to Patient (FHIR-51270).
  • Moved data-absent-reason extensions to core profiles where elements are 1.. (FHIR-51374).
  • Fixed resource IDs to follow lowerCamelCase convention (FHIR-51663).
  • Grouped profiles in Artifacts Summary page (FHIR-51223).
  • Fixed typos in the artifacts page (FHIR-51262).
  • Set Patient.name.extension[name-absent-reason] to 0..1 (FHIR-51261).
  • Added EHIC model to the R5 IG (FHIR-51369).
  • Created Patient EHIC profile derived from EU Core (FHIR-51394).
  • Added birthTime extension to Patient (FHIR-51177).
  • Set Location.managingOrganization reference to OrganizationEU (FHIR-51268).
  • Set Patient.communication to 0..0 for animals (FHIR-51362).
  • Fixed package IDs on the home page (FHIR-51221).
  • Fixed typo in downloads.md (FHIR-51372).
  • Fixed typo in constraint name name-or-identifier (FHIR-51392).
  • Corrected description for Patient-animal-eu profile (FHIR-51438).