Progress
AppBuilder
Developer’s Guide
SmartFilters
The query you build into your SmartDataObject might return thousands—or even millions—of records. A return of such size can totally overwhelm users, causing them to fervently wish for a way to further subset the data stream. AppBuilder offers an ADM SmartObject to deal with that problem: SmartFilter.
SmartFilter provides a query-by-form (QBF) interface to the data stream supplied by your SmartDataObject. Using SmartFilter, the user of your application can narrow the query as much as desired, possibly causing the query to return only a few records or even no records at all. Being able to focus the query more tightly can be very convenient for the user.
As seen by the user, SmartFilter is rather simple. Each filterable field is represented by one or two editable fields representing a value and a comparison operator. The user controls the object’s behavior using three buttons:
- Apply Filter — Immediately activates the filter, reducing the size of the data stream. To clear the effect of a filter, the user must choose Blank and then Apply.
- Blank — Clears all editable fields and resets the operators (if visible) to their default states, ready for the next setup.
- Reset — Restores the most recent filter expressions. Does not clear the fields.
![]()
SmartFilter is supplied as a pre-compiled master rather than as a template. To include an instance of SmartFilter in your application, follow these steps:
- Click on the SmartFilter tool icon in the Object Palette:
![]()
- There might be a short pause while AppBuilder creates the instance. Position the cursor over the workspace and click to place the instance.
- If you previously placed a SmartDataObject, AppBuilder now opens an Advisor window offering to create a Filter link to it. Unless you have reason not to do so, accept the offer:
![]()
- Inspect the properties for this SmartFilter and change any that do not meet your needs. See the "Configuring SmartFilter Properties" section in this chapter for information about how to do that.
- When you have finished making changes, choose OK to dismiss the properties dialog box.
- Click the object to select it. Drag the handles to position and size the object to suit your layout. Your SmartFilter is now ready for use.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |