Populating the Report Builder tree pane

The Report Builder window contains the following panes:

  • The tree pane (left).
  • The reports pane (top-right).
  • The parameter pane (bottom-right).

When the user clicks any folder in the tree pane, the Report Builder runs the associated report procedures from the command line. The -i option in the command line enables the Report Builder to use a discovery algorithm to collect the user interface information for Report Builder.

The Report Builder accesses the \scripts subdirectory. Directories in the tree appear as folders in the tree pane. Any files whose extensions match those listed below are listed in the reports pane.

.exe
Typically a Visual C++ application used to extract data
.js
JavaScript™, run under Windows® Scripting Host (cscript.exe)
.pl
Perl, executed under perl.exe from user’s PATH environment variable, for example, ActiveState Perl
.prl
ccperl
.vbs
VBScript, run under Windows Scripting Host (cscript.exe)

All other files are ignored. The file name extension of report procedures supplied with DevOps Code ClearCase® Reports is .prl, which the Report Builder associates with ccperl.exe.

At run time, the Report Builder displays all folder names, substituting a space for the underscore and dropping the file name extension. There is one exception: the root directory is always named Reports. This convention cannot be changed.

For example, you have the following on-disk directory tree:

scripts\
   Admin_Reports
      view_aging.prl
      all_views.prl
   UCM_Reports\
      lagging_streams.prl
      completed_acts.prl

The Report Builder displays text in the tree pane as the following folders:

\Reports
   Admin Reports\
   UCM Reports\