Prismamed Agent

Der Prismamed Agent ist ein kleines Programm am Arbeitsplatz, unter Windows mit einem Symbol im Infobereich der Taskleiste, am Mac mit einem Symbol in der Menüleiste. Er verbindet Geräte, Labor und Scanner des Rechners mit TCMSOFT:

• Er schreibt GDT-Anforderungen für Messgeräte und startet die Gerätesoftware.
• Er überwacht Import-, Labor-, Bestätigungs- und Scan-Ordner und lädt neue Dateien zu TCMSOFT hoch.
• Er übergibt Patienten an die Auftragsprogramme (Order-Entry) der Labore.
• Er nimmt Scans von der Scannersoftware entgegen.

Was der Agent tun soll, wird nur in TCMSOFT eingestellt. Am Arbeitsplatz wird nur installiert, gekoppelt und nachgesehen.

Aktuelle Version: 2026.11.201. Edition: ab TCMSOFTpro (die Seite Stammdaten › Agenten gibt es erst dort). Welcher Agent wofür da ist, steht unter Die Agenten im Überblick.

Auf einen Blick

Installation unter Windows

Wozu: Der Agent muss auf dem Rechner laufen, an dem die Gerätesoftware läuft, Labordateien ankommen, das Auftragsprogramm eines Labors läuft oder der Scanner hängt.

Voraussetzungen

• Das Windows-Konto, mit dem am Arbeitsplatz gearbeitet wird. Ein Administrator ist nicht nötig.
• Der Rechner erreicht TCMSOFT unter der Adresse, unter der die Praxis TCMSOFT im Browser öffnet.
• Für Updates: Zugang zu https://downloads.tcmsoft.de (Port 443).

Herunterladen

1. TCMSOFT am besten an dem Rechner öffnen, auf dem der Agent laufen soll.
2. Stammdaten › Agenten › Agent herunterladen… klicken. Das Fenster „Prismamed Agent herunterladen“ zeigt je eine Karte Windows, Mac mit Apple-Chip und Mac mit Intel-Prozessor.
3. Bei Windows auf Herunterladen klicken.

Ohne TCMSOFT am Rechner führt dieser Link immer zum aktuellen Setup:

https://downloads.tcmsoft.de/agent/PrismamedAgent-Setup.exe

Den Link der Schaltfläche Herunterladen können Sie mit der rechten Maustaste › „Link-Adresse kopieren“ weitergeben; er führt zu genau der gezeigten Version. Die Download-Ordner zeigen keine Verzeichnisliste, deshalb immer die Datei verlinken.

Steht in einer Karte statt der Schaltfläche ein Text, ist der Download-Server von TCMSOFT aus gerade nicht erreichbar, antwortet nicht wie erwartet oder für diese Plattform ist noch keine Version veröffentlicht. Ist der Server nicht erreichbar, nennt der Text die Datei unter festem Namen zum direkten Laden.

Installieren

1. Mit dem Windows-Konto anmelden, mit dem am Arbeitsplatz gearbeitet wird.
2. Das Setup per Doppelklick starten. Nicht „Als Administrator ausführen“ wählen.
3. Das Setup installiert den Agenten für dieses Konto nach %LocalAppData%\PrismamedAgent, legt die Verknüpfung „Prismamed Agent“ im Startmenü und im Autostart an und startet den Agenten. Ein Desktop-Symbol gibt es nicht.

Melden sich am Rechner mehrere Windows-Konten an, führen Sie das Setup in jedem Konto aus, in dem der Agent laufen soll. Die Kopplung gilt für den ganzen Rechner (siehe Mehrere Benutzerkonten und Terminalserver).

Woran Sie den Erfolg erkennen

• Im Infobereich der Taskleiste erscheint die Raute des TCMSOFT-Logos, zunächst blass (noch nicht gekoppelt).
• Das Fenster Prismamed Agent öffnet sich mit dem Bereich Mit TCMSOFT koppeln. Weiter unter Mit TCMSOFT koppeln.

Wenn nicht

Autostart

Die Verknüpfung „Prismamed Agent“ liegt im Autostart-Ordner des Windows-Kontos. Wird sie gelöscht, legt der Agent sie nicht von selbst wieder an. Er meldet dann in TCMSOFT unter Stammdaten › Agenten einen Update-Hinweis, der so beginnt: „Der Autostart des Agenten fehlt - nach der nächsten Anmeldung startet er nicht von selbst.“ Abhilfe: das Setup im selben Konto erneut ausführen.

Installation am Mac

Voraussetzungen

• macOS 12 oder neuer.
• Das Benutzerkonto, mit dem am Mac gearbeitet wird. Administratorrechte sind nicht nötig (siehe unten).
• Für Updates: Zugang zu https://downloads.tcmsoft.de (Port 443).

