Configuration Files

In the configuration file you can define the properties for starting a test. The following XML tags are available:

<Config ... />
Defines the project path.
<Run ... />
Defines properties for running the test file.
<Login ... />
Defines the login information.
<BrowserSettings ... />
Defines if a proxy server should be used for connecting to the defined web service.
<ParameterTable ... />
Defines if a parameter table should be used.
<Adaptor ... />
Defines the Fabasoft app.test Client Adaptor settings.
<Agent ... />
Defines the Fabasoft app.test Agent settings.
<Reporting ... />
Defines the reporting settings.
<Telemetry ... />
Defines if Fabasoft app.telemetry should be used.
<Threads ... />
Defines if several tests should be executed parallel by using threads.

The root tag of the configuration file is the <Config> tag. In here you can define the path of the project in the attribute projectpath and the project name in the attribute projectname.

Note: If a backslash occurs in the end of a path you have to escape this backslash by another backslash (otherwise the backslash escapes the quotation mark).

Example

In the Run tag you can define the settings for running the test.

These are the attributes that can be set in the Run tag:

Attribute	Description
execute	In the execute attribute the path to the test file is specified that should be executed.
webserver	The webserver attribute contains the web server where the test should be executed.
address	The address attribute contains the address where the test should be executed.
applicationtype	The applicationtype together with the attribute clienttype decide the test environment. The applicationtype can be one of the following: BROWSER - Use the browser installed on the test client JAVA - Use Java plugins to test custom applications Default value: BROWSER
clienttype	The clienttype attribute contains the web browser that should be used for executing a test. When using the application type BROWSER the following options are valid: APPLE_SAFARI GOOGLE_CHROME GOOGLE_CHROME_BETA GOOGLE_CHROME_HEADLESS MICROSOFT_EDGE_CHROMIUM MICROSOFT_EDGE_CHROMIUM_BETA MICROSOFT_EDGE_CHROMIUM_DEV MOZILLA_FIREFOX MOZILLA_FIREFOX_BETA MOZILLA_FIREFOX_HEADLESS With the application type JAVA the only option here is EXTERNAL.
scope	The scope attribute contains the scope that might be used within the file. The scope is an integer value between 1 and 9999. Default value: 1
runs	The runs attribute contains the number how often the specified file (execute attribute) should be executed. This must be a number greater than 0. Default value: 1
retries	This attribute contains the number of retry attempts in case a test fails. Default value: 0
sleep	The sleep attribute contains a time in milliseconds. The Fabasoft app.test Console Player waits the defined time after each statement. Default value: 0
onerror.screenshot	The onerror.screenshot attribute defines if a screenshot should be created each time an error occurs. Default value: false
onerror.htmldump	The onerror.htmldump attribute defines if the HTML of the currently shown web site should be saved each time an error occurs. Default value: false
onerror.controldump	The onerror.controldump attribute defines if the structure of all controls currently displayed in the Fabasoft app.test Client Adaptor should be saved as an XML file each time an error occurs. Furthermore, the currently set test parameters are saved as a parameter table. Default value: false
onerror.apptelemetryreport	The onerror.apptelemetryreport attribute defines if the error (with screenshot and all dumps as configured) should be reported to app.telemetry if available. Note: This attribute cannot be configured in the run dialog (defaults to true). Default value: true
closeremainingcontextapps	If an adaptor is closed, all remaining open third-party applications started by this adaptor which can be found via the Context statement will be closed automatically. If set to false, only a list of open applications will be reported. This will result in a warning in the session statement. Default value: true
langpath	The langpath attribute defines the default path for the language files that are used in the test. This path is saved in the system parameter langpath and can be used in the test for loading language files. Default value: {~resources~}LanguageFiles
timeout	The timeout attribute contains the timeout for statements, which means Fabasoft app.test throws a "Timeout" error if a statement takes too long to be executed. The timeout value can be defined individually (in milliseconds). Default value: 30000
sequencetimeout	The sequencetimeout attribute contains the timeout for session statements, which means Fabasoft app.test throws a "Timeout" error if a session takes too long to be started. The timeout value can be defined individually (in milliseconds). Default value: 60000
contexttimeout	The contexttimeout attribute contains the timeout for context statements, which means Fabasoft app.test throws a "Timeout" error if a context takes too long to be started. The timeout value can be defined individually (in milliseconds). Default value: 90000
maxerrors.test	In the maxerrors.test attribute you can define the maximum number of errors which may occur within a test. If this number is exceeded, the test is aborted. Default value: 0 (abort test on first error)
maxerrors.sequence	In the maxerrors.sequence attribute you can define the maximum number of errors which may occur within a session. The execution of the test continues with the next session if this number is exceeded (only the current session is aborted). Default value: 0 (abort sequence on first error)

Example

In the BrowserSettings tag you can define if a proxy server should be used when connecting to the web site defined in the Run tag.

These are the attributes that can be set in the BrowserSettings tag:

Attribute	Description
useproxy	In the useproxy attribute it is defined if a proxy server should be used. If this attribute is set to true a proxy server is used which also means you have to set the following attributes as well (for defining the proxy server to be used). Default value: false
proxyserver	The proxyserver attribute defines the proxy server to be used (IP address or name).
proxyport	In the proxyport attribute the port used by the proxy server is defined. Default value: 8080
jsenabled	In the jsenabled attribute it is defined if running JavaScript in the browser is enabled. Default value: true
pluginsenabled	In the pluginsenabled attribute it is defined if running plug-ins in the browser is enabled. Default value: true

Example

You can define variables in the configuration that can be used in the test. There are two ways for defining parameter tables in the configuration file:

You can either load an existing function definition file by using the filename attribute or you can directly enter set statements into the ParameterTable tag.

If you use both, the parameters set directly in the configuration file (by set statements) overwrite the parameters from the file that is loaded.

Example

On the "Login" tab of the "Run" dialog the information for logging on is specified:

This information is also needed in the Fabasoft app.test Console Player and can be specified in the Login tag by setting the following attributes:

Attribute	Description
authentication	In the authentication attribute you can define the type of authentication that should be used. basic - Basic authentication is used. This means the user that is specified in the session is used for logging on. Default value: basic
domain	The domain attribute specifies the domain of the user. This domain is overwritten if a domain is defined in a session of the test
username	The username attribute contains the name of the user that should be used. This user is overwritten if a user is defined in a session of the test
password	The password attribute contains the password that is used for logging on. This password is overwritten if a password is defined in a session of the test.

Example

In the Adaptor tag you can define the properties for the Fabasoft app.test Client Adaptor like the size, the position and the port that should be used.

These are the attributes that can be set in the Adaptor tag:

Attribute	Description
width	The width attribute defines the width of the Fabasoft app.test Client Adaptor (in pixels). Default value: 1000
height	The height attribute defines the height of the Fabasoft app.test Client Adaptor (in pixels). Default value: 750
poshor	The poshor attribute defines the horizontal position of the Fabasoft app.test Client Adaptor (in pixels). Default value: 10
posver	The posver attribute defines the vertical position of the Fabasoft app.test Client Adaptor (in pixels). Default value: 10
port	The port attribute defines the TCP port used by the Fabasoft app.test when running a test. Note: If the configured port is already in use, the next free port is taken. Default value: 4360

Example

In the TreeModel you can define the default tree model. If it is not set, the tree model is “ARIA”.

These are the attributes that can be set in the TreeModel tag:

Attribute

Description

default

The default attribute defines the used tree model.

Default value: ARIA

Configuration Files

Download PDF

Download PDF