Perforce JViews Gantt Sample: Searching Activities

Description

This sample shows how to search activities displayed in a Gantt chart by applying a regular expression to the activity names.

How to Use the Sample

• On the right side of the chart, in the Search tab you find the Find What 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 find and display the matching activities sequentially. 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.
• Press the Find Next button to find and display the next activity in the data model whose name matches the regular expression. When the search is completed, a dialog box will be displayed and the search will restart from the beginning of the data model.
• Pressing the Enter while the cursor is in the text entry field is equivalent to pressing the Find Next button.
• If the regular expression you have entered is not valid, the text in the Find What text entry turns red and the Find Next button is disabled.

How to Run the Sample as an Application

This sample can be run as an application. The installation directory contains an executable JAR file, search.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

• Using a regular expression to interactively search across the activities displayed in a Gantt chart.

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 Searching Activities sample is installed here.

Classes Involved

• ilog.views.gantt.IlvGanttModel
• ilog.views.gantt.IlvGanttModelUtil
• ilog.views.gantt.action.IlvZoomToFitAction
• ilog.views.util.collections.IlvSelectiveIterator

Source Files

• search.GanttSearchExample

  The main class of the sample. It extends the XMLGanttExample class.

• search.ActivitySearchController

  Implements the state machine for a logical search across the activities in a Gantt data model.