Adding a checkpoint and test steps

Important core concepts:

• Project
• Goal
• Tests
• Natural language syntax

Following up Creating and exploring the first goal, once a goal has been explored, you can augment the generated tests with the following steps:

1. Open a journey in the Goal view;

Users visiting the same journey

If other users are accessing the same journey as you, their avatars are shown near the journey name. In the above image, the user can see that someone with initials "IU" is also on the same journey authoring page.

2. Click on Add a checkpoint below the existing checkpoints. This will open up the form to either create a new checkpoint, or reuse an existing one (see shared checkpoints below):

   2.1. If you wish to create a new checkpoint, type its new name and click create or press enter.

   2.2. To reuse an existing checkpoint, type a hint of its name or number, and once it shows up in the list, click on its name to select it. The label on the confirm button will change from "Create" to "Attach" (note that a checkpoint cannot be inserted more than once in a journey, including the first one).

3. Add the test steps (see Natural language syntax for the available commands).

Adding test steps

You can create new test steps by mousing over an existing one and clicking on the icon . The icon shows the position where test step will be created.

Test step details

Once a test step is created, you can click on the test step to open the step details on the right side of the screen.

This panel is composed by the following tabs:

• Step editor here you can edit the details of the command that Virtuoso will use for this step such as the element selectors, use variables, or options such as what to do When this step fails;
• Screenshot here you will see a screenshot from the page after the test step was executed at least once, and if the instruction targets an element (e.g., click on "Images") you can switch to the Before element interaction to see the state of the page before clicking on the element;
• Side effects shows execution contextual observations that may be relevant to you (e.g., a value used by a variable);
• Step timeline shows the changes, jobs and comments associated to the test step (see Timeline for details).

Test steps added but not executed yet

Virtuoso will fill in some information for your step just after creating it depending on the natural language command used to create the step. After executing the step for the first time, Virtuoso will guess more information about the step such as the element structure, the element selectors, or any other information that the test might generate after executing it. Usually, you will not need to edit the test step details manually.

Shared checkpoints

Journeys from the same goal can share one or more checkpoints (set of test steps). You can see this in action in the first checkpoint of every journey:

On a shared checkpoint, any change to its test steps will be replicated in all other journeys where it's shared. In practice, they are all the same checkpoint. E.g., if you add a test step such as Click on "Images" in the first checkpoint (which is a shared checkpoint), that test step will be added in the same position on the first checkpoint of every journey of the goal.

Sharing a checkpoint

Checkpoints can be shared following one of these two methods:

Reuse an existing checkpoint

You can choose to reuse a checkpoint while adding a new one to the journey by typing a hint (name or checkpoint number) of an existing checkpoint, and selecting it from the list.

Create a new journey reusing another’s checkpoints

This method allows you to create a new journey that will share all the checkpoints up to a point with the original journey.

1. Move your mouse pointer after the checkpoint you want to share and click on New journey from here;

2. Enter the title for the new journey and click on Save;

The new journey will share all the checkpoints between the first checkpoint and the checkpoint where you clicked on New journey from here in the original journey:

Unsharing a checkpoint

You can unshare any checkpoint (except the first one) by clicking on the icon next to the Shared in N other journeys text next to the checkpoint name.

Following these steps allows you to write custom tests, augmenting the ones generated by Virtuoso. This is the end of the introduction to Virtuoso, next we look at how to Using Virtuoso, starting with Managing projects.