Creating the XML configuration file

When a system is built by Builder, the generated files include an XML configuration file called ispec.xml, which is located in the Bin folder under the Package Installation Directory as specified in the Folder Properties, Installation category.

For example, <package installation directory>\<configuration name>\<segment name>\Core\Bin\Ispec.xml. This file is configured with most tags defined and includes all the ispecs and reports in the system.

You have two options for creating a custom XML configuration file for your users:

Use the default config.xml file mentioned previously and using a text editor, remove the small number of existing sample entries and then add your own for your generated system.
Use the generated ispec.xml file and using a text editor, modify the entries to suit your requirements. For instance, you might want to limit the number of ispecs or reports which can be accessed by a group of users and by removing some of the existing entries to create an individual XML file for that group.

Either of the above methods is acceptable, the decision depends entirely on which is most convenient. Once you have created your customized version of the XML configuration file, save it using a suitable name, for example SalesConfig.XML, and append the file name to the WinForm Container shortcut or command line.

An ispec.xml file is created for each deployment folder if you set the Deploy Winform User Interface property to True and if you customize the Final Location and Download URI properties.

The ispec.xml file is available in the Builder Output folder. You can directly use this ispec.xml file as the two properties DownloadServerURI and LocalDownloadDirectory are already configured.

To locate the ispec.xml file:

Locate the Packages folder in the Builder Output folder, in the location <Builder Output Path>\<System Name>\<GUID ID>\Packages.
If you have multiple folders in the model, then you will find similar folders inside the Packages directory.
Locate the particular Winform folder and open the folder.
You will find the ispec.xml file generated for this folder.

Here is an example of a configuration file with a single system defined in it.

<?xml version="1.0" encoding="UTF-16"?>
<configuration xmlns="http://tempuri.org/config.xsd" version="1.0">
   <startupSystem name="Sample"></startupSystem>
<system name="Sample">
   <componentName>SAMPLE</componentName>
   <runtimeServer>localhost</runtimeServer>
<downloadServerURI>file://C:\MySystem\Sample\Release_Windows\Sample\Interfaces\WinForms\Bin</downloadServerURI>
   <localDownloadDirectory>.\</localDownloadDirectory>
   <defaultImageType>.jpg</defaultImageType>
   <defaultImageSubDirectory>images\</defaultImageSubDirectory>
   <defaultListType>.xml</defaultListType>
   <defaultListSubDirectory>lists\</defaultListSubDirectory>
   <disableConsole>true</disableConsole>
   <GIWCompatibleBehaviour>false</GIWCompatibleBehaviour>
   <enableLogging>true</enableLogging>
   <logFile>.\client.log</logFile>
   <windowState>Normal</windowState>
   <clientSize>800,600</clientSize>
   <useComputerNameForStation>false</useComputerNameForStation>
   <stationName></stationName>
   <ispecs>
   <ispec name="Menu" description="The description for the Menu class">
   </ispec>
</ispecs>
   <reports>
   <report name="Report1" description="The description for the Report1 class">
   </report>
   <report name="Report2" description="The description for the Report2 class">
   </report>
   </reports>
   <commands>
   </commands>
   <languages>
   </languages>
</system>
</configuration>

Refer to the table which describes the Meaning of the XML Tags.