From b08d7723532a7d7bbc6fcba0279546a0f6b6f361 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Morten=20L=C3=B8nskov?= Date: Thu, 21 Nov 2024 10:17:45 +0100 Subject: [PATCH] Update Roadmap, XLMA Workaround & TMDL overview (#128) * Update the workaorund to include a specification of how to use TMDL instead of the .bim file * Update roadmap and remove references to TMDL preview --------- Co-authored-by: Daniel Otykier --- te3/features/tmdl.md | 15 ++++----------- te3/other/roadmap.md | 26 +++++++++++++++++++------- te3/powerbi-xmla-pbix-workaround.md | 8 ++++++-- 3 files changed, 29 insertions(+), 20 deletions(-) diff --git a/te3/features/tmdl.md b/te3/features/tmdl.md index 9686ae2f..d6bd1207 100644 --- a/te3/features/tmdl.md +++ b/te3/features/tmdl.md @@ -14,16 +14,9 @@ applies_to: **TMDL** is a model metadata file format [announced by Microsoft in April 2023](https://powerbi.microsoft.com/en-ie/blog/announcing-public-preview-of-the-tabular-model-definition-language-tmdl/). It aims to provide a human-readable, text-based alternative to the JSON-based model.bim file format. TMDL is inspired by YAML, and as such, is easy to read and write, with minimal use of string quotes and escape characters. It also serializes a model as several smaller files in a folder structure, and is therefore also better suited for version control integration. -> [!IMPORTANT] -> As of February 2024, TMDL is still a preview feature. It is currently only supported by community tools such as Tabular Editor and [pbi-tools](https://pbi.tools/). However, the format is fully documented and available through [Microsoft-provided nuget packages](https://www.nuget.org/packages/Microsoft.AnalysisServices.Tabular.Tmdl.retail.amd64/19.64.0-TmdlPreview). +## Enabling TMDL in Tabular Editor 3 -> [!TIP] -> Since TMDL is a preview feature, breaking changes could be introduced between new releases of Tabular Editor. If you face any issues deserializing a model after upgrading Tabular Editor, rollback to the latest version of Tabular Editor, then temporarily save the model as a regular .bim file, before serializing it to TMDL again using the latest version of Tabular Editor. - - -## Enabling TMDL (Preview) in Tabular Editor 3 - -TMDL is only available as a preview feature in Tabular Editor 3. To enable TMDL (Preview) in Tabular Editor 3, go to **Tools > Preferences > File Formats > Save-to-folder**, and select "TMDL (preview)" in the **Serialization mode** dropdown. The legacy "save-to-folder" functionality will continue to exist side by side with TMDL, but is not a Microsoft supported format. +To enable TMDL in Tabular Editor 3, go to **Tools > Preferences > File Formats > Save-to-folder**, and select "TMDL" in the **Serialization mode** dropdown. The legacy "save-to-folder" functionality will continue to exist side by side with TMDL, but is not a Microsoft supported format. After doing so, Tabular Editor 3 will use the TMDL format when saving a model as a folder (**File > Save to folder...**). @@ -38,5 +31,5 @@ When saving a new model for the first time, Tabular Editor (since v. 3.7.0), wil # Next steps -- [TMDL overview (Microsoft Learn)](https://learn.microsoft.com/en-us/analysis-services/tmdl/tmdl-overview?view=asallproducts-allversions). -- [Get started with TMDL (Microsoft Learn)](https://learn.microsoft.com/en-us/analysis-services/tmdl/tmdl-how-to?view=asallproducts-allversions) +- [TMDL overview (Microsoft Learn)](https://learn.microsoft.com/en-us/analysis-services/tmdl/tmdl-overview). +- [Get started with TMDL (Microsoft Learn)](https://learn.microsoft.com/en-us/analysis-services/tmdl/tmdl-how-to) diff --git a/te3/other/roadmap.md b/te3/other/roadmap.md index 30dcb0c7..6c3501ac 100644 --- a/te3/other/roadmap.md +++ b/te3/other/roadmap.md @@ -8,13 +8,13 @@ updated: 2024-09-06 Below is an overview of major new features to be shipped with Tabular Editor 3 updates in the short- to long term: + + # [Planned 2024](#tab/PlannedQ4) -- More Daxscilla code refactoring options and automatic suggestions (for example, replace identical subexpressions with -a variable) -- TMDL GA Support -- Diagram Improvements -- GA of DAX Optimizer Integration +- Data Refresh View Improvements +- Power Query (M) Highlighting + ## Shipped in 2024 ✅ DAX Debugger Locals Enhancement @@ -23,14 +23,26 @@ a variable) ✅ .Net 8 migration ✅ Pivot Grid Enhancement ✅ DAX Query Enhancement +✅ TMDL GA Support +✅ Code Actions +✅ GA of DAX Optimizer Integration + +# [Planned 2025](#tab/Planned2025) +- Adding more Macro Actions +- Built in Best Practice Rules +- Built in Macros +- Power Query (M) Auto-Formatting # [Future Features](#tab/FutureFeatures) +## Up Next +- Localization +- Power Query (M) Editing Enchantments +- Macro Actions improvements such as automatic application across model and preferences for which to apply. ## Non Planned Features -- Localization -- Built in Macros and Best Practice Rules + - Standalone CLI application - Git integration - DAX Debugger Filter Context visualizer diff --git a/te3/powerbi-xmla-pbix-workaround.md b/te3/powerbi-xmla-pbix-workaround.md index ebb7234a..340ab2a4 100644 --- a/te3/powerbi-xmla-pbix-workaround.md +++ b/te3/powerbi-xmla-pbix-workaround.md @@ -44,10 +44,14 @@ In Tabular Editor using _File > Save as..._, navigate to the Power BI Project fo This will save the remote model into the Power BI Project that will now contain the model metadata. +If the .pbip folder is configured to store the model as [TMDL](xref:tmdl) files, you will need to use the Save To Folder option in Tabular Editor instead. Then navigate to the Power BI project folder for the semantic model (ModelName.SemanticModel), open the 'definition' folder and save your model there. + +> [!NOTE] +> To enable TMDL go to **Tools > Preferences > File Formats > Save-to-folder**, and select "TMDL" in the **Serialization mode** dropdown. See [TMDL documentation for more information](xref:tmdl) + ## Step 3.1: Remove incremental refresh partitions and create new (Optional) Use the Convert Incremental Refresh script below to delete incremental refresh partitions and create a single partition for each table containing the expression used in the incremental refresh expression. - ## Step 4: Save to .pbix and open this file in Power BI Desktop ![PBIP with Tables](~/images/power-bi/pbip-includes-tables.png) @@ -60,7 +64,7 @@ Save it to a .pbix using _File > Save As..._ in Power BI Desktop. The .pbix now contains the model that was published to the Fabric workspace. When you open the .pbix, you can _re-hydrate_ the file, meaning that you load the data based on the connections specified in the model. ## Convert Incremental Refresh partitions -The above step 4 will fail if the semantic model has incremental refresh enabled as a Power BI desktop model cannot contain multiple partitions. +The above step 4 will fail if the semantic model has incremental refresh enabled as a Power BI desktop model cannot contain multiple partitions. In this case the following script should be run against the model to convert incremental refresh partitions into single partitions