CGM TURBOMED – Patientenaufruf aus der Karteikarte

CGM TURBOMED kann selbst keinen HTTPS-Request senden. Dafür startet es auf Knopfdruck ein kleines Programm. Das Programm liest den gerade offenen Patienten aus der GDT-Datei und schickt genau einen Request an Wartezimmer-Aufruf. Danach genügt in der Karteikarte ein Klick, wie der Symbolleisten-Knopf der tomedo-Aktionskette.

Voraussetzungen: CGM TURBOMED unter Windows, das Passwort für die GDT-Einstellungen (beim CGM-Partner oder bei CGM in Koblenz), ein Konto bei Wartezimmer-Aufruf mit Tarif inklusive API-Zugriff und Internetzugang am Arbeitsplatz. Dauer: etwa 20 Minuten.

Menüpfade können sich mit der Version ändern. An der jeweiligen Stelle öffnet F1 das passende Kapitel. CGM beschreibt den Knopf in der Symbolleiste im GDT-Anbindungsbeispiel.

Nur der Knopf ruft auf#

Aufgerufen wird der Patient, bei dem Sie den Knopf drücken.

Die Akte öffnen, den Patienten lesen oder zum nächsten Patienten wechseln schickt keinen Request. TURBOMED schreibt die Patientendaten erst in dem Moment, in dem die GDT-Anbindung gestartet wird, und startet dann das Programm. Legen Sie keinen automatischen Start und kein Mitlaufen bei jedem Patientenwechsel an.

Ein Wartezimmer, viele Fernseher – oder ein Wartezimmer pro Fernseher#

Ein Wartezimmer  ──gleicher Anzeige-Link──▶  Fernseher 1, 2, 3, …
                                               (dieselben Aufrufe, dasselbe Video)

Vier Wartezimmer ──je ein eigener Link──▶  Fernseher A, B, C, D
                                               (eigene Aufrufe, eigene Videos)

Spiegeln: Dieselbe Anzeige können Sie auf beliebig vielen Fernsehern öffnen. Alle Geräte zeigen dieselben Aufrufe und dasselbe Bild oder Video. Das passt, wenn ein Wartezimmer von mehreren Seiten einsehbar sein soll.

Getrennte Fernseher: Sobald ein Fernseher eigene Aufrufe oder eigene Inhalte haben soll, legen Sie dafür ein eigenes Wartezimmer an. Jedes Wartezimmer hat einen eigenen Anzeige-Link, eine eigene Wartezimmer-ID und ein eigenes Medium.

Vier unabhängige Fernseher sind deshalb ein Standort und vier Wartezimmer. Hintergründe: Standorte & Wartezimmer.

So funktioniert die Anbindung#

Knopf in der Karteikarte  ──GDT──▶  Programm  ──HTTPS──▶  Wartezimmer-Aufruf  ──▶  genau ein Fernseher

Die Wartezimmer-ID im Programm wählt den Fernseher. Das Zimmer in der Ansage ist das Sprechzimmer und ist davon unabhängig. Pro Wartezimmer gibt es einen eigenen Knopf, analog zu einer eigenen tomedo-Aktionskette.

Schritt 1: API-Token und Wartezimmer-IDs holen#

1. In Wartezimmer-Aufruf anmelden und unter Standorte einen Standort anlegen.
2. Unter Wartezimmer ein Wartezimmer pro Fernseher anlegen. Jedem sein Medium zuweisen (Medien & Laufband) und den Anzeige-Link nur auf diesem Fernseher öffnen (Anzeige auf den Fernseher bringen).
3. Oben rechts Ihr Name → API Tokens → Token „TURBOMED“ erstellen und kopieren.
4. In jedem Wartezimmer die Wartezimmer-ID aus dem Kasten Aufruf aus der Praxissoftware (API) kopieren.

Die API ist in den Tarifen mit API-Zugriff enthalten. Ist sie nicht freigeschaltet, antwortet der Server mit 403.

Mehrere Arbeitsplätze sehen dieselben Wartezimmer, sobald die Personen im selben Team sind (Team & Benutzer).

Schritt 2: Dateien anlegen und den Request testen#

Einrichtung herunterladen. Im Zip liegt installieren.ps1. Auf dem Praxis-PC ausführen:

powershell -ExecutionPolicy Bypass -File installieren.ps1

Das Programm fragt Token, Wartezimmer-IDs und das Sprechzimmer dieses PCs ab und legt C:\Praxis\aufruf.ps1 sowie eine Startdatei pro Fernseher an. Es kann einen Testaufruf senden. TURBOMED bleibt unverändert: eine neue GDT-Anbindung speichert TURBOMED nur mit dem Tageskennwort, und die Symbolleiste ist ein eigener Schritt.

-Name im Skript ist nur für diesen Test. Im Alltag lässt TURBOMED den Namen weg, das Programm liest ihn aus der GDT-Datei.

param(
    [string]$Name,
    [Parameter(Mandatory = $true)][string]$Zimmer,
    [Parameter(Mandatory = $true)][ValidateSet("1", "2", "3", "4")][string]$Wartezimmer,
    [string]$GdtDatei = "C:\Praxis\gdt\aufruf.gdt"
)

