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 an IlvBasicFilterGanttModel 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.