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 HCL VersionVault 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\