$token = "IHR-API-TOKEN"
$ids = @{
    "1" = "WARTEZIMMER-ID-1"
    "2" = "WARTEZIMMER-ID-2"
    "3" = "WARTEZIMMER-ID-3"
    "4" = "WARTEZIMMER-ID-4"
}

function Get-GdtField([string]$Text, [string]$FieldId) {
    foreach ($line in ($Text -split "`r?`n")) {
        $line = $line.TrimEnd()
        if ($line.Length -lt 7) { continue }
        if ($line.Substring(3, 4) -eq $FieldId) { return $line.Substring(7).Trim() }
    }
    return ""
}

if (-not $Name) {
    if (-not (Test-Path -LiteralPath $GdtDatei)) { exit 0 }
    $file = Get-Item -LiteralPath $GdtDatei
    # Ältere Datei gehört zu einem früheren Klick, nicht zum Patienten, der nur geöffnet ist.
    if (((Get-Date) - $file.LastWriteTime).TotalSeconds -gt 30) { exit 0 }
    $text = [System.Text.Encoding]::GetEncoding(1252).GetString([System.IO.File]::ReadAllBytes($GdtDatei))
    $anrede = switch (Get-GdtField $text "3110") { "1" { "Herr" } "2" { "Frau" } default { "" } }
    $Name = (@($anrede, (Get-GdtField $text "3101")) | Where-Object { $_ }) -join " "
}

if (-not $Name) { exit 0 }

