CGM TURBOMED – Patientenaufruf aus der Karteikarte

Der Aufruf ist ein einziger HTTPS-Request. CGM TURBOMED braucht dafür keine Geräteschnittstelle. Es genügt eine Schaltfläche, die diesen Request mit Name und Zimmer des offenen Patienten abschickt. Danach erscheinen Anzeige und Ansage auf genau dem Fernseher, dessen Wartezimmer-ID in der Adresse steht.

Voraussetzungen: CGM TURBOMED unter Windows, ein Konto bei Wartezimmer-Aufruf mit Tarif inklusive API-Zugriff und Internetzugang am Arbeitsplatz. Dauer: etwa 15 Minuten. Technische Referenz: Aufruf per API.

Menüpfade können sich mit der TURBOMED-Version ändern. An der jeweiligen Stelle öffnet F1 das passende Kapitel der Gebrauchsanweisung.

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

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 Wartebereich von mehreren Seiten einsehbar sein soll.

Getrennte Displays: 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 Wartebereiche, die unabhängig voneinander laufen, sind deshalb ein Standort und vier Wartezimmer – zum Beispiel „Wartebereich 1“ bis „Wartebereich 4“. Hintergründe dazu: Standorte & Wartezimmer.

So funktioniert der Aufruf#

Karteikarte in TURBOMED  ──Schaltfläche──▶  HTTPS-POST  ──▶  genau ein Fernseher

Die Wartezimmer-ID in der Adresse wählt den Fernseher. Das Feld room ist das Sprechzimmer in der Ansage und ist davon unabhängig. Jeder Arbeitsplatz kann jedes der vier Wartezimmer aufrufen, weil alle denselben Request schicken – nur mit einer anderen ID.

curl -s -X POST "https://wartezimmer-aufruf.de/api/waitingrooms/WARTEZIMMER-ID/invocations" \
  -H "Authorization: Bearer IHR-API-TOKEN" -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "{\"name\":\"Frau Müller\",\"room\":\"3\"}"

Antwort bei Erfolg: {"ok":true}.

Schritt 1: Vier Wartezimmer anlegen#

1. In Wartezimmer-Aufruf anmelden und unter Standorte einen Standort für die Praxis anlegen.
2. Unter Wartezimmer vier Wartezimmer erstellen, eines pro Fernseher.
3. Jedem Wartezimmer sein Medium zuweisen (Bild oder Video) und optional ein Laufband. Anleitung: Medien & Laufband.
4. Den Anzeige-Link jedes Wartezimmers nur auf dem Fernseher dieses Bereichs öffnen. Einrichtung: Anzeige auf den Fernseher bringen.
5. In jedem Wartezimmer die Wartezimmer-ID aus dem Kasten Aufruf aus der Praxissoftware (API) kopieren.

Dieselbe Praxis, mehrere Arbeitsplätze: Laden Sie Ihr Team ein, damit alle dieselben Wartezimmer sehen (Team & Benutzer).

Schritt 2: API-Token holen#

Oben rechts auf Ihren Namen → API Tokens → Token anlegen, zum Beispiel „TURBOMED Anmeldung“, und sofort kopieren. Er wird nur einmal angezeigt.

Empfehlung: pro Arbeitsplatz ein eigener Token. Die API ist in den Tarifen mit API-Zugriff enthalten (siehe Preise).

Schritt 3: Request vom Praxis-PC aus testen#

TURBOMED startet unter Windows ein Programm. Dieses Programm macht nichts weiter als den Request oben. Speichern Sie dafür C:\Praxis\aufruf.ps1 und tragen Sie Token und die vier IDs ein:

param(
    [Parameter(Mandatory = $true)][string]$Name,
    [Parameter(Mandatory = $true)][string]$Zimmer,
    [Parameter(Mandatory = $true)][ValidateSet("1","2","3","4")][string]$Bereich
)

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

$roomId = $ids[$Bereich]

try {
    Invoke-RestMethod -Method Post -Uri "https://wartezimmer-aufruf.de/api/waitingrooms/$roomId/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 -Bereich 1

Erscheint der Aufruf nur auf dem Fernseher von Wartebereich 1, stimmen Token und ID. Kopieren Sie den Ordner auf jeden Arbeitsplatz und tragen Sie dort den Token dieses Platzes ein.

-Zimmer ist das Sprechzimmer in der Ansage. Hat jeder Behandlungsraum einen eigenen PC, bleibt die Zimmernummer in der Befehlszeile dieses PCs fest.

Schritt 4: Schaltfläche in TURBOMED#

Legen Sie in TURBOMED eine Schaltfläche oder ein externes Programm an, das diese Befehlszeile startet. <Anrede> und <Nachname> ersetzen Sie durch die Platzhalter, die TURBOMED für den gerade offenen Patienten einsetzt:

powershell -ExecutionPolicy Bypass -WindowStyle Hidden -File C:\Praxis\aufruf.ps1 -Name "<Anrede> <Nachname>" -Zimmer 3 -Bereich 1

-Bereich 1 ist der Fernseher. Für die anderen drei Wartebereiche legen Sie drei weitere Schaltflächen an und ändern nur die Zahl (-Bereich 2, -Bereich 3, -Bereich 4). Dieselbe Schaltfläche auf jedem Arbeitsplatz ruft denselben Fernseher auf.

Wie die Schaltfläche in Ihrer TURBOMED-Version heißt, steht in der Hilfe unter F1. Die Frage an den CGM-Support lautet: „Wie starte ich per Schaltfläche in der Karteikarte ein externes Programm und übergebe Anrede und Nachname des aktuellen Patienten?“ Die Antwort setzen Sie in die Befehlszeile ein.

Aufruf im Alltag: Patient in der Karteikarte öffnen, Schaltfläche des Wartebereichs drücken. Der Request geht raus, der Fernseher reagiert.

Ohne Schaltfläche geht derselbe Aufruf über das Dashboard: Formular Patient aufrufen, dort Wartezimmer und Zielraum wählen. Das ist derselbe Request, nur aus dem Browser, und funktioniert auf jedem PC und Tablet.

Videos auf jedem Fernseher#

Jedem Wartezimmer weisen Sie ein eigenes Bild oder Video zu. Die vier Fernseher können deshalb unterschiedliche Filme zeigen.

• Videos laufen in der Schleife und ohne Ton. Die Sprachansage kommt über die Lautsprecher des Fernsehers und soll nicht von Filmmusik überdeckt werden. Hintergrundmusik aus der Videodatei wird nicht abgespielt.
• 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 Request gilt nur für die Wartezimmer-ID in der Adresse. Die anderen drei Fernseher laufen ungestört weiter.

Mehrere Arbeitsplätze#

Jeder PC mit dem Skript und einem gültigen Token kann alle vier Wartezimmer aufrufen. Die Wartezimmer gehören zum Team, nicht zu einem einzelnen Rechner.

Häufige Fragen#

Der Name in der Ansage ist leer oder falsch. Dann hat TURBOMED die Platzhalter nicht eingesetzt. Lassen Sie die Software den fertigen Befehl einmal anzeigen und vergleichen Sie ihn mit dem funktionierenden Test aus Schritt 3.

Nur ein Fernseher sollte reagieren, es reagieren alle. Dann zeigen mehrere Geräte denselben Anzeige-Link. Für getrennte Bereiche braucht jeder Fernseher ein eigenes Wartezimmer, und der Request muss dessen ID verwenden.

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 in einem großen Wartebereich auf zwei Fernsehern. Dafür reicht ein Wartezimmer. Den Anzeige-Link auf beiden Geräten öffnen. Der Request bleibt derselbe.

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