Skip to content
vScope Support Page

Connect the vScope Power BI Template App to your vScope data

Prerequisites

Section titled “Prerequisites”
  • A vScope instance URL, for example https://yourcompany.vscope.net
  • A valid vScope API token
  • Permission to view the vScope tables you want to use
  • A Power BI account with access to template apps

Install the template app

Section titled “Install the template app”
  1. Open the app in Microsoft AppSource: vScope Power BI Template App.
  2. Select Get it now.
  3. Install the app in your Power BI workspace.

Choose data mode

Section titled “Choose data mode”

Path A: Use sample data

Section titled “Path A: Use sample data”
  1. Open the installed app.
  2. Keep the default parameter values.
  3. Select Connect.

Result: The report loads with sample data.

Path B: Use live vScope data

Section titled “Path B: Use live vScope data”
  1. Open the installed app.
  2. Select Connect your own data.
  3. Enter the required parameters.
ParameterValue
BaseURLYour vScope URL, for example https://yourcompany.vscope.net
APIKeyYour vScope API token
  1. For authentication, choose Anonymous and do not enter username/password credentials.
  2. Select Connect.

Result: The report loads with data from your vScope tables.

Add another vScope table

Section titled “Add another vScope table”
  1. In vScope, create and save a table in Table Explorer.
  2. Open the table and copy its ID from the permalink/collaborators link.
  3. In Power BI Desktop, duplicate an existing query in the template and edit the columns so it matches yours in the report.
  4. Create a paramter named TableID_YourReportName and add your TableID.
  5. Refresh the dataset.

Result: The new dataset is available in the report model.

Troubleshooting

Section titled “Troubleshooting”

No data appears

Section titled “No data appears”
  • Verify BaseURL, APIKey, and all TableID_* values.
  • Confirm the token user has access to each table.
  • Confirm authentication is set to Anonymous.

Parameter or credential errors

Section titled “Parameter or credential errors”
  • Reopen dataset settings and verify all parameter names and values.
  • Remove old saved credentials for the source and reconnect.

Data shape changed after table edits

Section titled “Data shape changed after table edits”
  • If table columns changed in vScope, update related Power Query steps.
  • Refresh the semantic model after query updates.
Section titled “Related guides”