commit 5b976821391c408d1a700a3428377947eae01807 Author: Patrick Gniza Date: Tue Aug 11 14:33:25 2026 +0000 Home hinzugefügt diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..b03c76b --- /dev/null +++ b/Home.md @@ -0,0 +1,306 @@ +# Plandent MSTSC Script Hook + +## Zweck + +Der **Plandent MSTSC Script Hook** wird eingesetzt, wenn Programme oder Scripte auf dem lokalen Arbeitsplatzrechner mit einer Anwendung innerhalb einer RDP-/Terminalserver-Sitzung zusammenarbeiten müssen. + +Das Tool deckt drei typische Techniker-Szenarien ab: + +- automatischer Start eines lokalen Receivers oder Scripts beim Aufbau einer RDP-Verbindung, +- gezielter Start eines vorkonfigurierten lokalen Programms aus der Terminalserver-Sitzung, +- Verbindung einer Anwendung im Terminalserver mit einem lokal installierten Sidexis über SIOMIN/SLIDA. + +Das Tool ist für den klassischen Windows-RDP-Client **Remotedesktopverbindung (`mstsc.exe`)** vorgesehen. + +--- + +## Benötigte Dateien + +### Auf dem lokalen Arbeitsplatz + +```text +PlandentMstscScriptHook.exe +``` + +Diese EXE enthält alles, was zur Installation und Konfiguration des Client-Plugins benötigt wird. + +### Auf dem Terminalserver + +Je nach Einsatzzweck: + +```text +PlandentRdpClientTrigger.exe +``` + +für einen einfachen Programmstart auf dem Client, + +oder: + +```text +PlandentSiominClientTrigger.exe +``` + +für den Sidexis-/SIOMIN-Anwendungsfall. + +--- + +## Installation auf dem Client + +1. Alle laufenden RDP-Verbindungen können zunächst bestehen bleiben, müssen nach der Installation aber einmal vollständig geschlossen werden. +2. `PlandentMstscScriptHook.exe` auf dem lokalen Arbeitsplatz starten. +3. Die gewünschte Konfiguration vornehmen. +4. **Plugin installieren** anklicken. +5. Danach alle noch geöffneten `mstsc.exe`-Fenster vollständig schließen. +6. Die RDP-Verbindung neu starten. + +Die Installation erfolgt für den aktuell angemeldeten Windows-Benutzer. + +--- + +# Anwendungsfall 1: RemoteVDDS automatisch starten + +In Verbindung mit den **RemoteVDDS-Scripten von Tobias Bauer** kann der benötigte Receiver automatisch gestartet werden, sobald der Techniker bzw. Anwender eine RDP-Verbindung zum Terminalserver aufbaut. + +Im Bereich **Automatischer Start bei RDP-Verbindung**: + +```text +Programm/Script: +C:\RemoteVDDS\RemoteVDDS_Receiver_TS.bat + +Argumente: +MIN + +Arbeitsverzeichnis: +C:\RemoteVDDS +``` + +Empfohlene Optionen: + +```text +[x] Bei erfolgreicher RDP-Verbindung starten +[x] Unsichtbar starten +[x] Mehrfachstart verhindern +``` + +**Bei RDP-Trennung beenden** sollte nur aktiviert werden, wenn der Receiver tatsächlich mit dem Ende der RDP-Verbindung beendet werden soll. + +Bei einer Datei mit `RemoteVDDS_Receiver_TS` im Namen wird `MIN` vom Konfigurator automatisch als Argument vorgeschlagen, sofern noch keine Argumente eingetragen sind. + +Über **Programm testen** kann vor der Installation geprüft werden, ob das Script auf dem lokalen Arbeitsplatz korrekt startet. + +> Die RemoteVDDS-Scripte selbst gehören nicht zum Plandent MSTSC Script Hook und müssen separat vorhanden sein. + +--- + +# Anwendungsfall 2: Lokales Programm bei Bedarf starten + +Soll ein lokales Programm nur dann gestartet werden, wenn eine Anwendung oder ein Ablauf innerhalb des Terminalservers dies benötigt, wird der zweite Bereich **Programmstart durch Terminalserver** verwendet. + +Auf dem Client beispielsweise: + +```text +Programm: +C:\Program Files\Sirona\Sidexis4\Sidexis4.exe +``` + +Optional können Argumente und ein Arbeitsverzeichnis eingetragen werden. + +Empfohlene Einstellungen: + +```text +[x] Start durch Terminalserver-Trigger erlauben +[x] Mehrfachstart verhindern +``` + +Ob **Unsichtbar starten** sinnvoll ist, hängt vom jeweiligen Programm ab. Eine grafische Anwendung wie Sidexis soll normalerweise sichtbar gestartet werden. + +Auf dem Terminalserver wird anschließend innerhalb der jeweiligen Benutzersitzung lediglich: + +```text +PlandentRdpClientTrigger.exe +``` + +ausgeführt. + +Der Trigger startet immer das Programm, das vorher auf dem jeweiligen Client konfiguriert wurde. + +--- + +# Anwendungsfall 3: Terminalprogramm mit lokalem Sidexis verbinden + +Dieser Anwendungsfall ist für Programme gedacht, die **innerhalb der RDP-Sitzung laufen**, ihre Patientendaten aber an ein **lokal auf dem Arbeitsplatz installiertes Sidexis** übergeben sollen. + +Dafür wird auf dem Terminalserver: + +```text +PlandentSiominClientTrigger.exe +``` + +verwendet. + +## Client konfigurieren + +Im Bereich **Programmstart durch Terminalserver** wird auf dem lokalen Arbeitsplatz Sidexis eingetragen, beispielsweise: + +```text +C:\Program Files\Sirona\Sidexis4\Sidexis4.exe +``` + +Anschließend: + +```text +[x] Start durch Terminalserver-Trigger erlauben +[x] Mehrfachstart verhindern +``` + +und **Plugin installieren**. + +## Terminalprogramm konfigurieren + +Im Programm innerhalb der RDP-Sitzung wird als **Sidexis-EXE** bzw. als aufzurufendes Sidexis-Programm nicht die echte Sidexis-EXE eingetragen, sondern: + +```text +C:\PDATA\exe\PlandentSiominClientTrigger.exe +``` + +Das Terminalprogramm muss seinen SLIDA-/SIOMIN-Eintrag zunächst in eine **temporäre lokale Datei auf dem Terminalserver** schreiben. + +Empfehlung: + +```text +C:\PDATA\temp_siomin.sdx +``` + +Die finale SIOMIN-Datei befindet sich üblicherweise im zentralen PDATA-Verzeichnis, zum Beispiel: + +```text +\\SERVER\PDATA\siomin.sdx +``` + +## INI konfigurieren + +Neben: + +```text +PlandentSiominClientTrigger.exe +``` + +liegt: + +```text +PlandentSiominClientTrigger.ini +``` + +Beispiel: + +```ini +[SIOMIN] +SIOMIN_TEMP_PATH=C:\PDATA\temp_siomin.sdx +SIOMIN_PATH=\\SERVER\PDATA\siomin.sdx +DEBUG=0 +``` + +Fehlt die INI, wird sie beim ersten Start automatisch mit folgenden Standardwerten erstellt: + +```ini +[SIOMIN] +SIOMIN_TEMP_PATH=C:\PDATA\temp_siomin.sdx +SIOMIN_PATH=C:\PDATA\siomin.sdx +DEBUG=0 +``` + +Danach muss `SIOMIN_PATH` gegebenenfalls auf das tatsächlich verwendete PDATA-Verzeichnis geändert werden. + +## Was beim Aufruf passiert + +Der Techniker muss dafür keine zusätzlichen Parameter angeben. + +Beim Aufruf übernimmt der Trigger den Eintrag aus der temporären Datei, ordnet ihn dem lokalen RDP-Client zu und schreibt ihn in die finale `siomin.sdx`. + +Nach erfolgreicher Übernahme wird die temporäre Datei geleert und anschließend das auf dem Client vorkonfigurierte Sidexis gestartet. + +Damit kann ein Terminalprogramm den Übergabevorgang so verwenden, als würde es Sidexis starten, obwohl Sidexis tatsächlich auf dem lokalen Arbeitsplatz läuft. + +--- + +# Fehlersuche + +## Clientprogramm startet nicht + +Prüfen: + +- wurde das Plugin auf dem **lokalen Arbeitsplatz** installiert? +- wurden nach der Installation alle alten `mstsc.exe`-Instanzen beendet? +- ist **Start durch Terminalserver-Trigger erlauben** aktiviert? +- ist der hinterlegte Programmpfad korrekt? +- verhindert **Mehrfachstart verhindern** absichtlich einen zweiten Start, weil das Programm bereits läuft? + +Das Client-Log befindet sich bei aktiviertem Plugin-Logging unter: + +```text +%LOCALAPPDATA%\Plandent\MstscScriptHook\plugin.log +``` + +## SIOMIN-Übergabe funktioniert nicht + +In: + +```text +PlandentSiominClientTrigger.ini +``` + +temporär: + +```ini +DEBUG=1 +``` + +setzen. + +Danach wird neben der EXE eine Logdatei erzeugt: + +```text +PlandentSiominClientTrigger.log +``` + +Prüfen: + +- existiert die unter `SIOMIN_TEMP_PATH` angegebene Datei? +- enthält sie nach dem Aufruf des Terminalprogramms einen Eintrag? +- ist `SIOMIN_PATH` der richtige PDATA-Pfad? +- besitzt der angemeldete Terminalserver-Benutzer Schreibrechte auf die finale `siomin.sdx`? +- ist auf dem lokalen Client der Terminalserver-Trigger aktiviert? +- wurde die RDP-Verbindung nach Installation oder Update des Plugins neu aufgebaut? + +Wenn Sidexis einen Eintrag nach `unprocessable.sdx` verschiebt, sollten sowohl das SIOMIN-Trigger-Log als auch das Sidexis-Log zur weiteren Prüfung gesichert werden. + +--- + +# Update des Client-Plugins + +Bei einer neuen Version: + +1. alle `mstsc.exe`-Instanzen auf dem Client schließen, +2. neue `PlandentMstscScriptHook.exe` starten, +3. **Plugin installieren** erneut ausführen, +4. RDP-Verbindung neu starten. + +Die vorhandene Konfiguration wird dabei weiterverwendet. + +--- + +# Deinstallation + +`PlandentMstscScriptHook.exe` starten und **Plugin entfernen** wählen. + +Sollte die Plugin-Datei noch verwendet werden, zuerst sämtliche `mstsc.exe`-Instanzen schließen und die Entfernung erneut durchführen. + +--- + +## Kurzüberblick + +| Aufgabe | Client | Terminalserver | +|---|---|---| +| RemoteVDDS automatisch starten | Automatischen Scriptstart konfigurieren | keine zusätzliche EXE erforderlich | +| Lokales Programm bei Bedarf starten | Trigger-Programm konfigurieren | `PlandentRdpClientTrigger.exe` | +| Terminalprogramm mit lokalem Sidexis verbinden | Sidexis als Trigger-Programm konfigurieren | `PlandentSiominClientTrigger.exe` + INI | \ No newline at end of file