e-Impfpass Guide
[geprüfte Version] | [unmarkierte Version] |
K |
(→Tabellarische Übersicht der Versionen mit jeweils PDF, Wiki, Erratum) |
||
Zeile 11: | Zeile 11: | ||
!Erratum | !Erratum | ||
|- style="background-color:#ffffcc; | |- style="background-color:#ffffcc; | ||
+ | |1.3.1+20220719 | ||
+ | |19.07.2022 | ||
+ | |[[Datei:finished.png|20px|verweis=Special:FilePath/Finished.png]] '''Normativ - gültig seit 1.4.2022''' | ||
+ | |'''Gültige Version''' (Patch der Nebenversion 1.3.0+20220127) | ||
+ | |[[Datei:PDF.png|20px|link=https://wiki.hl7.at/images/2/28/ILF_e-Impfpass_1.3.1+20220719.pdf]] | ||
+ | |[[Datei:Schwarzer link.png|20px|link=https://wiki.hl7.at/index.php?title=ILF:E-Impfpass]] | ||
+ | |[[Datei:Schwarzer link.png|20px|link=https://wiki.hl7.at/index.php?title=ILF_Diskussion:E-Impfpass]] | ||
+ | |- | ||
|1.3.0+20220127 | |1.3.0+20220127 | ||
|27.01.2022 | |27.01.2022 | ||
− | |[[Datei: | + | |[[Datei:Deprecated.png|20px|verweis=Special:FilePath/Deprecated.png]] Normativ - gültig seit 1.4.2022, ersetzt durch Patch-Version 1.3.1+20220719 |
− | | | + | |veraltet (Nebenversion von 1.0.0+20191021) |
|[[Datei:PDF.png|20px|link=https://wiki.hl7.at/images/2/28/ILF_e-Impfpass_1.3.0%2B20220127.pdf]] | |[[Datei:PDF.png|20px|link=https://wiki.hl7.at/images/2/28/ILF_e-Impfpass_1.3.0%2B20220127.pdf]] | ||
|[[Datei:Schwarzer link.png|20px|link=https://wiki.hl7.at/index.php?title=ILF:E-Impfpass]] | |[[Datei:Schwarzer link.png|20px|link=https://wiki.hl7.at/index.php?title=ILF:E-Impfpass]] |
Version vom 21. Juli 2022, 10:24 Uhr
1 Tabellarische Übersicht der Versionen mit jeweils PDF, Wiki, Erratum
2 Was ist der e-Impfpass?
Der CDA Implementierungsleitfaden e-Impfpass beschreibt die Datenaustauschformate für den e-Impfpass in Österreich. Als Datenaustauschformate dienen zwei unterschiedliche CDA Dokumententypen:
- Kompletter Immunisierungsstatus: Das von der zentralen Anwendung abrufbare Datenaustauschformat. Es enthält alle verfügbaren Informationen zum Immunisierungsstatus einer Person (Impfungen, impfrelevante Erkrankungen, Antikörper-Bestimmungen) und Impfempfehlungen.
- Update Immunisierungsstatus: Das Datenaustauschformat, das an die zentrale Anwendung gesendet wird, um Änderungen am Immunisierungsstatus einer Person zu dokumentieren (Impfungen, impfrelevante Erkrankungen, Antikörper-Bestimmungen) sowie individuell angepasste Impfempfehlungen, die durch den impfenden Arzt festgelegt werden.
Die Beschreibung enthält Festlegungen, Einschränkungen und Bedingungen auf Grundlage von HL7 CDA-Elementen. Als Basisspezifikation wurde das "Immunization Content (IC)" Inhaltsprofil aus dem IHE Technical Framework "Patient Care Coordination (PCC)" ausgewählt.
3 Unterstützende Materialien
3.1 Art-Decor Templates
Die im CDA Implementierungsleitfaden e-Impfpass angeführten Templatespezifikationen wurden im Art-Decor Projektrepository e-Impfpass erstellt und können dort eingesehen werden. Eine Anleitung zum Verständnis der Art-Decor-Notation finden Sie im Artikel Art-Decor-Tabellen verstehen.
3.2 Prüfregeln
- Das CDA Schema, definiert die Strukturen für alle HL7 Austria CDA-Dokumente. Das CDA Schema ist für alle speziellen CDA Leitfäden der HL7 Austria dasselbe und kann zum Validieren der groben Struktur des CDAs verwendet werden.
- Diese Prüfregeln sind performant und gegen diese sollte an jeder Stelle einer Bearbeitung eines CDAs geprüft werden.
- Download unter: https://gitlab.com/elga-gmbh/cda-schema
- Die CDA eImpfpass-Schematron, definiert die Strukturen und Inhalte nach dem speziellen HL7 Austria CDA-Leitfaden "e-Impfpass".
- Diese Prüfregeln fassen alle Regeln für das e-Impfpass-CDA zusammen. Es ist zu empfehlen am Ende des Bearbeitungsprozesses diese einmalig gegen das abgeschlossene CDA zu stellen und im Falle eines Fehlers diesen zu bearbeiten.
- Download unter: https://gitlab.com/elga-gmbh/cda-schematron/cda-eimpfpass-schematron
- Das CDA Gesamt-Schematron ergänzt das CDA Schema und definiert die Strukturen und Inhalte mehrerer spezieller HL7 Austria CDA-Leitfaden. Darunter fallen die Basisleitfäden, der eImpfpass, die eMedikation, der Telemonitoring-Episodenbreicht und der Ambulanzbefund.
- Dieses Prüfregeln-Set ist das größte und kann sich merklich auf die Performance auswirken. Es ist zu empfehlen dieses nur außerhalb eines Workflows einzusetzen. Z.B. wenn eine Kontrolle über bestimmte vorhandenen CDAs durchgeführt werden muss, ohne das diese eine zeitliche Abhängigkeit hat / darauf gewartet werden muss.
- Download unter: https://gitlab.com/elga-gmbh/cda-schematron/cda-gesamt-schematron
3.3 Terminologien
Die aktuellen Value Sets werden auf dem Terminologieserver bereitgestellt.
3.4 Beispiel-Dokumente
(Das enthaltene Stylesheet ist nicht notwendigerweise das aktuellste e-Impfpass Stylesheet. Aktuellste Version des Stylesheets siehe Visualisierung)
3.5 Visualisierung
Für die Darstellung der e-Impfpass-Dokumente wird ein eigenes Stylesheet bereitgestellt
- Download unter: https://gitlab.com/elga-gmbh/CDA_Visualization/-/tree/master/ELGA_eimpf_Referenzstylesheet
3.6 Zuordnungsmatrix Schemen - Dosiskennung - Impfstoff
- Download unter: Zuordnungsmatrix Impfschemas - Dosiskennung - Impfstoff
3.7 Design-Beispiel
Hier finden Sie ein Beispiel des Kompletten Immunisierungsstatus zur Ansicht:
4 Zusammenfassung
4.1 Übersicht CDA Struktur "Kompletter Immunisierungsstatus"
Die Struktur des CDA Austauschformats ist in den nachfolgenden Kapiteln im Detail beschrieben. Zum schnellen Einstieg findet sich hier eine stark vereinfachte Zusammenfassung der Elemente. Dieses Dokument kann von der zentralen Anwendung "e-Impfpass" angefragt werden. Es enthält alle gespeicherten Informationen zum Immunisierungsstatus der Person und wird jeweils aktuell erzeugt ("On-Demand-Dokument").
ELGA Interoperabilitätsstufen (EIS): Dieses Dokument existiert ausschließlich in einer voll strukturierten Form, eine Unterscheidung der Interoperabilitätsstufen ist daher nicht notwendig.
4.1.1 CDA Header
Der Header enthält die (administrativen) Dokument-Metadaten
- Allgemeine Dokumentinformationen: Dokumenten-Id, Code, Titel, Erstellungszeitpunkt, Sprache, Version
- "Impfling" Angaben zur Person (Patient), deren Immunisierungsstatus beschrieben wird: Name, Geburtsdatum, Geschlecht, Identifikatoren, Adresse und Kontaktdaten, ...
- Mitwirkende am Dokument: Autoren, Schreibkraft, Verwalter, Unterzeichner
- Related Document: Verweis auf ein allfällig ersetztes Dokument (Vorversion)
Der Header entspricht im Wesentlichen den bisherigen ELGA-CDA-Leitfäden ("Allgemeiner Leitfaden"). Für den e-Impfpass wurden punktuell Neuerungen eingeführt:
- TemplateIds für die Versionskennung
- Zusätzliches Translation-Element für den clinicalDocument.code
Hinweis: Einige Header-Elemente des Allgemeinen Leitfadens werden hier nicht benötigt [NP], sind aber der Vollständigkeit halber angegeben. [NP]-Elemente dürfen nicht angegeben werden, bzw. sind zu ignorieren. Beispiele: Data Enterer, Authorization, LegalAuthenticator, ...
4.1.2 CDA Body
Der "Structured Body" enthält die tatsächlichen (medizinischen) Inhalte des Dokuments
- Kapitel Impfungen: Sammlung der dokumentierten Impfungen
- Impfung, Impfdatum, Impfstoff, Impfschema und Dosisnummer, Impfstelle, Krankheit gegen welche die Impfung schützt, PZN, Chargennummer (LOT-Nr), Dosierung und weitere Angaben zur Verabreichung (Teilnehmende Personen)
- Kapitel Personengruppe: Dokumentiert die Zugehörigkeit zu speziellen Personengruppen.
- Personengruppe, Datumsbereich der Zugehörigkeit zur Gruppe
- Kapitel Impfrelevante Erkrankungen: Sammlung der dokumentierten impfrelevanten Erkrankungen
- Erkrankung, Datumsbereich
- Kapitel Antikörper-Untersuchungen: Sammlung der dokumentierten Antikörper-Bestimmungen
- Untersuchung, Wert, Bewertung, Datum
- Kapitel Impfempfehlungen: Sammlung der dokumentierten Impfempfehlungen (automatisch erstellte sowie vom Impfarzt individuell empfohlene)
- Strukturell wie Impfungen, mit anderen Pflichtfeldern und anderem Status
Anmerkung: Impfreaktionen werden in der derzeit geplanten Pilot-Umsetzung nicht unterstützt.
4.2 Übersicht CDA Struktur "Update Immunisierungsstatus"
Die Struktur des CDA Austauschformats ist in den nachfolgenden Kapiteln im Detail beschrieben. Zum schnellen Einstieg findet sich hier eine stark vereinfachte Zusammenfassung der Elemente.
Dieses Dokument wird vom impfenden GDA erstellt und an die zentrale Applikation gesendet. Es enthält die Informationen, die der GDA bei einem Besuch dokumentiert. Es kann Impfungen, Impfempfehlungen, impfrelevante Erkrankungen, Antikörperbestimmungen, etc enthalten.
ELGA Interoperabilitätsstufen (EIS): Dieses Dokument existiert ausschließlich in einer voll strukturierten Form, eine Unterscheidung der Interoperabilitätsstufen ist daher nicht notwendig.
4.2.1 CDA Header
Der Header enthält die (administrativen) Dokument-Metadaten
- Allgemeine Dokumentinformationen: Dokumenten-Id, Code, Titel, Erstellungszeitpunkt, Sprache, Version
- "Impfling" Angaben zur Person (Patient), deren Immunisierungsstatus beschrieben wird: Name, Geburtsdatum, Geschlecht, Identifikatoren, Adresse und Kontaktdaten, ...
- Mitwirkende am Dokument: Autoren, Erfasser, Verwalter, Unterzeichner
- Related Document: Verweis auf ein allfällig ersetztes Dokument (Vorversion)
Der Header entspricht im Wesentlichen den bisherigen ELGA-CDA-Leitfäden ("Allgemeiner Leitfaden"). Für den e-Impfpass wurden punktuell Neuerungen eingeführt:
- TemplateIds für die Versionskennung
- Zusätzliches Translation-Element für den clinicalDocument.code
4.2.2 CDA Body
Der "Structured Body" enthält die tatsächlichen (medizinischen) Inhalte des Dokuments
- Kapitel Impfungen: Sammlung der dokumentierten Impfungen
- Impfung, Impfdatum, Impfstoff, Impfschema und Dosisnummer, Impfstelle, Krankheit gegen welche die Impfung schützt, PZN, Chargennummer (LOT-Nr), Dosierung und weitere Angaben zur Verabreichung (Teilnehmende Personen)
- Kapitel Personengruppe: Dokumentiert die Zugehörigkeit zu speziellen Personengruppen.
- Personengruppe, Datumsbereich der Zugehörigkeit zur Gruppe
- Kapitel Impfrelevante Erkrankungen: Sammlung der dokumentierten impfrelevanten Erkrankungen
- Erkrankung, Datumsbereich
- Kapitel Antikörper-Bestimmungen: Sammlung der dokumentierten Laboruntersuchungen der impfrelevanten Antikörper ("Impftiter")
- Untersuchung, Wert, Bewertung, Datum
- Kapitel Impfempfehlungen: Vom Impfarzt individuell empfohlene Impfungstermine, wenn abweichend von den automatisch erstellten Impfempfehlungen
- Strukturell wie Impfungen, mit anderen Pflichtfeldern und anderem Status