try {
    Invoke-RestMethod -Method Post -Uri "https://wartezimmer-aufruf.de/api/waitingrooms/$($ids[$Wartezimmer])/invocations" `
        -Headers @{ Authorization = "Bearer $token"; Accept = "application/json" } `
        -ContentType "application/json" `
        -Body (@{ name = $Name; room = $Zimmer } | ConvertTo-Json) -TimeoutSec 5 | Out-Null
} catch {
    Add-Content -Path "C:\Praxis\aufruf-fehler.log" -Value ("{0} {1}" -f (Get-Date), $_.Exception.Message)
}

Test in der Eingabeaufforderung:

powershell -ExecutionPolicy Bypass -WindowStyle Hidden -File C:\Praxis\aufruf.ps1 -Name "Frau Müller" -Zimmer 3 -Wartezimmer 1

-Wartezimmer 1 ist das erste Wartezimmer aus der Liste im Skript, also der Fernseher mit der ersten ID. -Zimmer 3 ist das Sprechzimmer in der Ansage. Erscheint der Aufruf nur auf diesem Fernseher, stimmen Token und ID. Kopieren Sie C:\Praxis\ auf jeden Arbeitsplatz und tragen Sie dort den Token dieses Platzes ein.

Felder, die TURBOMED in die GDT-Datei schreibt (bei aktivem Rücksprung):

Angesagt wird Anrede plus Nachname, wie in der tomedo-Anleitung. Den Vornamen übernimmt das Programm nicht.

Schritt 3: GDT in TURBOMED einrichten#

Richten Sie zuerst nur ein Wartezimmer ein und prüfen Sie den Aufruf. Bestehende GDT-Anbindungen, etwa ein EKG, bleiben unverändert. Das Tageskennwort kommt vom CGM-Partner oder von CGM in Koblenz. Ohne dieses Kennwort lässt sich die Maske ausfüllen, TURBOMED speichert die neue Anbindung dann aber nicht.

Anbindung anlegen#

1. Einen Patienten öffnen und seine Karteikarte aufrufen. Erst dann erscheint das Menü Geräte.
2. Geräte → Einstellungen GDT-Schnittstelle. Dieselbe Stelle öffnet die Tastenfolge Alt+G, G.
3. Gerät anbinden, dann Neu. Das Tageskennwort eingeben.
4. Bezeichnung: Aufruf Wartezimmer 1. Diesen Namen auf allen Arbeitsplätzen gleich lassen. CGM verlangt das, damit die Anbindung in der Praxis einheitlich heißt.
5. Im Feld Programm den Pfad der Startdatei eintragen, inklusive Dateiname:

C:\Praxis\aufruf-wartezimmer1.bat

Diese Datei hat installieren.ps1 angelegt. Sie startet den Aufruf für das erste Wartezimmer:

@echo off
powershell -ExecutionPolicy Bypass -WindowStyle Hidden -File C:\Praxis\aufruf.ps1 -Wartezimmer 1 -Zimmer 3

-Wartezimmer 1 ist die erste Wartezimmer-ID im Skript und damit der Fernseher. -Zimmer 3 ist das Sprechzimmer in der Ansage. Auf einem anderen PC installieren.ps1 dort erneut ausführen und das Sprechzimmer dieses Platzes angeben.

6. Export: Pfad C:\Praxis\gdt, Dateiname aufruf.gdt. Den Zeichensatz auf Windows stellen, damit Umlaute im Namen ankommen.
7. Rücksprung aktivieren. Damit schreibt TURBOMED beim Klick die Daten des offenen Patienten in aufruf.gdt. Bei Rücksprung nur Pat.Nr. senden bleibt aus, sonst fehlt der Name.
8. Formular-Eintrag und Text-Eintrag bleiben aus. In die Karteikarte wird nichts zurückgeschrieben.
9. Übernehmen oder OK.

Fragt TURBOMED nach einer GDT-Kennung des Empfängers, genügt ein kurzer Name wie WZAUFRUF. Version und Satzart auf dem vorgeschlagenen Wert lassen.

Eintrag ins Menü Geräte übernehmen#

Die neue Anbindung ist damit gespeichert, im Menü Geräte aber noch nicht sichtbar. CGM beschreibt das im Anbindungsbeispiel so:

1. Wieder Alt+G, G. Die Anbindung Aufruf Wartezimmer 1 auswählen.
2. Gerät anbinden → Menue → Import.
3. Aufruf Wartezimmer 1 auswählen → OK.
4. Menü aktualisieren und die Nachfrage mit Ja bestätigen → Beenden.

Unter Geräte steht jetzt Aufruf Wartezimmer 1. Ein Klick darauf schreibt die GDT-Datei und startet den Aufruf. Die Akte nur zu öffnen tut das nicht.

Schritt 4: Knopf in die Symbolleiste legen#

1. In der Karteikarte mit der rechten Maustaste auf die Symbolleiste klicken → Anpassen.
2. Oben das Menü Geräte öffnen.
3. Aufruf Wartezimmer 1 mit gedrückter Maustaste in die Symbolleiste ziehen. Der Eintrag bleibt zusätzlich im Menü Geräte.
4. Speichern.

Aufruf im Alltag: Patient in der Karteikarte öffnen, den Knopf drücken. Erst dieser Klick schreibt die GDT-Datei und schickt den Request.

Weist TURBOMED danach auf eine fehlende Importdatei hin, ist der Aufruf auf dem Fernseher bereits erfolgt. In die Karteikarte wird nichts eingetragen.

Weitere Wartezimmer#

Für jeden weiteren Fernseher die Anbindung kopieren, falls der Knopf Kopieren vorhanden ist, sonst erneut Neu:

Export-Pfad, Dateiname aufruf.gdt und aufruf.ps1 bleiben gleich. Jede Anbindung danach wie oben ins Menü Geräte importieren und in die Symbolleiste ziehen.

Ohne diesen Knopf geht derselbe Request über das Dashboard: Formular Patient aufrufen, Wartezimmer und Zielraum wählen.

Videos auf jedem Fernseher#

Jedem Wartezimmer weisen Sie ein eigenes Bild oder Video zu.

• Videos laufen in der Schleife. Medien stumm schalten ist standardmäßig an und gilt für eigene Videos und YouTube. Ausgeschaltet bleibt der Ton hörbar und wird während einer Ansage leiser. YouTube kann Werbung einblenden.
• Bei einem Aufruf legt sich für etwa 10 Sekunden die große Anzeige (Name und Zimmer) über das Bild, die Ansage läuft, danach ist das Medium wieder zu sehen und läuft weiter.
• Ein Knopf gilt nur für die Wartezimmer-ID seiner Startdatei. Die anderen Fernseher laufen weiter.

Schritt 5: Testen#

1. Einen Patienten öffnen und warten. Auf dem Fernseher darf nichts passieren.
2. Den Knopf „Aufruf Wartezimmer 1“ drücken. Nur dieser Fernseher zeigt den Patienten, die Ansage läuft.
3. Einen anderen Patienten öffnen, ohne den Knopf zu drücken. Es bleibt still.

Häufige Fragen#

Jeder geöffnete Patient wird aufgerufen. Dann startet die GDT-Anbindung automatisch. Entfernen Sie diesen Automatismus. Es darf nur der Knopf in der Symbolleiste starten, und das Programm ignoriert eine GDT-Datei, die älter als 30 Sekunden ist.

Der Name ist leer oder falsch. Rücksprung muss an sein, „nur Pat.Nr. senden“ aus, der Zeichensatz auf Windows. In C:\Praxis\gdt\aufruf.gdt muss direkt nach dem Klick der Nachname im Feld 3101 stehen.

Nur ein Fernseher sollte reagieren, es reagieren alle. Dann zeigen mehrere Geräte denselben Anzeige-Link. Für getrennte Aufrufe braucht jeder Fernseher ein eigenes Wartezimmer.

Fehler 401 oder 403. Token falsch, oder der Tarif enthält keinen API-Zugriff. Der Benutzer des Tokens muss Mitglied des Teams sein, dem die Wartezimmer gehören.

Wir möchten denselben Film auf zwei Fernsehern eines Wartezimmers. Dafür reicht ein Wartezimmer. Den Anzeige-Link auf beiden Geräten öffnen. Der Knopf bleibt derselbe.

Wenn Sie beim Einrichten Unterstützung wünschen, schreiben Sie uns über Kontakt.