02 - Launch a functional journey analysis - Testbench

update 28 aug 2024

User journey

Instead of benchmark test, functional journey tests allow to measure a personalized user journey. For this purpose, it needs a script to describe the actions required to reproduce the journey.

A script language was designed to define the user journey to measure: GDSL for Greenspector Domain-specific language. By convention, files written in GDSL use .testgb extension.

To execute a first measure, we will use an example: sample.testgb. Please download it in your working directory.

############################################################################################ # Getting started with GDSL : a first analysis of www.gouvernement.fr # ############################################################################################ # Preparation # applicationKill,com.android.chrome browserPrepareAndOpenForReference pause,${PAUSEAFTERLOAD} # Blank tab reference # measureStart,PAUSE_referenceBrowser pause,${PAUSEDURATION} measureStop browserGoToUrl,https://www.gouvernement.fr/ # Loading step # assertNotExistsText,accept all measureStart,CHRGT_home pressEnter waitUntilText,accept all pause,${PAUSEAFTERLOAD} measureStop # Pause step # measureStart,PAUSE_home pause,${PAUSEDURATION} measureStop

This script visits the French government website and measures:

  • Reference empty tab

  • Homepage loading

  • Homepage idle

Initialization

The Greenspector CLI allows to launch measures on the Greenspector testbench. CLI means command-line interface: the Greenspector CLI is a command-line tool to be run in a terminal.

  • Windows:

gspt init ^ --greenspectorApi "https://core-saas-prod.greenspector.com/api" \ --privateToken [MYTOKEN]
  • Linux - MacOS:

gspt init \ --greenspectorApi "https://core-saas-prod.greenspector.com/api" \ --privateToken [MYTOKEN]

Regardless of your OS, please replace [MYTOKEN] with a personal token.

It can be found in core-saas-prod.greenspector.com:

  • Click on the account name in the upper right

  • Choose Preferences

Private token in Greenspector Core Saas

Verify Network

To verify that Greenspector testbench is reachable, simply ping it with the following command:

The following message should be received. If not, please contact support.

Application creation

All measurement iterations of Greenspector Studio are stored in core-saas-prod.greenspector.com in an application. We will create one to launch our first test.

  • In Applications menu, choose Add an application

  • Fill Name, Version of app in the pop-up. Description field is optional.

  • After validation, the new app should appear in the applications list:

Project configuration

We will now link Greenspector CLI with our new application:

Please replace [APPNAME] and [VERSION] with the information used in the previous section.

 

Test will be launched on a real device from our testbench. The model which will run the test has to be specified. Type the following command:

Enter the choice number:

For this simple test, simply use the most available device: the number 3 with Samsung - Galaxy S9 with android 10.

Launch measure

The following command will finally launch a first test:

 

Follow test progress

Regarding the testbench availability and iteration number, tests may take time, from 5 minutes to 3 hours. An email is sent as soon as the test finish.

If after 3 hours, you still haven’t received an email or any results, please restart or support contact.