Welche Fassung

Apple-Menü › Über diesen Mac:

• Steht dort „Chip Apple M…“, nehmen Sie die Fassung Mac mit Apple-Chip.
• Steht dort „Prozessor … Intel …“, nehmen Sie die Fassung Mac mit Intel-Prozessor.

Ohne TCMSOFT am Mac führen diese Links zur aktuellen Fassung:

https://downloads.tcmsoft.de/agent/PrismamedAgent-osx-arm64.dmg
https://downloads.tcmsoft.de/agent/PrismamedAgent-osx-x64.dmg

Die erste ist für Apple-Chip, die zweite für Intel. Updates folgen der Fassung, die läuft: Eine Intel-Fassung auf einem Mac mit Apple-Chip bleibt eine Intel-Fassung.

Installieren

1. Mit dem Benutzerkonto anmelden, mit dem am Mac gearbeitet wird.
2. Die DMG über Stammdaten › Agenten › Agent herunterladen… oder über den Link oben laden und öffnen.
3. Im Fenster der DMG Prismamed Agent auf den Ordner Applications ziehen (das ist der Ordner „Programme“).
4. Den Agenten im Ordner Programme mit Doppelklick starten.

Ohne Administratorrechte darf das Konto nicht in den Ordner „Programme“ des Systems schreiben. Legen Sie dann im Benutzerordner einen Ordner Applications an (macOS legt ihn nicht von selbst an, der Finder zeigt ihn als „Programme“) und ziehen Sie den Agenten dorthin.

Ein Installationsskript gibt es nicht. Das Programm heißt Prismamed Agent.app, die Bundle-ID ist de.prismamed.agent.

Gatekeeper

Programm und DMG sind mit einer Developer ID von Apple signiert und von Apple notarisiert. Beim ersten Öffnen fragt macOS wie bei jedem aus dem Internet geladenen Programm einmal nach; bestätigen Sie mit Öffnen.

Startet jemand den Agenten direkt aus dem Fenster der DMG (oder hat macOS ihn an einen Zufallsort verschoben, weil er nicht in „Programme“ liegt), zeigt er diese Meldung und beendet sich:

„Bitte ziehen Sie „Prismamed Agent“ in den Ordner „Programme“ (im Fenster der heruntergeladenen Datei: auf den Ordner „Applications“) und starten Sie ihn dort mit einem Doppelklick. Direkt aus der heruntergeladenen Datei kann er nicht laufen.“

Lässt macOS das Programm gar nicht öffnen, setzen Sie bitte nicht die Sicherheitseinstellungen herab, sondern melden Sie das dem TCMSOFT-Support.

Autostart

Der Agent richtet seinen Autostart beim ersten Start selbst ein, ohne Administrator: ~/Library/LaunchAgents/de.prismamed.agent.plist. Er prüft die Datei bei jedem Start und passt sie an, wenn das Programm verschoben wurde. macOS meldet dabei einmal „Hintergrundobjekt hinzugefügt“. Das ist normal. Ab der nächsten Anmeldung startet der Agent von selbst.

Kann der Agent den Autostart nicht anlegen, steht in TCMSOFT der Update-Hinweis „Der Autostart des Prismamed Agent konnte nicht eingerichtet werden …“. Abhilfe: den Agenten einmal über den Ordner „Programme“ starten. Hilft das nicht, das Protokoll an den Support senden.

Rückfragen von macOS

Der Text der Rückfrage zum lokalen Netzwerk lautet: „Der Prismamed Agent verbindet sich mit TCMSOFT in Ihrem Praxisnetz, um Befunde von Geräten und Labor sowie Scans zu übertragen.“

Wurde eine Rückfrage abgelehnt:

• Lokales Netzwerk: Das Koppeln scheitert mit „Keine Verbindung zum Server: …“; ein schon gekoppelter Agent zeigt „Keine Verbindung: Keine Verbindung zum Server: …“. Unter Systemeinstellungen › Datenschutz & Sicherheit › Lokales Netzwerk den „Prismamed Agent“ einschalten.
• Ordnerzugriff: Der Agent meldet beim Ordner „Ordner nicht gefunden - existiert er, und hat der Agent Zugriff? Am Mac: Systemeinstellungen › Datenschutz & Sicherheit › Dateien und Ordner – dort beim „Prismamed Agent“ den Ordner erlauben.“ Genau dort den Zugriff erlauben.

Woran Sie den Erfolg erkennen

• Oben rechts in der Menüleiste erscheint die Raute des TCMSOFT-Logos. Im Dock erscheint kein Symbol, das ist so gewollt.
• Das Fenster Prismamed Agent öffnet sich mit dem Bereich Mit TCMSOFT koppeln.

