POWER BI QUESTIONS

How Do You Send Power BI Reports to a Distribution List?

The weekly report is ready, but the recipient list has changed again. Someone has joined the team, someone has moved on, and the latest addresses may be in a spreadsheet rather than your email group.

PBRS can prepare and email the report using a group address, its own address book, a database query or a text-file list. You can build the delivery around the place your team keeps that information.

  
The weekly report

The report stays the same. The people change.

Imagine preparing the operations report for Monday’s meeting. You have the PDF ready, but before sending it you open last week’s email to check the names. A new manager needs a copy. A colleague has left. Someone else wants their deputy included while they are away.

Your team calls it the distribution list, but it may not be a single address in Outlook. It might be a column in an Excel workbook, a list of active managers in your business database or a small contact group you maintain yourself. The report is only part of the weekly job; keeping the audience right is the other part.

PBRS lets you bring that list into the delivery. If your mail administrator already maintains a group address, PBRS can send the report there. If the addresses live in a database or file, you can use that source instead of copying them into another email each week.

For the operations team, the aim is simple: the people attending Monday’s meeting should have the current report, and you should not have to rebuild the recipient list every Friday to make that happen.

Find the list people actually maintain

Ask the person who adds new managers where they make the change. That is a better starting point than creating another copy of the addresses that someone will also have to remember to update.

  
Your options

Use the list your team already looks after

If everyone is already in an email group, keep that arrangement. Add the group address to the PBRS Email destination and let your mail system look after its members. When the group owner adds the new manager, future messages to that address include them without changing the report schedule.

You can also keep contacts and groups in the PBRS Address Book. That is useful when the reporting team owns a small, shared set of recipients. Select the contacts or group when setting up the email, rather than typing the same addresses into every job. Outlook address-book contacts and groups are another option when PBRS is configured to use MAPI.

When the names come from your database

Suppose your operations database already records each manager’s email address, site and whether they are still active. PBRS can use a query to retrieve the people who should receive the weekly report. You choose the records you want, rather than maintaining a separate mailing list alongside information the business already keeps current.

For our Monday meeting, the query might select the active operations managers. A new manager starts receiving the report once their record meets those rules. A departing manager stops appearing when the record is updated. The accuracy of the email list follows the accuracy of that source.

When the list is in Excel

Your coordinator may prefer a workbook with a row for each manager. You can still use that list, but first decide how PBRS will read it. One route is to make the workbook available through an appropriate Excel ODBC connection and use PBRS’s database-source controls to query the addresses. Another is to export the email column to the plain-text mailing-list format PBRS accepts.

With the text-file route, keep one email address on each line, without a heading or separators. Save the file somewhere PBRS can read it. If the coordinator changes the workbook, the text copy must be refreshed too; saving the spreadsheet alone does not update a separate exported file.

The workbook route needs the right driver and access on the PBRS machine. Your technical colleague can set that up once, then test that the scheduled job can read the saved list while the coordinator is logged out.

Connection details for database and Excel lists

PBRS’s Get Values From Database interface supports an ODBC connection or a configured SQL Server account. Use a System DSN for an ODBC source that must be available to the background service. PBRS requires a compatible 64-bit ODBC driver; the service account also needs access to the data and any workbook or network path.

An Excel workbook is an ODBC source only after a suitable Excel driver and workbook connection have been configured. Query the worksheet or named range exposed by that driver, check the column names and inspect the returned addresses. This is a connection-based approach, not a promise that selecting an arbitrary XLSX file in the Text File option will work.

PBRS documents the connection and query controls in its database-source guide. Microsoft explains the workbook connection in its ODBC connection guide. Test the chosen workbook format and driver in your installation.

What about a native Power BI subscription?

If your team only needs a simple report notification, a Power BI subscription may already do the job. PBRS is worth considering when the work also includes reading the current recipient list, preparing attachments or giving different people different files. It can send exported documents through your configured mail account, and recipients do not need Power BI licenses to open those files.

Check native group subscription requirements

Microsoft’s group-alias subscription feature requires Premium capacity; PPU workspaces do not support group aliases. Distribution groups, dynamic distribution groups and mail-enabled security groups are supported. Microsoft 365 groups and ordinary security groups are not. External recipients require paid non-PPU capacity.

Power BI also offers dynamic subscriptions for supported scenarios. A database or spreadsheet list is not automatically a native group alias. Check Microsoft’s subscription requirements against the delivery you need.

PBRS still needs access to the report and a working export method. Its alternative rendering can support applicable Pro and PPU workflows without adding capacity; test the report and chosen output during evaluation.

Choose who owns the changes

Whether the list lives in Exchange, Excel or a database, someone needs to keep it current. Agree who removes departing staff and who checks new recipients before the next report goes out.

  
Set it up

Build the weekly operations delivery in PBRS

Begin with the operations report and a small test list. Choose people who can check the attachment with you before it becomes part of the whole team’s Monday routine.

