ELGA Referenz-Stylesheet: Unterschied zwischen den Versionen

Aus HL7 Austria MediaWiki
Wechseln zu: Navigation, Suche
[unmarkierte Version][unmarkierte Version]
K (Darstellung von fehlerhaft formatierten Tabellen)
(Optionen)
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
=ELGA Referenz-Stylesheet=
 
=ELGA Referenz-Stylesheet=
  
Seite in Arbeit
+
'''Seite in Arbeit'''
  
Das ELGA Referenz-Stylesheet ermöglicht die Darstellung von CDA Dokumenten in einem üblichen Browser. Dabei werden die XML-Dateien mit einer XST-Transformation in HTML umgewandelt.  
+
Das "ELGA Referenz-Stylesheet" ermöglicht eine allgemeine, einheitliche und benutzerfreundliche Darstellung von medizinischen CDA-Dokumenten (HL7 CDA Release 2.0), die gemäß der Vorgaben der ELGA CDA Implementierungsleitfäden erstellt wurden. Dabei werden die XML-Dateien mit einer XST-Transformation in HTML umgewandelt.  
Download von [https://www.elga.gv.at/CDA www.elga.gv.at/CDA]
 
  
 
--------------------
 
 
==Nutzungsbedingungen==
 
==Nutzungsbedingungen==
 
Das "ELGA Referenz-Stylesheet" wird von der ELGA GmbH bis auf Widerruf unentgeltlich und nicht-exklusiv sowie zeitlich und örtlich unbegrenzt, jedoch beschränkt auf Verwendungen für die Zwecke der "Clinical Document Architecture" (CDA) zur Verfügung gestellt. Veränderungen für die lokale Verwendung sind zulässig. Derartige Veränderungen (sogenannte bearbeitete Fassungen) dürfen ihrerseits publiziert und Dritten zur Weiterverwendung und Bearbeitung zur Verfügung gestellt werden.  
 
Das "ELGA Referenz-Stylesheet" wird von der ELGA GmbH bis auf Widerruf unentgeltlich und nicht-exklusiv sowie zeitlich und örtlich unbegrenzt, jedoch beschränkt auf Verwendungen für die Zwecke der "Clinical Document Architecture" (CDA) zur Verfügung gestellt. Veränderungen für die lokale Verwendung sind zulässig. Derartige Veränderungen (sogenannte bearbeitete Fassungen) dürfen ihrerseits publiziert und Dritten zur Weiterverwendung und Bearbeitung zur Verfügung gestellt werden.  
Zeile 14: Zeile 11:
  
 
==Optionen==
 
==Optionen==
Das Verhalten des Referenzstylesheets kann über folgende Optionen gesteuert werden:
+
Das Verhalten des ELGA Referenz-Stylesheets kann über Parameter umfangreich gesteuert werden. Neue Parameter können von Benutzern gemeldet werden und nach einer umfangreichen Prüfung, werden nützliche Parameter in das ELGA Referenz-Stylesheet aufgenommen. Durch die regelmäßigen Anpassungen und Weiterentwicklungen des Referenz-Stylesheets erscheinen in einem Jahr mind. zwei neue Versionen. Die aktuellste Version und die Vorgängerversion können auf der ELGA Webseite unter dem Reiter "Technischer Hintergrund" > "Technische ELGA-Leitfäden" ([https://www.elga.gv.at/technischer-hintergrund/technische-elga-leitfaeden/]) als "CDA Visualization" bzw. CDA Visualization (Vorgängerversion JJJJ-MM) heruntergeladen werden.
 +
 
 
* ShowRevisionMarks: eingefügten und gelöschten Text anzeigen
 
* ShowRevisionMarks: eingefügten und gelöschten Text anzeigen
* HideHeader: Header-Daten ausblenden
+
** Default: eingefügter Text wird normal, gelöschter Text nicht dargestellt.
* use external css: Externes CSS aktivieren
+
** Mit Parameter: eingefügter Text unterstrichen und kursiv, gelöschter Text durchgestrichen
* print icon visibility: Druck-Icon ausblenden
+
** Im XML: </content>: das ist der Fließtext mit <content revised='delete'>Text den man nur mit ShowRevisionMarks =1 durchgestrichen und</content> <content revised='insert'>eingefügten (daher kursiv und unterstrichen dargestelltem) </content> Text.
 +
* use external css: Externes CSS aktivieren bzw. deaktivieren
 +
* print icon visibility: Druck-Icon ein- und ausblenden
 
* isdeprecated: Status des Dokuments (gültig oder storniert)
 
* isdeprecated: Status des Dokuments (gültig oder storniert)
* param_base64DecoderServiceUrl: Die Verwendung des Base64 Decoders kann per Option gesetzt werden, die URL kann hier angegeben werden.
+
* enable Info Button: Verknüpfung zum Gesundheitsportal im Laborbefund EIS Full Support
* param_enableInfoButton: Anzeige eines [[Info-Button Laborbefund]] bei EIS Full Support (Link auf Seite im Gesundheitsportal www.gesundheit.gv.at)
 
 
* param_LOINCResolutionUrl: URL zur Auflösung bei InfoButton
 
* param_LOINCResolutionUrl: URL zur Auflösung bei InfoButton
* strict mode: wenn aktiviert, werden ungültige Dokumente nicht angezeigt (default: aktiviert)
+
* Fehlertoleranz für die Anzeige von Tabellen: wenn aktiviert, werden ungültige Dokumente nicht angezeigt (default: aktiviert)
* showTableInBestGuess: wenn aktiviert, werden ungültige Tabellen angezeigt ("in best guess mode") (default: deaktiviert)
+
** Default-Einstellung: Text "Das Dokument kann wegen einer ungültigen Formatanweisung nicht dargestellt werden." wird angezeigt
 +
** Strict mode: Dokumente mit ungültigen Tabellen werden angezeigt, jedoch wird anstelle der Tabelle der Hinweis "Die Tabelle kann wegen einer ungültigen Formatanweisung nicht dargestellt werden." (nur im debug mode möglich)
 +
** showTableInBestGuess: Ungültige Tabellen werden mit Warnhinweis angezeigt (default: deaktiviert) - nur im debug mode möglich und wenn param_strictModeDisabled = 1
 +
*section Title White Background Color: Section Überschrift kann mit grauem oder weißem Hintergrund angezeigt werden
  
 
===Hinweise===  
 
===Hinweise===  
Zeile 41: Zeile 43:
  
 
==Darstellung von eingebetteten Dateien==
 
==Darstellung von eingebetteten Dateien==
Einbettung von Dateien über Base64, Decodierung notwendig.
+
Base 64 Decoder für die Darstellung von Anhängen (PDF, Grafiken, Multimedia) ist eingebunden
  
 
==Darstellung von fehlerhaft formatierten Tabellen==
 
==Darstellung von fehlerhaft formatierten Tabellen==

Version vom 11. Februar 2020, 15:24 Uhr

1 ELGA Referenz-Stylesheet

Seite in Arbeit

Das "ELGA Referenz-Stylesheet" ermöglicht eine allgemeine, einheitliche und benutzerfreundliche Darstellung von medizinischen CDA-Dokumenten (HL7 CDA Release 2.0), die gemäß der Vorgaben der ELGA CDA Implementierungsleitfäden erstellt wurden. Dabei werden die XML-Dateien mit einer XST-Transformation in HTML umgewandelt.

1.1 Nutzungsbedingungen

Das "ELGA Referenz-Stylesheet" wird von der ELGA GmbH bis auf Widerruf unentgeltlich und nicht-exklusiv sowie zeitlich und örtlich unbegrenzt, jedoch beschränkt auf Verwendungen für die Zwecke der "Clinical Document Architecture" (CDA) zur Verfügung gestellt. Veränderungen für die lokale Verwendung sind zulässig. Derartige Veränderungen (sogenannte bearbeitete Fassungen) dürfen ihrerseits publiziert und Dritten zur Weiterverwendung und Bearbeitung zur Verfügung gestellt werden. Bei der Veröffentlichung von bearbeiteten Fassungen ist darauf hinzuweisen, dass diese auf Grundlage des von der ELGA GmbH publizierten "ELGA Referenz-Stylesheet" erstellt wurden. Die Anwendung sowie die allfällige Bearbeitung des "ELGA Referenz-Stylesheet" erfolgt in ausschließlicher Verantwortung der AnwenderInnen. Aus der Veröffentlichung, Verwendung und/oder Bearbeitung können keinerlei Rechtsansprüche gegen die ELGA GmbH erhoben oder abgeleitet werden.

1.2 Optionen

Das Verhalten des ELGA Referenz-Stylesheets kann über Parameter umfangreich gesteuert werden. Neue Parameter können von Benutzern gemeldet werden und nach einer umfangreichen Prüfung, werden nützliche Parameter in das ELGA Referenz-Stylesheet aufgenommen. Durch die regelmäßigen Anpassungen und Weiterentwicklungen des Referenz-Stylesheets erscheinen in einem Jahr mind. zwei neue Versionen. Die aktuellste Version und die Vorgängerversion können auf der ELGA Webseite unter dem Reiter "Technischer Hintergrund" > "Technische ELGA-Leitfäden" ([1]) als "CDA Visualization" bzw. CDA Visualization (Vorgängerversion JJJJ-MM) heruntergeladen werden.

  • ShowRevisionMarks: eingefügten und gelöschten Text anzeigen
    • Default: eingefügter Text wird normal, gelöschter Text nicht dargestellt.
    • Mit Parameter: eingefügter Text unterstrichen und kursiv, gelöschter Text durchgestrichen
    • Im XML: </content>: das ist der Fließtext mit <content revised='delete'>Text den man nur mit ShowRevisionMarks =1 durchgestrichen und</content> <content revised='insert'>eingefügten (daher kursiv und unterstrichen dargestelltem) </content> Text.
  • use external css: Externes CSS aktivieren bzw. deaktivieren
  • print icon visibility: Druck-Icon ein- und ausblenden
  • isdeprecated: Status des Dokuments (gültig oder storniert)
  • enable Info Button: Verknüpfung zum Gesundheitsportal im Laborbefund EIS Full Support
  • param_LOINCResolutionUrl: URL zur Auflösung bei InfoButton
  • Fehlertoleranz für die Anzeige von Tabellen: wenn aktiviert, werden ungültige Dokumente nicht angezeigt (default: aktiviert)
    • Default-Einstellung: Text "Das Dokument kann wegen einer ungültigen Formatanweisung nicht dargestellt werden." wird angezeigt
    • Strict mode: Dokumente mit ungültigen Tabellen werden angezeigt, jedoch wird anstelle der Tabelle der Hinweis "Die Tabelle kann wegen einer ungültigen Formatanweisung nicht dargestellt werden." (nur im debug mode möglich)
    • showTableInBestGuess: Ungültige Tabellen werden mit Warnhinweis angezeigt (default: deaktiviert) - nur im debug mode möglich und wenn param_strictModeDisabled = 1
  • section Title White Background Color: Section Überschrift kann mit grauem oder weißem Hintergrund angezeigt werden

1.2.1 Hinweise

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.

1.3 Getestete Umgebungen

Das ELGA Referenz-Stylesheet wurde erfolgreich mit folgenden XSLT-Prozessoren getestet:

  • Saxon, Versionen 6.5.5 und 9.6.0.7
  • Xsltproc
  • .NET 1.0
  • MSXML 3.0

1.4 Darstellung von eingebetteten Dateien

Base 64 Decoder für die Darstellung von Anhängen (PDF, Grafiken, Multimedia) ist eingebunden

1.5 Darstellung von fehlerhaft formatierten Tabellen

Ab Version 1.06.004.1 enthält das Stylesheet geänderte Funktionen zur Darstellung von fehlerhaft formatierten Tabellen:

Mit den Default-Einstellungen werden Dokumente mit fehlerhaften Tabellen nicht angezeigt.

  • Mit der Option "strict mode disabled" werden die Dokumente angezeigt, für die Tabellen werden Platzhalter mit entsprechendem Hinweistext eingefügt.
  • Mit der Option "showTableInBestGuess enabled" werden auch ungültige Tabellen, etwa 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.