Batch Command Line Options

Batch Command File

This is the most powerful command line option.  You can preselect the destination and format, and load parameter values.

A command file is invoked using the @ character, followed by the command file.  This is a simple text file with processing commands on separate lines. The commands may be in any sequence and are not case sensitive.

The following commands are supported:

Basic Commands

report=filename (indicates which rpt file you want to process
comment=description (you can include comments in the file)
logfile=filename (can change the name of the log file)
disk=diskfilename (saves the output to the disk file)
format=fileformat (specify the output file format)
email=emailaddress (sends the output to the email address)
emailcc=emailaddress (you can include a cc address)
emailbcc=emailaddress (can also have a bcc)
emailsubject=subjectline (the subject on the email message)
printer=printername (sends the output to that printer)
output=viewer (select the viewer for output)
burst=burstcontrolfile (processes the report as a bursting run)

There are some restrictions on what combinations are valid.  For example you can specify the disk file name as well as the email address to send the file to.

You must have an email to send the message to before the cc and bcc addresses are processed.

Disk and Email output must include a format.  If no format is specified, the default output is a rpt file with saved data.  Valid formats are Crystal Report, RPTR Locked Crystal Report, Excel, Excel Record, Excel Workbook, Acrobat File, Rich Text, Editable Rich Text, CSV File, Tab File, HTML Document, DHTML Document, MS Word and XML

Parameter Values

You can specify a parameter value using the command
{?parametername}=parametervalue

Multiple values can be entered on the line separated by a pipe (|) character.

A Range value can be entered on the line using
{?parameter}=fromvalue~tovalue

Formula Control

You can modify a formula in your report using
{@formulaname}=newformulatext

The new formula must fit on one line.  We can extend this if needed.

Table Mapping

You can invoke table mapping using the command
{:server}=NewServer

This can be used to modify the server or database properties of each table connection.  If you need to change both, use a second line.

If this is a new connection, you will need to load the password information on the database connection form.

To assist with getting the spelling correct for the server or database name, the table mapping information is saved to tablemap.html in the Shared\Web folder.  Only the most recently invoked table map will be displayed.

Table mapping will work on both reports and subreports. The source database names and server names are not case sensitive.

Report Viewing | Bursting | Scheduling | Product Activation | History | CrystalKiwi Home

Copyright © 2023 CrystalKiwi Ltd. All Rights Reserved.