Automated Test Framework \(ATF\) reference › Automated Test Framework \(ATF\) › Testing and debugging applications › Building applications

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

Testable Configurable Workspace components

Learn about the components and its associated actions in the configurable workspace.

For more information, see Testable configurable workspace components.

Accordion item

Actions	Data values and description	Data types
Check if accordion collapsed	Determines if the accordion is currently collapsed	Boolean
Toggle accordion content	Toggles the accordion item's content
Get header text	Expected return value: Returns the header text value in the accordion's item trigger	String
Get caption text	Expected return value: Returns the caption text value in the accordion's item trigger	String

Action bar

Actions	Data values and description	Data types
Click action	Clicks an action	N/A
Has action	Checks if an action exists	Boolean

Activity Stream

Actions	Data values and description	Data types
Select Option In Filter Set Modal Field	Selects the given option in the given field in the filter set modal	N/A
Apply Filter Set With Name	Applies the filter set with the given name	N/A
Get Journal Tile Content	Returns the content of a journal tile at the given indexNote: It can contain either HTML or text.	String
Open Filter Set Edit Modal	Opens the edit filter set modal with the given name	N/A
Open Filter Set Modal	Opens the filter set modal	N/A
Set Filter Set Name	Inputs the given value as the new filter set's name	N/A
Create New Filter Set From Existing Selections	Creates a new filter set from the current filter selections	N/A
Select All Options In Filter Set Modal Field	Selects all options in the given field in the filter set modal	N/A
Clear Option In Filter Set Modal Field	Clears the item at the given index in the given field in the filter set modal	String
Get Journal Tile Field Name	Returns the type of a Journal Tile \(work\_notes or comments\) at the given index	String
Get Activity Tile Type	Returns the type of an activity tile displayed in the activity stream	N/A
Click Save Filter Set Button	Clicks the save button in the filter set modal	N/A
Get Filter Set Name	Inputs the given value as the new filter set's name	String
Open Filters	Opens the filter section	N/A
Can Find Filter Set With Name	Expected return- True: Returns True if a filter set with the given name exists - False: Returns False if a filter set with the given name doesn't exists	Boolean
Clear All Options In Filter Set Modal Field	Clears all options in the given field in the filter set modal	N/A

Activity Stream Compose

Actions	Data values and description	Data types
Select Field	Selects a compose journal field tab or dropdown menu	Boolean
Is Journal Popped Out	Tests if the journal field composition for the given field name is shown as being edited outside of compose	N/A
Is Stacked View Enabled	Tests if Stacked View is enabled	Boolean
Is Stacked View Available	Tests if Stacked View is available	Boolean
Is Email Popped Out	Tests if the email composition is shown as if being edited outside of compose	N/A
Check If Tab Selected	Tests if a compose tab is selected	Boolean
Set Journal Text	Enters text into the editor of the provided field	N/A
Click pop-in button for journal editor	Clicks on the pop in button for journal editor	N/A
Select Tab	Selects a compose journal field tab	Boolean
Click pop-out button for journal editor	Clicks on the pop out button for journal editor	N/A
Click Post Button	Clicks on the editor post button	N/A
Click pop-in button for email editor	Clicks on the pop in button for email editor	N/A
Get Journal Text	Reads the text in the editor of the provided field	String
Is Using Tabs	Tests if the component is using now-tabs to display the fields	N/A
Toggle Stacked View	Clicks the Stacked View Toggle	N/A
Is Field Selected	Tests if a compose field is selected	N/A
Click pop-out button for email editor	Clicks on the pop out button for email editor	N/A

Alert

Actions	Data values and description	Data types
Check if alert collapsed	Checks if the alert is currently collapsed	Boolean
Toggle alert collapse state	Toggles the collapse state of the alert if its collapsible	N/A
Check if alert contains action	Determines if the alert has an action button	Boolean
Check if alert is collapsible	Checks if the alert can be collapsed	Boolean
Click alert button	Clicks the action button for the alert	N/A
Get alert title	Retrieves the title of the alert	String
Check if the alert text is focusable	Checks if the alert text can be focused	Boolean

Avatar

Actions	Data values and description	Data types
Click the avatar	Clicks the avatar.Note: The avatar gets clicked only if the interaction mode is being set to a button or a link.	N/A
Get the initials of the avatar	Returns the text value of the avatar if it has initials.	N/A
Check if the avatar has an image	Returns true if the avatar displays an image.	Boolean
Check if the avatar has initials	Returns true if the avatar returns the user initials.	Boolean
Check if the avatar is anonymous	Checks if the avatar doesn't have an image or the user initials.	Boolean