Create the PBRS schedule, select the report and choose the week and pages the team discusses. Add an Email destination and select the recipient source from the To, CC or BCC controls. You can type a group address, choose address-book contacts, build a database query or select a text-file list.

For a database or connected workbook, inspect the returned addresses before saving. Check a new manager and a departing colleague against the result. For a text file, open the saved file and check the same names. You are checking the list the job will actually use, rather than assuming it matches the coordinator’s latest changes.

PBRS To menu offering MAPI Address Book, PBRS Address Book, Database Source, Text File and Constants.

The PBRS Email destination guide explains the recipient controls. Use CC when the team should see who else received the message, or BCC when those addresses should not be displayed to the other recipients. A group address follows your mail system’s own membership and delivery rules.

Give the team a useful meeting pack

Choose PDF for the weekly overview and give the attachment and subject the reporting period. Write the explanation you would normally send: “The operations figures for last week are attached. Please bring any questions about your site to Monday’s meeting.” PBRS supports HTML formatting and Inserts, so the message can stay familiar while the date changes with each run.

If the meeting also needs stock and outstanding-order reports, PBRS can deliver several attachments together or merge the PDF outputs into one document. Excel outputs can be combined into a workbook, and you can save a copy to a folder or SharePoint in the same job. Everyone arrives with the material they need, without you assembling the pack again each week.

When each manager needs their own figures

So far, everyone has received the same operations report. Now the site managers ask for a report showing only their own location. Changing the mailing list will not change the figures inside a shared attachment.

This is where a PBRS data-driven schedule helps. Each row can supply the manager’s address and the site filter, so PBRS prepares the right version for that person. The same row can also supply the greeting, filename, format, password and destination. A manager who wants Excel can receive a workbook while another receives a PDF.

A query that simply returns email addresses fills a recipient list. A data-driven reporting job uses each record to prepare and deliver the corresponding report. Choose the latter when the people on the list should receive different information. The data-driven schedule guide walks through that setup.

Try the list before Monday depends on it

Run the job to the test audience and open the received attachment. Check the week, the pages and who received a copy. Then make a controlled change to the source list and test again. For a connected source, confirm the changed results are read; for an exported text list, refresh that file before testing.

If someone misses the email, start with their address in the source. For a group address, ask the mail administrator to check membership, allowed senders and any held messages. For a database or file, check what PBRS read and whether the background account could reach it. The PBRS execution results and Error Log help you separate a report-generation problem from an email problem.

Also decide what should happen if the query returns no recipients or the source cannot be read. Those are different from a successful report with no business data. Test the response in your installation so a broken list does not quietly become a missing Monday report.

Check one addition and one removal

A test that sends successfully to yesterday’s list is only half the job. Confirm that a new manager is included and a removed address is absent before relying on the routine.

  
For developers

Let your application request the prepared delivery

Your operations system may know when the weekly figures and manager records are ready. It can ask PBRS to run the saved report at that point. The reporting team keeps the report and recipient-source setup in PBRS, while the application supplies the request to start.

That avoids turning the application into another place where somebody has to maintain the mailing list. If the job reads a database or connected workbook, check that the latest changes have been saved and can be read by PBRS before requesting the run.

API example: run and monitor the saved PBRS schedule

Authenticate using your installation’s API configuration and replace the example schedule ID with the authorized job.

POST /api/Schedule/ExecuteScheduleAsync
Authorization: bearer {pbrsAccessToken}
Content-Type: application/json

{"ScheduleType":"report","uniqueid":101,"RunBy":"Weekly operations"}

GET /api/Schedule/GetExecutionStatus?ExecutionId={ExecutionId}
Authorization: bearer {pbrsAccessToken}

Retain ExecutionId with the reporting week and recipient-source reference. Inspect Status and parse ResultJson using the PBRS lifecycle reference. Completed processing alone does not prove that every recipient received an email.

Keep credentials on the backend. Do not replace a saved database-driven recipient source with an ad hoc To array unless that is the intended configuration. When updating a schedule, use the complete source-specific definition and preserve its other destinations and settings. Follow the create-and-update guide.

If a request times out, inspect the existing execution before retrying. Some messages may already have been sent.

Leave a trail for a colleague

Keep the week, job and list source together with the execution ID. If a manager asks about a missing report, your colleague can find the run and check the list it was meant to use.

  
Your next step

Let the meeting begin with everyone’s report ready

Return to Monday’s meeting. The new manager has the weekly PDF, the departing colleague is no longer on the list, and nobody has asked you to forward another copy. The report and the people receiving it are being looked after in the places your team has agreed to maintain.

Start with one recurring delivery and the list you already use. It may be an email group, a workbook or a query from your business system. Decide whether everyone needs the same document or their own version, then use that example to evaluate PBRS.

The Power BI report automation page explains how the report preparation and delivery fit together. To plan your first list-based delivery, explore PBRS report distribution.
Plan your report distribution

Contributors:

Christian Ofori-Boateng

Christian Ofori-Boateng

CEO, ChristianSteven Software