DICOM-Geräte und Mobilgeräte
Zwei Arten von Geräten verbinden sich direkt mit TCMSOFT, ohne Agent am Arbeitsplatz:
- DICOM-Geräte (Sonographie, Röntgen, Endoskopie, EKG …) senden ihre Bilder an den DICOM-Empfänger in TCMSOFT und holen sich die Patienten über die Worklist.
- Mobilgeräte mit der App „TCMSOFT Companion“ übertragen Fotos und gescannte Dokumente in die Akte.
DICOM-Geräte
Wozu und was es braucht
- Der DICOM-Empfänger läuft in TCMSOFT selbst. Ein Prismamed Agent ist dafür nicht nötig.
- Edition: ab TCMSOFTpro. In anderen Editionen fehlt der Menüpunkt Stammdaten › DICOM.
- Die Bilder erscheinen als Eintrag „DCM“ in der Akte des Patienten. Sie liegen in der Datenbank im Datenordner
(
mongodb/) und brauchen dort Platz. Für DICOM empfiehlt sich mehr Arbeitsspeicher als die 4 GB Mindestausstattung.
Netz und Port
| Was | Wert |
|---|---|
| Port | 11112 (Standard), einstellbar von 1024 bis 65535 |
| Richtung | eingehend am TCMSOFT-Server, aus dem Praxisnetz |
| Protokoll | DICOM über TCP: Bilder senden (C-STORE), Verbindungstest (C-ECHO), Worklist (C-FIND) – alles über denselben Port |
Docker: Der TCMSOFT-Container läuft im Host-Netz. Der DICOM-Port liegt deshalb direkt auf der NAS bzw. dem Server. Eine Port-Weiterleitung in Docker ist nicht nötig. Ändern Sie den Port in TCMSOFT, lauscht der Empfänger einige Sekunden nach dem Speichern auf dem neuen Port der NAS.
Firewall: Der Port muss auf dem Server bzw. in dessen Firewall für das Praxisnetz freigegeben sein. Ist auf einem Linux-Server ufw aktiv (
sudo ufw statuszeigt „Status: active“), geben Sie den Port so frei:sudo ufw allow 11112/tcp comment 'TCMSOFT DICOM'Bei einem anderen Port die Zahl anpassen. Bei einer NAS die Freigabe in deren Firewall-Einstellungen eintragen, falls die Firewall eingeschaltet ist.
Belegt ein anderes Programm den Port, startet der Empfänger nicht (siehe Typische Fehler).
Empfänger einschalten
- In TCMSOFT Stammdaten › DICOM öffnen. Die Seite heißt DICOM-Empfänger.
- In der Karte Einstellungen den Schalter Empfänger einschalten setzen.
- Port (Standard 11112) und AE-Title von TCMSOFT (Standard „TCMSOFT“, höchstens 16 Zeichen) prüfen.
- Bei Bedarf Maximale Größe je Objekt (MB) anpassen (Standard 500). Größere Objekte, etwa sehr lange Clips, weist TCMSOFT ab; das Gerät meldet einen Sendefehler, unter Nachrichten (Glocke) erscheint ein Hinweis mit der Größe.
- Oben Speichern klicken.
Woran Sie den Erfolg erkennen: Nach wenigen Sekunden zeigt die Karte Status beim Empfänger „Läuft seit … auf Port 11112“. Unter Adresse für die Geräte steht, was am Gerät als Ziel einzutragen ist. Läuft TCMSOFT im Container, steht dort statt einer Adresse: „TCMSOFT läuft in einem Container - am Gerät die Adresse der NAS bzw. des Servers eintragen, Port 11112.“
Gerät in TCMSOFT eintragen
- In der Karte DICOM-Geräte auf Neues Gerät klicken.
- Ausfüllen und Anlegen klicken:
| Feld | Inhalt |
|---|---|
| Bezeichnung | Pflicht, z. B. „Sono Raum 2“. So erscheint das Gerät in der Akte |
| AE-Title des Geräts | Pflicht, 1 bis 16 Zeichen. Der Name, mit dem sich das Gerät meldet (am Gerät meist „AE Title“ oder „Station Name“). Groß-/Kleinschreibung ist egal; jeder AE-Title nur einmal |
| Modalität | z. B. US, DX/CR, ECG, ES, OT. Nur zur Information |
| Aktiv | Ein inaktives Gerät wird abgewiesen, wenn Nur bekannte Geräte annehmen an ist |
| Terminkategorien für die Worklist | Termine dieser Kategorien stehen automatisch auf der Worklist dieses Geräts |
| Bemerkung | Freitext |
Am Gerät eintragen
Am Gerät heißt das Ziel meist „PACS“, „Storage SCP“ oder „Sendeziel“.
| Einstellung am Gerät | Wert |
|---|---|
| IP-Adresse / Host | die Adresse aus Status › Adresse für die Geräte, im Container die Adresse der NAS bzw. des Servers |
| Port | 11112 bzw. der eingestellte Port |
| AE-Title des Ziels | TCMSOFT bzw. der eingestellte AE-Title |
| Eigener AE-Title | genau wie in TCMSOFT beim Gerät eingetragen |
Für die Worklist tragen Sie dieselbe Adresse, denselben Port und denselben AE-Title ein.
Woran Sie den Erfolg erkennen: Starten Sie am Gerät den Verbindungstest (C-ECHO). Danach steht in der Karte DICOM-Geräte beim Gerät der Letzte Kontakt, und Status › Letzte Verbindung nennt den AE-Title des Geräts.
Freigabe: nur bekannte Geräte
Sind alle Geräte eingetragen, schalten Sie in Einstellungen Nur bekannte Geräte annehmen ein und speichern. Dann nimmt TCMSOFT nur noch Geräte an, die mit ihrem AE-Title eingetragen und aktiv sind. Abgewiesene Verbindungen zählt Status › Seit dem Start empfangen.
Worklist
Über die Worklist holt sich das Gerät den Patienten selbst. Die Bilder landen dann über die Auftragsnummer sicher in der richtigen Akte. Auf die Worklist kommen Patienten:
- über Termine der Terminkategorien, die beim Gerät hinterlegt sind,
- aus der Akte: Menü › Auf DICOM-Worklist setzen,
- aus dem Wartezimmer: über das Röntgen-Symbol auf der Karte des Patienten (nur, wenn aktive DICOM-Geräte eingetragen sind).
Die Karte Worklist unter Stammdaten › DICOM zeigt je Tag, was die Geräte sehen. Mit Untersuchung eintragen setzen Sie einen Patienten von Hand auf die Liste. Offene Einträge, deren geplanter Beginn mehr als 3 Tage zurückliegt, bricht TCMSOFT automatisch ab. Die meisten Geräte fragen nur den aktuellen Tag ab.
Typische Fehler
| Zustand | Ursache | Was tun |
|---|---|---|
| Empfänger zeigt „Gestört“, darunter „Der DICOM-Empfänger konnte nicht gestartet werden: Port … ist auf diesem Server bereits belegt oder darf nicht geöffnet werden. …“ | Ein anderes Programm nutzt den Port | Anderen Port ab 1024 wählen, speichern und am Gerät nachziehen |
| Das Gerät meldet „Association rejected“ | Nur bekannte Geräte annehmen ist an, der AE-Title des Geräts fehlt in TCMSOFT oder das Gerät ist inaktiv | Gerät eintragen bzw. aktivieren |
| Verbindungstest scheitert, in TCMSOFT kein Letzter Kontakt | Falsche Adresse oder falscher Port am Gerät, Firewall | Adresse und Port vergleichen, Freigabe des Ports prüfen |
| Das Gerät bekommt keine Worklist | Kein eigener AE-Title am Gerät, Eintrag gehört zu einem anderen Gerät oder ist nicht für heute geplant | Am Gerät einen eigenen AE-Title setzen; Eintrag prüfen |
| Bilder liegen im Eingang statt in der Akte | TCMSOFT konnte den Patienten nicht sicher erkennen (Gerät ohne Worklist, anders geschriebener Name) | Im Eingang zuordnen lassen; besser die Worklist nutzen |
| Gerät meldet Sendefehler bei großen Clips | Objekt größer als Maximale Größe je Objekt (MB) | Wert erhöhen (höchstens 4000) |
Weitere Hinweise für Anwender: Benutzerhandbuch › Stammdaten › DICOM.
Mobilgeräte (Companion-App)
Wozu und was es braucht
Mit der App TCMSOFT Companion fotografiert oder scannt das Praxisteam Dokumente und überträgt sie direkt in die Akte. Dazu wird jedes Handy einmal mit TCMSOFT gekoppelt.
- Edition: ab TCMSOFTsingle Unlimited. In TCMSOFTsingle fehlt der Menüpunkt Stammdaten › Mobilgeräte.
- App: „TCMSOFT Companion“ für Android und iPhone, kostenlos im App Store und bei Google Play (Anbieter Prismamed GmbH). TCMSOFT arbeitet mit App-Versionen ab 1.0 zusammen (Versionsangabe wie im App Store).
- Handy: Es ist im Praxis-WLAN, von dem aus TCMSOFT erreichbar ist, und hat eine Displaysperre.
- Netz: Das Handy spricht TCMSOFT über dessen normale Adresse und denselben Port an wie die Browser
(Schnittstelle
api/companion). Ein eigener Port ist nicht nötig.
Die Adresse für Handys
Beim Koppeln fragt TCMSOFT nach der Adresse für Handys: der Adresse, unter der das Handy TCMSOFT im Praxis-WLAN
erreicht. Meist ist es dieselbe wie im Browser der Arbeitsplätze, z. B. http://192.168.178.59:8085/.
- Die Adresse muss vollständig sein und mit
http://oderhttps://beginnen. Benutzername, „?“ und „#“ sind nicht erlaubt. - Auch über
http://sind die Übertragungen geschützt: Jede Nachricht ist zusätzlich mit dem Schlüssel des Handys verschlüsselt. - Keine
localhost-Adresse: Unter ihr findet das Handy TCMSOFT nicht. TCMSOFT warnt dann. - Namen mit
.local: Android-Handys finden sie oft nicht. TCMSOFT warnt; tragen Sie besser die IP-Adresse ein. - Mikroserver mit Caddy: TCMSOFT lauscht dort nur auf
127.0.0.1:5000und ist nur über Caddy erreichbar. Tragen Sie die Adresse ein, unter der die Arbeitsplätze TCMSOFT über Caddy öffnen, nie Port 5000. - HTTPS mit eigenem Zertifikat (z. B. dem der NAS): Ob die App einem Zertifikat vertraut, das nicht von einer anerkannten Stelle stammt, ist nicht getestet – vor dem Einsatz beim TCMSOFT-Support nachfragen.
Test: Öffnen Sie die Adresse im Browser des Handys. Erscheint die Anmeldeseite von TCMSOFT, ist TCMSOFT vom Handy aus erreichbar.
TCMSOFT merkt sich die Adresse für die nächste Kopplung.
Koppeln
- Stammdaten › Mobilgeräte öffnen und Handy koppeln klicken.
- Bezeichnung eintragen (Pflicht, höchstens 50 Zeichen, z. B. „Handy Anmeldung“) und die Adresse für Handys prüfen.
- QR-Code anzeigen klicken. Der Code gilt 15 Minuten und nur für ein Handy.
- Am Handy die App öffnen, Kopplungs-Code scannen antippen und den Code scannen.
Woran Sie den Erfolg erkennen: Das Fenster zeigt „Gekoppelt mit „…“ (…, App …) um … Uhr.“ mit Hersteller, Modell, System und App-Version des Handys. In der Liste steht beim Handy grün „Gekoppelt · zuletzt aktiv …“. Nennt das Fenster ein Handy, das nicht Ihres ist, schließen Sie das Fenster und entfernen Sie das Handy sofort.
Wird das Fenster geschlossen, bevor sich ein Handy gemeldet hat, entfernt TCMSOFT den offenen Eintrag wieder und meldet Nicht gekoppelt.
Status in der Liste
| Status | Farbe | Was tun |
|---|---|---|
| „Gekoppelt · zuletzt aktiv …“ | grün | nichts |
| „Wartet auf Kopplung bis … Uhr“ bzw. „Kopplung läuft“ | orange | warten |
| „Kopplung nicht abgeschlossen – bitte entfernen und neu koppeln“ | rot | Handy entfernen und neu koppeln |
| „Kopplungs-Code abgelaufen – bitte entfernen und neu koppeln“ | rot | Handy entfernen und neu koppeln |
Die Liste lädt sich alle 30 Sekunden neu.
Handy sperren
Ein verlorenes Handy oder das Handy eines ausgeschiedenen Mitarbeiters entfernen Sie sofort: Papierkorb in der Zeile (Handy entfernen), Rückfrage bestätigen. Das Handy kann ab sofort nichts mehr übertragen. In der App erscheint beim nächsten Versuch der Hinweis, es neu zu koppeln.
Für den Support
- Ohne passende Edition antwortet TCMSOFT der App mit HTTP 403 und dem Code
LIZENZ. - Abgelehnte Handys stehen im Programmprotokoll von TCMSOFT als „Companion … abgelehnt: Gerät … nicht gekoppelt oder Schlüssel falsch.“ (siehe Protokolle und Diagnose).
- Will ein zweites Handy denselben Kopplungs-Code nutzen, meldet die App, dass der Code nicht mehr gültig ist.
- Der Patienten-Code (QR-Code im Aktenkopf und auf Ausdrucken) hängt an einem Geheimnis in der Datenbank. Es ändert sich nur, wenn der Support die Datenbank im Servermanagement neu einrichtet (Datenbank neu initialisieren, Demodaten installieren, Datenübernahme). Danach passen schon gedruckte Patienten-Codes nicht mehr, und alle Handys müssen neu gekoppelt werden.
Weitere Hinweise für Anwender: Benutzerhandbuch › Stammdaten › Mobilgeräte.