Docs · Get started

Install the visuals

There are three ways to get a Grafpoint visual into a report. All three give you the same visual, and the free features work straight away.

Before the AppSource listing is liveThe visuals are on their way to AppSource. Until they are listed, use the .pbiviz files from the download page.

From AppSource

AppSource is Microsoft’s store for Power BI visuals. Visuals added from it update themselves.

  1. Open the report in Power BI Desktop, or in the Power BI service in edit mode.
  2. In the Visualizations pane, select … (Get more visuals) and then Get more visuals.
  3. Search for Grafpoint, pick a visual and select Add.
  4. The visual’s icon appears at the bottom of the Visualizations pane. Select it to add it to the page.

From a .pbiviz file

Use the file when AppSource is blocked in your organisation, for Power BI Report Server, or on a network with no internet access.

  1. Download the visual’s .pbiviz file from the download page.
  2. In the Visualizations pane, select … and then Import a visual from a file.
  3. Pick the .pbiviz file and confirm. The visual is now part of this report.

A visual imported from a file does not update itself. When we release a new version, import the new file again; reports keep their settings and licence key.

For the whole organisation

A Power BI or Fabric administrator can add a Grafpoint visual to the organisation’s own visuals, so every report creator finds it under My organization without importing anything.

  1. Open the Admin portal and go to Organizational visuals.
  2. Select Add visual, then From AppSource or From a file.
  3. From a file: pick the .pbiviz file, give the visual a name and leave Access on. Select Add.
  4. To put it in every creator’s Visualizations pane, select the visual in the list and then Enable for Visualization Pane. It then shows up next to the built-in visuals in Power BI Desktop and the service, with nothing to import.

An AppSource visual in the list updates itself. A visual added from a file does not: when we release a new version, select the visual, then Settings, Browse to the new file and Update. Reports keep their settings and licence key.

The licence key is saved in each report, so adding a visual for the whole organisation doesn’t unlock Pro by itself. Paste the key once in each report that uses Pro features.

If your tenant only allows certified visuals, the visual must be certified by Microsoft or added as an organisational visual. We are submitting every Grafpoint visual for certification; until then, adding it as an organisational visual is the way in.

Check it yourself

A .pbiviz file is a zip archive. Open it and read capabilities.json: the privileges list is empty, so Power BI would block any attempt to go online. More on the security page.

Next

Add your licence key to unlock Pro, or open the guide for your visual.