e-Impfpass Guide
[geprüfte Version] | [geprüfte Version] |
(→Zuordnungsmatrix Schemen - Dosiskennung - Impfstoff) |
|||
(5 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 14: | Zeile 14: | ||
! dafür gültiges <br />Schematron (*.sch) | ! dafür gültiges <br />Schematron (*.sch) | ||
|- | |- | ||
− | |2.0.0 | + | | 2.0.0+20230717 |
− | | | + | | 17.07.2023 |
− | |[[Datei:Warning.png|20px]] | + | | [[Datei:Warning.png|20px]] Normativ |
− | |noch nicht möglich, erfordert eine neue eHealth-Verordnung | + | | noch nicht möglich, erfordert eine neue eHealth-Verordnung |
− | | | + | | [[Datei:PDF.png|20px|link=https://wiki.hl7.at/images/2/2a/ILF_e-Impfpass_2.0.0%2B20230717.pdf]] |
− | |[[Datei:Schwarzer link.png|20px|link=https://wiki.hl7.at/index.php?title=ILF:E-Impfpass_(Version_2)]] | + | | [[Datei:Schwarzer link.png|20px|link=https://wiki.hl7.at/index.php?title=ILF:E-Impfpass_(Version_2)]] |
− | |[[Datei:Schwarzer link.png|20px|link=https://wiki.hl7.at/index.php?title=ILF_Diskussion:E-Impfpass_(Version_2)]] | + | | [[Datei:Schwarzer link.png|20px|link=https://wiki.hl7.at/index.php?title=ILF_Diskussion:E-Impfpass_(Version_2)]] |
| keiner, alle Elemente wurden explizit in diesem ILF modelliert | | keiner, alle Elemente wurden explizit in diesem ILF modelliert | ||
| [https://gitlab.com/elga-gmbh/cda-schema das aktuelle] | | [https://gitlab.com/elga-gmbh/cda-schema das aktuelle] | ||
Zeile 34: | Zeile 34: | ||
| keiner, alle Elemente wurden explizit in diesem ILF modelliert | | keiner, alle Elemente wurden explizit in diesem ILF modelliert | ||
| [https://gitlab.com/elga-gmbh/cda-schema/-/tree/1.3.0+20150801-2.6.0 1.3.0+20150801-2.6.0] | | [https://gitlab.com/elga-gmbh/cda-schema/-/tree/1.3.0+20150801-2.6.0 1.3.0+20150801-2.6.0] | ||
− | | [https://gitlab.com/elga-gmbh/cda-schematron/cda-eimpfpass-schematron | + | | [https://gitlab.com/elga-gmbh/cda-schematron/cda-eimpfpass-schematron/-/tree/9.14.0+20230719-1.3.1 9.14.0+20230719-1.3.1] |
|- | |- | ||
|1.3.0+20220127 | |1.3.0+20220127 | ||
Zeile 135: | Zeile 135: | ||
==Zuordnungsmatrix Schemen - Dosiskennung - Impfstoff== | ==Zuordnungsmatrix Schemen - Dosiskennung - Impfstoff== | ||
− | *Download unter: [ | + | *Download unter: [https://termgit.elga.gv.at/CodeSystem/eimpf-schemamatrix CodeSystem-eimpf-schemamatrix] |
==Design-Beispiel== | ==Design-Beispiel== | ||
Zeile 149: | Zeile 149: | ||
ELGA Interoperabilitätsstufen (EIS): Dieses Dokument existiert ausschließlich in einer voll strukturierten Form, eine Unterscheidung der Interoperabilitätsstufen ist daher nicht notwendig. | ELGA Interoperabilitätsstufen (EIS): Dieses Dokument existiert ausschließlich in einer voll strukturierten Form, eine Unterscheidung der Interoperabilitätsstufen ist daher nicht notwendig. | ||
− | [[Datei: | + | [[Datei:DLT_Grafik_KompletterImmunisierungsstatus.PNG|400px|CDA-Dokument in Ausprägung "Kompletter Immunisierungsstatus"]] |
===CDA Header=== | ===CDA Header=== | ||
Zeile 188: | Zeile 188: | ||
ELGA Interoperabilitätsstufen (EIS): Dieses Dokument existiert ausschließlich in einer voll strukturierten Form, eine Unterscheidung der Interoperabilitätsstufen ist daher nicht notwendig. | ELGA Interoperabilitätsstufen (EIS): Dieses Dokument existiert ausschließlich in einer voll strukturierten Form, eine Unterscheidung der Interoperabilitätsstufen ist daher nicht notwendig. | ||
− | [[Datei: | + | [[Datei:DLT_Grafik_UpdateImmunisierungsstatus.PNG|400px|CDA-Dokument in Ausprägung "Update Immunisierungsstatus"]] |
===CDA Header=== | ===CDA Header=== |
Version vom 20. Juli 2023, 15:04 Uhr
1 Tabellarische Übersicht der Versionen mit jeweils PDF, Wiki, Erratum
Version | Datum | Status | Anwendung in eHealth | Wiki | Erratum | dafür gültiger Allg. Leitfaden |
dafür gültiges XML Schema (*.xsd) |
dafür gültiges Schematron (*.sch) | |
---|---|---|---|---|---|---|---|---|---|
2.0.0+20230717 | 17.07.2023 | Normativ | noch nicht möglich, erfordert eine neue eHealth-Verordnung | keiner, alle Elemente wurden explizit in diesem ILF modelliert | das aktuelle | das aktuelle | |||
1.3.1+20220719 | 19.07.2022 | Normativ | Gültige Version (Patch) | keiner, alle Elemente wurden explizit in diesem ILF modelliert | 1.3.0+20150801-2.6.0 | 9.14.0+20230719-1.3.1 | |||
1.3.0+20220127 | 27.01.2022 | Nebenversion gültig seit 1.4.2022, ersetzt durch 1.3.1+20220719 | veraltet (Nebenversion von 1.0.0+20191021) | keiner, alle Elemente wurden explizit in diesem ILF modelliert | 1.3.0+20150801-2.6.0 | 9.2.0+20220627-1.3.0 | |||
1.2.0+20220103 | 03.01.2022 | Ersetzt durch 1.3.0+20220127 | veraltet (Nebenversion von 1.0.0+20191021) | keiner, alle Elemente wurden explizit in diesem ILF modelliert | 1.3.0+20150801-2.6.0 | 8.19.0+20220127-1.2.0 | |||
1.1.1+20210601 | 01.06.2021 | Ersetzt durch 1.2.0+20220103 | veraltet (Nebenversion von 1.0.0+20191021) | keiner, alle Elemente wurden explizit in diesem ILF modelliert | 1.3.0+20150801-2.6.0 | 8.12.0+20211029-1.1.1 | |||
1.1.0+20210512 | 12.05.2021 | Ersetzt durch 1.1.1+20210601 | veraltet (Nebenversion von 1.0.0+20191021) | keiner, alle Elemente wurden explizit in diesem ILF modelliert | 1.3.0+20150801-2.6.0 | 8.5.0+20210518-1.1.0 | |||
2019 (1.0.0+20191021 nach neuem Versionsschema) | 21.10.2019 | Ersetzt durch 1.1.0+20210521 | Gültig per eHealthV 2019 | keiner, alle Elemente wurden explizit in diesem ILF modelliert | 1.3.0+20150801-2.6.0 | 8.4.0+20210427-1.0.0 |
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
Für einzelne CDAs kann das Online Validator Portal unter https://ovp.elga-services.at genutzt werden, falls eigene Werkzeuge oder eine Überprüfung der CDAs im eigenen System implementiert wird, sind folgende Prüfregeln zu nutzen:
- 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: CodeSystem-eimpf-schemamatrix
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