Configurable workspace components examples

  • Release version: Zurich
  • Updated July 31, 2025
  • 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 to help ServiceNow customers understand how to interact with configurable workspace components. These examples focus on key components such assn-canvas-toolbar,now-uxf-tab-set, andnow-record-list-connected, detailing their available actions and expected input values. Understanding these enables users to automate interactions, validate UI elements, and manage records effectively within their workspace.

    Show full answer Show less

    sn-canvas-toolbar

    This component allows interaction with toolbar tabs through four main actions:

    • Assert button exists (by group and tooltip)
    • Assert button selected (by group and tooltip)
    • Select button (by group and order)
    • Select button (by group and tooltip)

    Key parameters:

    • group: Specify 'top' or 'bottom' to target tabs in respective toolbar sections.
    • toolTip: Exact tab name to open or assert; must match precisely to avoid errors.
    • order: Numerical position of the tab within the group, starting at 1.

    Behavior: Selecting a tab by group and order highlights it, while selecting by tooltip name opens that tab.

    now-uxf-tab-set

    This component manages tab selections with three actions:

    • Assert tab selected (by label)
    • Select tab (by order)
    • Select tab (by label)

    Key parameters:

    • label: Exact name of the tab for assertion or selection (e.g., 'Hardware assets').
    • order: Numerical index of the tab to open.

    Outcome: Assertions return True if the specified tab exists or is selected, enabling automated validation of tab presence and focus.

    now-record-list-connected

    This component supports interaction with record lists through five actions:

    • Apply filter on the list
    • Click a list UI action button
    • Validate record visibility in the list
    • Validate visibility of list’s declarative actions
    • Open a record in the list

    Key considerations:

    • Only UI actions currently available in the list appear for selection.
    • All records are accessible when validating visibility or opening a record.

    Benefit: These actions enable precise control and verification of records and UI actions within lists, facilitating robust automated testing and interaction workflows.

    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