How do I setup a Single Report Schedule for Paginated Reports for Power BI Service in PBRS?

The Single Schedule is the simplest and easiest way to schedule a Power BI report for delivery.

 

This article applies to:

  • Power BI Paginated Reports (Cloud - Power BI Service)

Paginated Reports excel 2

Single Reports Schedule for Power BI Paginated Reports Service.

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.

Example: 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 Report for Power BI Paginated Reports?

  • Go to Single.
  • Go to For PowerBI Service and select Paginated Reports.

Power BI and SSRS Reports: PBRS Home Screen

2-18-2020 4-11-10 PM

Single Report Schedule Wizard for Power BI

General Wizard

  • Create In: This section is to select the folder where you want to create the single report in.
  • Power BI Account: In this section is to select what Power BI Account you want to create the single report. In this section, you may add a new account in the Add New button.
  • Select Report: Click on the drop-down menus to navigate to the required report.
  • Schedule Name: Write in the name of the single schedule.
  • Description (optional): You may write a short description to help other users identify exactly what this schedule is and what it is expected to do.
  • Keyword (optional): Enter some keywords which can be used later by Smart Folders to identify this schedule.

Click Next to continue to the next wizard section.

Schedule Wizard

Power BI and SSRS: Schedule Wizard in Single Schedule for Paginated Reports in PBRS.

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.
    • Sub options: Repeat every X Days.
Example: Run the schedule every 3 days.

pbrs schedule daily

  • Weekly: Run a report on a weekly time frame.
    • Sub options: Repeat every X weeks.
Example: 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.
Example: Run every Monday, Wednesday, and Friday.

pbrs schedule weekly

  • Week Days: Run the schedule Monday through Friday.

pbrs schedule week days

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

pbrs schedule working day

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

pbrs schedule monthly

  • Annual: Run the schedule every year at a specified time.

pbrs schedule annual

  • 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 more information.

pbrs schedule custom calendar

  • Other: Other scheduling options.
    • Run Schedule every X Minutes, hours, days, weeks, months, years.

pbrs schedule other

  • None: No scheduling is required for this item.

pbrs schedule none

  • Start Date: Enter the desired starting date for the schedule. This section can be the current date (providing schedule time has not already passed) or a date in the future.
  • End Date: If the schedule is due to end after a certain date enter that here. If the schedule is to run indefinitely, then leave it blank.
  • Schedule time: On the Next Run date, the package will run at this time.
  • Exception Calendar: Choose a calendar that will instruct the schedule to NOT run on those specified days. Please see Custom Calendars for more information.
  • Next to run on: The package will next run on this date.
  • Repeat Every: Rerun the package every x minutes from the scheduled time until your specified time.
For example, you can set up a daily package to run every day at 8 am, and to run every hour until 5 pm.
  • Until: After this date, there will be no automated scheduling of this package.
  • Enable this Schedule: Uncheck this option to Disable the package. Disabled packages are not deleted, but they do not execute automatically. You can re-start the automatic scheduling at a later date by checking this option again. Or right-clicking this schedule from the main screen and selecting Enable.

Click Next to continue to the next wizard section.

Parameter Wizard

Power BI and SSRS: Parameter Wizard in Single Schedule for Paginated Reports in PBRS.

  • 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.
  • Parameter Name: Enter the parameter name of your report.
  • Parameter Value: Enter the parameter value of your report.
  • Parameter Type: Use the drop-down menu to select the parameter.
  • Click Add to add the parameter value.
  • Import: Use this option to add parameter values using a URL from Power BI Service to import a parameter to this report. 

Power BI and SSRS: Import Parameter from Power BI URL in PBRS.

  • Click OK.

Power BI and SSRS: Parameter Wizard in Single Schedule for Paginated Reports in PBRS.

  • Preview: View the report output given the selected parameters.

Click Next to continue to the next wizard section.

Destination Wizard

Power BI and SSRS: Destination Wizard in Single Schedule for Paginated Reports in PBRS.

  • Add: Click here to add a destination. You have several options which are: Email, Disk, Fax, FTP, ODBC, Printer, Sharepoint, SMS, and Dropbox.

pbrs destinations

  • Edit: Select a destination and click to edit its properties. Or simply double-click on the destination.
  • Delete: Select a destination and click this button to delete it.
  • Import: Click here to import from the list of default destinations.
  • For more information about Type of Destinations, click here.
  • For more information about Output Formats, click here.

Click Next to continue to the next wizard section.

Exception Handling Wizard

Power BI and SSRS: Exception Handling Wizard in Single Schedule for Paginated Reports in PBRS.

  • 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 PBRS 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.
