actiWATE: Tutorial

Configuration file

Configuration data for actiWATE tests are defined in actiwate.properties file. This file should be placed into a working directory or included into the Java CLASSPATH during tests execution.

Logging properties

filelogging.directory - defines the directory where actiWATE will store information about failed tests;
filelogging.enabled - indicates whether actiWATE will output logs and failure reports. actiWATE stores logs and failure reports only if the parameter value is 'yes' (case-insensitive).
filelogging.level - allows user to specify the level of details of generated logs. Possible values in order of decreasing precision are following: 'debug', 'info', 'warn', 'error', 'fatal' (case-insensitive).

Proxy configuration properties

proxy.hostname - defines proxy host. If this property is specified actiWATE connects to a tested web-application through the specified proxy. If this property is not specified then other proxy configuration properties are skipped.
proxy.port - defines proxy port number (default: 8080)
proxy.username - defines username for proxy authentication. It can be commented if a proxy doesn't require authentication.
proxy.password - defines password for proxy authentication. It can be commented if a proxy doesn't require authentication.

Basic Authorization credentials properties

authCredentials.username - defines username for basic authorization.
authCredentials.password - defines password for basic authorization.
authCredentials.host - defines the host the above credentials applied to. The omitted host signifies default credentials, which should be used when no credentials have been explictly supplied for the challenging host.
authCredentials.realm - defines authentication realm. The omitted realm signifies default credentials for the given host, which should be used when no credentials have been explictly supplied for the challenging realm.

Screen properties

screen.height - defines the vertical resolution of the screen.
screen.width - defines the horizontal resolution of the screen.
screen.availHeight - defines the height of the working area of the screen (excluding the Microsoft� Windows� taskbar in Microsoft� Windows�)
screen.availWidth - defines the width of the working area of the screen (excluding the Microsoft� Windows� taskbar in Microsoft� Windows�)
screen.colorDepth - defines the number of bits per pixel used for colors on the screen.

External resources properties

useJavaScriptCache - specifies whether actiWATE should use JavaScript cache or not. Turned off by default.
resourcesLoading - controls whether actiWATE will download auxiliary resources referenced from the page. If turned on, actiWATE will attempt to download images, css files, objects and if such download attempt was not successful a warning message will appear in actiWATE logs.
useAuxiliaryResourcesCache - forces actiWATE to use cache for auxiliary resources (i.e., images, css, objects). Turned off by default.

Timeout properties

connectTimeout - determines the timeout until HTTP connection with a server is established. The value of zero means that timeout is not used. By default timeout is not used.
dataTimeout - determines the time which actiWATE waits for data from server after connection is established. The value of zero means that timeout is not used. By default timeout is not used.

Accept-Language request header-field

acceptLanguageHeader - The Accept-Language request-header field restricts the set of natural languages that are preferred as a response to the request. Usually web applications use this header field to prepare HTTP responses in the requested language. Browsers assign the value to this header depending on the locale set on the machine. In actiWATE its value is configured using the acceptLanguageHeader configuration parameter. This way you can specify the preferred languages for your web application without changing the system locale if your web application is sensitive to this request header-field.

Example:
```
acceptLanguageHeader=en-us
```

Default character set

defaultCharset - During parsing of an HTTP response actiWATE reads character set name from the 'Content-type' response header field or from META tag if it's specified on an HTML page (HTTP response header filed has a priority). However, there are rare cases when neither HTTP response headers nor the META tag contain character set name. But actiWATE still require it in order to decode an HTTP response properly. For such cases you can specify the character set name using the defaultCharset configuration parameter. Otherwise actiWATE will use ISO-8859-1 character set to decode HTTP responses.

Example:
```
defaultCharset=UTF-8
```

Other properties

baseURL - This optional propery defines base URL for relative URLs used in tests. This is useful when one needs to test several installations of web application.
autoExecMetaRefreshes - forces actiWATE to automatically process META refresh tags. If this property is set to 'yes', then actiWATE will process META refresh automatically, immediately after the page loading. In this case there is no need to execute asynchronous events (see tutorial Working with asynchronous events). By default automatic execution of META refresh tags is turned off.