Štandardy

CDA vs FHIR: dokumenty verzus zdroje, kedy sa ktorý hodí a ako ich previesť

CDA je štandard pre dokumenty: jeden podpísaný XML súbor, ktorý zostáva celistvý. FHIR je štandard pre zdroje: malé, adresovateľné časti, ktoré API poskytuje a aktualizuje. Čo tento rozdiel znamená v praxi, ako FHIR dokumenty (Composition v Bundle) spájajú tieto dva štandardy, kedy je CDA stále potrebná a ako funguje konverzia.

od Zverejnené 6 min čítania

Krátka odpoveď: CDA vám dáva jeden dokument: podpísaný XML súbor o jednom pacientovi v jednom momente, s textom, ktorý číta človek, a záznamami, ktoré môže čítať počítač, pričom musí zostať celý a nezmenený. FHIR vám dáva zdroje: Pacienta, štyridsať Pozorovaní, tri Stavy, každý s vlastnou URL, načítaný, vyhľadávaný a aktualizovaný nezávisle prostredníctvom REST API. FHIR môže tiež zoskupiť zdroje do dokumentu (Bundle typu document vedeného Composition), čo je priamy ekvivalent CDA. Vyberte si CDA tam, kde to vyžaduje predpis alebo partner; vyberte si FHIR pre API, aplikácie a čokoľvek, čo sa má skôr dopytovať ako čítať.

Dva tvary

CDA a FHIR majú dva odlišné tvary. CDA vymieňa celé XML dokumenty postavené na dátových typoch HL7 v3, identifikované pomocou OID, s povinným textovým popisom, bez možnosti vyhľadávania, bez aktualizácií a s podpisom celého dokumentu. FHIR vymieňa jednotlivé JSON alebo XML zdroje alebo zväzky (Bundles), identifikované kanonickými URL adresami, s integrovaným REST vyhľadávaním, verzovanými aktualizáciami a profilmi publikovanými v sprievodcoch implementácie.

CDA / C-CDA FHIR
Jednotka výmeny Celý dokument Zdroj, alebo Bundle zdrojov
Formát XML, dátové typy HL7 v3 JSON alebo XML, dátové typy FHIR
Identifikácia OID pre šablóny a kódové systémy URL (kanonické) pre profily a kódové systémy
Časť čitateľná človekom Povinné <text> v každej sekcii Voliteľný textový naratív text.div pre každý zdroj; povinný v dokumentoch
Prenos Nedefinovaný; prenášaný cez XDS, Direct, MLLP, e-mail REST cez HTTPS definovaný štandardom; tiež správy a dokumenty
Dopytovanie Nie je možné v rámci dokumentu; registre indexujú hlavičku Vstavané: GET /Observation?patient=…&code=…
Aktualizácia Nikdy; nový dokument nahrádza starý Zdroje sú verzované a aktualizované na mieste
Podpisovanie Celý dokument, XML-DSig Možný celý Bundle; jednotlivé zdroje zriedka podpísané
Profily Šablóny (templateId) pre sekciu a záznam Profily StructureDefinition pre každý zdroj, publikované v sprievodcoch implementácie
Terminológia Kódy sekcií LOINC, záznamy SNOMED/ICD/RxNorm Rovnaké kódové systémy, ako CodeableConcept

Čo rozdiel znamená v praxi

V praxi je rozdiel medzi CDA a FHIR v tom, že CDA je vhodný pre obsah napísaný raz a uchovaný vcelku, ako napríklad podpísaná prepúšťacia správa, zatiaľ čo FHIR je vhodný pre dáta, ktoré rastú a sú vyhľadávané, ako napríklad séria meraní krvného tlaku. Prijímač CDA môže zobraziť, ale musí usporiadať na import; prijímač FHIR dostáva zdroje už tvarované ako jeho vlastný záznam.

