ActiveReports 11 Server User Guide
Managing Schedules
ActiveReports 11 Server User Guide > Managing Schedules

Shared schedules allow you to specify a recurring interval at which to run a report. Each schedule has a name, an optional description, and a list of roles that defines which users have permission to assign reports to it.

Once you add a shared schedule, all users in each role that is granted permission to the schedule can assign reports to run on it.

NoteIf the Don't process empty reports setting is selected on the Site Settings page under Configuration, the schedule task result will not be delivered.

Recurrence

You can set up recurrence options on shared schedules.

Recurrence options

Option Description
Starting On Set the date and time for the task to start.
Ending On Set the date and time for the task to end. By default, this setting doesn't have an end date. To set it, you can select the ending date and time from the Calendar control.
Repeat Task Every Enter a number and select Minutes, Hours, Days, Weeks, or Months to set the frequency of the report execution. 
On days Select check boxes to specify which day or days of the week the task runs.
On hours Enter hours within a day separated by a comma to specify which hour or hours of the day the task runs. When left blank, then "All" hours in the day are used for processing the schedule.
On minutes Enter minutes within an hour separated by a comma to specify which minute or minutes of the hour the task runs. When left blank, then "All" minutes in the hour are used for processing the schedule.
Result Expires After Enter a number and select Minutes, Hours, or Days to specify how long to keep the report in the History. When the specified time period expires, you can no longer open the report from the History tab by clicking Open.

Note: The Repeat Task Every and On days settings work in conjunction to define the dates for a scheduled task to run.

For example, if you set the Repeat Task Every setting to 2 Days and the On days setting to Fri, the scheduled task runs every second day that falls on a Friday.

Another example: if you set the Starting On setting to Thursday, the Repeat Task Every setting to 2 Weeks, and the On days setting to Thu, the scheduled task runs every second Thursday. However, if a day other than Thursday is selected in the On days setting, the scheduled task will NOT run, as the days for the schedule to run include the starting date.

NoteIf the Repeat Task Every is set to 1 minutes and On minutes is set to 5,10,15, then the task is executed on 5, 10, 15 minutes only.

Delivery

You can optionally set delivery options for your users, or you can leave them as set by default and allow the users to choose the settings.

Option Description
Format Select the format to which you want to deliver the report.
Formats: Allow User to Choose, Excel file (xls), MHT document (archived Web page), Image file, PDF document, Word document, or XML file (xml).
Delivery Type Select Allow User to Choose, EmailWindows File Share, or Print. Below are more options that appear with these delivery types.
Note: The Format option is unavailable if the Delivery Type is set to 'Print'. Also note that you must have permissions to the specified printer.

Delivery Type options

Email Delivery Type Options

Option Description
Email report to Enter one or more e-mail addresses where the report is to be sent. Separate multiple e-mail addresses with commas.
Subject

Enter the text to use for the e-mail's subject line. You can use the following syntax in the subject:

  • ?ParameterName: To specify parameter values for the report in the subject. Replace ParameterName with the actual name of the parameter.
  • &ReportName: To specify the report name.
  • &ExecutionTime: To specify the execution date and time of the report.
Body Enter text to use in the body of the e-mail. You can use the following syntax in the e-mail body:
  • ?ParameterName: To specify parameter values for the report in the e-mail body. Replace ParameterName with the actual name of the parameter.
  • &ReportName: To specify the report name.
  • &ExecutionTime: To specify the execution date and time of the report.

    Caution: When using a syntax such as, &ReportName, add a whitespace character after the syntax to replace the placeholder correctly.

    For example:

    • Correct: This is &ReportName template.
    • Incorrect: This is &ReportNametemplate.

    You can also enclose the syntax with curly braces to replace the placeholder correctly.

    For example:

    • &{ReportName}
Delivery method Select Allow User to Choose, or As Link to insert a hyperlink to the report in the body of the message, or As Attachment to attach the report to the message in the format specified above. If you select As Link, please see Site Settings Notification URL.
Attachment template Enter the resource name template. You can use the following syntax in the attachment template:
  • ?ParameterName: To specify parameter values for the report in the attachment template. Replace ParameterName with the actual name of the parameter.
  • &ReportName: To specify the report name. This is default template.
  • &ExecutionTime: To specify the execution date and time of the report.
Note: ExecutionTime token is specified as &{ExecutionTime:<TokenFormat>}. Different DateTime format strings for .NET framework such as "d", "F", "T" etc. can be specified for the TokenFormat. For example, &{ExecutionTime:d} will be displayed as 06/10/2014.
Caution: When "g" DateTime format is specified using special characters in the "&ExecutionTime" token, the generated attachment that is received through scheduled e-mail is downloaded in an unsupported format.

Windows File Share Delivery Type Options

Option Description
File name Enter the name of the report file. You can use the following syntax in the file name:
  • ?ParameterName: To specify parameter values for the report in the file name. Replace ParameterName with the actual name of the parameter.
  • &ReportName: To specify the report name. This is default template.
  • &ExecutionTime: To specify the execution date and time of the report.
Add file extension Select to add the file extension for the report's format to the file name.
Path Enter the fully qualified UNC path of the location at which to share the report.
User name Enter the user name to connect to the UNC path.
Password Enter the password of the user for the UNC path.
Overwrite Select Allow User to ChooseOverwrite the existing file if it exists , or Increment filename as newer versions are added to control how stored versions of the report are handled.

Print Delivery Type Options

Option Description
Printer Select a printer from the list of available printers on the server, or select Allow User to Choose option.
Printer Options The following options are available:
  • Color: Choose to print in Color, Gray scale, or select Allow user to choose option.
  • Two sided: Specify printing as One-sided, Two-sided(Long edge), Two-sided(Short edge), or select Allow user to choose.
  • Number of copies: Enter the number of copies to be printed or select Allow user to choose.
  • Paper size: Select the page size from several available options such as Letter, Legal, Statement, A5, and so on, or select Allow user to choose.
  • Paper source: Select paper source as Auto, Multi-purpose Tray, Drawer 1, Drawer 2, Paper Type Priority, or select Allow user to choose.

Setting Allow user to choose for any of the above options allows the user to set that option in the Report Portal later.

See Also