If manually determining the error timing, please double check the run time of the report in order to get the correct time estimate.
  • On error, retry executing schedule every: If set to 0, PBRS will deem the schedule as "Failed" the first time it encounters an error. The schedule will not run again until its next scheduled time. Change the value to tell PBRS how many times you want it to retry running the report before declaring it as "Failed."
  • Run custom tasks when the following exception occurs: Check this is option to enable the following options.
    • Report is Blank: If a report is blank because it genuinely returned no data, recipients can misconstrue this as an error with the scheduler. This option allows you to identify genuine empty reports and instruct PBRS on what to do with them.
    • Ignore the report and subsequent tasks: If the report is blank, do not send the report. The report will not be delivered to the destination. No custom tasks will be run.
    • Report exports fail: If a report export fails, you can receive a notification or run a tasks that the report failed to execute. 

Actions

Power BI and SSRS: Exception Handling Wizard in Single Schedule for Paginated Reports in PBRS.

  • Select an action from the task list. This task will be executed in the event that a schedule is blank.
  • For more information about tasks, click here.

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.

Blank Report Check Method 

Power BI and SSRS: Exception Handling Wizard in Single Schedule for Paginated Reports in PBRS.

  • Select the Method that will determine whether a report is 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.
    • Click Build.
    • Get values from a database window will appear. For more information about Get values from database, click here.

pbrs get values from database

  • File size check: Assume reports is blank if size is under "X" bytes.

Click Next to continue to the next wizard section.

Refresh Datasets Wizard

Power BI and SSRS: Refresh Datasets Wizard in Single Schedule for Paginated Reports in PBRS.

In this section select the datasets to refresh before the report is executed.

  • Power BI Account: Select the account to refresh datasets.
  • Workspace: The path to the required report.
  • Dataset: Select the dataset.
  • Notification Options: Receive a notification after the report is executed, the report failed to execute, or do not receive a notification.
  • After refreshing the datasets above, wait 'X' seconds before running the report.

Click Next to continue to the next wizard section.

Custom Tasks Wizard

Power BI and SSRS: Custom Tasks Wizard in Single Schedule for Paginated Reports in PBRS.
  • 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 information on Custom Tasks, click here.
  • If you have no desire to add a Custom Task, you can click finish to complete the schedule.

Single Report Schedule Context Menu

Power BI and SSRS: Single Report Schedule Context Menu for Paginated Reports in PBRS.

  • Right-Click on a schedule to see the following actions:
    • Properties: Edit the schedule from here. Or you can just double click on the schedule.
    • Copy: Use this to copy the schedule. Right-click in the "white space" of the folder you wish to copy it to and select Paste button.
    • Rename: Rename the package.
    • Enabled: Schedules are enabled when there is a check icon beside this option. To stop a schedule from running, or to "pause" it for a while, select this option to remove the check icon. Disabled schedules will not run until they are enabled again.
    • Move: Use this option to move the report into an existing package.
    • Preview: Preview the report before execution.
    • Execute: This button will execute the schedule immediately. Note that the next run date and time is not moved on as a result of manual execution. They only move on if the schedule is run automatically by one of the schedulers.
    • Delete: Selecting this option will delete the schedule.
    • Execute On: Use to option to execute the schedule to another collaboration server. 
    • Test: Use this option to test the schedule and export it to selected "test" destinations.
    • Convert To Package: This button will move this report into a package. The package will have the name of the single schedule report.
    • Ad-Hoc Email to Recipients: Select this option to send an ad-hoc email to all recipients of this package. You can use this to alert recipients to a planned system outage, or any other useful information.
    • 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 PBRS.
    • Ad-Hoc View: This button allows you to preview the report.
    • General Script: You can create SQL File and add the SQL File schedule in your PBRS database from another server.

Single Report Schedule Properties

Power BI and SSRS: Single Report Schedule Context Menu for Paginated Reports in PBRS.

  • To access your schedule properties, right-click on a schedule and select properties.
  • Similar to the schedule wizard, you adjust settings to your schedules such as timing, error handling, or custom tasks.
  • General

You can view the Schedule Unique ID in the General Wizard.

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • Schedule

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • Parameters

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • Destinations

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • Exception Handling

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • Refresh Datasets

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • Tasks

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • Sharing: Here you can share this schedule with multiple users. 

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • Snapshots: A snapshot is a copy of each report a schedule or a package generates. Keeping snapshots enables you to resend past reports without generating them afresh - especially if the data has changed in the meantime.
    • Simply select the number of days to keep the snapshots.

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.

  • History: Review the schedule's history. Successes, failures, and other data is located here.

Power BI and SSRS: Single Report Schedule Properties of Paginated Reports in PBRS.