Prepúšťacia správa je prirodzene dokument: napíše sa raz, podpíše ju jeden lekár a musí byť reprodukovateľná roky neskôr presne tak, ako bola prečítaná. Séria meraní krvného tlaku je prirodzene súbor zdrojov: rastie každý deň, je vykresľovaná a filtrovaná a nikto ju nepodpisuje. CDA dobre zvláda prvé a zle druhé (pre každé nové meranie by ste poslali celý dokument znova). FHIR zvláda druhé natívne a prvé prostredníctvom svojho mechanizmu dokumentov.

Ďalší praktický rozdiel je čo môže prijímateľ urobiť. Prijímateľ CDA môže vždy zobraziť dokument; import jeho záznamov vyžaduje zosúladenie, sekciu po sekcii. Prijímateľ FHIR dostáva zdroje, ktoré sú už vo forme jeho vlastného záznamu; ťažké otázky sa presúvajú na identitu (je to ten istý pacient?) a pôvod (kto to potvrdil a kedy?). Pozri Zhoda pacientov.

FHIR dokumenty: miesto stretnutia

FHIR dokument je Bundle s type: "document", ktorého prvým záznamom je Composition. Composition hrá úlohu hlavičky a zoznamu sekcií CDA: typ (LOINC), dátum, autor, predmet, správca, stav a section[] s názvom, kódom, textovým naratívom a odkazmi na zdroje, ktoré nesú dáta.

{
  "resourceType": "Bundle",
  "type": "document",
  "identifier": {"system": "urn:ietf:rfc:3986", "value": "urn:uuid:3f2d7a3e-…"},
  "timestamp": "2026-03-14T10:15:00+01:00",
  "entry": [
    {"fullUrl": "urn:uuid:comp-1", "resource": {
      "resourceType": "Composition", "status": "final",
      "type": {"coding": [{"system": "http://loinc.org", "code": "60591-5", "display": "Patient summary Document"}]},
      "subject": {"reference": "urn:uuid:pat-1"},
      "date": "2026-03-14T10:15:00+01:00",
      "author": [{"reference": "urn:uuid:prac-1"}],
      "title": "Patient summary",
      "section": [{
        "title": "Allergies and intolerances",
        "code": {"coding": [{"system": "http://loinc.org", "code": "48765-2"}]},
        "text": {"status": "generated", "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Penicillin: rash</p></div>"},
        "entry": [{"reference": "urn:uuid:allergy-1"}]
      }]
    }},
    {"fullUrl": "urn:uuid:pat-1", "resource": {"resourceType": "Patient", "id": "pat-1"}},
    {"fullUrl": "urn:uuid:prac-1", "resource": {"resourceType": "Practitioner", "id": "prac-1"}},
    {"fullUrl": "urn:uuid:allergy-1", "resource": {"resourceType": "AllergyIntolerance", "id": "allergy-1", "patient": {"reference": "urn:uuid:pat-1"}, "code": {"coding": [{"system": "http://snomed.info/sct", "code": "764146007", "display": "Penicillin"}]}}}
  ]
}

Medzinárodný súhrn pacienta je presne toto: profil FHIR dokumentu, s dvojníkom CDA pre systémy, ktoré ho stále potrebujú. Pozri tiež FHIR Bundle vysvetlený.

Konverzia medzi nimi

Konverzia medzi CDA a FHIR funguje oboma smermi s obmedzeniami. Sprievodca implementácie HL7 C-CDA na FHIR mapuje typy dokumentov, sekcie a položky na profily Composition a zdroje; sekcie iba s textovým popisom sa stanú textom bez dát. Konverzia z FHIR do CDA funguje pre zdroje, ktoré zodpovedajú šablónam C-CDA. V oboch smeroch by mal byť originál uchovaný ako DocumentReference s Provenance.

  • CDA → FHIR: sprievodca implementáciou HL7 C-CDA on FHIR mapuje americké typy dokumentov a sekcie na profily Composition; záznamy mapujú na zdroje (Problem Concern Act → Condition, Medication Activity → MedicationStatement, Result Observation → Observation). Mapovanie je deterministické pre dobre šablónovaný obsah úrovne 3 a stratové pre sekcie iba s naratívom, ktoré sa stávajú textom bez dát.
  • FHIR → CDA: možné pre dokumenty, ktorých zdroje zodpovedajú šablónam C-CDA. Voľné FHIR zdroje, ktoré neboli nikdy určené ako dokument (prúd pozorovaní z nositeľných zariadení), sa nestanú zmysluplným CDA.
  • Ponechajte originál. V oboch smeroch konverzie uložte zdroj tak, ako bol prijatý, ako DocumentReference, a nechajte Provenance ukazovať z konvertovaných zdrojov naň. Konverzia je pohľad, nie náhrada.

