Skip to main content
Matrix42 Self-Service Help Center

Data Query Primary Filter Configuration Example


This page shows how the Primary Filter property configuration in the Data Query filters the data displayed in the application to the end users.  

No Primary Filter applied

Data Query pre-requisites

  • Audience: unrestricted
  • Primary Filter: not set 
  • Default: not selected
  • Priority: not set


  1. Open Administration application.
  2. In the User Interface → Layouts → Dataset Views, create a new Dataset View called "System users".
  3. Set as Data Source the Data Query, e.g. the default provided in the system SPSUserClassBase_Portal. Note, that the Primary Filter for this Data Query is not configured, i.e. empty.
  4. Set Configuration Item to Person (SPSUserType):
  5. Click Done.
  6. Close the layout in the just-opened Layout Designer.
  7. Create a new Navigation Item that opens the just created Dataset View called "System users".
  8. In Action on Click section, choose Open Dataset View and select the created Dataset View.
  9. In the Item Type, define where the Navigation Item should be displayed: choose the necessary Child or Root Element:
  10. Click Done.


Open the configured "System users" Navigation Item in the application.

The displayed Dataset View data is shown according to the columns that were configured in the selected Data Query, for instance:

  • Data Query columns configuration in the Administration application:
    Screenshot 2023-07-24 at 18.17.17.png
    Primary Filter is not set therefore no additional constraints are applied to the displayed data.  
  • Displayed data in the configured "System users"Navigation Item might look as follows:
    The opened Dataset View displays all currently available Persons in the system.

Primary Filter applied


  1. Open Administration application
  2. Edit the SPSUserClassBase_Portal Data Query 
  3. Set Primary Filter to show only users with the last name SYSTEM, for instance:
    Screenshot 2023-07-24 at 18.02.24.png
  4. Click Done to apply changes.

This change is applied to all Dataset Views based on the modified Data Query.


Open the "System users" Navigation Item in the application.

The displayed data is restricted due to the applied Primary Filter:


Only one Person's last name is SYSTEM, therefore all the other users are not displayed on this Dataset View. 

  • Was this article helpful?