# Quick start

To assist you in using Virtuoso, this section will give an overview of the main components, the Organization dashboard and the Project dashboard. At the end of this page, there are several Tutorials covering the main tasks available in Virtuoso.

# Organization dashboard

Organization dashboard

After logging in to Virtuoso, you are presented with the organization dashboard, in which you can view or manage various aspects of your organization (e.g., usage, apps, team and member management, and settings). More importantly, in this dashboard you can create new projects and access existing projects you have access to.

In case a user is associated to multiple organizations, it is possible to switch between them, by selecting the organization in the dropdown as depicted below.

Organization dashboard

# Project dashboard

Project dashboard

To access this dashboard look for the icon on the left sidebar and click on it.

In this guide you will learn about the parts that compose the project dashboard:

  1. Overview
  2. Tags

This page presents an overview of the Project shared with you. Here you can find an overall look at how your goals are doing, information about your execution plans as well as other project-level settings such as tags, webhooks, and sharing actions.

# Overview

If you have created an execution plan, then you can view a summary of these plans at the top of this screen. The summary provides information such as the last execution status and the next scheduled execution time.

Project dashboard overview - Execution plans

You can open the respective plan editor by clicking on the name, and the execution page by clicking on the last execution status.

Below the execution plans section, there is a summary of your goals showing various statistics about each goal. You can filter the information presented using the controls on top of the section.

Project dashboard overview - Goals

The top part of the goals has a context menu where you can import a goal, perform batch actions with your goals such as exploring all or selected goals, and sorting all goals using a different criteria.

On the right side, you can switch from Active to Archived to review or restore archived goals, use the date picker to limit the information shown by the charts of each goal card, and search goals by typing part of their name in Search goals.

You can create a new goal by clicking the New goal button, which opens the goal creation page.

# Goal cards

Project dashboard overview - Goal card

Clicking on the goal name on top of the card leads you to the goal view (see Authoring your goal) for that specific goal;

On the top right of the card there is a context menu (look for icon ) and clicking on:

  • Execute launches an execution of all journeys in the goal's latest version;
  • Execute advanced... shows a modal to change some settings of the goal before launching the execution and those settings will be applied only for that specific execution;
  • Explore makes a new exploration from scratch on a new goal version capturing the states as if the goal has just been created;
  • Capture new snapshot shows the same modal as Execute advanced... option with the Capture checkpoint snapshots flag enabled;
  • View goal activity redirects you to the Jobs activity dashboard of the goal applying a filter for this specific goal;
  • Edit settings opens the goal's configuration page;
  • Fork makes a full copy of the existing version into a new goal;
  • Archive sets the goal has archived and hiding it from being listed as an Active goal;
  • Export journeys in Selenium exports the tests from the goal in a Selenium compatible format;
  • Import / Export shows a modal to export the goal in JSON format or to import an existing JSON goal file.

Exploring from scratch

This action removes the existing data of your goal (e.g., manually added test steps) but since Virtuoso has Goal version control lifecycles, if you did an exploration from scratch by mistake, you can rollback the goal to its previous version.

The charts give information about the health of the goal's tests in the currently selected date range presenting an aggregation of the last executions, and the journeys' state as of today. By clicking the individual status items of the charts' legends you'll be taken to the jobs activity dashboard or journeys dashboard, prefiltered for the corresponding goal and clicked status.

At the bottom, you have a summary of the last executed job for that goal. Clicking on the status will open the job page (exploration result or execution report depending on the job type).

# Tags

Tags can help you to categorize your tests and their execution results, and allow you to find specific journeys and jobs quickly using the tag filters.

To access to the project tags page, click on Tabs on the top part of the project dashboard.

Project dashboard tags - Tag manager

At the top of this page, there is a search box to filter tags by name, and on the top right, there is a button to create new tags. Each tag can use a different color, has a unique name and an optional description.

Project dashboard tags - Tag create

To add tags to a journey, visit the goal view page (see Authoring your goal) and use a journey's context menu.

You can also add tags to a job using the job activity dashboard. Expand a job from the list and type the tag you want to add in Add tag. If the tag does not exist, it is created for you.

Alternatively you can add tags to an execution before the job runs by choosing the Execute advanced... option and filling the Add tags with the desired tag names, creating them as project tags if they do not exist already.

# Pinning items

You can pin an item to the sidebar by clicking on the context menu icon of the item and then clicking on Pin <entity name> (e.g., Pin goal).

Pinning a goal

Once you have a pinned item you can click on it to jump directly into that resource. To remove a pinned item, click on the bin icon next to the item. You can also remove all pinned items at once by clicking on Unpin all.

Pinned items

FAQ

  • Pinned items are stored on your browser storage. If you clear the browser storage, your pinned items will be reset;
  • Removing a pinned item from the list does not remove the resource from the platform.

# Tutorials overview

Multiple tutorials are available to assist you with the main tasks that can be performed from Virtuoso's Dashboard. Some depend on previous ones or on specific Core concepts presenting that information at the top. This allows you to skip directly to the task you need assistance with.

WARNING

All tutorials assume that you have an account and reached the main page of the Dashboard. If you have problems reaching the main page consult Getting started or contact support for further assistance.

We suggest that the tutorials are consulted by the following order:

  1. Creating the first goal
  2. Executing tests
  3. Jobs activity dashboard
  4. Journeys dashboard
  5. Understanding the execution report
  6. Exploring a goal further
  7. Adding a checkpoint and test step
Last Updated: 11/19/2021, 12:00:07 PM