Agentry Test Script Overview

The Agentry Test Script is an XML schema supported by the Agentry Test Environment that can be used to automate testing the Client behavior of a mobile application built on Agentry. The Agentry Test Environment includes a script recorder that allows for the recording of test scripts, and can then play back those test scripts.

The test script language includes the ability to interact with all controls present on the client application’s interface, including field selection, data entry, button clicks, and navigation. Additionally, this language also supports the ability to check the current values of labels, fields, and other items displayed on the client application’s interface for expected values.

In addition to direct client interaction, the test script also includes the ability to query database systems for expected values. This can be used after transmit to verify the proper functioning of transactions related to the back end processing that is defined within those transactions.

Elements within the test script XML schema are logically grouped into the following categories:

Script Elements: Elements for the script itself, including the top-level <script> element and elements related to logging and script execution.
Button Elements: Elements that allow for interaction with button definitions, including selection (or “clicking”), checking the state of the button, and label values.
Field Elements: Elements that allow for interaction with detail screen fields. Note that certain field edit types are supported by elements in other groups.
List Elements: Elements for working with list controls of various types. This includes list controls on list screens, as well as the various list types that can be defined for detail screen fields.
Tree Elements: Elements for working with tree controls. This includes tree controls presented by detail screen fields.
Scanner Elements: Elements for simulating scanner behaviors, including passing values in as barcode scanner values.
SQL Elements: Elements for creating connections to and running queries against database back end systems. Values can be returned by these queries and checked against expected values.
Tab Elements: Elements for working with the tab controls presented by screen sets for each child screen definition.
Window Elements: Elements for closing windows on the client. Rarely used, as navigational actions defined to close screen sets should be used wherever present.
Client Elements: Elements for affecting the client process, including restarting and other behaviors.
Client Host Elements: Elements to interact directly with the client device, which may in turn affect the test client, such as entering key strokes or executing commands on the client device.

Common Test Script Element Attributes

The following attributes are common to the bulk of the elements within the Agentry Test Script XML schema. They relate primarily to time outs for the execution of a given element, and the amount of time to pause between the execution of one element and the next. Setting these attributes in the <script> element of the test script will set defaults for the entire script execution that can then be overridden by individual child elements if needed.

Name	Description	Data Type	Default Value	Required
timeout	The amount of time to wait for the element to finish processing before returning an error. This value can be set in the <script> element for the entire script and/or at each processing element within the test script. Child elements with this attribute will override the value set in parent elements. The value is specified in milliseconds.	Positive Integer	N/A	No
sleep	The amount of time to pause after the element is executed. This value can be set in the <script> element for the entire test script and/or at each processing element within the test script. Child elements with this attribute will override the value set in parent elements. The value is specified in milliseconds.	Positive Integer	N/A	No