4. Opening Vitaq AI in docker container

The following documentation sections will describe in tutorial style how to create a Vitaq AI test activity that will auto-generate tests for a bill splitting web application.

Make sure you have the Vitaq AI docker container running, by typing ‘docker ps’ in a terminal of your host machine. If it is not running then depending on your operating system you will need to execute a docker container start. On MacOS and Windows this is best done from the docker desktop Dashboard, in Linux you will do it from the terminal.

Open a browser and type to navigate to your local host port to find the Vitaq AI docker container. Click on Connect.

You can launch Vitaq AI from the docker container by clicking on the start icon in the bottom corner of the browser window. Selecting Programming Tools and then Vitaq Test Automation.

Click on File in the top tool bar menu and select New. Fill in the Test Activity Name with Bill_Split_Test_Activity, click OK. You will see that the Activity Diagram part of Vitaq window now has the name of the diagram in a tab at the top right.


When we want to reload this Vitaq Test Activity into Vitaq Test Automation we need to select file->open and select the .vtq file of that name.


You will see that the Test Activity canvas tab has a green setUp Test Action. If you select it by clicking on it you will see that the Action Properties tab on the right side of the Vitaq window displays its properties. You will notice that the value of the seed is set to 1 by default and that Auto-increment Seed is not enabled. Click the check box for auto-increment. We will cover seeds and why they are very important in the operation of Vitaq in the Setting Seeds section later in the guide. The setUp Test Action is special in that whenever a new Test Activity diagram is created it will also be created. It does not have an associated Test Action Script as all other Test Actions do. Test Action Scripts will be covered further on.

There are many examples of bill splitting apps available. They all perform the same function. You create an expense account, add the participants involved with each expense item, add expense items including the details of the bill, the costs, who paid and who was participating with the bill and then finally they calculate the balance that needs to be paid by each individual participant. These Apps also allow you to keep an existing account and add new participants and new expense items.

We are going to use this web bill splitting app https://splitme.net/en to demonstrate how to use Vitaq to auto-generate tests for User Interface testing.


To use the Scriptworks visual coding capability with Vitaq AI, you will need to set your preferences to enable the connection with Scriptworks cloud to gain access to your project and Test Action script functions for Vitaq AI to run with Selenium.

Select Edit -> Preferences

Click Use Scriptworks Integration radio button. Then enter your Scriptworks User Name and Password and click on the Connect button. It will turn green if the login to Scriptworks cloud is successful as shown below.


Now click Load on the Scriptworks Project and select from the list of projects available to you in Scriptworks. Select the SplitMeSelenium project in Scriptworks. You also need to select the Run Settings for Selenium (or Appium) in the Preferences. We have pre-installed the Chrome driver for you in the docker container, so select Chrome.


The runsettingsid number is the id number of the run settings group in Scriptworks for your current Scriptworks project.

Make sure you click ‘Ok’ to save the Preferences. If you have a small screen, you may find it difficult to navigate to the ‘Ok’ radio button. You can also use the tab to move between preference fields until you reach the ok radio button and then hit carriage return to save your preferences.