Badge

Actions	Data values and description	Data types
Get the badge text	Returns the text content of the badge	String

Actions	Data values and description	Data types
Click item	Clicks the matching breadcrumb item	N/A

Button

Actions	Data values and description	Data types
Click	Clicks the button	N/A
Get Text	Expected return value: Retrieves the text of the button	String

Button bare

Actions	Data values and description	Data types
Click	Clicks the button	N/A
Get Text	Expected return value: Retrieves the text of the button	String

Button circular

Actions	Data values and description	Data types
Click	Clicks the button	N/A
Get Text	Expected return value: Retrieves the text of the button	String

Button iconic

Actions	Data values and description	Data types
Click	Clicks the button	N/A
Get Text	Expected return value: Retrieves the text of the button	String

Button stateful

Actions	Data values and description	Data types
Click	Clicks the button	N/A
Get Text	Expected return value: Retrieves the text of the button	String

Card Base Container

Actions	Data values and description	Data types
Click	Clicks the cardNote: This is applicable only for interactive cards.	N/A
is Selected	Expected return- True: Returns True if the card is currently marked as selected - False: Returns False if the card is currently not marked as selected	Boolean

Card Base Header

Actions	Data values and description	Data types
Get Caption Text	Expected return value: Retrieves the text of the card caption	String
Get Heading Level	Expected return value: Retrieves the heading level	String
Get Heading Text	Expected return value: Retrieves the text of the card header	String
Get Tagline Text	Expected return value: Retrieves the text of the card tagline	String

Checkbox

Actions	Data values and description	Data types
Click checkbox	Clicks the checkbox	N/A

Collapse

Actions	Data values and description	Data types
Check if collapse is collapsed	Expected return- True: Returns True if the collapse is currently not expanded - False: Returns False if the collapse is currently expanded	N/A

Color selector

Actions	Data values and description	Data types
Get trigger label	Retrieves the trigger label	String
Open color selector panel	Opens the color selector panel popover	N/A
Check if color selector panel is displayed	Expected return- True: Returns True if the color selector panel is displayed - False: Returns False if the color selector panel is not displayed	Boolean

Actions	Data values and description	Data types
Click popover trigger	Simulates a click on the slotted trigger element for the popover	N/A
Popover panel visibility	Checks if the popover is opened and its panel is visible	Boolean

Date-Time

Actions	Data values and description	Data types
Check if item is disabled	Expected return- True: Returns True if the matching item in the calendar is disabled - False: Returns False if the matching item in the calendar is enabled	Boolean
Set input value	Sets value on native input, includes dispatch of event	N/A
Click Action	Clicks the first matching footer action	N/A
Check if calendar item is focused	Expected return- True: Returns True if the matching item in the calendar is focused - False: Returns False if the matching item in the calendar is not focused	Boolean
Check if calendar panel is displayed	Expected return- True: Returns True if the calendar panel is displayed - False: Returns False if the calendar panel is not displayed	Boolean
Select date item	Selects the matching date item in the calendar	N/A
Click on the input	Clicks on the input of now-date-time and opens the calendar	N/A
Check if item is selected	Expected return- True: Returns True if the matching item in the calendar is selected - False: Returns False if the matching item in the calendar is not selected	Boolean

Date-Time-Interval

Actions	Data values and description	Data types
Set the end input value	Expected return- True: Returns True if the matching item in the calendar is disabled - False: Returns False if the matching item in the calendar is enabled	N/A
Check if calendar panel is displayed	Sets value on native input, includes dispatch of event	Boolean
Check if item is selected	Clicks the first matching footer action	Boolean
Click the start input	Expected return- True: Returns True if the matching item in the calendar is focused - False: Returns False if the matching item in the calendar is not focused	N/A
Check if calendar item is focused	Expected return- True: Returns True if the calendar panel is displayed - False: Returns False if the calendar panel is not displayed	Boolean
Check if preset is selected	Selects the matching date item in the calendar	Boolean
Check if item is disabled	Clicks on the input of now-date-time and opens the calendar	Boolean
Click Action	Expected return- True: Returns True if the matching item in the calendar is selected - False: Returns False if the matching item in the calendar is not selected	N/A
Click the end input	Clicks on the start input of now-date-time and opens the calendar	N/A
Select a preset	Selects the matching preset item from the preset list	N/A
Select a date item	Selects the matching date item in the calendar	N/A
Set the start input value	Sets start value on native input, include dispatch of events	N/A

