All of these settings are defined in your VSys.ini
file. If you have multiple VSys.ini
files, for example one for each workstation, you'll need to make these settings in each file where you want them to be used.
E-mail robot SMTP server
By default, the E-mail robot uses port 25 for sending mail via an SMTP connection. This is the Internet standard for that protocol. To override this, within your VSys.ini
file, make the setting: [General]
SMTPPort=nn
where nn
is the port to be used.
Automatic Restart
When VSys One, VSys Lite and VSys Kiosk encounter an exception, they show detailed internal information and offer to send that to Bespoke for diagnostic. For remote machines or kiosks where network connectivity is inconsistent or where it's more important that the program continue running than issues be diagnosed, use: [General]
AutoRestartOnErr=1
After showing the message for thirty seconds, the program (VSys One, VSys Lite or VSys Kiosk) will restart itself automatically.
Tracing
Tracing can be turned on and off via System preferences and feature enabling or it can be forcibly enabled here. Doing it here prevents its being disabled via the regular UI tools.
[Magic]
ForceTraceEnabled=1
Kiosk PIN length
The default minimum PIN length in VSys is 4 characters, VSys won't let you assign one that's shorter than this. With the setting:
[Kiosk]
MinPINLength=nn
where nn
is a number greater than or equal to 2, a kiosk PIN can be as short as nn
.
Stored passwords
When VSys remembers the login ID and password for a database connection, it stores these values in the VSys.ini
file. By default, that password is stored in plain text. To obscure that password to users able to view the contents of that file, VSys allows the password to be encrypted. In the VSys.ini
file, make the settings: [General]
PasswordHash=somevaluetheywontguess
This label is something of a misnomer: it's not really a hash. Hashes are not trivially reversible, and this must be reversible since the name used here is for backwards-compatibility purposes. Instead VSys encrypts the password with the value you provide and an internal (fixed) value, reversing that encryption in order to log on to the database.
Time synchronization
By default, VSys will synchronize its clock with the clock on your database server every few seconds. To disable this on SQL Server, make the entry:
[SQL Server]
NoSchedTimeSynch=1
To disable it for NexusDB,
[NexusDB]
NoSchedTimeSynch=1
Backup version compatibility
When making VSys backups using NexusDB, VSys uses a special, fast mode which causes NexusDB to simply replicate the tables locally. Normally this is fine, but when making a backup of a database whose schema is of a later generation than the one on which the data will be restored, VSys will include in the backup those columns and tables which are part of the newer schema. This will cause older versions of VSys to refuse to use the backup file. To prevent this, make the entry:
[NexusDB]
NoFastBackups=1
This setting tells VSys to only copy columns and tables which it understands.
This does not affect any databases stored in SQL Server.
Prevent Reformatting of Zip/Postal codes
To prevent VSys from reformatting zip/postal codes, make the entry:
[Magic]
NoZipFormatting=1
You'd primarily use this when you're dealing with zip/postal codes from outside of the United States and Canada.
Font sizing
By default VSys will use the same font size that Windows uses. To override this, make the entry:
[Magic]
ForcedFontSize=10
This tells VSys to use a font size of 10
points. Use your own sizing here but note that VSys will ignore any font size of less than 8 points.
Screen size
VSys normally displays either as a standard window, or "maximized" if the screen size is small enough that this would be preferred. To force VSys to take up the whole screen, and at the same time prevent users from minimizing the VSys window, make the entry: [Magic]
ScreenMaximized=1
Hours Entry
To prevent manual hours entry for dates in the past, make the entry: [Magic]
HoursMaxPastDistance=nnn
Where nnn
is the maximum distance in the past in days.
You can also use relative dates here to be more creative. For example, to keep users from entering hours for last month once you've reached the tenth of this month (effectively "locking" last month), you could use:
HoursMaxPastDistance=RDM-10
This logic says "Relative date", "Subtract 10 days", "Adjust to the beginning of the resulting month".
If security is enabled, superusers are not subject to this restriction.
This mechanism doesn't affect the ability of any user to edit past hours, even the dates of those past hours.
Background Check Timeouts
VSys has a fixed period of time for which it will wait for a response when querying a background check company's servers. If that server doesn't respond in time, VSys will show an error and move on. To change how long VSys waits, use: [Magic]
XMLBackgroundCheckPostTimeout=nnn
Where nnn
is the maximum time VSys should wait (in seconds). Values greater than 300 seconds (5 minutes) will be ignored.
Schema Updates
When VSys One connects to its database, if it determines that the database schema (tables, indices) needs to be updated, it will prompt the user to let VSys update the schema. Adding
[General]
SilentSchemaUpdates=1
will tell VSys to make those schema updates without first prompting the user for permission or guidance.
Temporary files
While making backups or restoring, by default VSys uses the Windows temporary folder to store files. You can override this:
[Magic]
TempFolder=c:\something\something else\temp\something more