Report Action

A report action executes a report and delivers or saves it. The options for report action are shown below.

Table 3. Delivery Options

OPTION

DESCRIPTION

Save in Archive

Save the generated report in the report archive. A report archive must be properly configured, and you must have proper permissions to save the report in the selected folder.

Print on Server

Print to a server printer.

Deliver to Emails

Send a report to other users via email. To embed the report within the email as HTML, select the 'HTML Email' option. (Note that the appearance of the delivered report may not be fully preserved if the recipient's email client is not standards compliant). To send the report as an attachment, select one of the other formats (PDF, Excel, etc.). If the attached file is too large, it will be split into multiple emails. The email subject line can include parameters for automatic insertion of report alias and time/date of report generation. See the Email and Save to Disk Parameters section below for examples. The 'Bundled as zip' option allows you to zip the attachment and optionally specify a password to encode the archive with WinZip 256-bit AES encryption.

Save to Disk

Save the report on the local file system in any of the following formats: PDF, HTML, Excel, RTF, SVG, CSV, Text, XML. The 'Path' field should specify a valid absolute path, including filename. (The filename extension is added automatically.) The filename can include parameters for automatic insertion of report name and time/date of report generation. See the Email and Save to Disk Parameters section below for examples.

Notify when Completed

Send users an email notification about the task completion status. Optionally you can check 'Notify only if failed'.

Email and Save to Disk Parameters

The 'Deliver to Emails' subject line uses the java.text.MessageFormat syntax with two properties, the first (index 0) being the report alias, and the second (index 1) being the date and time of report generation. For example, a report with alias 'testReport' and 'Subject' specification

Report named {0}, generated at {1,time} on {1,date}

would produce an email subject line such as the following:

Report named testReport, generated at 10:34:54 AM on Nov 5, 2007

where the time and date shown would be the actual time and date of the report's generation. See below for some examples of date formatting using the java.text.SimpleDateFormat. The report alias is set by an administrator, and may often be the same as the report name.

The filename for the 'Save to Disk' action, and the attachment for the 'Deliver to Emails' action can include the same parameters as the email subject line. However, because of filename restrictions, you cannot use the “{1,time}” syntax. Some examples of automatically generated filenames are shown below.

Specified Filename

Generated Filename

myRep_{1,date}.pdf

myRep_Nov 14, 2007.pdf

{0}_{1,date}.pdf

“report alias”_Nov 14, 2007.pdf

myRep_{1,date,MMM-dd}.pdf

myRep_Nov-14.pdf

myRep_{1,date,EEE-h-mm a}.pdf

myRep_Wed-11-49 AM.pdf

myRep_{1,date,yy-MM-dd-HH-z}.pdf

myRep_07-11-14-11-EST.pdf

<< 4.4.5 Scheduler Actions © 1996-2013 InetSoft Technology Corporation (v11.5) Viewsheet Action >>