Running a Report from a Saved Template

Run a Report

1. To run a saved report template from file select Utilities > Standard Reporting > Reports > Run from the main window drop-down.

   You will see a File Browser, showing the contents of the directory REPORTS.

   This directory will contain reports with a file extension .rep, some of which are supplied with the product, and a TEMPLATES directory. Change to the TEMPLATES directory, and you will see a list of templates with the file extension .tmp. Some of the templates are supplied with the product, which correspond to the reports supplied, and you can look at these as examples.

2. Select the report template you want to use and select OK.

   What happens next will depend on how the template has been set up:

   • If you have no control over the report, it will be run immediately. If the report is sent to the screen, it will be written to the active output window, for example, the command window or the Query window, or to a new window if there is no output window. If the report is sent to a file, the file will be created in the directory REPORTS.

   • If you have some control over the way the report is produced, you will see the Report Details form as follows:

     

   According to how the report or template is set up, you may be able to specify the following in the Report Details form:

   Filename		If you can specify a filename, the report will be sent to the given file in the directory REPORTS. If you leave the text box empty, the report will be sent to the screen. If there is no filename text box, the file will be sent to the file named in the template, or to the screen, if the template specifies a screen report.
   Type(s)		Allows you to specify the types of item you want to report on. For example, VALVes, ELBOws.
   with		Allows you to restrict the report to elements of the given type whose properties satisfy given conditions. For example, you can report on Elbows with ABORE greater than 100.
   Hierarchy		Allows you to specify the level in the database hierarchy below which the selection will be made.
   Volume		You can specify a Volume in the model, and report on elements Completely within or Partially within it. Selecting Completely within or Partially within option will display the Report Volume form.
   From		These options are used together with the Volume option. You can specify:
   	MDB	which will select all elements in the master database within the volume.
   	Drawlist	which will select all elements in the Drawlist within the volume.
   	Obstruction list	which will select all elements in the obstruction list within the volume.

Running Reports in Batch Mode

Report templates are macros, which can be run in batch mode by giving the command $M/template-name. for further information about batch mode, see Monitor Reference.

Note: Report templates for batch mode must not have any runtime prompts set.