Perforce JViews Gantt Sample: Filtering Activities
Description
This sample illustrates how to create a Gantt data model that filters activities using a regular expression.
How to Use the Sample
-
On the right side of the chart, in the Filter tab you find the
Activity Name Filter text entry field. You can enter a regular
expression in the text field.
The expression is matched against the names of the activities in the
data model, and used to filter the activities displayed. The default
regular expression is
.*
, which matches all names. Examples of regular expressions are:-
[A-G].*
: matches any activity whose name begins with the letters A to G. -
.*i[rl].*
: matches any activity whose name contains the letter i, immediately followed by the letters r or l.
-
- If the regular expression you have entered is not valid, the text in the Activity Name Filter text entry turns red.
- When a child activity is matched against the regular expression, all of its parent activities are also displayed. This ensures the position of the child activity in the hierarchy is preserved. In this case the parent activities displayed do not necessarily match the regular expression.
-
For information about other actions possible with this sample,
refer to the
Gantt Chart
sample.
How to Run the Sample as an Application
This sample can
be run as an application.
The installation directory contains
an executable JAR file,
filter.jar
,
that allows you to execute the sample with a double click from a
file browser. Note that if you are using Internet Explorer, you can
open the installation directory
and execute the JAR file from the browser. This
technique may not work in other Web browsers.
Alternatively, you
can run the sample application from the command line.
First check that the Ant utility is properly configured. If not, see the
instructions on how to configure Ant for Perforce JViews.
Then, go to the installation directory
of the sample and type:
ant run
Topics Covered
-
Creating an
IlvFilter
implementation and using it with anIlvBasicFilterGanttModel
to filter activities.
Detailed Description
After launching this sample, you can enter different regular expressions that are matched against the names of the activities in the data model.
Installation Directory
The Filtering Activities sample is installed here.
Classes Involved
- ilog.views.gantt.model.filter.IlvFilterGanttModel
- ilog.views.gantt.model.filter.IlvBasicFilterGanttModel
- ilog.views.util.filter.IlvFilter
- ilog.views.util.filter.IlvAbstractFilter
Source Files
-
filter.GanttFilterExample
The main class of the sample. It extends the XMLGanttExample class.
-
filter.ActivityNameFilter
A filter implementation that matches regular expressions against activity names.