Introduction

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. 


C:\Users\[Windows Username]\AppData\Roaming\Wellnomics\WorkPace


Please note that in older versions of WorkPace, this location may be slightly different:


C:\Users\[Windows Username]\AppData\Local\Wellnomics\WorkPace

C:\Users\[Windows Username]\AppData\Local\Wellnomics WorkPace

C:\Users\[Windows Username]\AppData\Local\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). 


UserFileDir=$AppData\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: 


bruce99.usr

brice99_2016042708054872277.raw


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.

  1. Local Installation. Also known as a Standalone Installation. 
  2. 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:


UserFileConfig=Local


NetworkInternet / Wellnomics Risk Management server Installation:


UserFileConfig=NetworkInternet


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: 


StatusOptionShowStatus=Default:N


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 (support@wellnomics.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 users to the Wellnomics Risk Management server can fall into one of two categories:


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


C:\Users\[Windows Username]\AppData\Roaming\Wellnomics\WorkPace\wpcom.log


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 (support@wellnomics.com).


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.


C:\Users\Public\Documents\Wellnomics\WorkPace\wpclient.ini


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:


  1. The user's Windows login Name
  2. The ComputerId


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.