From 9bc93c49a62b50d29d33f0700f8ecfa58342c893 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Morten=20L=C3=B8nskov?= Date: Mon, 5 Feb 2024 09:38:47 +0100 Subject: [PATCH] Add Tips (#87) * Add important notice around how to roll back and forth between TMDL versions * Add tip about deleting Layout file. * Update tmdl.md --------- Co-authored-by: Daniel Otykier --- te3/features/supported-files.md | 6 ++++-- te3/features/tmdl.md | 8 ++++++-- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/te3/features/supported-files.md b/te3/features/supported-files.md index 416fca4d..8d9c1e79 100644 --- a/te3/features/supported-files.md +++ b/te3/features/supported-files.md @@ -210,5 +210,7 @@ You can download the official Microsoft BPA rules here: [PBA Rules](https://raw. Contains all the servers a user has been connected to. It can be advisable to edit it manually to 'forget' past servers no longer relevant. ### Layouts.json -The Layouts file is automatically generated by Tabular Editor when starting the application. -If the Tabular Editor layout does not behave as expected a good first step is to backup this file somewhere else, delete the original and restart Tabular Editor 3. +The Layouts file is automatically generated by Tabular Editor when starting the application. It contains all information to how Tabular Editor 3's UI layout is configured. + +> [!TIP] +> Deleting this file will reset Tabular Editor's layout. If the Tabular Editor layout does not behave as expected a good first step is to backup this file somewhere else, delete the original and restart Tabular Editor 3. diff --git a/te3/features/tmdl.md b/te3/features/tmdl.md index 870bc123..45e11fad 100644 --- a/te3/features/tmdl.md +++ b/te3/features/tmdl.md @@ -15,7 +15,11 @@ 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 May 2023, 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). +> 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). + +> [!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 @@ -35,4 +39,4 @@ 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) \ No newline at end of file +- [Get started with TMDL (Microsoft Learn)](https://learn.microsoft.com/en-us/analysis-services/tmdl/tmdl-how-to?view=asallproducts-allversions)