Internal, more detailed supplement to the customer page "Scopevisio on Citrix: Direct start by customer number & setting the data folder yourself". Purpose of this page: to enable support to assess edge cases of both functions on their own – without requiring developer background knowledge.

For a normal installation on a single-user PC, neither function is needed: there, the user enters their own customer number once when signing in to the Scopevisio program, and it is suggested automatically from then on at the next sign-in.

Normally a user enters their own customer number once when signing in to the Scopevisio program; it is then suggested automatically for the next sign-in. The customer number identifies a single instance – a customer can also have several instances, each with its own customer number.

If it is known in advance which instance should be opened – for example because a separate program icon is provided for each instance – the customer number can instead be passed when the launcher starts. The manual entry at sign-in is then no longer needed.

Important: If the wrong download (a client for a different environment) is used by mistake, the customer number is usually not found at all – the program then does not start. No understandable message appears for the user, only a technical error that is only visible in the terminal or in the log file. Only if the customer number happens to exist in the wrong environment too, the program starts there and shows the normal login; sign-in then usually fails because the user's own credentials do not exist in that other instance.

Example on Windows: With a normal desktop shortcut, the options are entered in the "Target" field after the path to the program, e.g.:

Exactly the same command line is also stored for a Citrix-published application – technically that is also just a shortcut with a fixed target, displayed to users as an icon.

Example on macOS: There is no shortcut with command-line arguments as on Windows. Instead, the "Automator" program preinstalled on every Mac can be used to create a small application that runs exactly this command on double-click:

This Automator application behaves like a perfectly normal double-clickable program icon for the user. This is an interim solution until a proper macOS equivalent of a Windows shortcut link (a real per-instance .app) is available.

The launcher normally stores its own files in the standard user profile (%LOCALAPPDATA%/%APPDATA% on Windows): the Java runtime, the customer client's program file, the configuration of the set-up environments and log files. On many Citrix/terminal server systems, however, this profile is restricted, reset at every sign-out or located on a network drive with little space – the launcher then does not work reliably there or loses its settings at every sign-in.

For such environments, the IT administration can specify a fixed folder in which Scopevisio works instead. This is done via a one-time, system-wide setting – not by the user themselves, and not within the Scopevisio application.

The environment variable is called SCOPEVISIO_BASE_DIR. An example value:

This one setting applies to the entire machine and is set once by the IT administration – usually when setting up the server or server image, e.g. via group policy or PowerShell.

Important when setting up: If the variable is set via setx in the command prompt, cmd already replaces the placeholder %USERNAME% with the name of the currently signed-in (administrating) account when typing – all people would then suddenly get the same folder. The variable should therefore be set via PowerShell or a group policy that stores the placeholder unchanged, and checked after setting.

Yes. The IT administration does not have to set the variable for each person individually. The one value shown above with the placeholder %USERNAME% is sufficient – it is replaced automatically at every start with the name of the person currently signed in. For example, when "j.mueller" signs in, their data automatically ends up under D:\ScopevisioData\j.mueller, and for "a.schmidt" accordingly under D:\ScopevisioData\a.schmidt – without any further action by the IT administration.

On a server where several people can sign in at the same time (Citrix, terminal server), the placeholder is mandatory: one identical folder shared by all people is not supported. On a single-user PC or a virtual machine that is only ever used by one person, a fixed path without a placeholder is also sufficient, e.g. D:\ScopevisioData.

A small number of personal settings – including the last customer number used at login (see function 1), the window position and any stored proxy settings – remain in a small configuration file (~/.erpclient.properties) in the classic user profile, independent of SCOPEVISIO_BASE_DIR. If the user profile itself is reset by a Citrix or profile management solution or not stored permanently, these few settings are still lost – even if SCOPEVISIO_BASE_DIR is set up correctly.

In typical Citrix use, both functions are combined:

A single person can also use several such shortcuts (for different instances) – the data of the respective instance is automatically kept cleanly separate, even if the parent data folder is the same. Only things belonging to the installation of the launcher itself (e.g. the Java runtime) are shared between the instances of the same person – this is intended and unproblematic.