Interne, ausführlichere Ergänzung zur Kundenseite „Scopevisio auf Citrix: Direktstart per Kundennummer & Datenordner selbst festlegen“. Ziel dieser Seite: Support in die Lage versetzen, Edge Cases bei beiden Funktionen selbst einzuordnen – ohne Entwickler-Hintergrundwissen vorauszusetzen.

Für die normale Installation auf einem Einzelplatz-PC braucht man keine der beiden Funktionen: dort gibt die Nutzerin oder der Nutzer die eigene Kundennummer einmalig direkt beim Anmelden im Scopevisio-Programm ein, und sie wird ab dann automatisch bei der nächsten Anmeldung vorgeschlagen.

Normalerweise gibt eine Nutzerin oder ein Nutzer die eigene Kundennummer einmalig direkt beim Anmelden im Scopevisio-Programm ein; sie wird danach automatisch für die nächste Anmeldung vorgeschlagen. Die Kundennummer identifiziert dabei eine einzelne Instanz – ein Kunde kann auch mehrere Instanzen haben, jede mit eigener Kundennummer.

Wenn von vornherein feststeht, welche Instanz geöffnet werden soll – etwa weil für jede Instanz ein eigenes Programmsymbol bereitgestellt wird –, kann die Kundennummer stattdessen schon beim Start des Launchers mitgegeben werden. Die manuelle Eingabe beim Anmelden entfällt dann.

Wichtig: Wird stattdessen versehentlich der falsche Download (ein Client für eine andere Umgebung) verwendet, wird die Kundennummer dort im Regelfall gar nicht gefunden – das Programm startet dann gar nicht erst. Dabei erscheint keine verständliche Meldung für die Nutzerin oder den Nutzer, sondern nur ein technischer Fehler, der lediglich im Terminal oder in der Protokolldatei sichtbar ist. Nur falls die Kundennummer zufällig auch in der falschen Umgebung existiert, startet das Programm dort und zeigt den normalen Login; die Anmeldung schlägt dann in aller Regel fehl, weil die eigenen Zugangsdaten in dieser fremden Instanz nicht existieren.

Beispiel unter Windows: Bei einer normalen Desktopverknüpfung trägt man die Optionen im Feld „Ziel“ hinter dem Pfad zum Programm ein, z. B.:

Genau dieselbe Kommandozeile wird auch für eine Citrix-veröffentlichte Anwendung hinterlegt – technisch ist das ebenfalls nur eine Verknüpfung mit fest eingetragenem Ziel, die den Nutzerinnen und Nutzern als Symbol angezeigt wird.

Beispiel unter macOS: Hier gibt es keine Verknüpfung mit Kommandozeilen-Argumenten wie unter Windows. Stattdessen kann mit dem auf jedem Mac vorinstallierten Programm „Automator“ eine kleine Anwendung erstellt werden, die beim Doppelklick genau diesen Befehl ausführt:

Diese Automator-Anwendung verhält sich für die Nutzerin oder den Nutzer wie ein ganz normales Programmsymbol zum Doppelklicken. Das ist ein Übergangsweg, bis eine richtige macOS-Entsprechung eines Windows-Verknüpfungs-Links (ein echtes Pro-Instanz-.app) verfügbar ist.

Der Launcher legt normalerweise eigene Dateien im Standard-Benutzerprofil ab (%LOCALAPPDATA%/%APPDATA% unter Windows): die Java-Laufzeitumgebung, die Programmdatei des Kunden-Clients, die Konfiguration der eingerichteten Umgebungen sowie Protokolldateien. Auf vielen Citrix-/Terminalserver-Systemen ist dieses Profil jedoch eingeschränkt, wird bei jeder Abmeldung zurückgesetzt oder liegt auf einem Netzlaufwerk mit wenig Platz – der Launcher funktioniert dort dann nicht zuverlässig oder verliert bei jeder Anmeldung seine Einstellungen.

Für solche Umgebungen kann die IT-Administration einen festen Ordner vorgeben, in dem Scopevisio stattdessen arbeitet. Das geschieht über eine einmalige, systemweite Einstellung – nicht durch die Nutzerin oder den Nutzer selbst, und nicht innerhalb der Scopevisio-Anwendung.

Die Umgebungsvariable heißt SCOPEVISIO_BASE_DIR. Ein Beispielwert:

Diese eine Einstellung gilt für die gesamte Maschine und wird von der IT-Administration einmalig gesetzt – üblicherweise beim Einrichten des Servers oder Server-Abbilds, z. B. über eine Gruppenrichtlinie oder PowerShell.

Wichtig bei der Einrichtung: Wird die Variable über setx in der Eingabeaufforderung gesetzt, ersetzt cmd den Platzhalter %USERNAME% bereits beim Eintippen durch den Namen des gerade angemeldeten (administrierenden) Kontos – dann bekämen plötzlich alle Personen denselben Ordner. Die Variable sollte daher über PowerShell oder eine Gruppenrichtlinie gesetzt werden, die den Platzhalter unverändert speichert, und nach dem Setzen kontrolliert werden.

Ja. Die IT-Administration muss die Variable nicht für jede Person einzeln setzen. Der eine oben gezeigte Wert mit dem Platzhalter %USERNAME% genügt – dieser wird bei jedem Start automatisch durch den Namen der gerade angemeldeten Person ersetzt. Meldet sich z. B. „j.mueller“ an, landen deren Daten automatisch unter D:\ScopevisioDaten\j.mueller, bei „a.schmidt“ entsprechend unter D:\ScopevisioDaten\a.schmidt – ohne weiteres Zutun der IT-Administration.

Auf einem Server, auf dem sich mehrere Personen gleichzeitig anmelden können (Citrix, Terminalserver), ist der Platzhalter zwingend erforderlich: ein für alle Personen gemeinsamer, identischer Ordner wird nicht unterstützt. Auf einem Einzelplatz-PC oder einer virtuellen Maschine, die immer nur von einer Person genutzt wird, reicht dagegen auch ein fester Pfad ohne Platzhalter, z. B. D:\ScopevisioDaten.

Eine kleine Zahl an persönlichen Einstellungen – u. a. die zuletzt verwendete Kundennummer aus dem Login (siehe Funktion 1), die Fensterposition und ggf. hinterlegte Proxy-Einstellungen – liegt weiterhin in einer kleinen Konfigurationsdatei (~/.erpclient.properties) im klassischen Benutzerprofil, unabhängig von SCOPEVISIO_BASE_DIR. Wird das Benutzerprofil selbst durch eine Citrix- oder Profilverwaltungslösung zurückgesetzt oder nicht dauerhaft gespeichert, gehen diese wenigen Einstellungen weiterhin verloren – auch wenn SCOPEVISIO_BASE_DIR korrekt eingerichtet ist.

Im typischen Citrix-Einsatz werden beide Funktionen kombiniert:

Eine einzelne Person kann dabei auch mehrere solcher Verknüpfungen (für verschiedene Instanzen) nutzen – die Daten der jeweiligen Instanz werden automatisch sauber voneinander getrennt, auch wenn der übergeordnete Datenordner derselbe ist. Lediglich Dinge, die zur Installation des Launchers selbst gehören (z. B. die Java-Laufzeitumgebung), werden zwischen den Instanzen derselben Person geteilt – das ist so gewollt und unproblematisch.