Skip to content

BeSmarterWithData/ImpactIQ-Local

Repository files navigation

impact iq 16x9
Be smarter with every change

Local Edition

Local Impact Analysis and Governance for Power BI

This is the local edition. If looking for the version that leverages the Power BI + Fabric Service and REST API across all Workspaces, check out Impact IQ's One-Click, Designed for Everyone edition: https://github.com/BeSmarterWithData/ImpactIQ

  • All computer requirements are at the user level and do not require admin privileges.
  • There are ZERO pre-reqs. It's as simple as downloading this repo into C:\Power BI Backups, placing your local files in the dedicated folder, opening Powershell, and running the included 'Final PS Script'

What It Does

This provides a quick and automated way to identify where and how specific fields, measures, and tables are used across your local Power BI reports by analyzing the visual object layer. It also breaks down the details of your models and report for easy review, including full measure lineage, giving you an all-in-one Power BI Governance solution.

Key Features:

  • Impact Analysis: Fully understand the downstream impact of data model changes, ensuring you don’t accidentally break visuals or dashboards—especially when reports connected to a model span multiple workspaces.
  • Used and Unused Objects: Identify which tables, columns, and measures are actively used and where. Equally as important, see what isn't used and can be safely removed from your model to save space and complexity.
  • User-Friendly Output: Results are presented in a Power BI model, making them easy to explore, analyze, and share with your team.

✨ Recently Added Features

  • Unused Model Objects → Identify model fields/measures not used in any visuals, measures, calculated columns, or relationships.
  • Broken Visuals → See all broken visuals/filters.
  • Report-Level Measures Inventory → Surface report-only measures with full DAX and usage details.
  • New Report Layouts & Wireframe → See where your visuals sit on the page with a wireframe layout - thanks to @stephbruno for this feature!

🚀 Quick Start Instructions

You’ve got two ways to get started:


🟢 Option 1 — One-Click Update & Run Tool (Recommended)

Always up-to-date and the easiest way to get started.

➡️ Download One-Click Update & Run Tool

This automatically:

  1. Pulls the latest repo from GitHub
  2. Places it into C:\Power BI Backups
  3. Runs the Local Final PS Script
  4. Opens the Local Power BI Governance Model at the end

💡 Tip: Once downloaded, simply re-run this locally anytime to keep your governance details up-to-date and take advantage of the newest features.

⚠️ If security policies block the batch file, follow the manual steps below instead.

📂 All outputs and the final Local Power BI Governance Model will be saved to: C:\Power BI Backups


🟡 Option 2 — Manual Setup

✅ Step 1: Create Folder

Make a folder at C:\Power BI Backups

✅ Step 2: Download Repo files

Place all repo files into the created folder

✅ Step 3: Add your Reports/Models to 'Local Reports and Models' folder

Place all the reports/models you're looking to analyze within the 'Local Reports and Models' folder.

✅ Step 4: Run Script — open PowerShell and run the Final PS Script

You can:

  • Copy/paste the full script
  • Or rename it from .txt to .ps1 and run it directly

✅ Step 5: Open the Power BI File — let it refresh, then save as .pbix

Open: Local Power BI Governance Model.pbit


🎉 That’s it — enjoy! 🎉


ℹ️ Additional Notes

⚙️ PowerShell may prompt to install required modules.
No admin access is needed — they install at the user level.

🧰 This setup uses the portable version of Tabular Editor 2 (v2.27.2).
You don't need it preinstalled. It runs locally from the folder with no differences.
https://github.com/TabularEditor/TabularEditor (MIT License)

🧠 Model are extracted from the PBIX using pbi-tools
Includes pbi-tools v1.2: https://github.com/pbi-tools/pbi-tools (AGPL 3.0 License)

🚨 Using Tabular Editor 3?
Tabular Editor 2 is still included and required for this because TE3 doesn't support command line execution.

🧩 Model refresh error in Power BI Desktop?
If you see:
"Query XXXXXX references other queries or steps..."

Update your Power BI Desktop privacy settings:
File → Options and settings → Options → Privacy
Then select either:

  • “Combine data according to each file's Privacy Level settings”
    or
  • “Always ignore Privacy Level settings”

Features


1. Model Metadata Extract - Measure Lineage, Used/Unused Objects

  • Saves exported models in a structured folder hierarchy based on model names.
  • Leverages Tabular Editor 2 and C# to extract the metadata and output within an Excel File.

2. Report Metadata Extract - Impact Analysis, Objects Usage - Where and How Often

  • Leverages Tabular Editor 2 and C# to extract the Visual Object Layer metadata and output within an Excel File (credit to @m-kovalsky for initial work on this)

4. Final Power BI Governance Model

Screenshots of Final Output

.. ..

image image image image image

About

ImpactIQ - Local Edition. Power BI All-in-One solution for Extracting the Metadata from Local PBIX files to understand Impact Analysis and Governance across your reports and models.

Resources

Stars

Watchers

Forks

Contributors