ELGA Referenz-Stylesheet: Unterschied zwischen den Versionen
| [unmarkierte Version] | [unmarkierte Version] |
(Die Seite wurde neu angelegt: „=ELGA Referenz-Stylesheet= Seite in Arbeit -------------------- ==Nutzungsbedingungen== Das "ELGA Referenz-Stylesheet" wird von der ELGA GmbH bis auf Widerru…“) |
K |
||
| (11 dazwischenliegende Versionen von 2 Benutzern 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 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. | ||
| + | ==Anwendung== | ||
| + | Die einfachste Art der Anwendung des Stylesheets ist das Rendern eines XML-Dokuments über das Stylesheet im Browser. Dazu muss das Stylesheet im vom XML-Dokument angegebenen Pfad liegen; für ELGA CDA im selben Verzeichnis wie die XML-Datei. | ||
| + | |||
| + | Das XML Stylesheet kann aber auch in Applikationen direkt eingebaut werden. | ||
| − | |||
==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 10: | Zeile 15: | ||
==Optionen== | ==Optionen== | ||
| − | Das Verhalten des | + | 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 | |
| − | + | ** 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 | ||
===Hinweise=== | ===Hinweise=== | ||
| + | |||
| + | Das ELGA-Referenz-Stylesheet enthält ab Version 1.06.004.1 eine geänderte Funktionen zur Darstellung von fehlerhaft formatierten Tabellen: | ||
Für das Setzen der Optionen strict mode: disabled und showTableInBestGuess: enabled ist unbedingt Folgendes zu beachten: | 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. | 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. | Der Inhalt kann dadurch unter Umständen fehlerhaft interpretiert werden. | ||
Diese Tabellen werden durch das Stylesheet mit einem Warnhinweis versehen angezeigt. | Diese Tabellen werden durch das Stylesheet mit einem Warnhinweis versehen angezeigt. | ||
| + | |||
| + | * 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. | ||
| + | Für das Setzen der Optionen beachten Sie bitte die Hinweise im readme. | ||
| + | |||
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. | ||
| + | |||
| + | ===Browser=== | ||
| + | Optimale Darstellungsergebnisse werden bei Verwendung von Firefox erreicht. | ||
| + | |||
| + | Bei der Darstellung in den verschiedenen Browsern, müssen einige Einstellungen beachtet werden, damit das Stylesheet richtig angezeigt wird (siehe Changelog_CDA Visualization) | ||
| + | |||
| + | ====Darstellungsprobleme in verschiedenen Browsern==== | ||
| + | =====Firefox ab Version 68 (veröffentlicht am 09.07.2019)===== | ||
| + | Das Stylesheet wird nicht mehr geladen und Firefox zeigt nur Teile des CDA Level 3 Teiles als reinen Text an. | ||
| + | '''Lösung:''' | ||
| + | * Firefox öffnen | ||
| + | * In die URL Zeile about:config eingeben und Enter drücken | ||
| + | * Warnhinweis bestätigen | ||
| + | * Im Suchfeld folgenden Parameter eingeben privacy.file_unique_origin | ||
| + | * Mit rechts Klick den Wert auf false umschalten | ||
| + | * Fenster schließen und CDA Dokument mit Firefox öffnen | ||
| + | |||
| + | =====Google Chrome ab Version 45 (veröffentlicht am 01.09.2015)===== | ||
| + | Google Chrome blockiert das Nachladen von XSLT Dateien aus XML Dateien, wodurch die Darstellung des Stylesheets in Chrome nicht mehr funktioniert. | ||
| + | '''Lösung:''' | ||
| + | * Alle Google Chrome Anwendungen schließen (Bei Neustart werden auch alle im Hintergrund weiterhin aktiven Anwendungen geschlossen) | ||
| + | * Google Chrome Dateipfad öffnen | ||
| + | ** Achtung: Darf keine Verknüpfung sein | ||
| + | * Neue Verknüpfung erstellen | ||
| + | * Folgenden Pfad eingeben Dateipfad\chrome.exe --allow-file-access-from-files | ||
| + | * Weiter auswählen | ||
| + | * Name für die Verknüpfung auswählen | ||
| + | * Verknüpfung öffnen und CDA Dokument hineinziehen | ||
| + | |||
| + | =====Microsoft Edge===== | ||
| + | Microsoft Edge (Codename Spartan) unterstützt keine XSL Transformationen, ein zu einer HTML-Datei transformierte Datei wird aber fehlerfrei angezeigt. | ||
| + | |||
| + | =====Microsoft Internet Explorer===== | ||
| + | Bei der Darstellung mittels Internet Explorer ist zu beachten: | ||
| + | * Bei der Darstellung von lokal gespeicherten Dateien muss folgende Einstellung für JavaScript getroffen werden: Internetoptionen -> Erweitert -> unter Sicherheit: Ausführung aktiver Inhalte in Dateien auf dem lokalen Computer zulassen | ||
| + | * Beim Speichern von eingebetteten Dateien wird im Internet Explorer wird keine Dateiendung an die Datei gehängt | ||
| + | Der Microsoft Internet Explorer wird vom Hersteller nicht mehr aktiv weiterentwickelt. | ||
==Getestete Umgebungen== | ==Getestete Umgebungen== | ||
Das ELGA Referenz-Stylesheet wurde erfolgreich mit folgenden XSLT-Prozessoren getestet: | 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 | |
| + | |||
| + | ==Darstellung von eingebetteten Dateien== | ||
| + | Base 64 Decoder für die Darstellung von Anhängen (PDF, Grafiken, Multimedia) ist eingebunden | ||
| + | |||
| + | ==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. | ||
Aktuelle Version vom 20. August 2020, 07:22 Uhr
Inhaltsverzeichnis
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 Anwendung
Die einfachste Art der Anwendung des Stylesheets ist das Rendern eines XML-Dokuments über das Stylesheet im Browser. Dazu muss das Stylesheet im vom XML-Dokument angegebenen Pfad liegen; für ELGA CDA im selben Verzeichnis wie die XML-Datei.
Das XML Stylesheet kann aber auch in Applikationen direkt eingebaut werden.
1.2 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.3 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.3.1 Hinweise
Das ELGA-Referenz-Stylesheet enthält ab Version 1.06.004.1 eine geänderte Funktionen zur Darstellung von fehlerhaft formatierten Tabellen: 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.
- 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.
Für das Setzen der Optionen beachten Sie bitte die Hinweise im readme.
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.2 Browser
Optimale Darstellungsergebnisse werden bei Verwendung von Firefox erreicht.
Bei der Darstellung in den verschiedenen Browsern, müssen einige Einstellungen beachtet werden, damit das Stylesheet richtig angezeigt wird (siehe Changelog_CDA Visualization)
1.3.2.1 Darstellungsprobleme in verschiedenen Browsern
1.3.2.1.1 Firefox ab Version 68 (veröffentlicht am 09.07.2019)
Das Stylesheet wird nicht mehr geladen und Firefox zeigt nur Teile des CDA Level 3 Teiles als reinen Text an. Lösung:
- Firefox öffnen
- In die URL Zeile about:config eingeben und Enter drücken
- Warnhinweis bestätigen
- Im Suchfeld folgenden Parameter eingeben privacy.file_unique_origin
- Mit rechts Klick den Wert auf false umschalten
- Fenster schließen und CDA Dokument mit Firefox öffnen
1.3.2.1.2 Google Chrome ab Version 45 (veröffentlicht am 01.09.2015)
Google Chrome blockiert das Nachladen von XSLT Dateien aus XML Dateien, wodurch die Darstellung des Stylesheets in Chrome nicht mehr funktioniert. Lösung:
- Alle Google Chrome Anwendungen schließen (Bei Neustart werden auch alle im Hintergrund weiterhin aktiven Anwendungen geschlossen)
- Google Chrome Dateipfad öffnen
- Achtung: Darf keine Verknüpfung sein
- Neue Verknüpfung erstellen
- Folgenden Pfad eingeben Dateipfad\chrome.exe --allow-file-access-from-files
- Weiter auswählen
- Name für die Verknüpfung auswählen
- Verknüpfung öffnen und CDA Dokument hineinziehen
1.3.2.1.3 Microsoft Edge
Microsoft Edge (Codename Spartan) unterstützt keine XSL Transformationen, ein zu einer HTML-Datei transformierte Datei wird aber fehlerfrei angezeigt.
1.3.2.1.4 Microsoft Internet Explorer
Bei der Darstellung mittels Internet Explorer ist zu beachten:
- Bei der Darstellung von lokal gespeicherten Dateien muss folgende Einstellung für JavaScript getroffen werden: Internetoptionen -> Erweitert -> unter Sicherheit: Ausführung aktiver Inhalte in Dateien auf dem lokalen Computer zulassen
- Beim Speichern von eingebetteten Dateien wird im Internet Explorer wird keine Dateiendung an die Datei gehängt
Der Microsoft Internet Explorer wird vom Hersteller nicht mehr aktiv weiterentwickelt.
1.4 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.5 Darstellung von eingebetteten Dateien
Base 64 Decoder für die Darstellung von Anhängen (PDF, Grafiken, Multimedia) ist eingebunden
1.6 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.
