Aufbau der Installation

Scopevisio besteht aus drei Schichten, die alle im Benutzerprofil liegen (keine Admin-Rechte, keine Registry, keine systemweiten Komponenten):

Native Launcher (Scopevisio.exe / Scopevisio.app / Scopevisio): richtet die Java-Laufzeitumgebung ein, verwaltet die Umgebungskonfiguration und startet
com.scopevisio.launch.jar: lädt die Programmteile des Clients in einen Cache und aktualisiert sie bei jedem Start, startet
den Scopevisio-Client (Java/Swing): Anmeldefenster und Anwendung.

Was	Windows	macOS	Linux
Launcher-Ordner: `jre/`, `jre.zip`, `version.txt`, `com.scopevisio.launch.jar`, `environments.json`, `log/svlaunch.log`	`%LOCALAPPDATA%\ScopevisioLauncher`	`~/Library/Application Support/Scopevisio`	`~/.scopevisio`
Client-Cache: `cache/`, `<host>/customer_<uuid>/`, `launch.log`; auch die Kopie `cache\<host>\clientx\<cid>\scopevisio_<Kundennr>.exe` (Windows)	`%LOCALAPPDATA%\Scopevisio` – in Citrix-ICA-Sitzungen `%APPDATA%\Scopevisio`	derselbe Ordner wie oben	derselbe Ordner wie oben
Persönliche Client-Einstellungen: E-Mail, Kundennummer, Sprache, Proxy (inkl. Passwort im Klartext), Fensterposition, UI-Skalierung	`%USERPROFILE%\.erpclient.properties`	`~/.erpclient.properties`	`~/.erpclient.properties`
Token „Automatische Anmeldung"	`%USERPROFILE%\.svautologin.properties`	`~/.svautologin.properties`	`~/.svautologin.properties`
Client-Logs (2 Tage)	`%USERPROFILE%\.erpclientlogs\`	`~/.erpclientlogs/`	`~/.erpclientlogs/`
Optionale Proxy-Datei (wird nur gelesen, Format s. u.)	`%USERPROFILE%\svproxy.txt`	`~/svproxy.txt`	`~/svproxy.txt`
Verknüpfungen (legt der Client beim ersten Login an)	Desktop-`.lnk` mit Ziel Scopevisio (auch `%PUBLIC%\Desktop`, dort nur mit Administratorrechten verschiebbar), Startmenü `Scopevisio AG\`	`~/Applications/*.app` mit Bundle-ID `com.scopevisio.ScopevisioLink-…` (Starter je Kundennummer)	`~/Desktop/.desktop`, `~/.local/share/applications/.desktop` des Clients
Programm	dort, wo heruntergeladen (meist `Downloads`)	`/Applications/Scopevisio.app`	beliebig

Serverseitig gespeichert und von einem lokalen Reset nicht betroffen: Layout, Menüs, Anwendungseinstellungen, alle Daten.

Hinweis Windows-Ordnernamen: ScopevisioLauncher und Scopevisio müssen so heißen; der Client zählt darüber laufende Instanzen. Bitte nicht umbenennen, solange Scopevisio läuft.

Abweichender Basisordner (SCOPEVISIO_BASE_DIR)

Ist die Umgebungsvariable SCOPEVISIO_BASE_DIR gesetzt (typisch auf Citrix-/Terminalservern, z. B. D:\ScopevisioDaten\%USERNAME%), liegen Launcher-Ordner und Client-Cache dort statt im Profil; die Ordnernamen darunter bleiben gleich (<base>\ScopevisioLauncher, <base>\Scopevisio). .erpclient.properties, .svautologin.properties und svproxy.txt bleiben trotzdem im klassischen Benutzerprofil. Den tatsächlich verwendeten Ordner zeigt Scopevisio.exe --print-config („Base Folder: … (platform default | configured via SCOPEVISIO_BASE_DIR)"). Details: Hilfeartikel „Scopevisio auf Citrix: Direktstart per Kundennummer & Datenordner selbst festlegen".

Reset durchführen

Prinzip: sichern → neu installieren → nach Erfolg das Backup löschen. Nichts wird sofort gelöscht; jeder Schritt ist rückgängig zu machen.

Manuell

Windows (PowerShell, als der betroffene Benutzer)

# Scopevisio muss beendet sein
$ts = Get-Date -Format "yyyyMMdd_HHmmss"
$base = if ($env:SCOPEVISIO_BASE_DIR) { [Environment]::ExpandEnvironmentVariables($env:SCOPEVISIO_BASE_DIR) } else { $env:LOCALAPPDATA }
foreach ($p in "$base\ScopevisioLauncher", "$base\Scopevisio", "$env:APPDATA\Scopevisio",
               "$env:USERPROFILE\.erpclient.properties", "$env:USERPROFILE\.svautologin.properties") {
  if (Test-Path $p) { Rename-Item $p ("{0}_backup_{1}" -f $p, $ts) }
}
Get-ChildItem "$env:USERPROFILE\Desktop", "$env:PUBLIC\Desktop" -Filter "*Scopevisio*.lnk" -ErrorAction SilentlyContinue |
  Rename-Item -NewName { $_.BaseName + "_backup_$ts" + $_.Extension }

Anschließend den Client neu aus dem Kundenportal laden (richtige Umgebung!), starten, anmelden. Danach die *_backup_*-Objekte löschen, oder das Reset-Werkzeug starten: Es erkennt dieses Namensmuster und bietet das Löschen an. Das Werkzeug ersetzt das frühere interne PowerShell-Skript (ScopevisioClientReset.ps1 / …_DryRun.ps1, Juni 2026) und deckt alles ab, was es tat; das Skript bleibt nur für Umgebungen, in denen die EXE nicht laufen darf.

macOS / Linux (Terminal)

ts=$(date +%Y%m%d_%H%M%S)
# macOS:
base="$HOME/Library/Application Support/Scopevisio"
# Linux:
# base="$HOME/.scopevisio"
[ -n "$SCOPEVISIO_BASE_DIR" ] && echo "Achtung: SCOPEVISIO_BASE_DIR=$SCOPEVISIO_BASE_DIR – Basisordner dort anpassen"
for p in "$base" "$HOME/.erpclient.properties" "$HOME/.svautologin.properties"; do
  [ -e "$p" ] && mv "$p" "${p}_backup_$ts"
done
# macOS: Starter je Kundennummer und App
ls -d "$HOME"/Applications/Scopevisio* 2>/dev/null && mv "$HOME"/Applications/Scopevisio* ~/.Trash/
mv /Applications/Scopevisio.app ~/.Trash/ 2>/dev/null
# Linux: Menüeinträge
rm -f ~/Desktop/*Scopevisio*.desktop ~/.local/share/applications/*Scopevisio*.desktop

Neu installieren, testen, dann *_backup_* entfernen.

Was ein Reset nicht anfasst

svproxy.txt (Proxy-Konfiguration der IT) – bewusst behalten.
Serverseitige Nutzereinstellungen.
Bei SCOPEVISIO_BASE_DIR: der alte Profil-Ordner, falls die Variable erst später gesetzt wurde (es wird nichts migriert).

Diagnose vor dem Reset

Symptom	Wahrscheinliche Ursache	Prüfen
„Die angegebene Kundennummer ist auf der gewählten Umgebung unbekannt"	Client für die falsche Umgebung (Standard ↔ C5)	Strg + Klick auf „Einstellungen" → Feld „Server": `appload.scopevisio.com` (Standard) vs. `appload.c5.scopevisio.com` (C5); `environments.json` → `active`
Programm startet gar nicht, keine Meldung (bei Verknüpfung mit `--public-id`)	Kundennummer existiert in der Umgebung des Downloads nicht	`log\svlaunch*.log`: „failed to resolve public id"
„Die Scopevisio-Server sind gerade nicht erreichbar …" / „Proxy nicht gefunden" / „Anmeldung am Proxy fehlgeschlagen"	Proxy/Firewall	Domains freischalten (unten); Proxy im Anmeldefenster unter „Einstellungen" oder per `svproxy.txt`
Startfenster: „Fehler: Die Anwendung steht nicht mehr zur Verfügung"	Proxy antwortet 407 oder Instanz-URL 404	`launch.log`
Startfenster: „Fehler: Verzeichnis Rechte nicht vorhanden" / „Keine Schreibrechte"; Dialog „The configured base folder cannot be used"	Basisordner nicht beschreibbar (Citrix, Profil eingeschränkt)	`--print-config`, Berechtigungen des Basisordners
Dialog „Failed to prepare the Scopevisio environment." (englisch)	Java-Laufzeit konnte nicht geladen werden (Netz, Proxy, Platz)	`log\svlaunch*.log`
Dialog „Timeout while preparing the Scopevisio environment …"	Launcher wartet > 20 min auf launch.jar	Proxy/Netz
Dialog „Update verfügbar"	Native Launcher älter als Mindestversion	Client neu aus dem Kundenportal laden

Logs: Launcher …\ScopevisioLauncher\log\svlaunch*.log (7 Tage), launch.jar …\Scopevisio\launch.log (bei jedem Start überschrieben), Client ~\.erpclientlogs\. SV_LOG_FILE=<Pfad> lenkt das Launcher-Log in eine feste Datei. Im Startfenster öffnet „?" ein Debug-Fenster; Taste s schreibt Umgebungsvariablen und System-Properties ins Log.

Netzwerk (Firewall/Proxy-Freigaben): account.scopevisio.com (Portal), appload.scopevisio.com (Standard) bzw. appload.c5.scopevisio.com (C5) für Downloads, Java-Laufzeit, Programmteile und Anwendung; Linux zusätzlich corretto.aws (Java-Laufzeit). Alles HTTPS/443. Status: status.scopevisio.com, status.c5.scopevisio.com.

svproxy.txt (im Benutzerprofil, wird von Launcher und launch.jar gelesen):

proxyhost=proxy.firma.local
proxyport=3128
proxyuser=…
proxypass=…

Ohne diese Datei werden die System-Proxy-Einstellungen verwendet.

Verteilung und Direktstart

Der Client benötigt keinen Installer und keine Admin-Rechte; für Terminalserver empfiehlt sich ein zentraler Ablageort der EXE plus SCOPEVISIO_BASE_DIR mit %USERNAME%-Platzhalter.
Start direkt in eine Instanz: Scopevisio.exe --public-id=<Kundennummer>; Umgebung ist im Download hinterlegt. Details im Hilfeartikel „Scopevisio auf Citrix …".
Scopevisio.exe --print-config zeigt Umgebungen, den Pfad der environments.json und den Basisordner.
Die Verknüpfungen zeigen auf eine Kopie des Launchers im Client-Cache: %LOCALAPPDATA%\Scopevisio\cache\<host>\clientx\<cid>\scopevisio_<Kundennr>.exe.

Verwandte Artikel

Scopevisio zurücksetzen und neu installieren – für IT-Administratoren