VSys One: Volunteer Management Software

Previous Topic

Book Contents

Book Index

Special Settings

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

See Also

Appendix

Installation

Databases

Startup Database Selection

Standalone E-mail Robot as a Windows Service

Issue Reports

Hosted VSys

Q & A

Shortcuts, Tips and Tricks in VSys One

IT Labor Estimates

Implementation Timeline

Ini file-based Advanced Settings

Volunteer Works Conversion Notes

How VSys Encrypts Data

Tracing (Audit Logs) Security

Command Line Parameters

Command Line Tools

Relative Dates

Notes on Banned People

Remote Support Sessions

Transitions