Power BI LabReport assurance
Contents
Documentation

Getting started

Start testing Power BI reports: sign in, connect Power BI, create your first test package and approve your first baseline.

What Power BI Lab does

Power BI Lab checks your Power BI reports before your users open them. You choose report pages and the checks to run on them; Power BI Lab opens each page the way a reader would and records what it finds.

A test package is one report with the pages to test and the checks for each page. Packages are kept in suites, folders that group them, for example by team or by business area. Each time a package runs, manually or on a schedule, the result is a run with its evidence: screenshots, timings and a log.

Sign in and your organization

Sign in with your Microsoft work account: Start a trial on the home page, or open the console. Everyone from the same Microsoft organization works in one Power BI Lab organization and sees the same suites, runs and settings.

The first person to sign in becomes its owner. Colleagues join as viewers the first time they sign in; an owner or admin then gives them the role they need (see Roles).

Invited by another organization? Open the invitation link in a browser where you are not signed in as someone else, for example a private window, and sign in with the account it was sent to. You then belong to both organizations and switch between them in the account menu at the bottom of the sidebar.

Invited without a Microsoft work account? On the sign-in page, enter the email address the invitation was sent to and use the link that arrives: it works once, for 15 minutes. If you later sign in with a Microsoft account of the same email, it keeps your organizations.

If Microsoft asks for admin approval when you sign in or connect Power BI, your organization allows its users to approve only apps of verified publishers. An administrator of your Microsoft organization can approve Power BI Lab once for everyone, or let users approve it themselves.

Connect Power BI

Runs read your reports through Power BI, with one of two connections:

Connect as me
Your own Power BI access, from Settings › Profile. Test packages you save run with your permissions, scheduled runs included. Reports in My workspace need this connection.
Organization connection
A service principal that an admin adds in Settings › Organization, for suites that should not depend on one person (see Add the organization connection). It also reads the Power BI inventory for Insights.

A package runs with the access of whoever saved it: their Connect as me sign-in when they had one, otherwise the organization connection. Both run every check, screenshots included.

Connect as me always uses your own Microsoft organization's Power BI, also while you work in an organization that invited you.

Microsoft ends a Connect as me sign-in after a long time without use. The sidebar then shows Power BI sign-in expired and, when the server sends email, you get an email about it once: connect again from your profile, or scheduled runs of your packages fail.

Create your first test package

  1. 1Open Suites › New test package.
  2. 2Power BI connection shows which access the package will use.
  3. 3Workspace and report: choose the workspace, then the report.
  4. 4Pages: tick the pages to test. Preview shows a page next to the list, so you can check it is the right one.
  5. 5Checks: choose the checks to run on every page (see Checks). You can turn single checks off for a page later.
  6. 6Suite and schedule: put the package in an existing suite or name a new one, and choose whether it runs only manually or daily or weekly at a time in UTC.
  7. 7Save, or Save and run now to see the first result right away.

Approve your first baseline

Visual checks compare every run with an approved screenshot of the page, its baseline. The first run of a page has nothing to compare with, so its visual check is skipped with a screenshot to approve.

  1. 1Open the run, from Runs or from the package page.
  2. 2Choose the visual result of the page; its screenshot opens under Visual review.
  3. 3If the page looks right, select Approve as baseline. From the next run on, the page is compared with this screenshot.