How do I setup a Package Reports Schedule for Power BI in PBRS?

The purpose of the wizard will be to guide you through the process of setting up a number of reports to be generated at defined intervals and delivered to one or more defined destinations - together.

Package Report Schedule for Power BI.

The purpose of the wizard will be to guide you through the process of setting up a number of reports to be generated at defined intervals and delivered to one or more defined destinations - together.

Example: Your entire monthly report pack (consisting of a number of reports) can be sent to a recipient with all reports attached to the single email. You can also zip up the reports into a single zip file, or export them out to a single Excel workbook, or export them in a single PDF file.

How to Create a Package Schedule Report for Power BI?

  • Go to Package.

Power BI and SSRS. Package Schedule Report for Power BI in PBRS.

 

Power BI and SSRS. General Wizard of Package Schedule Report for Power BI in PBRS.

General Wizard

  • Package Name: The name of the package.
  • Create In: The PBRS folder where the package is stored.
  • Description: A short description to help other users identify exactly what this schedule is and what it is expected to do.
  • Keyword: 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 of Package Schedule Report for Power BI 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.

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

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

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

  • Week Days: Run the schedule Monday through Friday.

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

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

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

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

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

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

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

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

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

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

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

  • None: No scheduling is required for this item.

Power BI and SSRS. Schedule Wizard of Package Schedule Report for Power BI in PBRS.

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

Destinations Wizard

In this section, you will decide where your schedule will be delivered. 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.

Power BI and SSRS. Destinations Wizard of Package Schedule Report for Power BI 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.

Power BI and SSRS. Adding a destination in Destination Wizard in PBRS.

  • Edit: Select a destination and click to edit it's 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.

Reports Wizard

Power BI and SSRS. Reports Wizard of Package Schedule Report for Power BI in PBRS.

A package may be created with no constituent reports and then the reports can be added later. However, you may also add reports at this stage in the wizard - and amend, delete or add some more later.

  • Merge all Text Files: Check this option to merge all text files and give the file a name.
  • Merge all PDF Files: Merge PDF outputs into a single PDF file. The reports will appear in the merged PDF in the order they are displayed in the package schedule. Checking this box will bring up additional PDF Options.

Power BI and SSRS. Reports Wizard of Package Schedule Report for Power BI in PBRS.

 

  • Merge all Excel Files: PBRS will then merge all excel outputs in the package into a single excel file.

Power BI and SSRS. Reports Wizard of Package Schedule Report for Power BI in PBRS.

HINT: Add Password Protection to this section in this option window rather than the individual report in the package. This will password protect the entire merged workbook.
  • Run Package using Multiple threads: This allows up to 8 reports to be exported simultaneously.
    • Each report in the package can run concurrently.
    • See Multi-threading for more info.
  • Enable snapshots and keep them for (days): Keep a copy of the report for how many days.
System resources will be shared so this will not always mean that reports will take 1/4 the normal time.
Example: You have 4 reports. Each one takes 15 minutes to export. Using a single thread, it would take 1 hour to complete the export. Using multiple threads, you would expect it to take 15 minutes for all 4. However, the sharing of your system resources by 4 reports may result in each report taking longer than 15 minutes and the total time for 4 reports may be more than 15 minutes, but it will be less than an hour
  • Click Add and select For Power BI.

Power BI and SSRS. Reports Wizard of Package Schedule Report for Power BI in PBRS.

  • Package Report Properties will appear on.

Package Report Properties

Report Wizard

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

  • Power BI Account: Add the account to send the report.
  • Select Report: The path to the required report.
  • Report Name: Enter a name for the report.
  • Enabled: Enable or Disable this specific report in the Package.

Output Format Wizard

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

  • In this section, you will select the output format of the report.
  • For more information on Output Format, click here.

Report Filter Wizard

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI 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.
  • Preview: View the dashboard/report output given the selected filters.
  • Filter Type: You may choose between Basic Filter or Advanced Filter.
  • Filter using this field (Table.column): Choose the table and column you would like to set up the filter.
  • Show items when the value matches (Basic Filter): Insert the value you would like to add and then click Add.

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

Show Items when the value (Advanced Filter): In this option, you have the option to show items when the value and select the option from the drop-down menu.

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

 

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

  • Click Save Filter to add the filter.

