IT in der Arztpraxis Technisches Handbuch zum Kodierassistenten

Transkript

1 Technisches Handbuch zum Kodierassistenten [KBV_ITA_AHEX_Handbuch_Kodierassistent] Dezernat 6 Informationstechnik, Telematik und Telemedizin Berlin, Herbert-Lewin-Platz 2 Kassenärztliche Bundesvereinigung Version 1.8 Datum: Klassifizierung: KBV Status: In Kraft Kassenärztliche Bundesvereinigung, Berlin 2012

2 DOKUMENTENHISTORIE Version Datum Autor Änderung Begründung Seite KBV KBV KBV Redaktionelle Änderungen Aufnahme der Parameter für die Kodierhilfe Schalter - jdbcurlparameter 5 KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 2 von 11

3 INHALTSVERZEICHNIS DOKUMENTENHISTORIE 2 INHALTSVERZEICHNIS 3 ABBILDUNGSVERZEICHNIS 4 1 HANDBUCH KODIERASSISTENT Einleitung Allgemeine Informationen Hinweise zur KRWCom / KHRQ Schnittstelle im KodierAssistenten Konfiguration Einstellungen per Kommandozeile übergeben Abfrage und Ergebnis-Verzeichnis per Kommandozeile Mehrfaches Starten des KodierAssistenten Minimiertes Starten des KA Zu nutzende JVM einstellen/konfigurieren Weiterführende Hinweise Beenden des Kodierassistenten Beenden des KA per Datei KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 3 von 11

4 ABBILDUNGSVERZEICHNIS Abbildung 1: Benutzervorgaben im KodierAssistenten... 6 KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 4 von 11

5 1 Handbuch Kodierassistent 1.1 Einleitung In diesem Dokument werden technische Details zum KBV KodierAssistenten beschrieben, die bei der Nutzung und Integration mit einem Praxis-Verwaltungs-System hilfreich sind. Das Dokument ist eine Ergänzung zum KodierAssistenten Handbuch, in dem bereits die Verwendung des KodierAssistenten beschrieben wird. Die dort beschriebenen Inhalte werden hier nicht wiederholt. 1.2 Allgemeine Informationen Hinweise zur KRWCom / KHRQ Schnittstelle im KodierAssistenten Der KodierAssistent überwacht ein festgelegtes Verzeichnis auf neue Dateien vom Typ XML. Dateien, die in diesem Verzeichnis bereitgestellt werden, werden vom KodierAssistenten erkannt, verarbeitet (gegen das KodierRegelWerk geprüft) und angezeigt. Für die Anwendung Kodierhilfe wird ein separates Verzeichnis überwacht. Die gleichen Funktionalitäten, wie für die KRWCom-Schnittstelle, stehen auch für die Kodierhilfe zu Verfügung. Dabei können folgende Einstellungen in den Benutzervorgaben geändert werden: Abfrage-Verzeichnis (das Verzeichnis, in dem die KRWCom -Dateien bereitgestellt werden müssen). Analog gibt es ein Abfrage-Verzeichnis für die Kodierhilfe. Wartezeit bis KRWCom-Datei verfügbar [in Sekunden] (das ist das Abfrage-Intervall des KodierAssistenten, also wie häufig geprüft werden soll, ob eine neue KRWCom-Datei bereitgestellt wurde). Analog gibt es die gleiche Einstellung für die Kodierhilfe. Dateitypfilter (die Dateiendung, die der KodierAssistent als Filter verwendet. Es werden nur Dateien erkannt, die mit dieser Zeichenkette enden. Das wird vermutlich immer XML sein und muss daher nicht umgestellt werden). Analog gibt es die gleiche Einstellung für die Kodierhilfe. Wichtiger Hinweis zur Funktionalität, die auch für die Kodierhilfe gilt: Der KodierAssistent analysiert das Abfrage-Verzeichnis beim Starten und reagiert erst nach dem Start (und nach dieser Analyse) auf Änderungen in diesem Verzeichnis. Das bedeutet, dass KRWCom-Dateien, die vor dem Start des KodierAssistenten in dem Abfrage-Verzeichnis abgelegt wurden, nicht automatisch verarbeitet werden. Die Dateien dürfen erst nach dem Start des KodierAssistenten bereitgestellt werden. Erst dann registriert der KodierAssistenten, dass eine neue Datei vorliegt und verarbeitet diese. KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 5 von 11