Actions	Data values and description	Data types
Click trigger	Click the dropdown	N/A
Number of selected items	Returns the number of selected items in the dropdown menu	Numeric
Get text	Retrieves the text content of the dropdown menu	String
Check selection	Returns true of the matching item of the menu is selectedNote: You also need to select a timeframe for the matching item	Boolean
Check panel display	Returns true of the menu is selected	Boolean
Select first matching item	Selects the first matching item in the menuNote: You also need to select a timeframe for the matching item	N/A

Actions	Data values and description	Data types
Check if the flyout menu panel is displayed	Returns true if the flyout menu is opened and the list panel is visible	Boolean
Check selection	Returns true if the matching item of the panel is selected	Boolean
Click flyout menu trigger	Clicks the slotted trigger element for the flyout menu	N/A
Select first matching item	Selects the first matching item found in the panel	N/A
Number of selected items	Returns the number of selected items in the flyout menu panel	Numeric

Heading

Actions	Data values and description	Data types
Get Text	Expected return value: Retrieves the text of the heading	String

Highlighted value

Actions	Data values and description	Data types
Get the highlighted-value text	Expected return value: Retrieves the text of the highlighted value	String

Input

Actions	Data values and description	Data types
Set value	Sets value on native input, includes dispatch of event	String

Input password

Actions	Data values and description	Data types
Set value	Sets value on native input, includes dispatch of event	String

Input phone

Actions	Data values and description	Data types
Set value	Sets value on native input, includes dispatch of event	String

Input URL

Actions	Data values and description	Data types
Set value	Sets value on native input, includes dispatch of event	String

List

Actions	Data values and description	Data types
Apply filter on the list	Applies filter on the list using encoded query	Boolean
Open a record in the list	Opens a record in the list by clicking on first cell link of record row	Boolean
Validate record visibility in the list	Validates if the record with the given sysid is present in the list	Boolean
Click a list UI action button	Clicks the UI action button with the given sysid	Boolean
Validate the visibility of list's declarative actions	Validates the visibility of declarative action buttonFor example, the New button. It is validated based on its sysid.	Boolean

Loader

Actions	Data values and description	Data types
Click the loader action	Clicks the action associated with the loader	N/A
Get the loader text	Returns the text of the loader	String
Check if loader has action	Expected return- True: Returns True if the loader has an action defined - False: Returns False if the loader doesn't have an action defined	Boolean

Loader Custom

Actions	Data values and description	Data types
Get the loader custom text	Returns the text of the loader custom	String

Modeless Dialog

Actions	Data values and description	Data types
Click window action	Clicks the matching window action.Note: The matcher could correspond to the index of the button within the buttons collection.	N/A
Check if dialog is closed	Expected return- True: Returns True if the dialog is opened - False: Returns False if the dialog is not opened	Boolean
Get the now-modeless-dialog text	Returns the text of the now-modeless dialog	String

now-alert-list

Actions	Data values and description	Data types
Toggle alert list collapsed state	Checks if the alert is currently collapsed	N/A
Check if alert list can collapse	Toggles the collapse state of the alert if its collapsible	Boolean
Dismiss alerts	Determines if the alert has an action button	N/A
Check if alert list collapsed	Checks if the alert can be collapsed	Boolean

now-card-footer

Actions	Data values and description	Data types
Get Footer End Text	Returns the text of the card footer's right sideNote: This is the end part of the footer text	String
Get Footer Text	Returns the text of the card footer	String
Get Footer Start Text	Returns the text of the card footer's left sideNote: This is the start part of the footer text	String

now-collapse-trigger

Actions	Data values and description	Data types
Finish collapse transition	Allows now-collapse to finish transitioning	N/A

now-color-selector-panel

Actions	Data values and description	Data types
Get color name	Returns the name of the color	String
Select color swatch by id	Selects the color swatch from color groups by the color id	N/A
Set hex value	Sets the hex value.Note: The valid value is either 3 or 6 hexadecimal characters without #.	N/A
Set color name	Sets the name of the color in the color name edit input field	N/A
Set slider value	Sets the value of hue slider	N/A
Click action	Clicks the first matching footer action	N/A
Set rgb value	Sets the rgb value	N/A
Set hsl value	Sets the hsl value	N/A

now-date-time-calendar