Wenn nicht

Stürzt der Agent am Mac nach mindestens einer Minute Laufzeit ab, startet er sich von selbst neu.

Mit TCMSOFT koppeln

Wozu: Durch die Kopplung weiß der Agent, mit welchem TCMSOFT er arbeitet, und TCMSOFT gibt ihm einen eigenen Schlüssel. Danach verbindet sich der Agent bei jedem Start von selbst.

In TCMSOFT einen Agenten anlegen

1. TCMSOFT unter der Adresse öffnen, unter der der Arbeitsplatz TCMSOFT erreicht. Das Fenster mit dem Code zeigt als Server-Adresse genau die Adresse aus dem Browser. Öffnen Sie TCMSOFT auf dem Server selbst über localhost, steht dort localhost, und das passt für keinen anderen Rechner.
2. Stammdaten › Agenten › Neu. Das Fenster „Agent anlegen“ öffnet sich.
3. Bezeichnung eintragen, am besten der Arbeitsplatz, z. B. „Anmeldung links“ oder „EKG-Rechner“. Laborordner und Scan-Ordner können Sie gleich oder später eintragen.
4. Anlegen klicken. TCMSOFT zeigt sofort das Fenster „Agent „…“ koppeln“ mit dem Kopplungscode (sechs Ziffern, „Gültig bis … Uhr“) und der Server-Adresse.

Der Code ist zufällig, gilt 15 Minuten und nur einmal. Einen neuen Code bekommen Sie jederzeit über das Schlüsselsymbol Kopplungscode erzeugen in der Zeile des Agenten, z. B. wenn der Code abgelaufen ist oder der Rechner neu installiert wurde.

Am Arbeitsplatz koppeln

1. Das Fenster des Agenten öffnen. Ist er noch nicht gekoppelt, öffnet es sich beim Start von selbst. Sonst unter Windows auf das Symbol klicken, am Mac im Menü des Symbols Einstellungen… wählen. Den Bereich Mit TCMSOFT koppeln zeigt das Fenster nur, solange der Agent nicht gekoppelt ist (siehe Neu koppeln).
2. Im Bereich Mit TCMSOFT koppeln die Server-Adresse und den Kopplungscode eintragen.
3. Koppeln klicken. Der Agent zeigt „Verbinde…“ und danach „Gekoppelt mit …“ mit dem Namen der Praxis.

Zur Server-Adresse:

• Die Adresse, unter der TCMSOFT im Browser läuft, z. B. https://praxis.tcmsoft.local oder http://192.168.1.10:5159.
• Ohne http:// oder https:// ergänzt der Agent https://.
• Andere Schemata lehnt er ab. Ein Pfad hinter der Adresse wird abgeschnitten; es zählen nur Schema, Name und Port.
• Bei https:// muss der Rechner dem Zertifikat von TCMSOFT vertrauen. Siehe Netzwerk und HTTPS.

Beim Koppeln meldet der Agent Rechnername, Betriebssystem und Version an TCMSOFT. TCMSOFT erzeugt einen API-Schlüssel, speichert davon nur einen Hash und löscht den Code. Der Agent legt den Schlüssel in agent.json ab und weist sich damit bei jeder Anfrage aus.

Woran Sie den Erfolg erkennen

• Im Fenster des Agenten steht statt des Kopplungsbereichs der Bereich Verbindung mit „… – dieser Arbeitsplatz heißt dort „…““, „Server: … · gekoppelt am …“ und „Letzter Kontakt: …“.
• Das Symbol ist kräftig, das Menü zeigt „Verbunden mit …“.
• In TCMSOFT unter Stammdaten › Agenten steht der Agent auf Online, mit Rechnername (Spalte Arbeitsplatz), System und Version. Unter Letzte Meldung steht zuerst „Gekoppelt“, danach z. B. „2 Ordner überwacht“.

Wenn nicht

Den Fehlertext hinter „Keine Verbindung zum Server:“ liefert das System, außer bei einem nicht vertrauenswürdigen Zertifikat: Das erkennt der Agent und sagt es mit eigenen Worten.

Kopplung per Kommandozeile

Für Installationsskripte lässt sich der Agent ohne Fenster koppeln. Der Befehl koppelt nur und endet dann. Rückgabewert 0 heißt gekoppelt, 1 heißt Fehler; die Meldung schreibt der Agent in die Konsole.

"%LocalAppData%\PrismamedAgent\current\Prismamed.Agent.exe" --koppeln <Server-Adresse> <Kopplungscode>

Der Agent ist ein Fensterprogramm, kein Konsolenprogramm. Damit ein Skript auf das Ende wartet und den Rückgabewert sicher bekommt, in PowerShell so aufrufen; maßgeblich ist dann der Rückgabewert:

