To filter data on your page, you can use the search bar functionality, or you can add an XPath constraint to your data grid. The search bar contains search fields that allow the end-user to quickly find the information he or she needs. XPath is a hard-coded constraint on your data grid that filters the data.
This how-to will start with preparing a data structure and some example data. After this setup, you will filter your data with a search bar. Then you will filter your data using different XPath constraints.
This how-to serves as a comparison for filtering data and emphasizes how to use XPath for the filtering.
This how-to will teach you how to do the following:
- Prepare the data structure
- Prepare the GUI
- Prepare the data
- Filter a list using the search bar
- Filter a list using XPath
2 Prerequisites - Preparing the Data Structure, GUI, and Example Data
To see the results of this how-to, it is necessary that you set up a test app with test data.
Before you continue, make sure that you know how to create the following:
- Domain models (for more information, see How to Create a Basic Data Layer)
- Overview and detail pages (for more information, see How to Create Your First Two Overview & Detail Pages)
- Menu items (for more information, see How to Set Up the Navigation Structure)
Create the following domain model:
Create overview and detail pages to manage objects of type Customer and Order.
Create menu items to access the Order and the Customer overview pages.
Add the following customer data to your app:
Add the following order data to your app:
4 Filtering a List of Orders Using the Search Bar
In the previous section you set up a basic data structure and created some sample data. In this section you will add search fields to the search bar to allow the user to filter data on your overview page. In the examples you will filter on the order status and on a minimum price.
Open your orders overview and right click the (empty) section above the Search button.The search bar section might be already populated if you automatically filled the contents of your data grid.
Right click the search bar section and select Add search field > Drop-down.
Add the OrderStatus attribute to the search field and define the name.
Redeploy your application and click the Search button on your orders overview. The new search field appears.
Use the Order status search field to filter your list on a specific order status and click the ‘Search’ button on the right side.
To filter on a minimum price, add another search field by selecting Add search field > Comparison.
Select the TotalPrice attribute, name the search field Minimum total price and change the Comparison from Contains to Greater or equal.
Redeploy your application and enter 50 in your newly added search field. Your list will be filtered to only show orders with a minimum value of 50.
5 Filtering a List of Orders with the “Open” Status Using XPath
In the previous section you used the search bar to filter data on your overview page. Now you will add an XPath constraint on the Orders data grid. With an XPath constraint on a data grid you can (hard coded) filter the objects shown in the list. Mendix XPath is one of the Mendix query languages designed to retrieve data. XPath uses path expressions to select data of Mendix objects and their attributes or associations. To learn more about XPath, see XPath Constraints. In this section you will constrain the data grid so it will only display orders with status ‘Open’.
Select the Order data grid and in the Properties pane on the right, change Data source > Type to XPath, and then click the XPath Constraint field:
Enter the following expression in the XPath Constraint editor:
[OrderStatus = ‘Open’]. The data grid will now only show orders with status ‘Open’.
Run your application to see the following result set:
6 Filtering a List of Orders on the Minimum Total Price Using XPath
In the previous section you have constraint the data grid on status ‘Open’. In this section we will change the constraint to ensure that the data grid will only show orders with a minimum value of 50.00.
Select the Order data grid and in the Properties pane on the right, click the XPath Constraint field and enter the following expression:
[TotalPrice >= 50].
If you run your application you will see the following result set.
7 Combining Constraints Using XPath
In the previous two sections you used single constraints to filter the data grid on status and minimum total price. In this section you will combine those two constraints. Combination can be made with logical operator AND and OR.
To constrain the results in the order overview to only the Open orders or orders with a minimum price of 50.00, you have to insert an
orstatement in the XPath constraint:
[OrderStatus = 'Open'] or [TotalPrice >= 50].
Run your application to see all the orders with the order status ‘Open’ or with a total price higher or equal to 50.
To constrain the results in the order overview to only the Open orders and orders with a minimum price of 50.00, you have to insert an
andstatement in the XPath constraint:
[OrderStatus = 'Open'] and [TotalPrice >= 50].
Run your application to see orders which are ‘Open’ and have a minimum total price of 50.
8 Filtering the Order List with Attributes of Associated Customers Using XPath
In the previous section you have constrained the data grid on attributes of the same entity as the data grid entity. In this section you will constrain on attributes over an associated object. In the example of this section you will filter the orders by their associated customers based on the city letter of the customer.
To constrain the results in the order overview to only orders from customers in Rotterdam, enter the following XPath into the XPath Contraint editor:
[Sales.Order_Customer/Sales.Customer/City = 'Rotterdam'].
Run your application to only see the orders of customers in Rotterdam.