Actions	Data values and description	Data types
Check if item is disabled	Expected return- True: Returns True if the matching item in the calendar is disabled - False: Returns False if the matching item in the calendar is enabled	Boolean
Check if item is focused	Expected return- True: Returns True if the matching item in the calendar is focused - False: Returns False if the matching item in the calendar is not focused	Boolean
Get active month	Returns a numeric value of the currently selected month	Numeric
Check if item is selected	Expected return- True: Returns True if the matching item in the calendar is selected - False: Returns False if the matching item in the calendar is not selected	Boolean
Get active year	Returns a numeric value of the currently selected year	Numeric
Select date item	Selects the matching date item in the calendar	N/A

Actions	Data values and description	Data types
Check panel display	Expected return- True: Returns True if the panel is displayed - False: Returns False if the if the panel is not displayed	Boolean
Select first matching item	Selects the first matching item found in the panel	N/A
Check selection	Expected return- True: Returns True if the matching item in the panel is selected - False: Returns False if the matching item in the panel is not selected	Boolean
Number of selected items	Returns the number of selected items in the dropdown panel	Numeric

Actions	Data values and description	Data types
Check if item is selected	Checks if the item is selected in the panel	Boolean
Get selected items count	Retrieves the number of items currently selected within the dropdown panel	Numeric
Check panel display	Expected return- True: Returns True if the panel is displayed - False: Returns False if the panel is not displayed	Boolean
Get panel item count	Returns the number of items in the dropdown panel	Numeric
Select first matching item	Selects the first matching item in the panel	N/A

Actions	Data values and description	Data types
Get number of selected items	Returns the number of selected items in the flyout-menu panel	Numeric
Get number of items	Returns the number of items in the flyout-menu panel	Numeric
Check if the flyout menu panel is displayed	Expected return- True: Returns True if the panel is displayed - False: Returns False if the panel is not displayed	Boolean
Select item	Selects the first matching item in the panel	N/A
Check if item is selected	Expected return- True: Returns True if the matching item in the panel is selected - False: Returns False if the matching item in the panel is not selected	Boolean

now-input-date-time

Actions	Data values and description	Data types
Set input value	Sets value on native input, includes dispatch of event	N/A

Actions	Data values and description	Data types
Is Displayed	Expected return- True: Returns True if the modal is currently displayed - False: Returns False if the modal is currently not displayed	Boolean
Get Content	Returns the text of the modal	N/A
Has Footer	Expected return- True: Returns True if the modal contains a footer - False: Returns False if the modal doesn't contain a footer	Boolean
Dismiss	Clicks the dismiss action of the modal	N/A
Get Heading	Returns the heading value of the modal	String
Click Action	Clicks the first matching footer action	N/A

now-record-list-connected

Actions	Data values and description	Data types
Apply filter on the list	Applies the filter in the form of encodedQuery	N/A
Click a list UI action button	Selects a UI action button in the list	N/A
Validate record visibility in the list	Validates if the selected record is visible in the list	Boolean
Validate the visibility of list's declarative actions	Validates if the list's declarative action is visible or not	Boolean
Open a record in the list	Opens the selected record from the list	N/A

now-tabs

Actions	Data values and description	Data types
Select tab by matcher	Selects a tab based on the provided criteriaNote: It also allows substring matching	N/A
Check if matching tab is selected	Checks if the tab matching the provided criteria is currently selected	Boolean

now-tabs-vertical

Actions	Data values and description	Data types
Check if matching tab is selected	Checks if the tab matching the provided criteria is currently selected	N/A
Select tab by matcher	Selects a tab based on the provided criteriaNote: It also allows substring matching	Boolean

now-uxf-tab-set

Actions	Data values and description	Data types
Assert tab selected by label	Returns true if the tab with the given label is present. An error is shown if the tab is not found.Note: You must enter the exact name in the label to check if it exists.	Boolean
Select tab by order	Selects a tab by its order in the tab set. The order starts from 1.Note: You must enter the required order of the tab you want to be selected.	N/A
Select tab by label	Selects a tab by its label.Note: You must enter the required label of the tab you want to be selected.	N/A

pagination-control

Actions	Data values and description	Data types
Get page label	Returns page label	String
Check if page selected	Checks if the page matching the provided criteria is currently selected	Boolean
Select page size	Selects a page size from the dropdown control	N/A
Click go-to-next-page button	Simulates a click on the go-to-next-page button	N/A
Set input value	Sets value on input field and dispatches associated events	N/A
Click go-to-last-page button	Simulates a click on the go-to-last-page button	N/A
Click go-to-previous-page button	Simulates a click on the go-to-previous-page button	N/A
Click go-to-first-page button	Simulates a click on the go-to-first-page button	N/A

pill

