Application Files and Folders

Files within an application are divided between "user files" and "working files". This chapter discusses user files. The set of working files in the .sync folder must not be edited. Any attempt to do so will damage or destroy your application.

Most user files may be edited using a text editor, but be aware that edited files must be imported into an application's working set before those changes will go into effect. The Import/Export Files dialog is not available in runtime-only versions of VTScada. Also, access to the Import/Export Files dialog is controlled by the Security Manager. Only users with the Edit Files privilege may import an edited file.

As you work within VTScada, it will automatically update the user files to reflect changes to the working set.

The working set of files and the change history repository are stored within the .sync folder. Do not attempt to edit any file in that folder structure. Any attempt to do so will damage your application.

Folders:

Pages

Contains the source code for all of the application pages. You may edit these files and import your changes to modify an application.

PlatformInfo

Contains information about your VTScada installation, the application and the computer you are running the application on. These details may be viewed by opening the VTScada Application Manager (VAM), clicking on Properties, then on Information.
Do not attempt to edit files in the PlatformInfo folder. Damage to your application is likely to result.

Resources

Contains logo and button images used by VTScada.

Bitmaps

If you are adding your own custom images for display in an application page, you will create this folder and store the images here.

Tags

If the setting, ExportTagFilesToUser is set, this folder will contain an up-to-date copy of all the tag files. This copy cannot be imported, but serves as a reference and can be used in recovery should the .sync folder be damaged.

Data

Contains data output files generated by the application including log files, retained data files and network values. Copy this folder to make backups of your application's data.

Widgets

Contains user copies of the source code for all user-created widgets.

Files:

Accounts.Dynamic

Created only after security has been enabled. Contains encrypted account information. User edits to this file will be ignored.

Application.version

Stores information about the current revision of the application. User edits to this file will be ignored.

AppRoot.SRC

The main source file for an application. Lists top-level variables and modules in use by the application. Edits may be imported. This file was named "AppMod.SRC" in earlier versions of VTScada.

GroupName.SRC

The source code for any user-defined widgets (groups) in the application will be stored in these files, where the name of the widget is used instead of "GroupName". User edits to these files may be imported.

Lexicon.VLX

If you customize the speech lexicon within an application, your edits will be stored in Lexicon.VLX.

Servers.RPC

Contains the list of configuration servers. This text file is in XML format. User edits may be imported, but must be made using correctly formed XML.

Settings.Dynamic

Contains application properties (formerly, configuration variables) whose value may be changed without re-starting the application. This file follows the same structure as the obsolete Config.INI

Settings.Startup

Contains application properties (formerly, configuration variables) whose value can only be changed by re-starting the application. This file follows the same structure as the obsolete Config.INI