Create list categories in App Engine Studio (AES) to add pages that list table records. You can add filter conditions and change columns to create variations on the list.

Before you begin

Role required: sn_app_eng_studio.user or delegated_developer. For more information, see Delegate developers using AES.

About this task

Note:

  • You can launch and view workspaces in the Workspace Builder. However, you can only edit workspaces created through ServiceNow Studio and App Engine Studio within those specific tools.

  • If you remove the list page/route, you must use UI Builder to edit the workspace, not Workspace Builder.

Procedure

  1. Navigate to All > App Engine > App Engine Studio.
  2. From the My Apps page, open your application.
  3. Next to the workspace you created, select the additional actions icon (Additional actions icon) and then select Edit.

    You can also select the bar that lists the workspace in the Experience section of your app.

    Figure 1. Edit a workspace
    Select to edit a workspace
    The workspace appears in Workspace Builder.
  4. If they aren't already activated, activate lists to enable them for the workspace.
    You must be in the Navigation configuration tab of Workspace Builder. If you're already in the Navigation configuration tab, you can't select it.
    1. In the navigation panel, select List.
    2. In the configuration panel, select the Activate list option.

    Workspace list view with lists activated

  5. Add a list category.
    1. In the List section navigation panel, select Add list category.
      If the table associated with the workspace isn't a core table, you must add new list categories.
    2. On the form, fill in the fields.
      Table 1. List category settings
      Field Definition
      Name Name to identify the list category.
      Description Brief description of the contents of the list category to help developers understand the purpose.
      Note: Workspace users don't see the description.
    3. Select Add.
  6. (Optional) To rearrange the order list categories appear, drag them to a new position.
  7. Add a filtered list to a list category.
    For example, in the list category for the Task table, you could create separate filtered lists for Opened, Unassigned, and Closed tasks.
    1. In the navigation panel, expand the list category you want to create a filtered list for.
    2. Select Add filtered list.
    3. On the form, fill in the fields.
      Table 2. Filtered list settings
      Field Definition
      Name Name to identify the filtered list.
      Table Table that contains the subset of records that appear in the filtered list.You can select from two sections: Tables that are already available in your app, and all tables outside the app scope.
    4. Select Add.
    The preview canvas displays the contents of the filtered list.
  8. Refine how the filtered list displays its content by adding filter conditions to narrow what it displays.
    You can make additional configurations to the filtered list.
    1. In the navigation panel, select the filtered list you want to change.
    2. In the configuration panel, specify the additional settings.
      Table 3. More filtered list settings
      Field Definition
      Activate list Option to enable users to work with the filtered list.
      Manage columns Option to select and arrange the columns that appear.

      In the Manage columns dialog box, move columns from Available columns to Selected columns, drag to rearrange the columns, and select Apply.

      You can select a field on a related table by dot-walking to it. For more information, see Dot-walking to data in related tables.
      Add filter condition Option to add a filter condition to the list. In the dialog box that appears, you can do the following:
      • To apply a predefined filter, select Use existing filter and search for the filter.
      • To view existing conditions, expand the Filter overview section.
      • To create a filter condition, use the condition builder. For more information on building conditions, see Condition builder.
      • To change the sort order of the filtered results, expand the Sort by section and make changes.
      • To save the filter condition that you created for reuse, select Save filter.

      When you're done creating the filter condition, select Apply filter.

      For more information on working with filters for lists, see Filters.
    3. In the configuration panel, select Save.
  9. Complete any additional actions on the list.
    OptionDescription
    Edit a list category
    1. In the navigation panel, select the list category.
    2. In the configuration panel, specify its List category settings.
    3. Select Save.
    Change how the filtered list appears by selecting the list in the navigation panel
    1. In the configuration panel, select Manage columns.
    2. In the form that appears, move columns from Available columns to Selected columns, drag to rearrange the columns, and select OK.
    3. Refresh the canvas preview by selecting the refresh icon (Refresh icon on preview canvas) in the canvas header.
    Delete a list category
    1. In the navigation panel, select the list category.
    2. In the configuration panel, select Delete list category.
    3. In the confirmation dialog, select Delete.
    Delete a filtered list
    1. In the navigation panel, select the filtered list.
    2. In the configuration panel, select Delete filtered list.
    3. In the confirmation dialog, select Delete.