Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Roadmap, XLMA Workaround & TMDL overview #128

Merged
merged 7 commits into from
Nov 21, 2024
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 1 addition & 8 deletions te3/features/tmdl.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,7 @@ 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).

> [!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
## Enabling TMDL 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.

Expand Down
26 changes: 19 additions & 7 deletions te3/other/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down
3 changes: 3 additions & 0 deletions te3/powerbi-xmla-pbix-workaround.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,9 @@ This will save the remote model into the Power BI Project that will now contain
## 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 3.2: Save into .pbip using TMDL
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if we should bring this section up to step 3? Just to avoid confusion if people already saved the model once as a model.bim as instructed above...

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@otykier Agreed, I have reworked Step 3.2. into step 3 and added a note about how to set save to folder as TMDL


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.

## Step 4: Save to .pbix and open this file in Power BI Desktop

Expand Down
Loading