The Single Schedule is the simplest and easiest way to schedule a report for delivery. It involves defining the report you wish to schedule, determine its timing, selecting parameters (if any), and setting the destination (s) of the report.
Jamie is a reports developer that must send a daily report to management detailing the number of support tickets currently open.
She requires a report to be sent in PDF format at 8:30AM to three individuals.
How to create a single schedule:
First, select single schedule from the “Home” Tab.
A wizard will appear. Click here to view the Single Schedule Wizard.
Single Report Schedule: General
The General Tab decides the most basic properties of the schedule itself. How the schedule is organized, the report (s) it runs, and its purpose are determined here. Once the require fields are filled, click next to proceed to the next section.
Create In: Select the folder where you wish the schedule to be stored. These are SQL-RD specific folders.
Report Service URL: Enter the address of your reporting services server
Report Location: Browse through the report server browser to select the desired report. Authenticate to the reports server if necessary.
*Hint: SQL Azure Reporting Services- when writing your report, make sure you have enabled Forms Authentication. You should use the 2010 .asmx address for your reporting service URL.
Schedule Name: Name the schedule
Description: Add a Description to the schedule to better identify it.
Keywords: Add keywords to your schedule. With keywords you can easily search for a specific schedule, and can be used to create a smart folder.
Continue To Single Report Schedule - Schedule
Single Report Schedule: Schedule
In this section, you will decide when the report will execute. There are a variety of options:
Daily: Run a report every day or at a frequency of days.
Repeat every X Days- EX. Run the schedule every 3 days.
Weekly: Run a report on a weekly time frame.
Repeat every X weeks- EX. Run the schedule every 2 Weeks.
On- Select the specific days of the week the schedule will run. If only once a week, select only the day of the week it will run. EX. Run every Monday, Wednesday, and Friday.
Weekdays: Run the schedule Monday through Friday.
Working Day: Run the schedule starting on a specific day of the month. Indicate which day of the month the schedule will run. E.G. run the schedule on the 4th working day of the month.
Monthly: Run the schedule on a monthly time frame.
Use the following options- Checking this box will enable you to select frequency options such as the “last Thursday of the month.” Also you can include or exclude specific months from the schedule.
Annually: run the schedule every year at a specified time.
Custom Calendar: Select the custom Calendar you wish to use. You can create a new custom calendar from the menu as well. Please see Custom Calendars for a tutorial.
Other: Other scheduling options.
Run Schedule every X Minutes, hours, days, weeks, months, years
None: No scheduling is required for this item.
Next, you will specify the time that the schedule will run as well as repetition options.
Schedule time: Specify the exact time you want your schedule to run. *Tip: keeping in mind how long it takes for your report, time your schedules accordingly!
Exception Calendar: choose a calendar that will instruct the schedule to NOT run on those specified days. Please see Custom Calendars for a tutorial.
Next to run on: displays the next run date of your schedule.
Repeat ever X hours or minutes: run your reports on a reoccurring basis during a specific time frame. EX Repeat every .25 hours until 5PM.
Enable this schedule: to enable the schedule leave the box checked. To create this schedule disabled, deselect this box.
Once you have finished creating the timing for your schedule, click finish to proceed to the next stage.
Continue To Single Report Schedule - Report
Single Report Schedule: Report
In this section, you will determine the parameters for your report (if any). If your report has no parameters, you may skip this section by clicking next.
There are 3 requirements in order for SQL-RD to detect your SSRS Report parameters and their parameter values:
1) The parameter must be in use in the report
2) The parameter must be visible
3) The parameter must be set to be prompted at runtime
If these three requirements are achieved, you should see the parameters in your report listed in this screen.
For each parameter, select from the drop down list the value the report must use. In a single schedule, only one parameter value can be run at a time per parameter. You can type a value into the field as well.
Set as Null: Set no value for this parameter.
Ignore: Do not run this parameter, ignore it at runtime.
Select from the dropdown list the upper and lower value for the parameter.
Include Value upper/lower: Include the selected parameter value in the range.
No lower/upper bound: include all values above the upper value, include all values below the lower value.
*Tip: to enable a report parameter to run for a date constant (Current Date, Yesterday etc.), select SQL-RD Constants from the inserts window, then drag and drop your
desired constant to the parameter field.
Preview: view the report output given the selected parameters.
Multi-Select Parameters and Cascading Parameters
SQL-RD can handle SSRS Reports with Cascading parameters, or reports where you can select multiple parameter values..
Simply select the top level parameter value. The secondary parameter value options will be populated based on your previous choices. Selecting All Available Values will run the report given all the values.
Continue To Single Report Schedule - Report Options
Single Schedule Report: Report Options
In this section you will authenticate to the database the report runs against, set snapshots, and other options.
Login Required: Set the authentication information for the report.
Resume failed/errored schedules with cached data: If the schedule fails, resume the schedule from where it left off. You can then select how long should the cached data should be kept.
Save Snapshots: Save a Picture of the report as it is produced. Choose the amount of time will be stored in the system before deletion. View Snapshots for more info.
Preview: View the report prior to execution.
Continue To Single Report Schedule - Destinations
Packaged Report Schedule: Destinations
In this section, you will decide where your schedule will be delivered. In a Package Schedule, all reports enclosed in the package will be delivered to the same destination(s).
The list in the center will display the list of destinations you have added to the schedule. You can organize the various destinations’ order by clicking on the green up and down arrows.
By clicking Edit, you can edit any destinations you have created.
The delete button will remove that destination from your schedule.
Import allows you to add default destinations. Please see Options section for more details on default destinations.
To add destinations click on the “Add” button. Alternatively, click the small down arrow to immediately select a destination.
If you clicked the small arrow, skip this paragraph and proceed to the next. If not, a new window will appear. In the “Type” Field, select your destination from the drop down list.
These are the destinations currently support by SQL-RD:
Disk- Send a report to folder on the machine or any UNC path.
Email- Email a report via MAPI, SMTP, GroupWise, or SQL-RDMail.
Fax- Send a report via Fax Machine. (Requires a V92 Fax Modem)
FTP- Send a report via FTP or SFTP
ODBC- Output reports to a database
Printer- Send your report to a connected or networked printer.
SharePoint- Upload the report to a SharePoint directory.
SMS- Send the report as a text message.
*Please see Destinations for details.
Select the Destination that you wish to use. A window will appear that will allow you to set up the destination. Also an Inserts window will appear separately.
In this scenario, we wish to email the report to the recipient. Select email as the destination.
Setting up an Email Destination:
Enter the email address of the recipient. If there is more than one, simply place a semi colon followed by the next recipient’s email.
Add a subject to the email, and attach any additional file you desire.
In the body, you can write a customized message to your recipients. Using inserts you can add dates and user constants.
By default the report comes attached. For details on the email destination please see destinations.
Setting the Report Format:
Each destination has a format tab in its mini wizard. To select a format for your report, go to the format tab.
From the dropdown list you can select a format for your report. SQL-RD has a wide variety of formats to choose from. For details on all formats available in SQL-RD please see the Formats section.
In this Scenario, Jamie needs the report in PDF format. Select Adobe “Acrobat Format (*.pdf)” from the dropdown list.
If are finished with your destination’s settings, click OK to return to the wizard.
Click OK and you will be returned to the destinations screen where your destination (email in this case) will be listed. You can continue to add destinations by clicking on the add button and repeating the steps above.
Once you have created all of your destinations, click next to go to Report section.
Continue To Single Report Schedule - Exception Handling
Single Report Schedule: Exception Handling
In this section, you will set error handling for your report, as well as options for blank reports.
Treat as “error” if not completed in X minutes: if a report takes longer than the specified amount of time to run, this option will treat the schedule as an error and follow the appropriate action. The “Auto-calculate” option instructs SQL-RD automatically determine how long a schedule should take to run the report. If it takes longer than the calculated amount of time, then it is an error.
*Note: if manually determining the error timing, please double check the runtime of the report in order to get the correct time estimate.
On error, retry executing schedule every X minutes up to Y times: If an error has occurred with the schedule, you can set the interval and number of times you wish the schedule to attempt a retry. By default SQL-RD will make 3 attempts.
SQL-RD and Blank Reports:
SQL-RD has the ability determine if a report is blank. Meaning that if a report genuinely has no data behind it, then SQL-RD can do a number of things with the report and the schedule.
Check if a report is blank: With this option you can check if a report is blank.
Ignore the report: if the report is blank, do not send the report. The report will not be delivered to the destination.
Method Tab: Select the Method that will determine whether a report is blank.
Native: SQL-RD will check to see if the report returns any data. If not, the report is considered blank.
SQL Query: Select this option to use a user made query that will determine if the report is blank. If the query returns no results, the report is blank.
File Size Check: If the file fails to be a certain file size then the report will be considered blank.
Actions Tab: Select an action from the task list. This task will be executed in the event that a schedule is blank.
*Tip: You can send a notification if a report is considered blank instead of sending the report. Simply select “check if a report is blank” then select “Ignore the report.” In the actions tab, select “Send Email” from the list. Compose your email and save.
Continue To Single Report Schedule - Custom Tasks
Single Report Schedule: Custom Tasks
In the section you have the option of setting up custom tasks. Custom tasks are business process automation tools that can be auto triggered before or after a report runs. For more details on Custom Tasks, please see Automation Schedules for a full description of each task.
If you have no desire to add a Custom Task, you can click the finish button to complete the schedule.
Single Report Schedule Context Menu
Right-Click on a schedule to see the following actions.
Copy: Use this to copy an existing schedule. You can then paste it into another folder or the same folder. Simply open the folder you wish to paste to, right-click in the "white" space and select "Paste". Follow the on-screen instructions to complete the process.
Paste: Paste a previously copied schedule
Rename: Rename a schedule
Enabled: Schedules are Enabled when there is a check beside this option. To stop a schedule from running, or to "pause" it for a while, select this option to remove the check. Disabled schedules will not run till they are enabled again.
Refresh: When a schedule is first created, SQL-RD caches (saves) a copy of the report. All executions of the scheduled are performed using this copy. If you make changes to your master report, you must select this option in order to pull the changes into SQL-RD.
Preview Report: Click this option to preview your report.
Execute Schedule: This will execute the schedule immediately. Note that the next run date and time is not moved on as a result of a manual execution. They only move on if the schedule is run automatically by one of the schedulers.
Delete Schedule: Selecting this option will delete the schedule.
Properties: Selecting this option will bring up the "Properties" module containing configuration information for that schedule. For more information on Properties, click here.
Test Schedule: Use this option to test the schedule and export it to selected "test" destinations.
Convert to Package: Select this option to convert a Single Report Schedule to a Packaged Reports Schedule. Please note that you can select multiple single schedules to convert into a single Packaged Report Schedule. You are given the option to select which single schedule will be used as a template for the Packaged Report Schedule. Please note that the single schedules are deleted once the Packaged Report Schedule is created. For more information on Packaged Reports Schedules, click here.
Ad-Hoc Email to Recipients: Select this option to send an ad-hoc email to all recipients of this schedule. You can use this to alert recipients to a planned system outage, or any other useful information. For more information on this feature, click here.
Create Shortcut: Use this option to create a shortcut you can save in any location on your PC. Execute the shortcut to execute the schedule in SQL-RD.
Adhoc View: This enables you to execute the report without using any of the parameter values and other settings in the schedule.
Single Report Schedule - Properties
To access your schedule properties, right click on a schedule and select properties.
Similar to the schedule wizard, you adjust settings to your schedule such as timing, error handling, or custom tasks.
For more information on each of the menu items, select the relevant link below:
History: Review the schedules history. Successes, failures, and other data is located here.