Report Settings Wizard

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

  • In this section, you may set up the dashboard/report.
  • Left margin (% of width): The size of the left margin as a percentage of the page width.
  • Page Height(pixels): The height of the rendered file.
  • Page width (pixels): The width of the rendered file.
  • Right margin (% of width): The size of the right margin as a percentage of the page width.
  • Maximum Loading Time(secs): The maximum amount of time that the renderer will wait before timing out.
  • Minimum Loading Time(secs): The amount of time that PBRS will wait for the dashboard/report to load before rendering it to file.
  • Page Number (Optional): The Power BI page(s) to render. Only applicable to Power BI reports. You can specify a page range e.g 1-5 or specific e.g. 1,3,5.
  • View Style: How the report fits on the page: Fit to Page, Fit to Width, or Actual Size.
  • Enable snapshots and keep snapshots for "X" Days.
  • Preview: By clicking here you may see the preview dashboard/report.

Refresh Datasets

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI 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.

Naming (Optional)

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

  • Default Naming Convention: PBRS will name the output file in the following format: reportname.format extension, e.g. Catalog Report.pdf.
  • Customize the output file name: Choose your own filename or right-click and use the Insert Function to insert a value.
  • Customize output extension: Choose your own extension. This is useful for system integration. For example, the default extension for a character separated file is "CSV," but you can give your export an extension of "txt" so that the file can be read by another already existing system you may have. You may also right-click and use the Insert Function to insert a value.
  • Append date/time: This is useful for the following reasons:
    • If the filename is the same each time, and it is being exported to the same folder each time, then it will be overwritten by the latest one each time. By appending date and time to the filename, each file remains unique, and no files are overwritten.
    • You can track which reports ran and when they ran by looking at what the report is named.

Exception Handling Wizard

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

  • Check if the 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.

Method

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI 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.

Power BI and SSRS. Get value from database interface in PBRS.

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

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI in PBRS.

Actions

Power BI and SSRS. Package Report Properties of Package Schedule Report for Power BI 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.
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.
  • Click OK.

Exception Handling Wizard

Power BI and SSRS. Exception Handling Wizard of Package Schedule Report for Power BI 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."
  • Check if the 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.

Method

Power BI and SSRS. Exception Handling Wizard of Package Schedule Report for Power BI 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.

Power BI and SSRS. Get values from database interface in PBRS.

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

Power BI and SSRS. Exception Handling Wizard of Package Schedule Report for Power BI in PBRS.

Actions

Power BI and SSRS. Exception Handling Wizard of Package Schedule Report for Power BI 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.
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.

Click Next to continue to the next wizard section.

Custom Tasks Wizard

Power BI and SSRS. Custom Tasks Wizard of Package Schedule Report for Power BI 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.

Package Report Schedule Context Menu

Power BI and SSRS. Package Schedule Report Context Menu for Power BI 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.
  • Open: This will open the package and show its constituent reports.

Power BI and SSRS. Open Wizard of Package Schedule Report Context Menu for Power BI in PBRS.

  • You can right-click on each of the constituent reports to see the context-sensitive menu shown in the picture above.
    • Enabled: Use this to enable or disable the constituent report.
    • Refresh: Pulls through changes to just that report which were made outside PBRS.
    • Rename: Renames the selected report.
    • Preview: Generates a preview of the selected report.
    • Delete: Deletes the selected report from package.
    • Properties: Displays the configuration properties of just that report.
  • Add Report: Use this to add one or more reports to an existing package.
  • 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.
  • Execute: This button 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: Selecting this option will delete the schedule.
  • Test Package: Use this option to test the schedule and export it to selected "test" destinations.
  • Split into Single Schedules: This will split all the constituent reports in the package into Single Report Schedules.
This process will automatically delete the package once the splitting process is completed.
  • 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.

Package Report Schedule Properties

Power BI and SSRS. Package Schedule Report Context Menu for Power BI 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 schedule such as timing, error handling, or custom tasks.
  • General

Power BI and SSRS. General Wizard of Package Schedule Report Properties for Power BI in PBRS.

  • Schedule

Power BI and SSRS. Schedule Wizard of Package Schedule Report Properties for Power BI in PBRS.

  • Reports

Power BI and SSRS. Reports Wizard of  Package Schedule Report Properties for Power BI in PBRS.

  • Destinations

Power BI and SSRS. Destinations Wizard of Package Schedule Report Properties for Power BI in PBRS.

  • Exception Handling

Power BI and SSRS. Exception Handling Wizard of Package Schedule Report Properties for Power BI in PBRS.

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

Power BI and SSRS. History Wizard of Package Schedule Report Properties for Power BI in PBRS.

  • Tasks

Power BI and SSRS. Tasks Wizard of Package Schedule Report Properties for Power BI 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. Snapshots Wizard of Package Schedule Report Properties for Power BI in PBRS.