$p = Start-Process -FilePath "$env:LOCALAPPDATA\PrismamedAgent\current\Prismamed.Agent.exe" -ArgumentList '--koppeln','<Server-Adresse>','<Kopplungscode>' -Wait -PassThru
$p.ExitCode

Läuft der Agent schon und war er noch nicht gekoppelt, übernimmt er eine so geschriebene Kopplung innerhalb von 5 Sekunden. War er schon gekoppelt, übernimmt er den neuen Schlüssel, sobald TCMSOFT den alten abweist, also beim nächsten Heartbeat (höchstens etwa 30 Sekunden). Weil die Kopplung im gemeinsamen Datenordner liegt, gilt sie unter Windows für alle Konten des Rechners.

Am Mac ist der Aufruf aus dem Code abgeleitet, aber nicht gesondert getestet. Er muss im Benutzerkonto laufen, in dem der Agent arbeitet:

"/Applications/Prismamed Agent.app/Contents/MacOS/Prismamed.Agent" --koppeln <Server-Adresse> <Kopplungscode>

Neu koppeln, Kopplung aufheben, Serverwechsel

• Neu koppeln geht jederzeit mit einem neuen Code aus Kopplungscode erzeugen, z. B. nachdem der Rechner neu aufgesetzt wurde. Ein erneut ausgeführtes Setup braucht keine neue Kopplung, solange der Datenordner erhalten bleibt. In TCMSOFT bleibt der alte Schlüssel gültig, bis die neue Kopplung gelingt. Ist der Agent am Arbeitsplatz noch gekoppelt, im Fenster zuerst Kopplung aufheben klicken; dann erscheint wieder der Bereich Mit TCMSOFT koppeln, die bisherige Server-Adresse steht schon darin. Ohne Fenster geht es mit --koppeln (siehe oben).
• Kopplung aufheben im Fenster des Agenten hebt die Kopplung nur am Arbeitsplatz auf. Die Ordnerüberwachung endet, und der Agent zeigt „Kopplung aufgehoben. In TCMSOFT unter Stammdaten / Agenten einen neuen Code erzeugen, um wieder zu koppeln.“ In TCMSOFT bleibt der Eintrag stehen, bis er dort entfernt wird.
• Neue Adresse von TCMSOFT (Umzug, anderer Port, Umstellung auf HTTPS): Die Server-Adresse lässt sich im Fenster nicht ändern. Jeden Agenten wie eben beschrieben mit der neuen Adresse und einem neuen Code neu koppeln. Der Agent erkennt dabei denselben Agenteneintrag und überträgt Scans, die noch warteten, danach an die neue Adresse; das gilt über das Fenster wie mit --koppeln.
• Anderer Server: Kopplung aufheben, dann mit der neuen Server-Adresse und einem Code des neuen Servers koppeln. Scans, die noch für den bisherigen Server warteten, verwirft der Agent dabei; das Original liegt weiter im Ordner der Scannersoftware.
• In TCMSOFT entfernt oder deaktiviert: TCMSOFT weist den Agenten ab mit „Der Agent ist nicht (mehr) gekoppelt. Koppeln Sie ihn in TCMSOFT unter Stammdaten / Agenten erneut.“ Der Agent zeigt „Keine Verbindung: …“ und nimmt keine Scans der Scannersoftware mehr an. Ein deaktivierter Agent behält seine Geräte und Ordner in TCMSOFT; nach dem Aktivieren arbeitet er beim nächsten Kontakt weiter.

So arbeitet der Agent

Verbindung

Der Agent verbindet sich immer von sich aus mit TCMSOFT, über die Server-Adresse aus der Kopplung. Er öffnet keinen Port am Arbeitsplatz. In der Firewall des Arbeitsplatzes ist deshalb nichts freizugeben; der Arbeitsplatz muss TCMSOFT nur so erreichen wie der Browser.

Heartbeat und Konfiguration

• Alle 30 Sekunden meldet sich der Agent bei TCMSOFT, nach einem Fehler schon nach 10 Sekunden.
• Er meldet seine Version, den Zustand der Ordner und den Stand des Selbst-Updates. In TCMSOFT steht das unter Stammdaten › Agenten in der Spalte Letzte Meldung, z. B. „3 Ordner überwacht“, „2 Datei(en) warten auf Übertragung“ oder der Fehler eines Ordners. Meldet der Agent einen Fehler, steht er auf Gestört.
• Ändert sich in TCMSOFT etwas an Geräten, Laboren oder Ordnern, holt der Agent die neue Konfiguration beim nächsten Heartbeat ab.
• Meldet sich ein Agent 90 Sekunden nicht, steht er in TCMSOFT auf Offline. Die Liste lädt sich alle 30 Sekunden neu.

Aufträge

TCMSOFT gibt dem Agenten Aufträge, z. B. „Untersuchung starten“ in der Akte oder die Übergabe an das Auftragsprogramm eines Labors. Ein Auftrag heißt hier: eine Datei in einen Ordner schreiben und auf Wunsch ein Programm starten.

• Der Agent fragt ständig nach neuen Aufträgen; TCMSOFT hält jede Anfrage bis zu 25 Sekunden offen. Ein Auftrag kommt deshalb ohne spürbare Verzögerung an.
• Hat ein Agent einen Auftrag abgeholt, aber nach 5 Minuten kein Ergebnis gemeldet, darf er ihn erneut abholen.
• Ein Auftrag, den 24 Stunden lang niemand abholt, verfällt. TCMSOFT schreibt dann die Nachricht „Aufträge an den Agenten verfallen“.
• Ist der Agent des Arbeitsplatzes nicht verbunden, lässt sich eine Untersuchung in der Akte gar nicht erst starten.

GDT-Ablauf

1. In TCMSOFT ist das Gerät unter Stammdaten › Dokumentationstypen › Neues Gerät (GDT) eingerichtet, Reiter GDT-Verbindung, mit diesem Agenten unter Agent (Arbeitsplatz).
2. In der Akte klickt jemand Untersuchung starten.
3. Der Agent schreibt die Anforderung nach Exportordner / Dateiname. Der Zeichensatz ist standardmäßig CP437.
4. Ist Geräteprogramm starten eingeschaltet, startet er das Programm mit dem Inhalt von Parameter. Dort gibt es die Platzhalter {datei} (vollständiger Pfad), {dateiname} und {ordner}.
5. Das Gerät legt sein Ergebnis im Importordner ab. Dateimuster ist standardmäßig *.gdt, mehrere Muster mit Semikolon.
6. Der Agent lädt die Datei hoch. Mit ihr gehen Dateien, auf die die GDT-Datei im Feld 6305 verweist, und alles im Ordner für Zusatzdateien.
7. Der Eintrag erscheint in der Akte.

Zum Prüfen ohne Patienten: Testdatei senden auf der Seite des Geräts schreibt eine Musteranforderung für einen Musterpatienten (und startet das Programm, falls eingestellt). Ob es geklappt hat, zeigt die Datei im Exportordner und das Protokoll des Agenten („GDT-Datei geschrieben: …“). Scheitert der Auftrag, legt TCMSOFT die Nachricht „Auftrag am Arbeitsplatz fehlgeschlagen“ mit dem Grund an. Die Spalte Letzte Meldung unter Stammdaten › Agenten zeigt den Zustand der Ordner aus dem Heartbeat, nicht das Ergebnis eines Auftrags, auch wenn die Meldung nach dem Klick darauf verweist.

Typische Fehler beim Schreiben (sie stehen in der Nachricht „Auftrag am Arbeitsplatz fehlgeschlagen“):

• „Der Exportordner „…“ wurde auf diesem Rechner nicht gefunden.“ Den Pfad unter GDT-Verbindung prüfen; er muss auf dem Rechner des Agenten gelten.
• „Das Geräteprogramm „…“ wurde nicht gefunden. Die GDT-Datei wurde trotzdem geschrieben.“ Den Programmpfad korrigieren.

Programmstart am Mac

Am Mac ist ein Programm meist ein Bundle, z. B. /Applications/EKG.app.

• Tragen Sie unter Programm das Bundle ein. Die Endung .app darf fehlen, der Finder zeigt sie ohnehin nicht an.

• Der Agent startet das Bundle wie der Finder:

  /usr/bin/open -a "/Applications/EKG.app" --args <Parameter>
  

• Läuft das Programm schon, holt macOS es nur nach vorn. Die Parameter erreichen es dann nicht. Die meisten Geräteprogramme lesen die Anforderung ohnehin aus ihrem Ordner.

• Braucht ein Programm die Parameter bei jedem Aufruf, tragen Sie die ausführbare Datei im Bundle ein, z. B. /Applications/EKG.app/Contents/MacOS/EKG (im Finder: Rechtsklick auf das Programm › Paketinhalt zeigen › Contents › MacOS). Das startet das Programm allerdings jedes Mal neu.

Vom Agenten gestartete Programme laufen weiter, wenn der Agent endet, z. B. bei einem Update.

Ordnerüberwachung

