CDA2PDF

Aus HL7 Austria MediaWiki
Wechseln zu: Navigation, Suche
[unmarkierte Version][unmarkierte Version]
(CDA2PDF V1.08.002.3)
(CDA2PDF V1.08.004 (2019-11))
 
(13 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/]
 
Der CDA2PDF Konverter kann unter folgendem Link aufgerufen werden [https://cda2pdf-elga.metis-consulting.at/]
  
Zeile 8: Zeile 8:
 
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.
 
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==
+
===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.
 
* 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.
 
* 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.
Zeile 39: Zeile 39:
  
 
Weitere Informationen unter der [https://www.elga.gv.at/ ELGA Webseite]
 
Weitere Informationen unter der [https://www.elga.gv.at/ ELGA Webseite]
 +
 
Mail an office@elga.gv.at
 
Mail an office@elga.gv.at
  
==Changelog CDA2PDF==
+
===Changelog CDA2PDF===
Hier sind alle Änderungen des CDA2PDF Konverters seit Mai 2019 aufgelistet.
+
Hier sind alle Änderungen des CDA2PDF Konverters seit Mai 2019 (absteigend nach Erscheinungsdatum) aufgelistet.
  
==CDA2PDF V1.08.002.3==
+
====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.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)
  
{| class="wikitable"
+
{| border="1" cellpadding="20" cellspacing="0"
 
!Neue Gestaltung der Anzeige
 
!Neue Gestaltung der Anzeige
 
!Type of change
 
!Type of change
 
|-
 
|-
 
|Hinweis: Da in der Druckansicht weniger Informationen dargestellt werden, wurde ein Hinweistext eingefügt
 
|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“
+
*„Weitere administrative Informationen dieses Dokuments stehen in der Online-Version zur Verfügung“
|New
+
|'''''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

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
  • „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


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