Description Eugene Chan 2004-07-05 13:50:25 EDT

prefix        d
name          rrunner 9604
reference     aix192599
abstract      F: Filtering Capability in views

    <Note by who (Wayne Ho), 2001/12/18 19:47:52, seq: 1 rel: 0  action: open>
Description:
Provide a consistent interface mechanism to provide filtering
capabilities within each view.

Resolution:
Each view should have a consistent method of accessing filtering
functionality.  It will be important to follow emerging Eclipse
UI Guidelines.  The likely path to follow will be a local
toolbar button on a view for filtering (or via the Views drop-down menu).  
When clicking on this Filter button, a Filter dialog will appear 
providing a number of options.  The dialog allows a number of 
filtering options.

We will need to consider the specific filters for each view
and this dialog may vary slightly from view to view.

    <Note by rduggan (Richard R.K. Duggan), 2001/12/20 18:20:36, seq: 2 rel: 0  
action: return>
Wayne,  we already have a working prototype of a 
UI filtering mechanism that is scheduled to go
in V5.  If you would like to see it please 
contact me.

    <Note by who (Wayne Ho), 2002/02/14 15:00:29, seq: 3 rel: 0  action: reopen>
I am reopening this Feature after having a number of design
discussions with Mike.  

A design document is available in the Problem Determination
UCD Database

Title: Filtering Designs
Server: D25DB01/25/A/IBM
Filename: function\ucd\problemDet.nsf

(on the Navigator click on the "General" tab and then look
in the "Library" under Design Documents"

Design Summary (note: see the Notes database for most recent design):
The basic premise of the design allows the user to
access filtering functionality via a Filter local toolbar
button in a view.  The filter button will also have an associated
drop-down menu allowing users to:

Edit the filter (opens an Edit Filter Dialog)
Quickly select the Current Filter Set (using a cascade menu to select)
Delete a Filter Set

The Edit Filter Dialog will allow users to pre-emptively
filter out items/objects such as classes, methods, and threads.

Filtering can also be done "directly" in the view, via selecting
and object in the view and using the context-menu to filter.  This
will automatically open the Edit Filter dialog and automatically
add the item into the filter.

    <Note by who (Wayne Ho), 2002/11/19 18:28:14, seq: 11 rel: 0  action: note>
Description:
* Allow users to filter information within the views 
* These are UI view filters (not to be confused with the collection filters)
* This allows users to drill-down in a view and find the problem
* It should be easy to quickly set filters and also clear filters to see all
  data in the model

Resolution:
A filter button should be made available in the toolbar for each view
that can be used as a "Filter Access Point".  Ideally, the toolbar
button would have a drop-down menu.

Single clicking on the toolbar button can open an Edit Filter dialog.
Single clicking on the drop-down will display the UI Filtering drop-down menu.

The drop-down menu can provide access to:
  Edit Filters...
  Select Filter Set -> [List of filter sets]

The Edit Filters dialog could use the same design as the collection filters
allowing users to create and remove filter sets, and to modify the current
filter set.

* It is important to ensure the designs easily distinguish between
  UI filters and collection filters
* Appropriate feedback is necessary to indicate UI filtering is enabled
  on a view (e.g., modifying the view's title).  "Heap (Filter: myFilterSet)"

Additional discussion is required to finalize the design.