CDA2PDF
[unmarkierte Version] | [unmarkierte Version] |
(→Known Issues) |
(→CDA2PDF V1.08.004 (2019-11)) |
||
(16 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
{{#customtitle:CDA2PDF}} | {{#customtitle:CDA2PDF}} | ||
− | =CDA2PDF Konverter | + | ==CDA2PDF Konverter== |
− | + | Der CDA2PDF Konverter kann unter folgendem Link aufgerufen werden [https://cda2pdf-elga.metis-consulting.at/] | |
− | |||
− | |||
− | |||
− | === | + | Das WAR-File kann auf einem Web Application Server eingespielt und verwendet werden (getestet mit Apache Tomcat ab Version 7.0). |
− | + | Das CDA2PDFOffline Paket steht auch zur offline-Nutzung zur Verfügung (CDA2PDFOffline.zip). | |
− | * | + | |
− | * | + | Die ELGA GmbH stellt den ELGA CDA2PDF Konverter unentgeltlich zur Verfügung. Die ELGA GmbH übernimmt keine Haftung für die korrekte Funktion, für etwaige Mängel, Schäden oder Folgefehler. Aus der Verwendung des vorliegenden Programmes kann keinerlei Rechtsanspruch gegen die ELGA GmbH erhoben und/oder abgeleitet werden. |
− | * | + | |
− | * | + | ===Hinweise zur Anwendung=== |
− | * | + | * Um Headerdaten in der Darstellung auszublenden (Die Anzeige beginnt dann direkt beim Ersteller/Empfänger) muss das Attribut "hideheader" mit dem Wert 1 mit übergeben werden. |
− | * | + | * Standardmäßig wird eingefügter Text normal, gelöschter Text nicht dargestellt. Es gibt die Möglichkeit, eingefügten Text unterstrichen und kursiv, gelöschten Text durchgestrichen darzustellen. Dem Servlet muss dafür das Attribut "showrevisionmarks" mit dem Wert 1 übergeben werden. |
− | * | + | Beispiele: |
+ | <content revised="insert">Eingefügter Text</content> | ||
+ | <content revised="delete">GelöschterText </content> | ||
+ | * Es kann zwischen einer normalen und einer vollständigen PDF-Variante gewählt werden. Die "normale" Version enthält Folgendes nicht: | ||
+ | ** Bereich ab Allgemeine Daten bis einschließlich Aufenthalt | ||
+ | ** Zusätzliche Informationen über dieses Dokument | ||
+ | * Der Status des Dokuments kann gewählt werden (aktuelles bzw. storniertes Dokument) | ||
+ | * Der angemeldete Benutzer kann übergeben werden | ||
+ | * Die Originaldatei kann optional eingebettet werden (PDF-A3) | ||
+ | * Der Konverter generiert eine PDF/A-1a Datei, was spezielle Einschränkungen mit sich bringt, u.a. sind aus diesem Grund transparente Grafiken in der Originaldatei nicht erlaubt | ||
+ | * Tabellen mit ungleicher Spaltenanzahl können nicht ausgegeben werden | ||
+ | * Der Tabellenheader kann bei Tabellen über mehrere Seiten am Beginn jeder Seite wiederholt werden (Option repeattableheader) | ||
ACHTUNG, für das Setzen der folgenden Optionen beachten Sie bitte die untenstehenden Hinweise! | ACHTUNG, für das Setzen der folgenden Optionen beachten Sie bitte die untenstehenden Hinweise! | ||
Zeile 27: | Zeile 35: | ||
Das Umstellen dieser beiden Optionen ist aus haftungsrechtlichen Gründen dringend mit dem Verantwortlichen/Ihrem Vorgesetzten abzustimmen. Bei Fragen wenden Sie sich an cda@elga.gv.at. | Das Umstellen dieser beiden Optionen ist aus haftungsrechtlichen Gründen dringend mit dem Verantwortlichen/Ihrem Vorgesetzten abzustimmen. Bei Fragen wenden Sie sich an cda@elga.gv.at. | ||
− | Das ELGA | + | Die ELGA GmbH weist ausdrücklich darauf hin, dass die Nutzung des vorliegenden Programmes freiwillig und in ausschließlicher Verantwortung der Anwender erfolgt. |
− | + | Das Ausblenden des ELGA-Logos mit dem Parameter hideFooterLogo() ist für Befunde, die in ELGA registriert werden, nicht gestattet. | |
− | |||
− | |||
− | |||
− | + | Weitere Informationen unter der [https://www.elga.gv.at/ ELGA Webseite] | |
− | |||
− | + | Mail an office@elga.gv.at | |
− | |||
− | |||
− | |||
− | + | ===Changelog CDA2PDF=== | |
+ | Hier sind alle Änderungen des CDA2PDF Konverters seit Mai 2019 (absteigend nach Erscheinungsdatum) aufgelistet. | ||
− | + | ====CDA2PDF V1.09.002 (2020-04)==== | |
+ | Getestet mit den folgenden Browsern: | ||
+ | * Firefox Version 75.0 (64-Bit) | ||
+ | * Microsoft Edge 44.17763.831.0 | ||
+ | * Google Chrome Version 81.0.4044.113 (64-Bit) | ||
− | == | + | '''Änderungen in diesem Release''' |
− | + | * Verbesserte Darstellung von Aufnahmezahl und Geburtsdatum im Patienten-Header | |
+ | ** Geburtsdatum wird in der Patienten-Box vor der SV-Nummer angezeigt (zur Erleichterung der administrativen Prozesse) | ||
+ | ** Aufnahmezahl (AZ) bzw. Fallzahl (FZ) werden in den Aufenthalt-Box dargestellt | ||
+ | * Einführung des Parameters „showPDFCreationInformation“ zur Anzeige der PDF-Erzeugungsinformationen | ||
+ | * Verbesserte Formatierungsmöglichkeiten in der Allergie-Sektion | ||
+ | ** Tabellarischen Darstellung der Allergie-Sektion | ||
+ | * Verbesserte Darstellung von Abschnitten im Stylecode "xELGA_monospaced" | ||
+ | * Verbesserte Anzeige der gesetzlichen Vertreter | ||
+ | ** Neue Bezeichnung: „Gesetzlicher Vertreter: Erwachsenenvertreter, Vormund, Obsorgeberechtigter“ | ||
+ | * Verbesserte Darstellung des Geschlechts mit Nullflavor | ||
+ | ** administrativeGenderCode NullFlavor=“UNK“ --> „Unbekannt“ | ||
+ | ** administrativeGenderCode NullFlavor=“NA“ --> „Offen“ | ||
− | ==CDA2PDF V1.08.002.3== | + | ====CDA2PDF V1.08.004 (2019-11)==== |
+ | Getestet mit den folgenden Browsern: | ||
+ | * Microsoft Edge 44.17763.771.0 | ||
+ | * Firefox Version 69.0 (64-Bit) | ||
+ | * Google Chrome Version 78.0.3904.87 (64-Bit) | ||
+ | |||
+ | '''Änderungen in diesem Release''' | ||
+ | * Bugfix: Fehlerhafte Darstellung von CDA2PDF mit Microsoft Edge behoben | ||
+ | * Optimierte Darstellung des Zeitraums bei ambulanten Besuchen | ||
+ | * Darstellung von CDA Attachments in CDA2PDF | ||
+ | ** Option "Originales CDA-Dokument einbetten" siehe Doku -> Parameter -> attachCDAToPDF() | ||
+ | <entry> | ||
+ | <observationMedia classCode="OBS" moodCode="EVN” ID="embeddedCDA1"> | ||
+ | <templateId root="1.2.40.0.34.11.1.3.1" assigningAuthorityName="ELGA"/> | ||
+ | <value mediaType="text/xml" representation="B64">...</value> | ||
+ | </observationMedia> | ||
+ | </entry> | ||
+ | |||
+ | ====CDA2PDF V1.08.003 (2019-09)==== | ||
+ | Getestet mit den folgenden Browsern: | ||
+ | * Microsoft Edge 44.17763.1.0 | ||
+ | * Firefox Version 69.0 (64-Bit) | ||
+ | * Google Chrome Version 77.0.3865.75 (64-Bit) | ||
+ | |||
+ | '''Änderungen in diesem Release''' | ||
+ | * Bugfix: Absturz von CDA2PDF Konverter bei sehr langen Tabellen behoben | ||
+ | * Verbesserte Anzeige von unbekannten Ländercodes | ||
+ | ** Unbekannte Ländercodes werden nur mehr als Code angezeigt | ||
+ | * Der Hintergrund von Section-Überschriften kann mittels Parameter (param_sectionTitleWhiteBackgroundColor) gesteuert werden | ||
+ | * Verbesserte Anzeige des Datums bei „Unterzeichnet von“ (/ClinicalDocument/author[1]/assignedAuthor[1]) | ||
+ | ** Anstelle von „unbekannt“ wird kein Datum angezeigt, wenn kein Datum eingetragen wurde | ||
+ | |||
+ | ====CDA2PDF V1.08.002.3 (2019-05)==== | ||
Getestet mit den folgenden Browsern: | Getestet mit den folgenden Browsern: | ||
* Microsoft Edge 42.17134.1.0 | * Microsoft Edge 42.17134.1.0 | ||
* Firefox Version 66.0.5 (64-Bit) | * Firefox Version 66.0.5 (64-Bit) | ||
+ | |||
+ | {| border="1" cellpadding="20" cellspacing="0" | ||
+ | !Neue Gestaltung der Anzeige | ||
+ | !Type of change | ||
+ | |- | ||
+ | |Hinweis: Da in der Druckansicht weniger Informationen dargestellt werden, wurde ein Hinweistext eingefügt | ||
+ | *„Weitere administrative Informationen dieses Dokuments stehen in der Online-Version zur Verfügung“ | ||
+ | |'''''New''''' | ||
+ | |- | ||
+ | |Section.Title Zeile mit Farbhintergrund angezeigt | ||
+ | |'''''New''''' | ||
+ | |- | ||
+ | |Tabellen | ||
+ | * Rahmen entfernt | ||
+ | * Header farblich dargestellt | ||
+ | * Body in Zebra-Muster dargestellt (alternierend gefärbte Zeilen) | ||
+ | * Trennlinien zwischen den Zeilen | ||
+ | |'''''New''''' | ||
+ | |- | ||
+ | |Erzeugt „Tagged PDF“ | ||
+ | |'''''New''''' | ||
+ | |- | ||
+ | |Ersteller/ Empfängerbox (/ClinicalDocument/participant typeCode="REF") wurde entfernt (Ausnahme: Laborbefund, eigene Auftraggeberbox vorhanden) | ||
+ | |'''Removed''' | ||
+ | |- | ||
+ | |Dialog „Keine Warnung“ wurde entfernt | ||
+ | |'''Removed''' | ||
+ | |- | ||
+ | |Rahmen der Boxen wurden entfernt | ||
+ | |'''Removed''' | ||
+ | |- | ||
+ | |Schriftgröße und Abstände reduziert | ||
+ | |Changed | ||
+ | |- | ||
+ | |Patientenbox (/ClinicalDocument/recordTarget): Titel, Name, Abkürzung des Geschlechts, SV-Nummer, Anzeige des Icons für gesetzliche Vertreter, wenn vorhanden | ||
+ | |Changed | ||
+ | |- | ||
+ | |Aufenthaltsbox (/ClinicalDocument/componentOf/encompassingEncounter) getrennt von Patientenbox: Einrichtung und Aufenthaltsdauer | ||
+ | |Changed | ||
+ | |- | ||
+ | |Weniger Einrückung des Textes | ||
+ | |Changed | ||
+ | |- | ||
+ | |Inhalt der Section Allergien wird bereits in der gelben „Warnungsbox“ angezeigt | ||
+ | |Changed | ||
+ | |- | ||
+ | |Box „Bei Fragen kontaktieren Sie bitte“ (/ClinicalDocument/participant typeCode="CALLBCK"): Name, Telefonnummer | ||
+ | |Changed | ||
+ | |- | ||
+ | |Unterzeichnerbox (/ClinicalDocument/legalAuthenticator; /ClinicalDocument/authenticator): alle Unterzeichner werden in einer Box eingetragen, ersichtlich sind die Namen und das Datum | ||
+ | |Changed | ||
+ | |- | ||
+ | |Kopfzeile verkleinert: Logo und Text wurden verkleinert | ||
+ | |Changed | ||
+ | |- | ||
+ | |Dezentere Farbauswahl | ||
+ | |Changed | ||
+ | |- | ||
+ | |Die Anzeigelogik für das Icon „gesetzlicher Vertreter“ in der Patientenbox wurde optimiert (/ClinicalDocument/recordTarget/patientRole/patient/guardian) | ||
+ | |Changed | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | {| border="1" cellpadding="20" cellspacing="0" | ||
+ | !Neue Funktionalitäten | ||
+ | !Type of change | ||
+ | |- | ||
+ | |„PDF-Anhänge bei EIS Basic Befunden am Ende des Dokuments anzeigen“ (Option: unstructuredBodyLast) | ||
+ | * Bei CDA EIS Basic Befunden mit UnstructuredBody wird das im Body enthaltene PDF (Content) zuerst angezeigt und danach erst die CDA Metadaten | ||
+ | |'''''New''''' | ||
+ | |- | ||
+ | |„Ohne Attachment“ (Option: excludeAttachments) | ||
+ | * PDF wird durch Aktivierung dieses Parameters ohne Anhänge angezeigt | ||
+ | |'''''New''''' | ||
+ | |- | ||
+ | |„Briefdruck“ (Option: addAddressForLetter) | ||
+ | * Ein Deckblatt mit Empfängeradresse wird erzeugt | ||
+ | * Als Empfänger wird das Element „Primärer Empfänger“ verwendet (/ClinicalDocument/informationRecipient typeCode="PRCP") | ||
+ | * Positionierung der Adresse passend für Sichtfensterkuverts (DIN C4 Versandtasche mit Fenster) | ||
+ | * PDF wurde für den postalischen Briefversand optimiert | ||
+ | |'''''New''''' | ||
+ | |- | ||
+ | |„Volle Druckansicht“ (Option: fullDocument) | ||
+ | * In der Vergangenheit wurde standardmäßig das gesamte Dokument in PDF ausgegeben | ||
+ | * In der Vergangenheit konnte eine verkürzte Druckansicht eingestellt werden | ||
+ | * Mit dem neuen Release ist die Standardeinstellung die reduzierte Druckansicht und per Option kann eine vollständige Druckansicht (gesamtes Dokument) ausgegeben werden | ||
+ | |'''''New''''' | ||
+ | |} |
Aktuelle Version vom 2. Juli 2020, 10:34 Uhr
Inhaltsverzeichnis
1 CDA2PDF Konverter
Der CDA2PDF Konverter kann unter folgendem Link aufgerufen werden [1]
Das WAR-File kann auf einem Web Application Server eingespielt und verwendet werden (getestet mit Apache Tomcat ab Version 7.0). Das CDA2PDFOffline Paket steht auch zur offline-Nutzung zur Verfügung (CDA2PDFOffline.zip).
Die ELGA GmbH stellt den ELGA CDA2PDF Konverter unentgeltlich zur Verfügung. Die ELGA GmbH übernimmt keine Haftung für die korrekte Funktion, für etwaige Mängel, Schäden oder Folgefehler. Aus der Verwendung des vorliegenden Programmes kann keinerlei Rechtsanspruch gegen die ELGA GmbH erhoben und/oder abgeleitet werden.
1.1 Hinweise zur Anwendung
- Um Headerdaten in der Darstellung auszublenden (Die Anzeige beginnt dann direkt beim Ersteller/Empfänger) muss das Attribut "hideheader" mit dem Wert 1 mit übergeben werden.
- Standardmäßig wird eingefügter Text normal, gelöschter Text nicht dargestellt. Es gibt die Möglichkeit, eingefügten Text unterstrichen und kursiv, gelöschten Text durchgestrichen darzustellen. Dem Servlet muss dafür das Attribut "showrevisionmarks" mit dem Wert 1 übergeben werden.
Beispiele: <content revised="insert">Eingefügter Text</content> <content revised="delete">GelöschterText </content>
- Es kann zwischen einer normalen und einer vollständigen PDF-Variante gewählt werden. Die "normale" Version enthält Folgendes nicht:
- Bereich ab Allgemeine Daten bis einschließlich Aufenthalt
- Zusätzliche Informationen über dieses Dokument
- Der Status des Dokuments kann gewählt werden (aktuelles bzw. storniertes Dokument)
- Der angemeldete Benutzer kann übergeben werden
- Die Originaldatei kann optional eingebettet werden (PDF-A3)
- Der Konverter generiert eine PDF/A-1a Datei, was spezielle Einschränkungen mit sich bringt, u.a. sind aus diesem Grund transparente Grafiken in der Originaldatei nicht erlaubt
- Tabellen mit ungleicher Spaltenanzahl können nicht ausgegeben werden
- Der Tabellenheader kann bei Tabellen über mehrere Seiten am Beginn jeder Seite wiederholt werden (Option repeattableheader)
ACHTUNG, für das Setzen der folgenden Optionen beachten Sie bitte die untenstehenden Hinweise!
- strict mode: wenn aktiviert, werden ungültige Dokumente nicht angezeigt (default: aktiviert)
- showTableInBestGuess: wenn aktiviert, werden ungültige Tabellen angezeigt ("in best guess mode") (default: deaktiviert)
ACHTUNG: Für das Setzen der Optionen strict mode: disabled und showTableInBestGuess: enabled ist unbedingt Folgendes zu beachten: Mit dieser Einstellung werden auch ungültige Tabellen, z.B.: mit unterschiedlicher Spaltenanzahl innerhalb einer Tabelle im "best guess" Modus angezeigt. Der Inhalt kann dadurch unter Umständen fehlerhaft interpretiert werden. Diese Tabellen werden durch das Stylesheet mit einem Warnhinweis versehen angezeigt. Das Umstellen dieser beiden Optionen ist aus haftungsrechtlichen Gründen dringend mit dem Verantwortlichen/Ihrem Vorgesetzten abzustimmen. Bei Fragen wenden Sie sich an cda@elga.gv.at.
Die ELGA GmbH weist ausdrücklich darauf hin, dass die Nutzung des vorliegenden Programmes freiwillig und in ausschließlicher Verantwortung der Anwender erfolgt. Das Ausblenden des ELGA-Logos mit dem Parameter hideFooterLogo() ist für Befunde, die in ELGA registriert werden, nicht gestattet.
Weitere Informationen unter der ELGA Webseite
Mail an office@elga.gv.at
1.2 Changelog CDA2PDF
Hier sind alle Änderungen des CDA2PDF Konverters seit Mai 2019 (absteigend nach Erscheinungsdatum) aufgelistet.
1.2.1 CDA2PDF V1.09.002 (2020-04)
Getestet mit den folgenden Browsern:
- Firefox Version 75.0 (64-Bit)
- Microsoft Edge 44.17763.831.0
- Google Chrome Version 81.0.4044.113 (64-Bit)
Änderungen in diesem Release
- Verbesserte Darstellung von Aufnahmezahl und Geburtsdatum im Patienten-Header
- Geburtsdatum wird in der Patienten-Box vor der SV-Nummer angezeigt (zur Erleichterung der administrativen Prozesse)
- Aufnahmezahl (AZ) bzw. Fallzahl (FZ) werden in den Aufenthalt-Box dargestellt
- Einführung des Parameters „showPDFCreationInformation“ zur Anzeige der PDF-Erzeugungsinformationen
- Verbesserte Formatierungsmöglichkeiten in der Allergie-Sektion
- Tabellarischen Darstellung der Allergie-Sektion
- Verbesserte Darstellung von Abschnitten im Stylecode "xELGA_monospaced"
- Verbesserte Anzeige der gesetzlichen Vertreter
- Neue Bezeichnung: „Gesetzlicher Vertreter: Erwachsenenvertreter, Vormund, Obsorgeberechtigter“
- Verbesserte Darstellung des Geschlechts mit Nullflavor
- administrativeGenderCode NullFlavor=“UNK“ --> „Unbekannt“
- administrativeGenderCode NullFlavor=“NA“ --> „Offen“
1.2.2 CDA2PDF V1.08.004 (2019-11)
Getestet mit den folgenden Browsern:
- Microsoft Edge 44.17763.771.0
- Firefox Version 69.0 (64-Bit)
- Google Chrome Version 78.0.3904.87 (64-Bit)
Änderungen in diesem Release
- Bugfix: Fehlerhafte Darstellung von CDA2PDF mit Microsoft Edge behoben
- Optimierte Darstellung des Zeitraums bei ambulanten Besuchen
- Darstellung von CDA Attachments in CDA2PDF
- Option "Originales CDA-Dokument einbetten" siehe Doku -> Parameter -> attachCDAToPDF()
<entry> <observationMedia classCode="OBS" moodCode="EVN” ID="embeddedCDA1"> <templateId root="1.2.40.0.34.11.1.3.1" assigningAuthorityName="ELGA"/> <value mediaType="text/xml" representation="B64">...</value> </observationMedia> </entry>
1.2.3 CDA2PDF V1.08.003 (2019-09)
Getestet mit den folgenden Browsern:
- Microsoft Edge 44.17763.1.0
- Firefox Version 69.0 (64-Bit)
- Google Chrome Version 77.0.3865.75 (64-Bit)
Änderungen in diesem Release
- Bugfix: Absturz von CDA2PDF Konverter bei sehr langen Tabellen behoben
- Verbesserte Anzeige von unbekannten Ländercodes
- Unbekannte Ländercodes werden nur mehr als Code angezeigt
- Der Hintergrund von Section-Überschriften kann mittels Parameter (param_sectionTitleWhiteBackgroundColor) gesteuert werden
- Verbesserte Anzeige des Datums bei „Unterzeichnet von“ (/ClinicalDocument/author[1]/assignedAuthor[1])
- Anstelle von „unbekannt“ wird kein Datum angezeigt, wenn kein Datum eingetragen wurde
1.2.4 CDA2PDF V1.08.002.3 (2019-05)
Getestet mit den folgenden Browsern:
- Microsoft Edge 42.17134.1.0
- Firefox Version 66.0.5 (64-Bit)
Neue Gestaltung der Anzeige | Type of change |
---|---|
Hinweis: Da in der Druckansicht weniger Informationen dargestellt werden, wurde ein Hinweistext eingefügt
|
New |
Section.Title Zeile mit Farbhintergrund angezeigt | New |
Tabellen
|
New |
Erzeugt „Tagged PDF“ | New |
Ersteller/ Empfängerbox (/ClinicalDocument/participant typeCode="REF") wurde entfernt (Ausnahme: Laborbefund, eigene Auftraggeberbox vorhanden) | Removed |
Dialog „Keine Warnung“ wurde entfernt | Removed |
Rahmen der Boxen wurden entfernt | Removed |
Schriftgröße und Abstände reduziert | Changed |
Patientenbox (/ClinicalDocument/recordTarget): Titel, Name, Abkürzung des Geschlechts, SV-Nummer, Anzeige des Icons für gesetzliche Vertreter, wenn vorhanden | Changed |
Aufenthaltsbox (/ClinicalDocument/componentOf/encompassingEncounter) getrennt von Patientenbox: Einrichtung und Aufenthaltsdauer | Changed |
Weniger Einrückung des Textes | Changed |
Inhalt der Section Allergien wird bereits in der gelben „Warnungsbox“ angezeigt | Changed |
Box „Bei Fragen kontaktieren Sie bitte“ (/ClinicalDocument/participant typeCode="CALLBCK"): Name, Telefonnummer | Changed |
Unterzeichnerbox (/ClinicalDocument/legalAuthenticator; /ClinicalDocument/authenticator): alle Unterzeichner werden in einer Box eingetragen, ersichtlich sind die Namen und das Datum | Changed |
Kopfzeile verkleinert: Logo und Text wurden verkleinert | Changed |
Dezentere Farbauswahl | Changed |
Die Anzeigelogik für das Icon „gesetzlicher Vertreter“ in der Patientenbox wurde optimiert (/ClinicalDocument/recordTarget/patientRole/patient/guardian) | Changed |
Neue Funktionalitäten | Type of change |
---|---|
„PDF-Anhänge bei EIS Basic Befunden am Ende des Dokuments anzeigen“ (Option: unstructuredBodyLast)
|
New |
„Ohne Attachment“ (Option: excludeAttachments)
|
New |
„Briefdruck“ (Option: addAddressForLetter)
|
New |
„Volle Druckansicht“ (Option: fullDocument)
|
New |