Articles in this section

See more

Integrating Applitools Ultrafast Grid and Tricentis Tosca

Avatar
Nikhil Nigam
  • Updated

Introduction

The purpose of this document is to explain the newly built integration of Applitools’ Ultrafast Grid  (for cross browser testing) with Tricentis Tosca . Tosca is an enterprise grade no code automation solution which can automate testing of web, mobile and desktop applications. The prior integration between Applitools and Tosca provided advanced AI powered visual validation across all these applications and this new integration enables cross browser testing for web applications using the Applitools Ultrafast Test grid and the power of AI.

 

This integration will now enable existing Tosca tests for Visual Testing using AI and simultaneously allow for running the test on multiple devices and browsers without the need of having a local infrastructure. By using this new integration teams can now leverage full capabilities of AI in increasing test accuracy, reliability and test coverage.

 

Note: Minimum Tosca version supported for this integration is Tosca 13.2

System requirements

  • Windows 8 and above (refer to supported version for your Tosca installation)
  • Java 8 and above
  • Browser (chrome, firefox or edge)
  • Tosca 13 and above
  • .Net Framework 4.5 and above

Installation

Following needs to be installed (refer to download package in last section):

  1. Applitools browser extension - drag and drop the extension to your browser (enable developer mode).
  2. Applitools UFG SET dll - deploy this to a custom directory when setting up SET.Note: open the properties of DLL and ensure it is not 'blocked'.
  3. Import the sample subset provided in the download package. This should install the Applitools modules in your Tosca environment.

Applitools Modules

The custom SET created for this integration has the following modules:

Eyes Open

eyesOpen.png

Eyes Check

eyesCheck.png

Eyes Close

eyesClose.png

How to use it?

Following parameters can be set at the Test Configuration level

Parameter

Values

APIKey

Applitools API key

ApplitoolsCloud

Applitools url (public or dedicated) - provided during setup

ApplitoolsRetryInterval

Retry interval in seconds

ApplitoolsRetryMaxCount

Retry attempts

AppName

Application name

Browser

Chrome, Firefox, Edge

EnableLogs

True or False

FailOnError

True or False

HostApp

Environment e.g chrome browser

HostOS

Operating system

LayoutBreakpoints

<Viewports> e.g. 1600,1200 or All/True or None/False

URL

<application url>

Concurrency

To control the number of parallel executions on the Applitools' Ultra fast Grid. Contact administrator to know your max concurrency limit.

EnableAccessibility

This flag is used to enable contrast advisor for accessibility. Flag value can be 'True' or 'False'.

 

Now record the Tosca test as usual using the scan option on Tosca commander. Once the test case is  recorded, first use Eyes Open to establish a connection with the Applitools server. Following are parameters:

Parameter

Values

Caption

Browser tab - Title

App Name

Application name

Test Name

Test name

Viewport

Provide Width and Height

BrowserInfo

Add Browsers, devices from the provided list.

BatchInfo

Provide batch Id (if batching is required) and batch name

Accessibility

Select the WCAG version and WCAG level for your test run.



Next is to include Eyes Check for every screen/component validation that needs to be performed. Following are parameters:

Parameter

Values

Caption

Browser tab - title

Check Type

Windows vs Region

Region Selector

Provide css selector, only if check type = ‘region’

Match Level

Strict, Layout, Content

Step Name

Logical step name

IsFullPage

True - if full page screenshot required

LayoutBreakpoints

<Viewports> e.g. 1600,1200 or All/True or None/False

 

Once the test is completed invoke the Eyes Close module to close the connection and get results from Applitools.

Parameter

Values

Caption

Browser tab - title

 

Note 1: Web driver should only be closed after the Applitools connection is closed (Eyes Close).

Note 2: Browsers running the automation should not get closed during the execution of automation.

Note 3: Include any number of Eyes Check within a single test. Each Eyes check corresponds to a page validation.

 

Appendix

  1. Test Sample - download the test sample (including applitools SET modules) from the link mentioned below. Replace the  API KEY with your own license key.
  2. Special Execution Task DLL - use the applitools DLL corresponding to your existing Tosca environment (e.g. 13.2, 14.0 or 14.2,15.0, 15.2)  from the download link given below.

Related articles