The user’s WorkPace settings, preferences, and historical data are stored on the local hard drive of their PC in a standard location designed by Microsoft for this very purpose.
Please note that in older versions of WorkPace, this location may be slightly different:
C:\Users\[Windows Username]\AppData\Local\Wellnomics WorkPace
The actual location that WorkPace uses for this storage location is determined by one of the lines in the file workpace.ini, which you will find in the same directory that WorkPace is installed in (normally C:\Program Files (x86)\Wellnomics WorkPace).
We may use Windows environment variables to refer to common locations. For example, $AppData refers to the location C:\Users\[Windows Username]\AppData\Roaming.
The WorkPace data files are encrypted and non-editable. They will be named after the user’s Windows Username, and have the letters “USR” and "RAW" as their file extensions. For example:
The WorkPace USR file
Until WorkPace is able to establish its start-up settings, the USR file will not exist. Whenever WorkPace starts up it looks for the user’s local USR file to load up the user’s WorkPace settings. If that USR file does not exist then WorkPace must create a new one for the user, and load in all of the default settings that should be applied for a new user.
After the USR file is created, any changes that a user makes to their own WorkPace settings or preferences are stored back into their WorkPace USR file.
Exactly where WorkPace gets these settings for new users depends on what type installation WorkPace is running on.
Local Installation. Also known as a Standalone Installation.
NetworkInternet. Also known as a Wellnomics Risk Management server Installation
The type of WorkPace installation is also determined within the lines in the file workpace.ini, and will appear as either one of the following:
Local / Standalone Installation:
NetworkInternet / Wellnomics Risk Management server Installation:
New User Settings for a Local / Standalone Installation
In a Local Installation of WorkPace, the new user settings are obtained from the file default.ini, which may be found in the \system subdirectory of the WorkPace installation directory. The full path to this file is usually:
C:\Program Files (x86)\Wellnomics WorkPace\system\default.ini
The default.ini file is a plain text file that may be edited to control a lot more than just the default settings values for new users. It can contain instructions on locking various WorkPace features into either an on or off state, as well as enforcing range-locks where the user’s minimum and maximum settings values may be restricted. These settings may be applied to the user whether they are new or not.
One parameter that may be used to define the default settings value for a new user is “default”. Here is an example of how it may be used:
The “StatusOptionShowStatus” refers to the option of showing the WorkPace Status Panel on the Windows Desktop.
The “Default:N” is the setting value that by DEFAULT (for a new user) is set to NO. Meaning that the Status Panel will not be displayed on the screen for new users.
The “defaults” are only applied when a new user’s USR is created, so changing or adding “defaults” in this way to this file after the user’s USR file is created will have no effect.
More information on all of these settings is covered in depth within the Wellnomics WorkPace IT Administration Guide, which is available from Wellnomics Support (email@example.com).
New User Settings for a NetworkInternet / Wellnomics Risk Management server installation
In a NetworkInternet Installation of WorkPace, the new user settings are obtained from the Wellnomics Risk Management server.
The settings for new WorkPace users is determined by the options selected in the Admin > Policy Configuration > Settings Profiles screen in the Wellnomics Portal website.
This may appear a little confusing at first, until you realize that this screen is referring to WorkPace users connecting to the Wellnomics Risk Management server for the first time (New Wellnomics User Settings).
New WorkPace Users
The specified Settings Profile shown here will be applied to new WorkPace users, when WorkPace connects to the Wellnomics Risk Management server for the first time from a PC that has no existing user history or settings files on that PC.
As there will be no pre-existing WorkPace settings on the user’s PC, the initial synchronization process will apply the full range of WorkPace settings that are specified on the server including any Locked, Range-Locked, and Range-Locked defaults that may be defined in that Settings Profile.
Existing WorkPace Users
Wellnomics Risk Management server for the first time from a PC that has existing history or settings files on that PC.
As there will already be pre-existing WorkPace settings on the PC, the initial synchronization process will only apply those WorkPace settings that are specified on the server as being "locked". That is, Locked and Range-Locked. Any Range-Locked “default” settings specified in the settings profile will be ignored.
Please note that if WorkPace is unable to connect for the server to receive the New User settings then WorkPace will run in in Suspended mode and the WorkPace icon will look like this:
You will not be able to interact with any of the WorkPace features as WorkPace is unable to obtain its start-up values for any of these features. The only function you will have is the ability to “Connect Now” (right-click on the
WorkPace icon in the Windows System Tray) which will attempt to connect to the server again. Troubleshooting information may be available in the WorkPace Communications Log, located at
More information on settings control in Wellnomics Risk Management is covered in depth within the Wellnomics Risk Management User Guide, and information on the XML Settings files used by the server is covered in the Wellnomics Risk Management IT Administration Guide, which is available from Wellnomics Support (firstname.lastname@example.org).
The WorkPace RAW file
The RAW file will contain a compressed history of the daily computer-use data monitored and stored by WorkPace for a single user. Even when WorkPace is configured to send its data to a Wellnomics Risk Management server, WorkPace always retails a local copy of that data.
There are several safety precautions built into a WorkPace RAW file to prevent a user's file from being renamed and uploaded to a Wellnomics Risk Management server under the guise of another user. These precautions are also in place to prevent a user's WorkPace data being uploaded to the server twice (causing data duplication on the server which results in false "High Risk" reporting). The main method used to prevent these occurrences is the linking of the user's WorkPace RAW file to the PC that the data was recorded on.
Uniquely identifying a user's WorkPace RAW file
When WorkPace runs on a PC, WorkPace checks the following location for the file wpclient.ini. If this file does not exist then WorkPace will create it.
This file contains a unique ComputerId, along with a Serial and Hash to protect the integrity of the file.
Whenever a user runs WorkPace on a PC, WorkPace looks for the user's RAW file to use for it's historical data, and will add any new daily data that is records to that same file. The name of the RAW file that it will use is based two things:
The user's Windows login Name
For example, on my PC my Windows login is Tony, and my ComputerId is 2016090809125733891. My RAW file is therefore named Tony_2016090809125733891.raw. It should also be noted that WorkPace also encodes a copy of the ComputerId inside the RAW file itself, and the external name of the file must match with the internal name for WorkPace to recognize it.
If I were to copy my USR and RAW files onto another PC (even under the same Windows profile name) where WorkPace was already installed, WorkPace would ignore the RAW file and create another based on that PC's ComputerId.