Configuring Winform

Before running applications, you must edit a configuration file named config.xml. This is an xml file that contains configuration information to enable the Winform clients to find and connect to the application component. This file is automatically created by the generation of the system. The administrator might have already modified this configuration file in the installation package. Check with your administrator before proceeding.

A default copy of config.xml file is located at <AB Suite installation folder>\Unisys\<AB Suite>\Bin.

Alternatively, a pre-configured version of this Winform configuration file, named ispec.xml is automatically generated each time a system is built with Builder. This file is located in the systems installation Bin folder.

For example:

C:\Sample\Release_Windows\SAMPLE\Core\Bin

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 created and 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:

  1. Locate the Packages directory in the Builder Output folder, in the location <Builder Output Path>\<System Name>\<GUID ID>\Packages.

  2. If you have multiple folders in the model, then you will find similar folders inside the Packages directory.

  3. Locate the particular Winform folder and open the folder.

  4. You will find the ispec.xml file generated for this folder.

The following entries might need to be edited:

  1. <system name> should be set to a string with the name of the system. This name appears on the title bar of the Winform window. For example, <system name = “Sample”>

  2. <startupSystem name> should be set to the same string as <system name>. Note that you can have multiple <system name> sections in the config.xml file. This <startupSystem name> entry specifies which system is started when you first open the Winform Container. For example, <startupSystem name=”Sample”>

  3. <componentName> should be set to the name of the COM Program ID that the system was generated with. Contact your administrator for this value. For example, <componentName>SAMPLE</componentName>.This name is case sensitive and must correspond to the case of the actual name of the COM Prog ID.

  4. <runtimeServer> must contain the machine name where the runtime system was deployed and installed. Contact your administrator for this value. Use “localhost” if you generated a test system to your own machine.

  5. <downloadServerURI> is where the generated Winform dlls have been copied. For example, <downloadServerURI>http://192.234.333.23/WinFormsDownload/ SAMPLE</downloadServerURI>

    or <downloadServerURI>file:///C:\Sample\Release\SAMPLE\Interfaces\WinForms\Bin

  6. <GIWCompatibleBehaviour> can be set to true or false. If set to true, then the behavior of some GUI controls are backwards compatible with a previously used client product called GIW (Graphical Interface Workbench). The specific GIW behavior includes the following:

    • Push Buttons: When a push button is pressed, the values associated with all other push buttons on the form is cleared, so that only the value for the pressed push button is sent to the host.

    • Radio Buttons: In a radio button group, if no button in the group is set (a default button has not been defined and none of the button values match the value sent from the host) then the first button in the group is set.

    Language numbers are added automatically and do not need to be included as part of this entry.

    Configuring Winform for ROC

    If you want to connect to the Report Output Control System (ROC) from another application using the Roc command, you must first configure the Winforms client to support switching to the ROC system. To do this, add the following XML to the end of the config.xml file:

    <system name="ROC18">
 <componentName>ROC18</componentName> 
 <runtimeServer>localhost</runtimeServer> 
 <downloadServerURI>
		file://C:\ROC\Release\ROC18\Interfaces\WinForms\Bin
		</downloadServerURI>
 <localDownloadDirectory>.\</localDownloadDirectory>
 <defaultImageType>.jpg</defaultImageType>
 <defaultImageSubDirectory>images\</defaultImageSubDirectory>
 <defaultListType>.xml</defaultListType>
 <defaultListSubDirectory>lists\</defaultListSubDirectory>
 <disableConsole>false</disableConsole>
 <GIWCompatibleBehaviour>false</GIWCompatibleBehaviour>
 <enableLogging>true</enableLogging>
 <logFile>.\client.log</logFile>
</system>

    Note: For 64-bit, you need to modify the <downloadServerURI> entry with the following:<downloadServerURI> file://C:\ROC\Release\ROC18\Interfaces\WinForms\Bin64 </downloadServerURI>