Switch PBI reports to TMDL (#763)

microsoft · Jun 24, 2024 · 1e9ce50 · 1e9ce50
1 parent fa446df
commit 1e9ce50
Show file tree

Hide file tree

Showing 39 changed files with 11,983 additions and 15,625 deletions.
diff --git a/docs/_resources/changelog.md b/docs/_resources/changelog.md
@@ -88,6 +88,10 @@ Legend:
 >
 > 1. Renamed the "Commitment discounts" report to "Rate optimization" to align to the FinOps Framework 2024 updates.
 > 2. Changed the **Tags** column to default to `{}` when empty to facilitate tag expansion ([#691](https://github.com/microsoft/finops-toolkit/issues/691#issuecomment-2134072033)).
+> 3. Changed internal storage for reports to use [Tabular Model Definition Language (TMDL)](https://learn.microsoft.com/power-bi/developer/projects/projects-dataset#tmdl-format).
+>    - This change makes it easier to review changes to the data model in Power BI.
+>    - Reports will still be released as PBIX files so this change should not impact end users.
+>    - Visualizations are not being switched to [Power BI Enhanced Report (PBIR)](https://learn.microsoft.com/power-bi/developer/projects/projects-report#pbir-format) format yet due to functional limitations that would impact end users (as of June 2024).
 
 🌐 Open data
 {: .fs-5 .fw-500 .mt-4 mb-0 }

diff --git a/src/power-bi/DataIngestion.Report/report.json b/src/power-bi/DataIngestion.Report/report.json
@@ -108,7 +108,7 @@
           "z": 1000.00
         },
         {
-          "config": "{\"name\":\"907968064288c59539c5\",\"layouts\":[{\"id\":0,\"position\":{\"x\":16,\"y\":16,\"z\":0,\"width\":1264,\"height\":96,\"tabOrder\":5000}}],\"singleVisual\":{\"visualType\":\"textbox\",\"drillFilterOtherVisuals\":true,\"objects\":{\"general\":[{\"properties\":{\"paragraphs\":[{\"textRuns\":[{\"value\":\"Data ingestion report\",\"textStyle\":{\"fontWeight\":\"bold\",\"fontSize\":\"42pt\"}},{\"value\":\"   v24.06.22\",\"textStyle\":{\"color\":\"#808080\"}}]}]}}]},\"vcObjects\":{\"visualHeader\":[{\"properties\":{\"show\":{\"expr\":{\"Literal\":{\"Value\":\"false\"}}}}}],\"background\":[{\"properties\":{\"show\":{\"expr\":{\"Literal\":{\"Value\":\"false\"}}}}}]}}}",
+          "config": "{\"name\":\"907968064288c59539c5\",\"layouts\":[{\"id\":0,\"position\":{\"x\":16,\"y\":16,\"z\":0,\"width\":1264,\"height\":96,\"tabOrder\":5000}}],\"singleVisual\":{\"visualType\":\"textbox\",\"drillFilterOtherVisuals\":true,\"objects\":{\"general\":[{\"properties\":{\"paragraphs\":[{\"textRuns\":[{\"value\":\"Data ingestion report\",\"textStyle\":{\"fontWeight\":\"bold\",\"fontSize\":\"42pt\"}},{\"value\":\"   v24.06.24\",\"textStyle\":{\"color\":\"#808080\"}}]}]}}]},\"vcObjects\":{\"visualHeader\":[{\"properties\":{\"show\":{\"expr\":{\"Literal\":{\"Value\":\"false\"}}}}}],\"background\":[{\"properties\":{\"show\":{\"expr\":{\"Literal\":{\"Value\":\"false\"}}}}}]}}}",
           "filters": "[]",
           "height": 96.00,
           "width": 1264.00,

diff --git a/src/power-bi/README.md b/src/power-bi/README.md
@@ -2,11 +2,27 @@
 
 On this page:
 
+- [� Prerequisites](#-prerequisites)
 - [📐 Design guidelines](#-design-guidelines)
 - [ℹ️ Cost Management template app](#ℹ️-cost-management-template-app)
 
 ---
 
+## 📋 Prerequisites
+
+Power BI reports use [Tabular Model Definition Language (TMDL)](https://learn.microsoft.com/power-bi/developer/projects/projects-dataset#tmdl-format), which is currently a preview. Before you can open reports, you will need to enable the **** preview.
+
+1. Open Power BI
+2. Select **File** > **Options and settings** > **Options** > **Global** > **Preview features**
+3. Enable the following features:
+   1. Power BI Project (.pbip) save option
+   2. Store semantic model using TMDL format
+4. **DO NOT** enable the "Store reports using enhanced metadata format (PBIR)"
+5. Select the **OK** button to save settings
+6. Restart Power BI
+
+<br>
+
 ## 📐 Design guidelines
 
 Power BI reports in the FinOps toolkit must adhere to the following guidelines: