Commands

Commands are the building blocks of a test step. This section documents every command, what it does and the parameters it accepts.

The groups below match the ones in the Add step panel, so what you see in the product is what you look up here.

Not sure which one you need?

What you want to do	Command
Put a value in a field	Fill, or Type if the field reacts as you type
Check the process worked	Verify Field
Handle a step that only happens sometimes	A verify step with a conditional
Repeat steps for every row of a spreadsheet	Loop
Carry a value from one step to another	Set variable
Deal with a popup	Click for an in-app dialog, Accept Dialog for a browser alert
Wait for something slow	Raise the timeout on the next command rather than adding a Wait

Mouse

Command	Purpose
Click	Click a field or button
Right Click	Right-click to open a context menu
Mouse Hover	Hover a field to reveal what shows on hover
Move Mouse	Move the pointer to exact coordinates
Scroll Page	Scroll the page vertically or horizontally
Drag and Drop	Drag an element onto another

Keyboard

Command	Purpose
Press Key	Press a key or shortcut, such as Enter or Control+A

Entering data

Command	Purpose
Fill	Paste a value straight into a field
Type	Type a value one character at a time
Select Options	Choose one or more options from a dropdown

Files

Command	Purpose
Upload File	Upload a file held in a variable
Catch Downloaded File	Save a file the test downloads to a variable

Verification

Command	Purpose
Verify Field	Check a field is available, then check its value
Verify Variable	Check the value a variable is holding

Variables

Command	Purpose
Set variable	Save a value from the page to a variable
Modify variable	Transform a variable, such as trim, slice or increment
Extract Value	Read one value out of JSON, XML, Excel or CSV
Update Value	Write one value into JSON, XML, Excel or CSV

Navigation & waiting

Command	Purpose
Navigate	Go to a URL
Navigate (Advanced)	Go to a URL that needs NTLM sign-in or a longer wait
Set URL Query Param	Change one parameter in the current URL
Refresh Page	Reload the current page
Wait	Pause for a fixed number of milliseconds

Window control

Command	Purpose
Maximise Window	Maximise the window in focus
Zoom Window	Zoom the window to a percentage

Tabs

Command	Purpose
Close Tab	Close the active tab and fall back to the previous one
Detect New Window/Tab	Follow the test's focus onto a page that just opened
Switch Tab	Focus a specific window or tab
Close Page	Close a specific window or tab by identifier

Login

Command	Purpose
Microsoft Login	Sign in with a Microsoft account
Microsoft Login With MFA	Sign in with a Microsoft account and pass MFA
Get MFA Code	Put a test user's current MFA code into a field

AI

Command	Purpose
Ask AI	Ask a question and save the answer to a variable
Verify using AI	Judge a screenshot against a plain-English expectation
AI Actions	Hand the browser to the AI to complete a described task
Click (Using Computer Vision)	Find and click a field using a reference image

Check what the AI did

AI steps can behave differently from one run to the next. Follow one with a verification, so a wrong result fails the test rather than passing quietly.

Application-specific

Available only when the test's application is that product.

Command	Application	Purpose
Change Company	Finance & Operations	Switch to another legal entity by company code
Column Filter	Finance & Operations	Filter a grid column
Expand or Collapse Section	Finance & Operations	Open or close one section, or every section on the page
Toggle Checkbox	Finance & Operations	Set a checkbox or radio to the state you want
Toggle Checkbox	Business Central	Set a checkbox or radio to the state you want
Expand Section	Business Central	Open a collapsed section
Collapse Section	Business Central	Close an expanded section
Verify Checkbox	Business Central	Check whether a checkbox is enabled or disabled
Change View	Project Operations	Switch the view dropdown at the top left of the page

Everything else

Command	Purpose
Loop	Repeat steps over fields, a range, or spreadsheet rows
API Request	Call an endpoint and save the response
Accept Dialog	Answer OK to native browser alerts from here on
Dismiss Dialog	Answer Cancel to native browser alerts from here on
Comment	Add a note to the test and its reports
Take a Screenshot	Capture a full-screen image into the results
Pass	End the test early and mark it passed
Fail	End the test with a custom error

Common advanced options

Several commands share the same set of Advanced options. Rather than repeat them on every command, they're documented once here.

Click position

Overrides the default (centre) position of the click on the element. Position 0, 0 points to the top left corner of the element, not the page. Removing these values defaults the test back to a centre click.

Click count

Used when you want to click more than once. For example, 2 results in a double click.

Force

Sometimes required to override an event that is blocking the click.

Timeout

The maximum time the test will wait for the field to be visible before failing the test.

Which commands have these?

Click position, click count and force apply to the click-style commands: Click, Right Click, Select Options, Click (Using Computer Vision) and Column Filter. Timeout applies more broadly, including Fill, Type and Verify Field.