Additional /datareport Arguments

This topic gives detailed description of command line switches and examples of their usage.

Arguments

To get more information on switches related to data reports in the command line interface, you can type:

C:\Program Files\Devart\dbForge Studio for MySQL>dbforgemysql.com /datareport /?

Below all switches of this option are described, together with usage examples.

/connection

This switch is used to specify a connection string with additional parameters. Command usage is as follows:

/connection:<connection_string>

Example of using the /connection argument:

C:\Program Files\Devart\dbForge Studio for MySQL>dbforgemysql.com /datareport /connection:"User Id=scott;Server=ORCL"

/format

This switch is used to specify report format. Note that the HTML report won’t be sent by FTP or email if result contains several files or folders. Command usage is as follows:

/format:<PDF|HTML|MHT|RTF|TEXT|CSV|EXCEL|EXCEL2007|BMP|EMF|GIF|JPEG|PNG|TIFF|WMF>

Example of using the /format argument:

C:\Program Files\Devart\dbForge Studio for MySQL>dbforgemysql.com /datareport /format:"PDF" 

/parameters

The switch is used to specify values for parameters declared in a query script. Command usage is as follows:

<param_name1>:<param_value1>
<param_name2>:<param_value2>

Example of using the /parameters argument:

C:\Program Files\Devart\dbForge Studio for MySQL>dbforgemysql.com /datareport /parameters param1:value1 param2:value2

/password

Use this switch if you want to specify a server password. This argument overrides the password specified in the connection string. Command usage is as follows:

/password:<pw>

Example of using the /password argument:

C:\Program Files\Devart\dbForge Studio for MySQL>dbforgemysql.com /datareport /password:"tiger"

/reportfile

Use this switch to specify the input report file. Command usage is as follows:

/reportfile:<file name>

The following example shows how to specify the input report file:

C:\Program Files\Devart\dbForge Studio for MySQL>dbforgemysql.com /datareport /reportfile:"sample_report.rdb"

/result

Use this switch to specify what should be done with the result: save the report to disk, or send it by email or FTP.

You can specify SMTP settings on the corresponding options page.

Command usage is as follows:

/result folder:<file path> | email:<email address> | ftplogin:<login> ftppassword:<password>

Usage examples:

  1. Report is saved to the specified folder on disk in the CSV format:

     /datareport /reportfile:"D:\workDir\dept.rdb" /format:CSV /result folder:"D:/output/"
    
  2. Report is sent by email:

     /datareport /reportfile:"D:\workDir\dept.rdb" /format:CSV /result email:"address@hostname.net"
    
  3. Report is sent by FTP:

     /datareport /reportfile:"D:\workDir\dept.rdb" /format:CSV /result folder:"ftp://hostname.net/output/" ftplogin:user_name ftppassword:user_password
    
  4. Report is sent by email and FTP:

     /datareport /reportfile:"D:\workDir\dept.rdb" /format
    

/resultfilename

The switch is used to specify a report name. Command usage is as follows:

/resultfilename:<document name>

Example of using the /resultfilename argument:

C:\Program Files\Devart\dbForge Studio for MySQL>dbforgemysql.com /datareport /reportfile:"sample_report.rdb" /resultfilename:report1