Read Settings from Command Line Window

The Read Settings from Command Line window allows you to reverse-engineer project settings from a set of command line options that you use to run the Command Runner.

This window can be reached from the following locations:

In the Command Line Builder, from the FileRead Settings from Command Line menu command. In this case you may only paste in one command line, and the settings imported from the command line replace all the current settings in the Command Line Builder.
In the Project Editor, from the FileNew » Project from command line(s) menu command. In this case you may paste in one or more command lines, and the settings from those commands lines are combined to create a new project.
In the Project Editor, from the AddReports and tasks from command line menu command on the context (right-click) menu for the Project node. In this case you may paste in one or more command lines, and the settings from those commands are used to add additional reports and e-mail tasks to the currently-open project.

To use this tool, copy a command line that you are currently using to run the Command Runner (adcrutil) to the clipboard, and then paste it into this window.

For example, if you have a batch file that runs this command every day:

"c:\program files\report commander\adcrutil.exe" -report="C:\reports\dailysales.rpt" -login!=dbserv1.customerdb:batchuser:pGNXQoGmNboLH/UtHMMong== -suppressempty -exportformat=PDF -exportfile="dailysales.pdf" -removefile -emsender="Report Distribution <[email protected]>" -emrecipient="[email protected]" -emsubject="Daily Sales Report" -emtext="Attached is the daily sales report for {MMM d, yyyy}" -parameters "{yyyy-MM-dd}~{yyyy-MM-dd}"

You can copy/paste that entire line into the input box in this window.

You can also paste just the command-line options, without the "adcrutil.exe" part:

-report="C:\reports\dailysales.rpt" -login!=dbserv1.customerdb:batchuser:pGNXQoGmNboLH/UtHMMong== -suppressempty -exportformat=PDF -exportfile="dailysales.pdf" -removefile -emsender="Report Distribution <[email protected]>" -emrecipient="[email protected]" -emsubject="Daily Sales Report" -emtext="Attached is the daily sales report for {MMM d, yyyy}" -parameters "{yyyy-MM-dd}~{yyyy-MM-dd}"

Your command line must be on a single line in the input box, even if it's a very long line.

The source report (.rpt file) must be available when you run the conversion, as Report Commander needs to read information from the report file. Make sure the -report option points to the file.

When you click OK, Report Commander will read the settings and create or update a project from them.

Combining Multiple Commands

If you are currently running several different commands that you would like to combine into a single project, you can paste all of the command lines into the input box together. Each command line must be on its own, single line in the box.

This option is not available when this tool is invoked from the Command Line Builder, because the Command Line Builder can only work with one report/output.

When you use this option, each command line is used to add a new target report to the project, unless the report names (including path) match, in which case the command line will be used to add a new Output Group to the existing report. In this case, the logins specified on the second command line are ignored.

If the report filename and parameters both match an existing report, the command line will be used to add a new Output to the existing Output Group.

If the command line is configured to e-mail the report output, a new e-mail task is added to the project. The conversion tool does not attempt to combine e-mail operations into a single task.