Use this dialog to define a “run report” command to be used in a Formattable Report.
This will run the specified report when the Formattable Report including this command is run. You can use this to nest formattable reports.
Report Type - Choose the type of report to run. The Report Name list will change to list the reports of the selected type. If Named By Variable is selected, the list will contain the names of variables defined in the formatted report script.
Report Name - Choose the name of the required report from the list. If the list contains variable names, the report name will be the whatever the variable contains when the command script is run.
Write Report To A Separate File - Leave blank to include the report into the report file generated when running the Formattable Report script.
Parameters Passed To Report - If the report you want to run is another user report you can pass up to eight parameters to it at run time to affect how its contents. For example the dialog shown above is passing a variable that will be set up with the required side (top or bottom) so the pick an place output will only output the components on that side.
In the report to be run, the parameters passed to it can be picked up by adding a command to set a Variable to the passed value. For example “Set Variable ‘side’ to Runtime Parameter 1”.
You can also use these parameters to alter the filename of the report to be run. See Run Report for more details on how to do this.
Place Result in Variable - Check this box to supply the name of a variable to hold a value returned by the user report you want to run. In the dialog shown above the return value from the “Pick and Place” report is the number of components output, and at run time this value will be placed into the variable called “Count” after the report has been run so that it can be used by the parent report.
In the user report to be run, the return value is set by adding a command to save a Variable to the report result.
Other Command Dialogs
Angle Units | Attribute | Set Alternate Attributes | Component Group List | Coordinate Units | Fixed Commands | If | List | List Field | Position | Rule Check | Value | Variable | While