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

Test the database view

Verify that the database view works correctly.

Before you begin

Role required: admin.

About this task

Procedure

  1. Navigate to All > System Definition > Database Views.

  2. Select the database view that you want to test.

  3. Test the view by clicking the Try It related link.

    Note: If you do not see the Try It link, the tables necessary for the view do not exist. If this problem occurs, it is possible that you did not activate the necessary plugins to create the supporting tables.

    The database view runs and a list of items is displayed. If you have specified fields in the View Fields related list for each table, the output is limited to those fields. If you specified view fields and the view does not display correctly, review the View Fields related list for each table and ensure that you include fields from the Where clause.

Output of the sample Incident Metrics database view

Image omitted: database-view-output.png
Output of the sample Incident Metrics database view

What to do next

To use the database view in a data visualization, select it from the data sources. Database views are listed under tables.

Image omitted: db-view-selection.png
The Incident Metric database view selected for a visualization

You can create any visualization type using the database view. This example shows the database view visualized as vertical bar.

Image omitted: db-view-used-in-data-vis.png
The incident metric database view visualized as a vertical bar grouped by escalation

Parent Topic:Joining tables using database views

Previous topic:Configuring the number of records to return

Next topic:Displaying function results in a database view