Meaning of the RTXML Tags

The following table describes all the RTXML tags used in the RTXML configuration files:

XML Tag Pair

Description

<?xml version=”1.0” encoding=”UTF-8”?>

Do not modify this line as it contains information about the level and type of the rtxml format.

<configuration xmlns=”http:// tempuri.org/config.xsd”version=”1.0”>

Do not modify this line as it contains information about the level and type of the rtxml format.

<startupSystem Name="Sample" />

Identifies the <system> that should start when the WPF Client Container is run, if there are multiple systems declared in the config file. If this line is omitted, then the first <system> block that is encountered is run. The name entered here must match the name given in one of the <system> blocks in the configuration file. Change the name to the "system name" of the system that you want to start.

<system Name=”Sample”>

 

This is the descriptive name of the system and appears on the title bar of the WPF Client Container window. It marks the start of the block of data for the named system. Change this to your system name.

<componentName>SAMPLE </componentName>

This is the name of the component installed in COM+ for the deployed system. It is typically the name of the segment defined in System Modeler.

Note: This name is case-sensitive and must correspond to the actual name of the folder.

<runtimeServer>localhost </runtimeServer>

This is the machine name that the AB Suite application has been deployed to. This can also be the IP address of the server.

<downloadServerURI>C:\Users\Administrator\documents\Visual Studio 2017\Projects\WPFClient\Access Layer API Deploy</downloadServerURI>

This is a location that specifies from where the dependent components, such as DataModels, DataViewModels, or Views assemblies, are downloaded.

<downLoadCredentials>     </downLoadCredentials>

This allows you to specify the FTP usercode and password, if you are using the FTP Server location for the DownloadServerURI.

<fileRepositoryDirectory>WPFClient\

Images</fileRepositoryDirectory>

Specifies the location from where the dependent files such as images are retrieved. It can be on the same machine or on a remote server. The FileRepository interface of the Access Layer API transfers the dependent files from the specified location.

<assemblies> WPFClient.WPFClient.DataModels.dll, WPFClient.WPFClient.DataViewModels.dll, WPFClient.WPFClient.Views.dll </assemblies>

This defines the dependent assemblies required by the WPF Client application. This tag is pre-filled with the names of the DataModels, DataViewModels, and Views assemblies for a WPF Technology folder.

<localDownloadDirectory> 

C:\ProgramData\Unisys\ABSuite\7.0.\WpfContainer Downloads\Sample

</localDownloadDirectory>

This specifies the location of the local machine to which the dependent files are downloaded for use by the WPF Client application.

<enableKanji> false </enableKanji>

Enables the correct handling of Kanji data in a segment that has NationalString Nodal property under the National Support category set to MultiByte. In particular, it ensures that Kanji data sent to the WPF Clients through the SendDynamic and SendStatic commands are properly encoded and displayed in list boxes.

<disableConsole>false </disableConsole>

Prevents a user from accessing the console processing window in a WPF Client application. This option must be set to False if you want the end user to be able to run reports, or interact with reports. If this item is set to True, the Command Console, Select Commands, and Run Reports menu items are disabled.

<logLevel>Error</logLevel>

Sets the log level for the Access Layer API component. The valid values are Error, Info, and Debug.

<logFolder>C:\Temp </logFolder>

Specifies the location of the log file created by the Access Layer API logging process. By default, the location of the log file is C:\Temp.

<useComputerNameForStation> false </useComputerNameForStation>

Determines whether to use the local computer name as the station name for the runtime system. By default, the value is False.

<stationName>WIN-IQFR1DJ10U5

</stationName>

Allows you to specify a station name for a machine running the WPF Client application. If specified, this value overrides the default station name (which is the current users Windows user name) and/or the <useComputerNameForStation> setting, if it is set to True.

<supportAutoTabbing>false </supportAutoTabbing>

Specifies whether the focus should move to the next field in the tab order when a field is filled according to the defined field length. By default, the value is False.

<offLine>false</offLine>

This allows you to run the WPF Client application in offline mode. It does not try to establish a connection with the runtime system if this tag is set to True. By default, the value is False.

<isAnonymous>false </isAnonymous>

Specifies whether the connection should be made anonymously. This allows you to run multiple WPF Client sessions to the runtime system simultaneously on the same machine. By default, the value is False.

<forceLogin>false</forceLogin>

An existing session for the same user can be overridden with a new connection to the runtime system if this tag is set to True. By default, the value is False.

<useGateway>false </useGateway>

Allows you to connect to the runtime system using the AB Suite WCF Gateway service, instead of using the COM/DCOM directly from the WPF Client application. By default, the value is False.

<gateWayAddress>127.0.0.1 </gateWayAddress>

Specifies the address of the machine where the WCF Gateway is running.

<showClosingDownMessageForBye>

true</showClosingDownMessageForBye>

Specifies whether a message box should appear when an application is closed due to a Bye request received from the runtime system. By default, the value is True.

<reports> </reports>

Do not modify this tag as it identifies a <reports> block. This lists the reports generated for an application. The reports can be initiated from the WPF Client. If the <reports> tag is empty, the run reports menu item is disabled in the WPF Client.

<languages>

Do not modify. This tag identifies a <languages> block. If this block is empty, the Language menu item is disabled. This block is only required if you want to switch between languages.

<language name=”English” ID=”1033” / >

Specifies the languages that you have defined in your AB Suite Client Framework application.

</language>

Defines the end of language block.

Note: The individual closing tag for each language might be omitted if each language tag is terminated with the closing character of /.

</languages>

Defines the end of languages block.

<ATTRecord Enable="false" Mode="connect" Server="127.0.0.1" Port="8888">

This allows you to define the ATT Recording options to capture the ATT Test cases using the WPF Client. The recorded test cases can be replayed using ATT through the Access Layer API.

<file>C:\Temp\Recordings\Testcase.smtest

</file>

     

Specifies the path and name of the file to which the Test Case is recorded when ATT is in the Disconnect mode. For example, C:\Temp\Recordings\Testcase.smtest.

<recordDynamicLists>false

</recordDynamicLists>

Specifies whether ATT record is Dynamic List Data or not. By default, the value is False, because this recording option adds an overhead to the ATT test case processing and should only be turned on if required.

</ATTRecord>

Defines the end of the ATT record block.

</system>

Defines the end of this particular system.

If you switch between more than one systems by using the SWITCH.TO command in your runtime logic, you must define a <system> block for each system that might be switched to.

</configuration>

Defines the end of the configuration block.