• Welche Ordner überwacht werden, kommt nur aus TCMSOFT: Importordner der Geräte, Laborordner, Bestätigungsordner der Labore und Scan-Ordner.
• Je Ordner beobachtet der Agent die Dateiereignisse von Windows bzw. macOS und sieht zusätzlich alle 30 Sekunden nach, bei Scan-Ordnern alle 5 Sekunden. Auf Netzlaufwerken gehen Dateiereignisse gern verloren; der Durchlauf fängt das ab.
• Eine Datei wird erst übernommen, wenn sie 2 Sekunden unverändert ist und sich exklusiv öffnen lässt. Liegt ihre Dateizeit in der Zukunft (Uhr eines Netzlaufwerks geht vor), wartet der Agent auf einen zweiten, unveränderten Blick.
• Scheitert das Hochladen, bleibt die Datei liegen. Neue Versuche nach 30 Sekunden, 1 Minute, 2 Minuten und so weiter, höchstens alle 10 Minuten. Im Fenster steht beim Ordner „… wartet: …“ mit Dateiname und Grund.
• Ein Upload darf 60 Sekunden plus 1 Sekunde je 25 KB dauern.
• Ordner jetzt prüfen (Menü oder Fenster) stößt sofort einen Durchlauf an.
• Fehlt ein Ordner oder ist er nicht lesbar, meldet der Agent „Ordner nicht gefunden - existiert er, und hat der Agent Zugriff?“; das Symbol zeigt ein Ausrufezeichen.

Archiv

• Nach dem Hochladen verschiebt der Agent die Datei nach <Ordner>/archiv/<JJJJ-MM>/<Dateiname>. Gibt es den Namen dort schon, hängt er die Uhrzeit an (_HHmmss).
• Ist bei einem Gerät Archiv behalten aus, löscht er die Datei nach dem Hochladen. Labor-, Bestätigungs- und Scan-Ordner archivieren immer.
• Leere Dateien archiviert er, ohne sie hochzuladen.

Der Archivordner wächst mit der Zeit; der Agent löscht dort nichts. Die Dateien enthalten Patientendaten. Ob und wann sie aufgeräumt werden, entscheidet die Praxis mit ihrer IT-Betreuung.

Labor (LDT) und Order-Entry

• Laborordner (LDT) trägt die Praxis unter Stammdaten › Agenten beim Agenten ein, einen Ordner je Zeile, so wie er auf diesem Rechner heißt (z. B. C:\Labor\Eingang). Der Agent überwacht dort *.ldt.
• Auftragsprogramme der Labore werden unter Stammdaten › Labore eingerichtet, Karte Patient an das Order-Entry-Programm übergeben: Agent (Arbeitsplatz), Exportordner, auf Wunsch Programm starten. Die Übergabe läuft wie ein GDT-Auftrag: Datei schreiben, Programm starten.
• Der Bestätigungsordner eines Labors (Dateimuster standardmäßig *.ldt;*.gdt;*.bdt) wird ebenfalls überwacht.
• Export- und Bestätigungsordner eines Labors müssen verschieden sein und dürfen nicht schon anders vom selben Agenten genutzt werden (Laborordner, Scan-Ordner, Import- oder Anhangordner der GDT-Geräte, Ordner anderer Labore); zwei Labore am selben Agenten brauchen also je einen eigenen Bestätigungsordner. Auch ein Scan-Ordner muss ein eigener Ordner sein. TCMSOFT prüft das beim Speichern und nennt den Konflikt.

Im Fenster des Agenten erscheinen Labor- und Bestätigungsordner als „Labor (LDT)“.

Scans

Scans über den Agenten gibt es ab TCMSOFTpro.

Windows: Übergabe aus der Scannersoftware

• Die Scannersoftware ruft den Agenten mit der fertigen Datei auf. In ScanSnap Home: Profil bearbeiten › Senden an › Anwendung hinzufügen. Den Pfad zeigt das Fenster des Agenten im Bereich Scannen (z. B. ScanSnap) unter „Programm für die Scannersoftware:“, meist C:\Users\<Name>\AppData\Local\PrismamedAgent\current\Prismamed.Agent.exe.
• Ein kurzer zweiter Prozess kopiert die Dateien in den Ordner scan-eingang im Datenordner und endet. Der laufende Agent lädt sie von dort hoch und löscht die Kopie. Läuft der Agent gerade nicht, wird er gestartet.
• Angenommen werden PDF, JPEG und PNG.
• Abgelehnt wird mit einem Meldungsfenster „Prismamed Agent - Scan nicht übernommen“, wenn der Agent nicht gekoppelt ist, TCMSOFT keine Scans annimmt (Edition unter TCMSOFTpro), das TCMSOFT älter als der Agent ist, der Agent in TCMSOFT entfernt oder deaktiviert wurde oder die Datei kein PDF, JPEG oder PNG ist. Der Text sagt, was zu tun ist; der Scan bleibt im Ordner der Scannersoftware.

Mac: Die Scannersoftware übergibt am Mac keine Datei an ein Programm. Scans gehen dort nur über einen Scan-Ordner (ScanSnap Home: Profil bearbeiten › Speichern unter).

