ImplementationGuide — La racine d'un IG FHIR

US Core, IPS, FR Core, MIO, IPS-AU : tous ces guides d'implémentation publient une ImplementationGuide racine qui décrit le contenu, les dépendances et la table des matières d'un package FHIR.

Objet de la ressource

Un Implementation Guide (IG) FHIR est un package livrable contenant des profils (StructureDefinition), des terminologies (ValueSet, CodeSystem), des exemples, des extensions et de la documentation. ImplementationGuide est la ressource racine qui décrit ce package : ses dépendances, son packageId NPM-FHIR, sa version FHIR cible, sa licence.

L'outil de référence IG Publisher de HL7 consomme cette racine, parcourt les artefacts listés, et génère le site web HTML de l'IG (la page sous-arborescence) plus le package npm distribuable hl7.fhir.<realm>.<name>.

Champs clés

IGs de référence

• US Core — hl7.fhir.us.core — profil pivot américain pour ONC.
• IPS UV — hl7.fhir.uv.ips — International Patient Summary.
• FR Core — hl7.fhir.fr.core — profil français ANS.
• NL Core / Nictiz — profil néerlandais.
• UK Core — hl7.fhir.uk.core — profil NHS Digital.
• IHE PCC mCSD, mACM… — IGs IHE pour les profils techniques de référence.
• SDOH Clinical Care — Social Determinants of Health (HL7 US).
• CARIN BB — Consumer-Directed Payer Data Exchange.

Exemple JSON

Squelette d'une ImplementationGuide US Core, version 6.1.0 :

{
  "resourceType": "ImplementationGuide",
  "id": "hl7.fhir.us.core",
  "url": "http://hl7.org/fhir/us/core/ImplementationGuide/hl7.fhir.us.core",
  "version": "6.1.0",
  "name": "USCoreImplementationGuide",
  "title": "US Core Implementation Guide",
  "status": "active",
  "experimental": false,
  "date": "2026-05-14",
  "publisher": "HL7 International - Cross-Group Projects",
  "packageId": "hl7.fhir.us.core",
  "license": "CC0-1.0",
  "fhirVersion": ["5.0.0"],
  "dependsOn": [{
    "uri": "http://terminology.hl7.org/ImplementationGuide/hl7.terminology",
    "packageId": "hl7.terminology",
    "version": "5.5.0"
  }],
  "definition": {
    "resource": [
      { "reference": { "reference": "StructureDefinition/us-core-patient" }, "name": "US Core Patient Profile", "exampleBoolean": false },
      { "reference": { "reference": "StructureDefinition/us-core-condition" }, "name": "US Core Condition Profile", "exampleBoolean": false },
      { "reference": { "reference": "ValueSet/us-core-clinical-note-type" }, "name": "US Core Clinical Note Type", "exampleBoolean": false },
      { "reference": { "reference": "Patient/example" }, "name": "Example Patient", "exampleBoolean": true }
    ],
    "page": {
      "nameUrl": "toc.html",
      "title": "Table of Contents",
      "generation": "html"
    }
  }
}

Pièges courants

• packageId non conforme au format npm — doit être en lowercase, sans underscore, format vendor.fhir.realm.name.
• Oubli de dependsOn — un IG qui réutilise des CodeSystem THO (HL7 Terminology) DOIT déclarer la dépendance pour que l'IG Publisher résolve les codes.
• Mauvaise FHIR version — un IG R4 (4.0.1) et un IG R5 (5.0.0) ne sont pas interopérables : les serveurs lisent fhirVersion avant tout chargement.
• Profil avec contraintes incompatibles — un profil enfant qui relâche une contrainte parente est une derivation invalide, refusée par IG Publisher.
• Confondre IG et NPM package — l'IG est la métadonnée, le package npm-FHIR (npm install --registry=https://packages.simplifier.net) est le distribuable physique.

Ressources liées

• StructureDefinition — profil/Resource/Extension décrit par l'IG.
• ValueSet, CodeSystem — terminologies incluses.
• OperationDefinition — opérations métier décrites par l'IG.
• CapabilityStatement — capacité serveur conforme à l'IG.