6 1.3 Konfiguration Einstellungen per Kommandozeile übergeben Normalerweise werden die Einstellungen im KodierAssistenten unter Fenster Benutzervorgaben vorgenommen: Abbildung 1: Benutzervorgaben im KodierAssistenten Vorab ein genereller Hinweis zu den Benutzereinstellungen: Für die Benutzervorgaben gibt es sinnvolle Default-Einstellungen, die automatisch beim ersten Start der Anwendung gesetzt werden. Wenn diese Einstellungen nach dem ersten Start geändert werden, speichert die Anwendung die geänderten Einstellungen im Benutzerverzeichnis. Bei allen darauffolgenden Starts des KodierAssistenten werden nicht mehr die Default-Einstellungen, sondern die Einstellungen aus dem Benutzerverzeichnis gelesen. Die Regel zum Lesen der Einstellungen lautet also: Es wird zuerst im Benutzerverzeichnis nach (individuellen) Benutzervorgaben gesucht und nur wenn es keine gibt, werden die Default-Einstellungen eingelesen. Nur die Kommandozeilen- Argumente sind noch höherwertiger. Sind diese gesetzt, werden auch die (individuellen) Einstellungen überschrieben Abfrage und Ergebnis-Verzeichnis per Kommandozeile Die Einstellungen für das Abfrage-Verzeichnis und Verzeichnis für KRW Ergebnisse können auch per Kommandozeile beim Starten des KodierAssistenten übergeben werden. Die entsprechenden Kommandozeilen-Argumente lauten: -krwpruefeingang (für das Abfrage-Verzeichnis) -krwpruefergebnisse (für das Ergebnis-Verzeichnis) KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 6 von 11

7 Am einfachsten werden diese in der Kodierassistent.ini Datei im Programmverzeichnis des KodierAssistenten wie folgt angegeben: -startup plugins/org.eclipse.equinox.launcher_ r35x_v jar --launcher.library plugins/org.eclipse.equinox.launcher.win32.win32.x86_ v krwpruefergebnisse c:\tmp\krwpruefergebnisse\ -krwpruefeingang c:\tmp\krwpruefeingang\ -vmargs -Xms128m -Xmx512m Damit ist es möglich die Einstellungen in den Benutzervorgaben beim Starten des KodierAssistenten zu überschreiben. Die Kommandozeileargumente überschreiben dabei immer (bei jedem Start) die aktuellen Einstellungen. Wenn also die Verzeichnisse nach dem Start des KodierAssistenten manuell (in den Benutzervorgaben) geändert werden, dann gehen diese Änderungen beim nächsten Start verloren, wenn der KodierAssistent erneut mit den Kommandozeile-Argumenten gestartet wird. Wenn die angegebenen Verzeichnisse nicht existieren, dann versucht der KodierAssistent die Verzeichnisse anzulegen Mehrfaches Starten des KodierAssistenten Wir der KodierAssistent mehrfach gestartet, dann muss einerseits für jede gestartete Instanz ein anderes Abfrage-Verzeichnis angegeben werden (siehe auch Kapitel 3.1.1). Zum anderen muss auch die im KodierAssistent enthaltene Datenbank in einen sogenannten Mixed-Mode gesetzt werden, damit die Datenbank mehrere Verbindungen zulässt. Die Standardeinstellung ist, das der KodierAssistent nur 1x gestartet wird und die interne Datenbank auch nur eine Verbindung erlaubt. Wird der KodierAssistent dann 2x gestartet, läuft dieser auf eine Fehlermeldung, sobald die 2. Instanz auch auf die Datenbank zugreifen möchte. Um zu ermöglichen, dass der KodierAssistent mehrfach gestartet werden kann, ist es notwendig den KodierAssistenten beim Starten einen weiteren Parameter mitzugeben, der die interne Datenbank in den Mixed-Mode, der mehrere Verbindungen erlaubt, zu versetzen. Der Parameter kann auch auf der Kommandozeile übergeben werden und lautet: -jdbcurlparams ";AUTO_SERVER=TRUE" Diese Konstellation ist z.b. sinnvoll, wenn der KodierAssistent von einem freigegebenem Laufwerk gestartet wird, auf das mehrere Personen zugreifen. Die interne Datenbank verbleibt für alle zugreifenden Personen (Clients) auf dem freigegebenem Laufwerk und muss daher in diesem Fall mehrere Zugriffe erlauben. KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 7 von 11

8 Auch wenn diese Möglichkeit besteht, wird empfohlen den KodierAssistenten im Einzelplatzbetrieb zu nutzen. Für alle mit dem Serverbetrieb einhergehenden Probleme, die nicht direkt den KodierAssistenten betreffen, bietet die KBV keinen Support Minimiertes Starten des KA Damit beim Starten des primären Systems (das den KA mit startet) der Bildschirm nach dem Start nicht vom KodierAssistenten überdeckt ist und dieser daher vom Anwender erst minimiert werden muss, kann der KodierAssistent über den Kommandozeilenparameter "-starticonified" direkt minimiert gestartet werden. (Bei Systemen, die eine sog. Traybar unterstützen, wird der KodierAssistent in die TrayBar minimiert.) Der Parameter sollte auch hier in die Datei KodierAssistent.ini eingetragen werden: -startup plugins/org.eclipse.equinox.launcher_ r35x_v jar --launcher.library plugins/org.eclipse.equinox.launcher.win32.win32.x86_ v starticonified -vmargs -Xms128m Zu nutzende JVM einstellen/konfigurieren Wenn auf dem Zielrechner bereits eine Java Virtual Machine (JVM) vorhanden ist, z.b. weil das PVS bereits eine JVM mitbringt und wenn diese JVM den Versions-Anforderungen des KodierAssistenten genügt, dann kann das Verzeichnis für die JVM in der KodierAssistent.ini Datei konfiguriert werden. Dazu muss der Parameter vm als erstes (ganz oben in der Datei) eingefügt werden und auf den nächsten Zeile das entsprechende Verzeichnis für die javaw.exe angegeben werden: KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 8 von 11

