ActiveReports 10 Server User Guide
Managing Schedules
ActiveReports 10 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.

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.
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.
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.

Delivery

You can optionally set delivery options for your users, or you can leave this section blank and allow your users to choose these settings.

Option Description
Format

Select the format in which 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, Email, or Windows File Share. Below are more options that appear with these delivery types.

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 can use the following styntax 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 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.
See Also