Scan-Ordner (Windows und Mac)

• Unter Stammdaten › Agenten beim Agenten unter Scan-Ordner eintragen, einen Ordner je Zeile.
• Einen gemeinsamen Netzwerkordner nur bei einem Agenten eintragen.
• Als Zeitpunkt des Scans zählt, wann der Agent die Datei zuerst sah, nicht die Dateizeit des Kopierers.
• Liegen im Ordner Dateien in anderen Formaten (z. B. TIFF), meldet der Agent beim Ordner „Im Ordner liegen Dateien, die TCMSOFT nicht annimmt (nur PDF, JPEG und PNG) …“.

Welche Akte den Scan bekommt, legt die Praxis im Browser fest (Mein Arbeitsplatz…). Das beschreibt das Benutzerhandbuch › Stammdaten: Geräte und Labor › Agenten und GDT-Geräte.

Während eines Updates

Der Agent spielt ein Update nie während einer Datei oder eines Auftrags ein. Dateien, die in den etwa 10 Sekunden des Neustarts ankommen, überträgt er danach. Ein Auftrag, der genau in diesem Moment ankommt, geht an TCMSOFT zurück und wird vom neu gestarteten Agenten nach etwa 10 Sekunden abgeholt. Alles Weitere unter Updates der Agenten.

Fenster und Menü des Agenten

Symbol

Unter Windows öffnet ein Klick auf das Symbol das Fenster, ein Rechtsklick das Menü. Am Mac öffnet ein Klick das Menü. Der Tooltip zeigt Version und Status, z. B. „Prismamed Agent 2026.10.701 – Verbunden mit …“.

Menü

• Status (grau), z. B. „Verbunden mit …“
• Stand des Updates, z. B. „Aktuell: Version …“ oder „Update … ist bereit“ (nur mit Selbst-Update)
• Update auf Version … herunterladen… (nur, wenn sich der Agent nicht selbst aktualisiert und TCMSOFT eine neuere Version kennt)
• Jetzt aktualisieren (Neustart, ca. 10 Sekunden) (nur mit Selbst-Update)
• Nach Updates suchen (nur mit Selbst-Update)
• Einstellungen… (öffnet das Fenster)
• Ordner jetzt prüfen
• Protokoll öffnen (öffnet den Ordner mit den Protokolldateien)
• Beenden

Statustexte

Fenster „Prismamed Agent“

• Mit TCMSOFT koppeln (nur ohne Kopplung) bzw. Verbindung mit Praxis, Server, Zeitpunkt der Kopplung, letztem Kontakt, dem letzten Fehler und Kopplung aufheben.
• Scannen (z. B. ScanSnap): wie die Scannersoftware eingerichtet wird, unter Windows mit dem Programmpfad.
• Überwachte Ordner: je Ordner Bezeichnung und Art (GDT, LDT, Scan), Pfad und die letzte Meldung, z. B. „Bereit“, „Zuletzt übertragen: …“ oder der Fehler.
• Unten: „Version … · Protokolle: …“ und die Schaltflächen Ordner jetzt prüfen, Protokoll öffnen, Schließen.

Datenordner, Dateien und Protokolle

• agent.json enthält Server-Adresse, Agent-ID und den API-Schlüssel des Agenten. Die Datei nicht weitergeben. Wer sie hat, kann sich gegenüber TCMSOFT als dieser Agent ausweisen. Ist sie in falsche Hände geraten, den Agenten in TCMSOFT entfernen, neu anlegen und neu koppeln.
• scan-gesperrt.txt schreibt der laufende Agent, wenn TCMSOFT gerade keine Scans annimmt; ihr Text erklärt den Grund.
• Unter Windows gibt der Agent dem Datenordner beim Anlegen für die Gruppe „Benutzer“ das Recht „Ändern“, damit auch ein anderes Windows-Konto neu koppeln kann. Hat ein anderer Besitzer den Ordner angelegt und fehlt das Recht, ändert der Agent nichts.
• Der Agent behält 30 Protokolldateien, eine je Tag. Meldungen des Selbst-Updates stehen in derselben Datei, Meldungen von Velopack selbst mit dem Vorsatz „Velopack: “. Auch die Scan-Übergabe schreibt in diese Datei.
• Protokoll öffnen im Menü oder Fenster öffnet den Ordner. Für den Support die Dateien der betroffenen Tage schicken.

In TCMSOFT selbst stehen fehlgeschlagene Kopplungen und ungültige Schlüssel mit der IP-Adresse im Protokoll des Servers: „Kopplung fehlgeschlagen von …“ und „Agent-Schnittstelle: ungültiger Schlüssel von …“. Siehe Protokolle und Diagnose.

