Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

List and Related List

Validate the functionality and visibility of records and UI actions in lists and related lists.

Validate the visibility of the selected related lists on a form.

FieldDescription
Execution orderInteger specifying the order in which the test executes this step.As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.
ApplicationApplication scope in which the system runs this step.
ActiveOption to activate this test step for use.
TestName of the test that you're adding the step to.
Step configName of the step.
NotesNotes about the test step.
TableName of the table of the parent form where related list visibility is validated.
VisibleList of related lists to assert as visible.
Not visibleList of related lists to assert as not visible.

Apply Filter to List

Apply a filter to a list to find the required record.

FieldDescription
Execution orderInteger specifying the order in which the test executes this step.As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.
ActiveOption to activate this test step for use.
ApplicationApplication scope in which the system runs this step.
TestName of the test that you're adding the step to.
Step configName of the step.
NotesNotes about the test step.
List typeOption to select the type of list.- List - Related list
Assert TypeSpecifies the assertion on executing the test step:- At least one matching record found: The step succeeds if there is at least one matching record. - No matching record found: The step fails if there is any matching record. - One matching record found: The step succeeds if there is exactly one matching record.
Table

If the List type is List, this field is the table of the opened list.

If the List type is Related list, this field states the name of the table of the parent form where the list belongs.

Related ListThe related list to apply a filter to.Note: This field is available when Related list is selected from List type.
List filterFilter conditions to apply to the list.
FieldDescription
first_recordThe first record found in the list after applying the indicated filter.

Validate Record Present in List

Validate the presence of a record in a list. A valid form must be open and the list containing the record must be visible to proceed.

FieldDescription
Execution orderInteger specifying the order in which the test executes this step.As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.
ApplicationApplication scope in which the system runs this step.
ActiveOption to activate this test step for use.
TestName of the test that you're adding the step to.
TimeoutNumber of seconds allowed before the step fails. If the validation fails, the system repeats the step until it reaches the duration of the timeout. If the validation fails after the timeout duration has passed, the step fails.
Step configName of the step.
NotesNotes about the test step.
List typeOption to select the type of list.- List - Related list
Assert typeSpecifies the assertion on executing the test step:- Record is present in the list - Record is not present in the list
TableName of the parent table where the list belongs.
Related listThe related list which has the record to validate. Note: This field is available when Related list is selected from List type.
RecordThe record whose presence is validated.

Open a Record in List

Open a specific record in a list.

FieldDescription
Execution orderInteger specifying the order in which the test executes this step.As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.
ApplicationApplication scope in which the system runs this step.
ActiveOption to activate this test step for use.
TestName of the test that you're adding the step to.
Step configName of the step.
NotesNotes about the test step.
List typeOption to select the type of list.- List - Related list
TableName of the parent table where the list belongs.
Related ListThe related list which has the record to open.Note: This field is available when Related list is selected from List type.
RecordThe record to be opened.

Validate List UI Action Visibility

Validate that a UI action is visible in a list. If you're impersonating a user, the visibility of a UI action can change depending on the user being impersonated.

FieldDescription
Execution orderInteger specifying the order in which the test executes this step.As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.
ApplicationApplication scope in which the system runs this step.
ActiveOption to activate this test step for use.
TestName of the test that you're adding the step to.
Step configName of the step.
NotesNotes about the test step.
List typeOption to select the type of list.- List - Related list
TableName of the table of the parent form.
Related ListThe related list which has the UI actions. Note: This field is available when Related list is selected from List type.
VisibleList of UI actions to assert as visible.
Not visibleList of UI actions to assert as not visible.

Click a List UI Action

Select a list UI action in a list on a form.

FieldDescription
Execution orderInteger specifying the order in which the test executes this step.As you create steps, the system automatically assigns each step an incremental value. This value causes the test to execute steps in the order that you created them. You can change this default order by editing the Execution order values.
ApplicationApplication scope in which the system runs this step.
ActiveOption to activate this test step for use.
TestName of the test that you're adding the step to.
Step configName of the step.
NotesNotes about the test step.
List typeOption to select the type of list.- List - Related list
TableName of the table where the UI action belongs.
Related listThe related list which has the UI actions.Note: This field is available when Related list is selected from List type.
List actionThe list UI action to be clicked.
Action typeThe type of UI action to be clicked.
Apply toThe record on which the UI action is applied.
Assert typeThe assertion made by the step when executed. - None: Click a UI action and continue without making an assertion. - Page reloaded or redirected: Click a UI action, and assert that the page was reloaded or redirected. This assert type doesn't assert form submission.
RecordThe record to which the UI action is applied. Note: This field appears when you choose Single record in the Apply to field.