Actions	Data values and description	Data types
Get the pill text	Returns the text content of the pill	String
Dismiss pill	Clicks the dismiss button of the pill	N/A
Check if pill is dismissible	Expected return- True: Returns True if the pill is dismissible - False: Returns False if the pill is not dismissible	Boolean
Click pill	Clicks the pill	N/A

Radio buttons

Actions	Data values and description	Data types
Select a radio button	Clicks the matching radio button, toggling its selected state	N/A

Select

Actions	Data values and description	Data types
Click trigger element	Simulates a click on the trigger element	N/A
Check if dropdown displayed	Determines if the dropdown list is currently visible on the screen	Boolean
Select matching item	Selects the matching item in the dropdown list	N/A

sn-canvas-tabs

Actions	Data values and description	Data types
Assert tab with label exist	Returns true if the tab with the required label exist	Boolean
Assert tab with label is selected	Returns true if the tab with the required label is selected	Boolean
Close tab by order	Closes the tab by its order in the tab set. The order starts from 1.Note: You must enter the required order of the tab you want to be closed.	N/A
Close tab with label	Closes the tab by its label in the tab set.Note: You must enter the required label of the tab you want to be closed.	N/A
Select tab by order	Selects a tab by its order in the tab set. The order starts from 1.Note: You must enter the required order of the tab you want to be selected.	N/A
Select tab with label	Selects a tab by its label.Note: You must enter the required label of the tab you want to be selected.	N/A

Actions	Data values and description	Data types
Assert button exists by group and tool tip	Verifies that a button with the given tooltip is present within the group.- group: top or bottom - toolTip: - Expected return - True: Returns True if a button with the given tooltip is present within the group - False: Returns False if a button with the given tooltip is not present within the group	Boolean
Assert button selected by group and tool tip	Selects a button with the given tooltip within the group.	Boolean
Select button by group and order	Selects a button within the toolbar group by its ordering. The order starts from 1. Groups can either be top or bottom.	N/A
Select button by group and tool tip	Selects a button within the toolbar group by its toolTip values. The order starts from 1. ToolTip value	N/A

Split button

Actions	Data values and description	Data types
Is Panel Displayed	Expected return- True: Returns True if the panel is displayed - False: Returns False if the panel is not displayed	Boolean
Is Item Selected	Returns true if the panel's matching item is selectedExpected return- True: Returns True if the matching item in the panel is selected - False: Returns False if the matching item in the panel is not selected	Boolean
Click	Clicks the primary action of the split-button	N/A
Get button text	Returns the text content of the split-button	String
Click Trigger	Clicks the split-button's dropdown trigger	N/A
Select Item	Selects the first matching item found in the panel	N/A
Count Selected Items	Returns the number of selected items in the dropdown panel of the split-button	Numeric

Stepper

Actions	Data values and description	Data types
Is Step Selected	Expected return- True: Returns True if the step is currently selected - False: Returns False if the step is currently not selected	Boolean
Click next page button	Clicks the next page button	N/A
Click previous page button	Clicks the previous page button	N/A
Select a step	Selects a step	N/A

Tabs

Actions	Data values and description	Data types
Select tab by order	Selects a tab by its order in the tab setNote: The order starts at 1.	Boolean
Select tab by label	Selects a tab by its labelNote: An error is shown if the tab is not found.	N/A
Assert tab selected by label	Asserts that a tab with the given label is selected.Note: An error is shown if the tab is not found.	N/A

Test link

Actions	Data values and description	Data types
Get text	Returns the text of the text-link	String
Click	Clicks the link	N/A

Text area

Actions	Data values and description	Data types
Set textarea value	Sets value on native textarea, includes dispatch of events	N/A

Toggle

Actions	Data values and description	Data types
Click trigger element	Simulates a click on the trigger element	N/A

Typeahead

Actions	Data values and description	Data types
Set input value	Sets value on typeahead input and dispatches associated events	N/A
Select item	Selects one of the items of the typeahead	N/A
Click the input	Clicks on the input of the typeahead	N/A
Check if panel is displayed	Expected return- True: Returns True if the panel is opened and visible - False: Returns False if the panel is not opened and visible	Boolean

Typeahead multi

Actions	Data values and description	Data types
Select item	Selects one of the items of the typeahead	N/A
Click the input	Clicks on the input of the typeahead	N/A
Check if panel is displayed	Expected return- True: Returns True if the panel is opened and visible - False: Returns False if the panel is not opened and visible	Boolean
Set input value	Sets value on typeahead input and dispatches associated events	N/A

Configurable workspace components examples
To grasp how to interact with configurable workspace components, review these examples.

Parent Topic:Automated Test Framework (ATF) reference