Configurable workspace components examples

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Configurable Workspace Components Examples

    This document provides practical examples for interacting with configurable workspace components in ServiceNow, which allow users to perform various actions on UI elements effectively. Each component has specific actions that can be executed to enhance user experience and facilitate interaction within the workspace.

    Show full answer Show less

    Key Features

    • sn-canvas-toolbar:
      • Assert button exists by group and tool tip
      • Assert button selected by group and tool tip
      • Select button by group and order
      • Select button by group and tool tip

      For this component, specify the group ('top' or 'bottom'), the toolTip (exact tab name), and the order number (starting at 1) to interact with the toolbar tabs.

    • now-uxf-tab-set:
      • Assert tab selected by label
      • Select tab by order
      • Select tab by label

      Actions require the exact tab name for assertions and selections. The order number specifies which tab to open.

    • now-record-list-connected:
      • Apply filter on the list
      • Click a list UI action button
      • Validate record visibility in the list
      • Validate the visibility of list's declarative actions
      • Open a record in the list

      Users can select UI actions, validate record visibility, and open records from the list, with all relevant records displayed for easier interaction.

    Key Outcomes

    By utilizing these components effectively, ServiceNow customers can enhance their workspace interactions, ensuring that they can quickly access and validate necessary elements, leading to improved productivity and user satisfaction.

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

    Note:
    When you submit an action in a component, a test step is created.

    sn-canvas-toolbar

    For sn-canvas-toolbar component, it has the following four actions:
    • Assert button exists by group and tool tip
    • Assert button selected by group and tool tip
    • Select button by group and order
    • Select button by group and tool tip
    These are the expected values for the actions:
    • group: Enter either 'top' or 'bottom' depending on which tab in the toolbar you want to interact with.
    • toolTip: Name of the tab in the toolbar you want to open.

      Screenshot showing tooltip error

      Note:
      An error is shown if the toolTip name doesn't exactly matches the tab name you want to open up.
    • order: Depending on the group entry, the order number is decided. The order starts at 1. For instance, if you've selected 'top' for a group in a toolbar with six items and want to access the second tab from the top, you'd enter '2' as the order number. Similarly you'd enter '5' as the order number if you've selected 'bottom' for a group.

      Screenshot showing order number depending on the group

    Note:
    When you submit an action to select a specific tab (based on its group and order), that tab becomes focused or highlighted. When you enter the exact name of the tab in the toolTip, that tab opens up.

    now-uxf-tab-set

    For now-uxf-tab-set component, it has the following three actions:
    • Assert tab selected by label
    • Select tab by order
    • Select tab by label
    These are the expected values for the actions:
    • label: Enter the exact name of the tab that you want to assert if it exists. For example, after selecting the Assert tab selected by label action, enter 'Hardware assets' to check if the 'Hardware assets' tab is present. The expected return value is True if it exists. If you select Select tab by label action, enter the name of the tab in the toolbar you want to open.
      • Assert tab selected by label

        Screenshot showing Assert tab selected by label action

      • Select tab by label

        Screenshot showing Select tab by label action

    • order: The order number you enter determines which tab opens on the selected toolbar.

      Screenshot showing Select tab by order action

    now-record-list-connected

    For now-record-list-connected component, it has the following five actions:
    • Apply filter on the list
    • Click a list UI action button
    • Validate record visibility in the list
    • Validate the visibility of list's declarative actions
    • Open a record in the list
    These are the expected values for the actions:
    • Select the required UI action.
      Note:
      Only the UI actions which are available in the list shows up.

      Screenshot showing selecting list UI action

    • Select the record from the list you want to validate.
      Note:
      All the records in the list show up when you select the Validate record visibility in the list action.

      Screenshot showing selecting record to validate

    • Select the required UI action to validate its visibility in the list.

      Screenshot showing list UI action validation

    • Select the required record to open from the list.
      Note:
      All the records in the list show up when you select the Open a record in the list action.

      Screenshot showing to select a record to open