Über die Schnittstelle Comm-Server
Die Schnittstelle Comm-Server (kurz für: Kommunikationsserver) ermöglicht einem BASIS 6 Server die Kommunikation mit externen Kommunikationsservern. Hierfür wird eine socketbasierte Datenübertragung auf TCP-Basis genutzt, um Nachrichten im HL7-Standard zu senden und zu empfangen. Dadurch ist ein Datenaustausch mit vielen externen Kommunikationsservern anderer Hersteller möglich. Von der Schnittstelle empfangene Daten werden als Dateien im Dateisystem abgelegt, um über bestehende Schnittstellen in BASIS 6 importiert werden zu können.
Mögliche Anwendungsfälle für die Schnittstelle Comm-Server sind:
- Automatisierte Übertragung von Beschäftigtendaten an einen Kommunikations-Server
- Automatisierte Übertragung von Laboranforderungen an einen Kommunikations-Server
- Automatischer Empfang von Laborergebnissen von einem Kommunikations-Server
Systemvoraussetzung
Die Schnittstelle Comm-Server ist nur für BASIS Server verfügbar und diese Anleitung bezieht sich auf die BASIS Version 6
Ersteinrichtung
Die Schnittstelle erfordert aufgrund einer hohen Komplexität bei der ersten Einrichtung in der Regel Unterstützung durch den Support von Medisoft.
Aufrufen der Voreinstellungen für die Schnittstelle Comm-Server
Um die Voreinstellungen für die Schnittstelle Comm-Server anzupassen, rufen Sie zunächst den Bereich Voreinstellungen in BASIS 6 auf. Suchen Sie dazu im Funktionskatalog nach „Voreinstellungen“ und öffnen Sie diesen Eintrag mit einem Klicken auf den Button OK. Anschließend wählen Sie in der hierarchischen Liste unter Schnittstellen den Eintrag Comm-Server aus.
Einstellungen für die Schnittstelle Comm-Server
Wenn Sie die Voreinstellungen für die Schnittstelle Kommunikationsserver aufrufen, sehen Sie die Tabs Konfiguration und Status. Der Tab Konfiguration fasst die Einstellungen für das Senden und Empfangen zusammen und unter dem Tab Status können Sie den aktuellen Zustand der Schnittstelle Comm-Server sehen.
Einstellungen für die Schnittstelle zum Senden
Schnittstelle „Senden“ aktiv
Mit dem Kontrollkästchen Schnittstelle „Senden“ aktiv aktivieren und deaktivieren Sie die Schnittstelle Kommunikationsserver.
Schnittstelle „Senden“ des Comm-Servers neu starten
Mit einem Klick auf das Neustart-Icon können Sie die Schnittstelle Kommunikationsserver neu starten.
Geänderte Voreinstellungen werden dadurch sofort aktiv. Wenn Sie Voreinstellungen der Schnittstelle Kommunikationsserver ändern, ohne auf das Icon Neustart zu klicken, werden die geänderten Einstellungen erst mit dem nächsten Start des BASIS 6 Server aktiv.
IP:Port
In dem Eingabefeld IP:Port geben Sie die IP-Adresse und den Port an, unter der der externe Kommunikationsserver erreichbar ist. Lautet die IP-Adresse zum Beispiel 192.168.0.1 und der Port 5555, geben Sie hier 192.168.0.1:5555 ein. Die Angabe muss immer eine Portnummer enthalten.
DNS-Adressen
Geben Sie keine DNS-Adressen wie zum Beispiel www.example.com an, diese können nicht aufgelöst werde.
Benutzer
In dem Eingabefeld Benutzer können Sie den Benutzernamen für die Anmeldung am externen Kommunikationsserver eingeben, wenn er zur Anmeldung erforderlich ist.
Passwort
In dem Eingabefeld Passwort können Sie das Passwort für die Anmeldung am externen Kommunikationsserver eingeben, wenn es zur Anmeldung erforderlich ist.
Zeichensatz
In dem Menü Zeichensatz können Sie den Zeichensatz auswählen, den die Schnittstelle Comm-Server zum Senden der Nachrichten nutzt.
Acknowledge
Mit dem Kontrollkästchen Acknowledge können Sie festlegen, dass die Schnittstelle Comm-Server bei der Kommunikation mit dem angegebenen externen Server auf eine Antwort zur Bestätigung wartet.
Optionen
Labor-Nr. (intern) Pflicht
Mit dem Kontrollkästchen Labor-Nr. (intern) Pflicht können Sie festlegen, dass BASIS 6 bei Beschäftigtenanlage immer eine interne Labornummer vergibt. Hierfür muss ein Nummernkreis für die Labornummern eingerichtet sein, bei Manueller Vergabe steht die Option nicht zur Verfügung und das Kontrollkästchen Labor-Nr. (intern) Pflicht ist ausgegraut.
Automatische Vergabe von Labornummern
Sie können die Einstellungen zur automatischen Vergabe von Labornummern in den Voreinstellungen im Bereich Anpassen → Beschäftigte unter dem Tab Labordaten und dann Interne Labornummern festlegen.
Senden bei neuer Untersuchung
Mit dem Kontrollkästchen Senden bei neuer Untersuchung können Sie festlegen, dass die Daten eines Beschäftigten von der Schnittstelle Comm-Server gesendet werden, sobald für den Beschäftigten eine neue Untersuchung angelegt wird.
Beschäftigte
Nachrichten-Templates
In der Liste Nachrichten-Templates können für alle zur Verfügung stehenden Nachrichten-Typen Inhalte festgelegt werden. Typ und Message-ID der Nachrichten sind dabei vom HL7-Standard vorgegeben und können nicht bearbeitet werden. Der bearbeitbare Inhalt einer Nachricht besteht aus dem übertragenen Datensatz im HL7-Standard.
Nachrichteninhalt bearbeiten
Um den Inhalt einer von der Schnittstelle Comm-Server gesendeten Nachricht zu bearbeiten, doppelklicken Sie auf den Eintrag der Nachricht für den gewünschten Typ in der Liste der Nachrichten. Es wird ein Dialogfenster zur Bearbeitung des Nachrichteninhalts geöffnet. Die Nachricht verwendet den HL7-Standard mit Variablen, die vor dem Senden von BASIS 6 gefüllt werden. Variablen sind von Dollarzeichen umschlossen.
In HL7 ADT-Nachrichten verfügbare Variablen
ADT-Nachrichten werden genutzt, um Informationen über die Aufnahme, Entlassung und Übertragung von Patienten auszutauschen. (Engl. Admit/Discharge/Transfer). Folgende Variablen sind verfügbar:
$ABetrieb$
$ABetriebPfad$
$Anrede_Titel$
$Arbeitsbereich_Bez$
$AuftragNr$
$AuftragNr$
$EBetrieb$
$EBetriebPfad$
$EMail_Adresse$
$ExterneLabID$
$GebDatum$
$GebJahr$
$GebName$
$Geschlecht$
$InterneLabID$
$Kostenstelle_Bez$
$Mobiltelefon_Privat$
$Nachname$
$Ort$
$Personal_Nr$
$PLZ$
$PseudoNachname$
$PseudoVorname$
$Strasse$
$Taetigkeit_kurz$
$Telefon_Privat$
$TimeStamp$
$TimeStampShort$
$Vorname$
In HL7 ORM-Nachrichten verfügbare Variablen
ORM-Nachrichten werden für Order-Entry-Systeme genutzt. (Engl. Order-Entry Message). Folgende Variablen sind verfügbar:
$AuftragNr$
$FallNr$
$GebDat$
$LabLoopCount$
$LabParaCode$
$LfDNrORM$
$PseudoID$
$Sex$
$SpecimenSource$
$Timestamp$
Initialisierung
Neue Beschäftigte senden
Mit dem Button Neue Beschäftigte senden unter dem Punkt Initialisierung können Sie die Daten für alle Beschäftigten in BASIS 6 an den externen Kommunikationsserver übertragen. Hierbei wird von der BASIS 6 Schnittstelle Comm-Server auf Protokollebene der Nachrichtentyp „New“ mit der Message-ID A01 genutzt. Dies ist zum Beispiel bei der erstmaligen Einrichtung sinnvoll, da die Schnittstelle Comm-Server standardmäßig nur Datensätze für Beschäftigte überträgt, wenn in diesen Änderungen erfolgt sind.
Alle Beschäftigten senden
Mit dem Button Alle Beschäftigten senden unter dem Punkt Initialisierung können Sie die Daten von Beschäftigten an den externen Kommunikationsserver übertragen. Hierbei wird von der Schnittstelle Comm-Server auf Protokollebene der Nachrichtentyp „Update“ mit der Message-ID A08 genutzt.
Alle Beschäftigten als gesendet markieren
Mit dem Button Alle Beschäftigten als gesendet markieren können Sie die anstehende Übertragung von Datensätzen, die geändert wurden, verhindern. Dies ist sinnvoll, wenn Sie verhindern wollen, dass eine unwesentliche Änderung der Daten vieler Beschäftigter zu einer Übertragung sehr vieler Datensätze führt.
Einstellungen für die Schnittstelle zum Empfangen
Import der empfangenen Daten
Empfangene Daten werden über bestehende Schnittstellen in BASIS 6 importiert. Diese müssen separat konfiguriert werden. Achten Sie darauf, dort dasselbe Verzeichnis wie in der Konfiguration der Schnittstelle Comm-Server anzugeben. Für die weiteren Schnittstellen können weitere Lizenzen notwendig sein.
Schnittstelle „Empfangen“ des Comm-Servers neu starten
Mit einem Klick auf das Neustart-Icon können Sie die Schnittstelle Kommunikationsserver neu starten.
Geänderte Voreinstellungen werden dadurch sofort aktiv. Wenn Sie Voreinstellungen der Schnittstelle Kommunikationsserver ändern, ohne auf das Icon Neustart zu klicken, werden die geänderten Einstellungen erst mit dem nächsten Start des BASIS 6 Server aktiv.
Übertragung
In der Liste Übertragung können Sie die Portnummern angeben, die der BASIS 6 Server nutzt, um Nachrichten zu empfangen so wie ein Zielverzeichnis festlegen, in dem diese als Dateien gespeichert werden. Die IP-Adresse ist dabei immer die Adresse des BASIS 6 Servers.
Pfadangaben für das Zielverzeichnis
- Vermeiden Sie Sonder- und Leerzeichen.
- Pfade beginnen in der Regel mit einem Laufwerksbuchstaben: C:\
- Pfade enden in der Regel mit einem Backslash: \
- Auch UNC-Pfad wie zum Beispiel \\192.168.5.100\Temp\HL7\In\ können genutzt werden.
Beachten Sie in diesem Fall, dass der BASIS 6 Server Schreibrechte für den Ordner haben muss.
Einen externen Kommunikationsserver hinzufügen
Gehen Sie wie folgt vor, um der Liste Übertragung der Schnittstelle Comm-Server einen externen Kommunikationsserver für den Empfang von Daten hinzuzufügen:
- Klicken Sie auf das Plus-Icon rechts oberhalb der Liste
Eine neue Zeile in der Liste Übertragung erscheint, in der die jeweiligen Angaben mit Platzhaltern gefüllt sind:
- Markieren Sie die Zeile und klicken auf die Angabe *IP-Adresse*, um diese bearbeiten zu können. Tragen anschließend die IP-Adresse des BASIS 6 Servers ein.
- Doppelklicken Sie auf die Angabe *Port* und tragen anschließend die Portnummer ein, die der BASIS 6 Server zum Empfangen der Nachrichten nutzen soll.
- Doppelklicken Sie auf die Angabe *Ordner* und tragen anschließend den kompletten Pfad des Zielverzeichnisses ein.
- Klicken Sie auf das Icon Neustart neben dem Kontrollkästchen Schnittstelle “Empfangen” aktiv, damit Ihre Änderung sofort wirksam wird.
Einen externen Kommunikationsserver entfernen
Gehen Sie wie folgt vor, um einen externen Kommunikationsserver von der Liste Übertragung der Schnittstelle Comm-Server zu entfernen:
- Wählen Sie den Kommunikationsserver in der Liste Übertragungen aus
- Klicken Sie auf das Minus-Icon rechts oberhalb der Liste
- Der externe Kommunikationsserver wird sofort entfernt.
- Klicken Sie auf das Icon Neustart neben dem Kontrollkästchen Schnittstelle “Empfangen” aktiv, damit Ihre Änderung sofort wirksam wird.
Einen externen Kommunikationsserver bearbeiten
Gehen Sie wie folgt vor, um IP-Adresse, Port oder Zielverzeichnis eines in die Liste Übertragung der Schnittstelle Comm-Server eingetragenen externen Kommunikationsservers zu bearbeiten:
- Wählen Sie den Kommunikationsserver in der Liste Übertragungen aus, den Sie bearbeiten möchten
- Klicken Sie auf die Angabe, die Sie ändern möchten, und tragen die neuen Daten ein.
- Klicken Sie auf das Icon Neustart neben dem Kontrollkästchen Schnittstelle “Empfangen” aktiv, damit Ihre Änderung sofort wirksam wird.
Zeichensatz
Die Schnittstelle Comm-Server bestimmt anhand von Informationen in den empfangenen Dateien den zur Dekodierung genutzten Zeichensatz. Manchmal stimmen die Informationen nicht mit der tatsächlichen Kodierung der Dateien überein. Ein falsch gewählter Zeichensatz führt oft zu defekten Sonderzeichen sowie weiteren Fehlern in Texten. In dem Menü Zeichensatz können Sie den Zeichensatz in so einem Fall manuell auswählen.
Acknowledge
Mit dem Kontrollkästchen Acknowledge im Bereich der Einstellungen für die Schnittstelle zum Empfangen können Sie festlegen, dass die Schnittstelle Comm-Server beim Empfangen eine Bestätigung an den externen Server sendet.
Status der Schnittstelle Comm-Server
Unter dem Tab Status können Sie den aktuellen Status der Schnittstelle Comm-Server sehen. Die Darstellung erfolgt getrennt nach den Bereichen “Senden” und “Empfangen”.
Protokolle für die Schnittstelle Comm-Server aufrufen
Sie können ein Protokoll aufrufen, in dem weitere Informationen zu erfolgreichen und fehlgeschlagenen Datenübertragungen der Schnittstelle Comm-Server protokolliert werden. Hierdurch wird eine Fehlersuche deutlich vereinfacht.
Um das Protokoll aufzurufen, suchen Sie im Funktionskatalog nach „Protokolle“ und rufen diese mit einem Klick auf den Button OK auf. Wechseln Sie anschließend auf den Tab Labor-Schnittstelle. Hier sehen Sie die Protokolleinträge für die Schnittstelle Comm-Server (Datum und Uhrzeit der Protokolleintrags, BASIS-Benutzer und Rechner, Fehlerlevel, Typ, Aktion der Schnittstelle und den Eintrag, der die Aktion näher erklärt.)
Weiterführende Informationen
Health Level Seven International Webseite:
https://www.hl7.org/
