Appendix G - Configuration XML File Format

G.1       Configuration File Editing

The configuration file that is used to save gateway configuration and reload later to reconfigure another gateway the same way is saved in XML format. This makes it easy to read for diagnostic purposes, primarily for Control Solutions' technical support use. However, due to the complexity of the file, the XML FILE IS NOT INTENDED TO BE MANUALLY EDITED.

There is no reason to manually edit an XML file. If you are looking for a short cut in configuring the gateway, you are looking in the wrong direction. The configuration tool includes the ability to import and export object lists as a CSV file. Manual editing should be limited to creating and modifying the CSV file. In the process of importing the CSV file, you effectively auto-create much of the configuration.

The configuration software (user interface) includes a number of error checking steps that are applied as you enter information in the various pages of the software tool, and these are bypassed in the event you manually edit an XML file. IF YOU HAVE CREATED PROBLEMS BY MANUALLY EDITING AN XML FILE, CONTROL SOLUTIONS WILL NOT TRY TO FIX THE FILE FOR YOU.