9 -vm C:/Programme/Java/jdk1.6.0_18/bin/javaw.exe -startup plugins/org.eclipse.equinox.launcher_ r35x_v jar --launcher.library plugins/org.eclipse.equinox.launcher.win32.win32.x86_ v krwpruefergebnisse c:\tmp\krwpruefergebnisse\ -krwpruefeingang c:\tmp\krwpruefeingang\ -vmargs -Xms128m -Xmx512m KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 9 von 11

10 1.4 Weiterführende Hinweise Beenden des Kodierassistenten Da der KodierAssistent sehr häufig in ein PVS integriert wird, entsteht die Notwendigkeit diesen aus dem PVS heraus zu starten und mit dem Beenden des PVS den KodierAssistenten auch zu beenden. Daher wird hier exemplarisch (in Java) eine Möglichkeit aufgezeigt, wie man den KodierAssistenten aus einer Anwendung heraus starten und wieder beenden kann: public class BeendeKA { public static void main(string[] args) { try { ProcessBuilder launcher = new ProcessBuilder( "c:\\tmp\\kodierassistent\\kodierassistent.exe"); launcher.directory(new File( "c:\\tmp\\kodierassistent \\")); launcher.redirecterrorstream(true); Process ka = launcher.start(); Thread t1 = new Thread(new InputAndErrorStreamLogger( ka.getinputstream())); t1.start(); Thread.sleep(10000); // 10 Sekunden warten System.out.println("Anwendung und KA beenden..."); ka.destroy(); catch (java.io.ioexception ioe) { ioe.printstacktrace(); catch (InterruptedException e) { e.printstacktrace(); public static class InputAndErrorStreamLogger implements Runnable { private InputStream is; public InputAndErrorStreamLogger(InputStream is) { super(); this.is = is; public void run() { Scanner s = new Scanner(this.is).useDelimiter("\n"); while (s.hasnext()) { System.out.println(s.next()); KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 10 von 11

11 Zumindest in Java und bei Verwendung der Klasse ProcessBuilder ist es notwendig, dass der Error- und InputStream abgefangen wird, sonst hängt der Prozess. Daher wird hier ein zusätzlicher Thread erzeugt, der den Inputstream des Prozesses liest und einfach ausgibt. Für die Integration in ein PVS sollte das Beenden des erzeugten Prozesses natürlich in das Event-Handling zum Beenden des PVS selbst eingebunden werden. Das gleiche Prinzip sollte in anderen Programmiersprachen ähnlich anwendbar sein Beenden des KA per Datei Die bevorzugte Variante zum Beenden des als Kindprozess erzeugten KodierAssistenten sollte ähnlich der in Kapitel 4.1 beschriebenen Vorgehensweise sein. Wenn aber aus anderen Gründen der Weg nicht möglich ist, gibt es alternativ die Möglichkeit den KodierAssistenten per Übergabe einer Datei mit dem Namen beendeka.xml zu beenden. Dazu ist eine Datei mit exakt diesem Namen (Groß- und Kleinschreibung wird dabei ignoriert) in das Abfrage-Verzeichnis für KRWCom Dateien bereitzustellen (also das Verzeichnis, dass in den Benutzervorgaben unter Abfrage-Verzeichnis eingestellt ist). Die Datei wird mit dem Beenden des KA wiederum gelöscht. (Das funktioniert natürlich nur, wenn kein anderer Prozess diese Datei noch blockiert). Bitte beachten Sie an dieser Stelle auch den Hinweis unter Wichtiger Hinweis zur Funktionaliät" aus Kapitel 2.1. Das Verzeichnis wird erst nach dem Start des KA auf Änderungen überwacht. Dateien, die sich schon vorher im Abfrage-Verzeichnis befinden, werden ignoriert. Nach jetzigem Stand wird dieses Feature ab Version des KodierAssistenten zur Verfügung stehen. Da die Versionsnummern noch nicht in Stein gemeißelt sind, sollten im Zweifel die Release-Notes des KodierAssistenten geprüft werden. Darin wird das Feature inkl. der einführenden Version angezeigt. KBV_ITA_AHEX_Handbuch_Kodierassistent * Version 1.8 Seite 11 von 11