Kedy je CDA stále správnou odpoveďou

CDA je stále správnou odpoveďou, keď to vyžaduje prijímajúca strana (prechodné starostlivosti v USA, súhrn pacienta a elektronický predpis MyHealth@EU, niekoľko národných registrov dokumentov), keď je obsah právne dokumentom, ktorý musí byť podpísaný a uchovaný vcelku, alebo keď infraštruktúra partnera používa IHE XDS, ktorá indexuje dokumenty namiesto zdrojov. V ostatných prípadoch začnite s FHIR.

Keď to vyžaduje prijímajúca strana (americké prechody starostlivosti, medzinárodný súhrn pacienta MyHealth@EU a elektronický predpis dnes, rôzne národné registre dokumentov); keď je obsah právne dokumentom, ktorý musí byť podpísaný a zachovaný celý; keď je infraštruktúra partnera IHE XDS, ktorá indexuje dokumenty a nie zdroje. Vo všetkých ostatných prípadoch začnite s FHIR a vytvorte FHIR dokument tam, kde je potrebný dokument.

Súvisiace stránky

Zdroje

Časté otázky

Je FHIR dokument len CDA v JSON?

Nie. Zdieľa princípy (celý, podpísaný, čitateľný človekom, s hlavičkou), ale jeho obsah sú bežné FHIR zdroje, takže rovnaké Observation môže žiť v dokumente a byť obsluhované API. V CDA záznam existuje iba vo vnútri svojho dokumentu.

Môžem podpísať FHIR dokument?

Áno. Bundle.signature obsahuje digitálny podpis nad bundle a IPS a národné sprievodcovia popisujú ako. V praxi sa mnohé nasadenia spoliehajú na bezpečnosť prenosu a pôvod namiesto podpisov.

Má FHIR templateId?

Ekvivalentom je meta.profile, zoznam kanonických URL StructureDefinitions, ku ktorým sa zdroj hlási. Validátory kontrolujú zhodu tak, ako CDA schematrony kontrolujú šablóny.

Čo by si mal vybrať nový národný program?

Nedávne programy (formát výmeny EHDS, pravidlá prístupu pacientov v USA, IPS) si vyberajú FHIR, s FHIR dokumentmi pre súhrny a listy, a ponechávajú cestu CDA iba pre starších partnerov.

Anpheros Platform

Vyskúšajte zadarmo v sandboxe

Prvé volanie FHIR za 5 minút. API podľa štandardu HL7 FHIR R4 s integrovaným súhlasom pacienta: vyskúšajte si ho v sandboxe a potom pripojte svoju vlastnú aplikáciu alebo klinický systém.

Zadarmo · 30 syntetických pacientov · bez karty

Tento návod slúži na informačné účely a nenahrádza lekársku radu. Pri rozhodovaní o svojom zdraví sa poraďte so svojím lekárom. V núdzi volajte miestne tiesňové číslo (v Európe 112).
Napísal
Tím Anpheros

Anpheros vyvíja zdravotný záznam, ktorý pacient ovláda a môže zdieľať s akoukoľvek klinikou, na platforme HL7 FHIR R4, so sídlom v EÚ. Tieto návody vám pomôžu pochopiť a usporiadať si svoje zdravie; nenahrádzajú vášho lekára.

O Anpherose →