Available Parameters
The following parameters can be entered when running a report from the command line, a custom button, a menu or a dashboard widget. Some parameters are specific to only one or some of these scenarios.
Parameter |
Description |
Value |
Default Value |
Notes |
Connection Name |
The Exo Business database connection to use. |
|
|
Only required when running a report from the command line, in which case this must be the first parameter specified. |
Username |
The login name of the Exo Business user to run the report as. |
|
|
Only required when running a report from the command line, in which case this must be the second parameter specified. |
Password |
The specified user's password. |
|
|
Only required when running a report from the command line, in which case this must be the third parameter specified. |
Report Name |
The file name of the Exo Clarity report to run. |
|
|
When running from the command line, this must be the fourth parameter specified; in all other cases, it must be the first |
/D or /d |
The report destination to output to. |
Printer, File, Viewer, Email, Grid |
/d=Viewer |
The File and Email options require the /F and /M parameters. The Printer option requires a valid /P or /I parameter. If not specified, the Viewer (Print Preview) window will appear, ignoring any inheritance direction values set by the /I parameter. It is good practice to always have this in any Exo Clarity command line call. |
/F or /f |
The filename for the output file. |
A valid file name |
|
The file extension must match the format specified by the /M parameter e.g. *.DOC or *.PDF |
/M or /m |
The output file mode. |
TextFile, XLSData, XLSReport, XLSData, GraphicFile, HTMLLayerFile, HTMLFile, PDFFile, RTFFile, ReportTextFile |
/m=RTFFile |
Specifies the output format:
|
/P or /p |
The printer to print the report to. |
'Default' or Printer name with the network drive portion in UNC format |
/p=Default |
This parameter is needed when the /D parameter is set to Printer. It is not used if a /I parameter is specified. "Default" is the Windows default printer. If the path is incorrectly entered, Exo Clarity will print to the default printer. The name to use is not the name of the printer as it is called on the server sharing the printer; it needs to be name as it is known on your machine, i.e. the printer name as displayed in the Control Panel > Printers and Faxes. The print server can be an IP address. |
/C or /c |
The number of copies to print. |
1 or more |
/c=1 |
Only used when the /D parameter is set to Printer. The copy counter and total copies are available for use in the report as global variables in the plGlobalVars data source. |
/A or /a |
Open the Clarity Report Parameters window to ask for report parameter values. |
Y or y, N or n |
|
Add /A=N to skip the confirmation of any parameters that exist for the report. Otherwise the report will run on defaults or values specified by the /S parameter. When used with a Clarity report dashboard widget, adding /A=Y will make the widget's Parameters tab appear by default when the widget first opens. If /A is set to N, or if it is not included, the Report tab is displayed when the widget opens. |
/L or /l |
Hide the Exo Clarity splash screen. |
N or n |
|
Only applies when running a report from the command line and asking for parameters (/A=Y). If this parameter is specified, the Exo Clarity splash screen will not appear when opening the report. |
/S or /s |
Specifies report parameter values. |
Comma separated parameter=value pairs |
|
Used internally for passing multiple parameters to a .CLF type file, but can also be used with a CLR file and associated CLS file. You must specify the parameter names as they are defined in the CLS file. If a parameter name is omitted or misspelled, then the parameter dialogue will appear at runtime, regardless of the /A parameter. Double quote marks that are part of the string are repeated to distinguish them from the quotes that surround the entire launch parameter string. If /A and /S are used together, any specified values will be pre-populated in the Clarity Report Parameters window. |
/E or /e |
Opens the report in the Clarity Report Designer for editing. |
|
|
Other parameters are ignored. |
/I or /i |
Inherit the profile settings the .CLF file for an Exo Business form. Pass in a form ID value based upon a predefined list of constants in the Exo Business code. Can be used instead of specifying each individually if a similar report exists in Exo Business that has profile-controlled settings. |
Valid integer value |
0 |
Principally for internal use by Exo Business developers.
Current form IDs are: Note: /I should never be used in conjunction with other output / destination type command line parameters like /P or /D as it gets overridden by them. |