Training

User Settings

If you need to dynamically change a configuration setting at run time, then make use of the User Settings. In short User Settings are parameters you define, and can then pass to your steps.

This means you can change a user setting to change the behaviour of your project without needing to re-create your steps over and over.

You can view any settings you have created by clicking onto the Settings tab.

View Settings

Create a Setting

To create a new user setting first click onto the settings tab and then either use the shortcut button in the toolbar or by going to File > Add Setting.

Add Setting Shortcut

Add Setting

You then need to set a name and a value for your setting in the configuration window.

Configure Setting

Using Settings

To use your settings in your step configurations you need to type the name inside two curly braces. For example {{MySetting}}.

The built in user setting SMTPUsername is used by default for the project status step.

Project Status Email Step

Built in Settings

The Run Tool has a few built in settings that are calculated at the point the Run Tool project is started.

Below is a table of all of the built in settings that you can make use of in your steps

Please note that time settings take your PC time. This will be either local or UTC depending on how your PC is configured.

Name Setting Example
DAY {{DAY}} 14
MONTH {{MONTH}} 05
YEAR {{YEAR}} 2021
FILEDATE {{FILEDATE}} 2021-05-14
DATE {{DATE}} 2021-05-14
FILETIME {{FILETIME}} 134339
TIME {{TIME}} 13:43:39
HOUR {{HOUR}} 13
MIN {{MIN}} 43
SEC {{SEC}} 39
MACHINE {{MACHINE}} MachineName
USERNAME {{USERNAME}} User1
DOMAIN {{DOMAIN}} MyDomain
APPPATH {{APPPATH}} C:\Program Files\Simego\Data Synchronisation Studio 3.0
PERSONAL {{PERSONAL}} C:\Users\{{User}}\Documents
LOCALAPPLICATIONDATA {{LOCALAPPLICATIONDATA}} C:\Users\{{User}}\AppData\Local
APPLICATIONDATA {{APPLICATIONDATA}} C:\Users\{{User}}\AppData\Roaming
COMMONAPPLICATIONDATA {{COMMONAPPLICATIONDATA}} C:\ProgramData
PROGRAMFILES {{PROGRAMFILES}} C:\Program Files
PROGRAMFILESX86 {{PROGRAMFILESX86}} C:\Program Files (x86)
SYSTEM {{SYSTEM}} C:\WINDOWS\system32
SYSTEMX86 {{SYSTEMX86}} C:\WINDOWS\SysWOW64
WINDOWS {{WINDOWS}} C:\WINDOWS\system32
TEMP {{TEMP}} C:\Users\{{User}}\AppData\Local\Temp\
NEWGUID {{NEWGUID}} {87747ce2-ada0-4ae7-b603-240832ff37cf}
SMTPUsername {{SMTPUsername}} myemail@domain.com
SolutionName {{SolutionName}} RunToolProject
SolutionPath {{SolutionPath}} C:\Users\{{User}}\source\repos\myRepo\RunToolProject
SolutionDataPath {{SolutionDataPath}} C:\Users\{{User}}\source\repos\myRepo\RunToolProject\.ds