Automation with Agilitest

This feature is available only in the Premium version of Squash AUTOM.

Test reference in Squash TM

In order to bind a Squash TM test case to an Agilitest automated test, the content of the Automated test reference field of the Automation block of a test case must have the following format:

[1] / [2]

With:

• [1]: Name of the project on the source code repository.

• [2]: Path and name of the ActionTestScript file, from the root of the project (with the .ats extension).

Focus

The ATS script must be located in src/main/ats/* , as in any regular ATS project architecture.

Nature of the exploitable Squash TM parameters

The exploitable Squash TM parameters in an ActionTestScript script will differ depending on whether you're using the Community or Premium version of Squash DEVOPS.

Here is a table showing the exploitable parameters:

Nature	Key	Community	Premium
Name of the dataset	DSNAME	✅	✅
Dataset parameter	DS_[name]	✅	✅
Test case reference	TC_REFERENCE	✅	✅
Test case custom field	TC_CUF_[code]	✅	✅
Iteration custom field	IT_CUF_[code]	❌	✅
Campaign custom field	CPG_CUF_[code]	❌	✅
Test suite custom field	TS_CUF_[code]	❌	✅

Legend:

• [code]: Value of the "Code" of a custom field
• [name]: Parameter name as filled in Squash TM

As indicated, Squash TM adds a prefix to the code of the transmitted custom field. Make sure to take it into account.

Refer to the Squash TM documentation for more information about custom fields.

Squash TM parameters usage

When executing a Squash TM automated test case with Agilitest, it is possible to exploit the Squash TM parameters inside the test.

In order to achieve this, you will have to follow these steps:

• Create custom fields in Squash TM and bind them to the project bearing the test plan to execute.

• Make sure that the code fields of the parameters correspond to the names of the existing environment variables present in the ActionTestScript script.

Example

Below is an example of an Agilitest test file and the corresponding Squash TM test case automation:

Squash TM 1.22.XSquash TM 2.X.Y

Supported versions

Squash AUTOM and Squash DEVOPS have been validated with ATS 2.3.0. Any recent version should work properly.