Functions

A function is a group of steps saved under one name. Instead of rebuilding the same sign-in or search sequence in every script, you build it once and drop it into as many scripts as you like.

Functions belong to the project, not to the script they were created from, so every script in the project can use them.

Prerequisites

• A test script with at least two steps. See Test Scripts.

Creating a function

1. Open the script that already contains the steps you want to reuse.

2. Click the edit icon at the top right of the panel on the right. This puts the step list into edit mode and adds Start recording steps and Create function to the Actions section.

3. Tick the steps you want in the function. You need at least two — Create function stays greyed out until you have ticked a second one.

   

   Steps selected, with Create function available
4. Click Create function.

5. Give it a Function Name * and a Description *. Tags are optional.

   

   The Create Function dialog
6. Click Create Function.

Name functions for what they do — "Sign in to QBank" tells the next person more than "Function 1".

Using a function in a script

1. On the step where you want the function to run, choose Functions as the action type.

2. Two options appear: Execute Function and Execute Test Case.

   • Execute Function runs the steps in a function you have created.

   • Execute Test Case runs another whole script.

3. Choose Execute Function, type a description for the step, then click Select Function and pick the function you want.

Once selected, the function's steps are shown beneath the step so you can see what will run.

Managing functions

All the project's functions live in one place. Go to Project Setup and open the Functions tab.

The Functions tab in Project Setup

The tab lists Recently added functions and All functions (n), each showing the function name and its step count. Alongside them:

Control	What it does
Import Function	Brings in a function from a file
Export as	Saves a function to XLSX or JSON
View Usage	Shows which scripts use the function
Sort By, Date Filter, Created By	Narrow a long list. Reset clears them

Editing, cloning, exporting and deleting

Click the ⋮ beside a function.

The function menu

Action	What it does
Clone	Duplicates the function
Edit	Changes its name, description and tags
Export As	Saves it as Export XLSX or Export JSON
Delete	Removes it

Edit opens a dialog with the current values filled in. Change what you need and click Update Function.

Editing a function

Before you delete a function, use View Usage to check which scripts depend on it.

Editing the steps inside a function

Click the function's name in the Functions tab to open its step list. Use the edit icon at the top right to change the steps, then Save.

Where to go next

To read about	Go to
Sharing functions between projects as files	Import and Export Scripts
Building the steps themselves	Test Steps