Kommandozeile und Umgebungsvariablen

Für Skripte, Sonderfälle und den Support. Im normalen Betrieb ist nichts davon nötig.

--nach-absturz ist intern (Neustart nach einem Absturz am Mac) und nicht für den Aufruf von Hand gedacht.

Mehrere Benutzerkonten und Terminalserver

Windows

• Jedes Windows-Konto hat seine eigene Installation und aktualisiert sie selbst. Das Setup muss in jedem Konto einmal laufen, in dem der Agent laufen soll.
• Die Kopplung liegt im gemeinsamen %ProgramData%\Prismamed\Agent und gilt für den ganzen Rechner.
• Gleichzeitig angemeldete Konten (schneller Benutzerwechsel): In jedem läuft ein eigener Agent mit derselben Kopplung. Einen Auftrag erledigt der Agent, der ihn zuerst abholt. Ein „Untersuchung starten“ kann also das Geräteprogramm in der Sitzung des anderen Kontos öffnen. Ordner beobachten alle Agenten; einen doppelt übertragenen Scan legt TCMSOFT nur einmal ab. Konten, die nicht gebraucht werden, besser abmelden.
• Terminalserver, an dem dasselbe Windows-Konto in mehreren Sitzungen gleichzeitig angemeldet ist: nicht unterstützt. Das Update in einer Sitzung beendet den Agenten der anderen.
• Terminalserver mit mehreren Konten: Es gilt dasselbe wie bei gleichzeitig angemeldeten Konten. Diese Einrichtung ist nicht getestet; vor dem Einsatz beim TCMSOFT-Support nachfragen.

Agent ohne Anmeldung (--headless über die Aufgabenplanung oder als Dienst): Hier aktualisiert sich der Agent nicht verlässlich selbst, denn nach einem Update startet Velopack ihn an Aufgabenplanung bzw. Dienst vorbei neu. Deshalb in der Umgebung des Kontos, unter dem er läuft, das Selbst-Update abschalten und neue Versionen mit dem Setup einspielen:

setx PRISMAMED_SELBSTUPDATE aus

Läuft daneben in einem angemeldeten Konto noch ein Agent mit Symbol, gilt dasselbe wie bei gleichzeitig angemeldeten Konten.

Mac

• Jedes Benutzerkonto hat seinen eigenen Agenten mit eigener Kopplung und eigenem Datenordner. Koppeln Sie den Agenten nur in einem Konto, am besten in dem, mit dem am Mac gearbeitet wird. Sonst überwachen zwei Agenten dieselben Ordner.
• Wer den Agenten in einem weiteren Konto startet, richtet dort auch den Autostart ein. Soll er dort nicht laufen, in diesem Konto ~/Library/LaunchAgents/de.prismamed.agent.plist löschen.
• Selbst aktualisieren kann sich der Agent nur in dem Konto, das ihn in „Programme“ gezogen hat.
• Schläft der Mac, ist der Agent für TCMSOFT offline.

Deinstallation

Windows

1. Agent beenden: Rechtsklick auf das Symbol › Beenden.
2. Einstellungen › Apps, „Prismamed Agent“ deinstallieren.
3. In TCMSOFT unter Stammdaten › Agenten den Agenten mit dem Papierkorb Agent entfernen löschen. Danach kann er sich nicht mehr verbinden. Geräte und Labore, die ihn als Arbeitsplatz nutzen, brauchen einen anderen Agenten.

Ob die Deinstallation die Ordner %ProgramData%\Prismamed\Agent (Kopplung, Protokolle) und %LocalAppData%\Prismamed\Agent (Update-Zustand) entfernt, ist nicht dokumentiert. Prüfen Sie das im Explorer und löschen Sie die Ordner bei Bedarf von Hand. Den gemeinsamen Ordner unter %ProgramData% nur löschen, wenn der Agent in keinem anderen Windows-Konto des Rechners mehr läuft.

Mac

1. Agent beenden: Menü › Beenden.

2. Das Programm aus „Programme“ in den Papierkorb legen.

3. Autostart und Datenordner löschen:

   rm "$HOME/Library/LaunchAgents/de.prismamed.agent.plist"
   rm -r "$HOME/Library/Application Support/Prismamed/Agent"
   

4. In TCMSOFT unter Stammdaten › Agenten den Agenten entfernen (wie unter Windows).

Hat ein weiteres Benutzerkonto den Agenten gestartet, Schritt 3 auch in diesem Konto ausführen.

Siehe auch

• Die Agenten im Überblick
• Updates der Agenten
• Print Agent
• Netzwerk und HTTPS
• Meldungen und ihre Bedeutung
• Protokolle und Diagnose
• Benutzerhandbuch › Stammdaten: Geräte und Labor › Agenten und GDT-Geräte