Skip to content

Commit

Permalink
Release/3 12 0 (#74)
Browse files Browse the repository at this point in the history
* Added documentation for DAX query window

* Fixes to doc

* Added docs for the new apply options in DAX query

* Remove WIP from user interface doc

* 3.12.0 release notes and links updates

* Add blog and fix mistake in Whats new

* Update language in 3.12.0 whats new

* Fix

* updated release notes

* Updated links

* updated dates

---------

Co-authored-by: Morten Lonskov <[email protected]>
  • Loading branch information
otykier and mlonsk authored Nov 27, 2023
1 parent 7018707 commit 8228247
Show file tree
Hide file tree
Showing 11 changed files with 153 additions and 10 deletions.
2 changes: 1 addition & 1 deletion _site/staticwebapp.config.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"routes": [
{
"route": "/te3/other/release-notes",
"redirect": "/te3/other/release-notes/3_11_0.html",
"redirect": "/te3/other/release-notes/3_12_0.html",
"statusCode": 301
},
{
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified images/features/dax_query_window/dax_query_toolbar.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
27 changes: 27 additions & 0 deletions te3/features/dax-query.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,33 @@ The DAX query window has four different query options.

The Auto Execute Query allows for keeping track of the connected semantic model and update the query results whenever something changes in the model. This can be useful for understanding e.g. how the result of a measure changes if modified.

### Adding or Updating Measures with DAX Queries

Tabular Editor (3.12.0 and higher) has the ability to add or change measures directly through the DAX Query window.

In addition to the above mentioned options four other have been introduced.

![Dax Query New](~/images/features/dax_query_window/dax_query_apply_measure.png)

The "Apply" option sync the DAX expression for all measures explicitly defined in the query, to the definition of the measures. Any measures that do not already exist, are created.

"Apply Measures & Sync" applies the DAX expression to the definition of the measures and saves the model.

The "Apply Selection" and "Apply Selection & Sync" will only apply the measures within the current selection of the query editor.

Unlike the [DAX Script feature](xrefid:dax-scripts), only the expression property of a measure can be updated this way, as the DAX query syntax does not support specifying other properties, such as Description, Display Folder, etc.

The "Apply" option has also been added to the right-click context menu.

![Dax Query New](~/images/features/dax_query_window/dax_query_apply_measure_right_click.png.png)

The shortcuts for these commands are:

- Apply (F7)
- Apply Measures & Sync (Shift+F7)
- Apply Selection (F8)
- Apply Selection and Synch (Shift F7)

## DAX Query Example

A DAX query always return a table of results, and the simplest form of DAX query to create is one that evaluates a table within the model.
Expand Down
2 changes: 1 addition & 1 deletion te3/features/user-interface.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ For the vector based themes (Basic and Bezier), use the **Window > Palette** men

# Menus

The following section describes the menus in Tabular Editor 3 in more details (WIP).
The following section describes the menus in Tabular Editor 3 in more details.

We use the term **Active document** in the following section, to mean that the cursor is placed within a document such as the Expression Editor or the "DAX Script 1" tab in the screenshot below. Some keyboard shortcuts and menu items behave differently depending on whether there is an active document or not, and what type of document is active.

Expand Down
19 changes: 13 additions & 6 deletions te3/other/downloads.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,20 @@
uid: downloads
title: All downloads
author: Daniel Otykier
updated: 2023-09-25
updated: 2023-11-27
---
# Tabular Editor 3 Downloads

This page provides download and installation instructions for Tabular Editor 3.

## Production builds

- Latest production release (x64): [TabularEditor.3.11.0.Installer.x64.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.Installer.x64.exe)
- Latest production release (x86): [TabularEditor.3.11.0.Installer.x86.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.Installer.x86.exe)
- Portable version: [TabularEditor.3.11.0.x64.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.x64.zip), [TabularEditor.3.11.0.x86.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.x86.zip)
- MSI version: [TabularEditor.3.11.0.x64.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.x64.msi), [TabularEditor.3.11.0.x86.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.x86.msi)
- Latest production release (x64): [TabularEditor.3.12.0.Installer.x64.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x64.exe)
- Latest production release (x86): [TabularEditor.3.12.0.Installer.x86.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x86.exe)
- Portable version: [TabularEditor.3.12.0.x64.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.zip), [TabularEditor.3.12.0.x86.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.zip)
- MSI version: [TabularEditor.3.12.0.x64.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.msi), [TabularEditor.3.12.0.x86.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.msi)

Read the [latest release notes](release-notes/3_11_0.md).
Read the [latest release notes](release-notes/3_12_0.md).

## Installation Instructions

Expand All @@ -27,6 +27,13 @@ It is not necessary to remove previous installations when upgrading to a newer v

## History

- 2023-12-27 **Tabular Editor 3.12.0** (*[Release notes](release-notes/3_12_0.md)*)
- [TabularEditor.3.12.0.Installer.x64.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x64.exe)
- [TabularEditor.3.12.0.Installer.x86.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x86.exe)
- [TabularEditor.3.12.0.x64.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.zip)
- [TabularEditor.3.12.0.x86.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.zip)
- [TabularEditor.3.12.0.x64.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.msi)
- [TabularEditor.3.12.0.x86.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.msi)
- 2023-09-25 **Tabular Editor 3.11.0** (*[Release notes](release-notes/3_11_0.md)*)
- [TabularEditor.3.11.0.Installer.x64.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.Installer.x64.exe)
- [TabularEditor.3.11.0.Installer.x86.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.Installer.x86.exe)
Expand Down
14 changes: 14 additions & 0 deletions te3/other/release-history.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,19 @@
# Full release history

- 2023-12-27 **Tabular Editor 3.12.0** (*[Release notes](release-notes/3_12_0.md)*)
- [TabularEditor.3.12.0.Installer.x64.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x64.exe)
- [TabularEditor.3.12.0.Installer.x86.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x86.exe)
- [TabularEditor.3.12.0.x64.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.zip)
- [TabularEditor.3.12.0.x86.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.zip)
- [TabularEditor.3.12.0.x64.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.msi)
- [TabularEditor.3.12.0.x86.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.msi)
- 2023-09-25 **Tabular Editor 3.11.0** (*[Release notes](release-notes/3_11_0.md)*)
- [TabularEditor.3.11.0.Installer.x64.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.Installer.x64.exe)
- [TabularEditor.3.11.0.Installer.x86.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.Installer.x86.exe)
- [TabularEditor.3.11.0.x64.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.x64.zip)
- [TabularEditor.3.11.0.x86.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.x86.zip)
- [TabularEditor.3.11.0.x64.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.x64.msi)
- [TabularEditor.3.11.0.x86.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.11.0.x86.msi)
- 2023-08-30 **Tabular Editor 3.10.1** (*[Release notes](release-notes/3_10_1.md)*)
- [TabularEditor.3.10.1.Installer.x64.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.10.1.Installer.x64.exe)
- [TabularEditor.3.10.1.Installer.x86.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.10.1.Installer.x86.exe)
Expand Down
94 changes: 94 additions & 0 deletions te3/other/release-notes/3_12_0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
---
uid: release-3-12-0
---
# Tabular Editor 3.12.0

# [**Downloads**](#tab/downloads)

Tabular Editor 3.12.0 downloads:

- Download [Tabular Editor 3.12.0 (64 bit)](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x64.exe) *(recommended)*
- Download [Tabular Editor 3.12.0 (32 bit)](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x86.exe)
- Portable versions: [x64](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.zip), [x86](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.zip)
- MSI version: [x64](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.msi), [x86](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.msi)

*If you haven't used Tabular Editor 3 before, you are eligible to a 30 day trial, which can be requested after installation. You can also [purchase a license](https://tabulareditor.com/licensing).*

# [**SHA-256 checksums**](#tab/checksums)

| File | SHA-256 |
| -- | -- |
| [TabularEditor.3.12.0.Installer.x64.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x64.exe) | `EF139EA10FF8D7376B36C505778F4030BF5FE5D4B4976DA6EBA4E594C857CAA4` |
| [TabularEditor.3.12.0.x64.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.msi) | `12691A728D51D9CA27AEB5D99B8C8C5BC820633AFD1521DDE5AA7CFC7B5C1798` |
| [TabularEditor.3.12.0.x64.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x64.zip) | `852F233CEA4724DA492ADD66FB5D1DF5BB6722D08BC04AC35AB37B71255C520F` |
| [TabularEditor.3.12.0.Installer.x86.exe](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.Installer.x86.exe) | `83CD723B477421834AA640C01887AFC530366E321263E8929D3D12FB77713BB8` |
| [TabularEditor.3.12.0.x86.msi](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.msi) | `772C7BBA32F5603D51CD16DFB71E0D9CF56D33F34C3FB2E6B99FFDAB018A8CD5` |
| [TabularEditor.3.12.0.x86.zip](https://cdn.tabulareditor.com/files/TabularEditor.3.12.0.x86.zip) | `94CA188CCCF73FC11CCF1862BE68C69475EE7EDAB9C4C03F5DEA25693BF4AE7D` |

***

### Prerequisites

Tabular Editor 3.3.0 (and newer) uses .NET 6. You may have to install the [.NET 6.0 Runtime for Desktop](https://dotnet.microsoft.com/en-us/download/dotnet/6.0/runtime) before you can launch Tabular Editor 3.3.0 (or newer). Starting from 3.3.1, the Tabular Editor 3 installer will download and install these prerequisites, if they are missing.

## New in 3.12.0

Check out our [release blog](https://blog.tabulareditor.com/2023/11/27/tabular-editor-3-november-2023-release) to get a brief overview of the most important updates in this release.

- Tabular Editor now displays a "What's New" page when the application is updated. The page informs you of new Tabular Editor features, along with community updates and other relevant news for Tabular Editor users. If the page is hidden, you can access it from the **Help > What's New**. You can disable this feature by unchecking **Tools > Preferences > Updates and Feedback > Show "What's New" page on startup**.
- When prototyping new measures, it is quite common to specify them within the `DEFINE` block of a DAX query. In this update, we've added an easy way to create/update model measures based on measures defined within the DAX query. On the toolbar, through the **Query** menu, and through the right-click context menu of the DAX query editor, you will see 4 new options light up, which work very similarly to the "Apply" actions in [DAX Scripts](https://docs.tabulareditor.com/te3/features/dax-scripts.html#shortcuts), with the exception that only a measures' name and expression is applied (since it's not possible to specify other properties like Description, Display Folder, etc. through a DAX query). More details in the [blog post](https://blog.tabulareditor.com).
- Please be aware that we're now using a new certificate to sign the binaries, in case your IT organization needs to expclitly approve 3rd party code certificates. The new certificate is issued by [GlobalSign GCC](https://www.globalsign.com/en) and the certificate is issued directly to [Tabular Editor ApS](https://tabulareditor.com/contact).

## Improvements in 3.12.0

- We have hidden the special RowNumber column from the various VertiPaq Analyzer views, to align with other tools (DAX Studio, DAX Optimizer, etc.).
- AMO/TOM has been updated to [19.69.6.2](https://www.nuget.org/packages/Microsoft.AnalysisServices.NetCore.retail.amd64), meaning Tabular Editor 3 now supports the latest data modelling features. For example, we now support the `Model.DirectLakeBehavior` property, letting you control whether DirectQuery fallback on DirectLake models should occur or not.
- TMDL has also been updated to the [latest version](https://www.nuget.org/packages/Microsoft.AnalysisServices.Tabular.Tmdl.NetCore.retail.amd64/19.69.6.2-TmdlPreview).

> [!NOTE]
> **TMDL is still in preview and should not be used in production.** We're aware of a deserialization issue in AMO/TOM 19.69.6.2, when a table has an incremental refresh policy applied. This will be fixed in the next release of AMO/TOM.
- You can now create BPA rules that inspect DAX tokens returned from the [`IDaxDependantObject.Tokenize()`](https://docs.tabulareditor.com/api/TabularEditor.TOMWrapper.Utils.DaxDependencyHelper.html#TabularEditor_TOMWrapper_Utils_DaxDependencyHelper_Tokenize_TabularEditor_TOMWrapper_IDaxDependantObject_) method, the same way as in TE2.
- We now show a warning in the DAX editor, when a variable is declared but never used. See [#934](https://github.com/TabularEditor/TabularEditor3/issues/934). Such variables should generally be removed to keep your DAX tidy.
- When importing tables or updating table schema from a T-SQL source, where the partition references a Stored Procedure, we now provide an option to execute the Stored Procedure, in cases where the resulting schema cannot be statically determined. This can happen, for example, when the stored procedure uses temp tables. The user is always prompted with an option to cancel the operation, before the stored procedure is executed.
- Tabular Editor now allows importing tables from Snowflake using Native Query, see [#949](https://github.com/TabularEditor/TabularEditor3/issues/949). **Note:** For this option to be available, you must specify a database name in the Snowflake connection dialog.
- You can now refresh individual tables or partitions in Direct Lake mode (this operation is also known as ["framing"](https://github.com/TabularEditor/TabularEditor3/issues/999)).
- Adding tables to a model in Direct Lake mode, will no longer prompt you for the type of partition to create (defaulting to an Entity Partition in Direct Lake mode).

## Bugfixes in 3.12.0

- Fixed an issue where the **Rename Variable** context menu option would not always be available, see [#692](https://github.com/TabularEditor/TabularEditor3/issues/692).
- Fixed an issue where username/passwords were not properly persisted for ODBC data connections. Tabular Editor will now prompt if the ODBC credentials are missing.
- Fixed an issue where a Snowflake DSI ODBC connection string was not generated correctly, see [#993](https://github.com/TabularEditor/TabularEditor3/issues/993).
- When Tabular Editor generates T-SQL during table import/schema updates, we no longer use the `IIF` keyword, since this is not supported on Azure Synapse (dedicated SQL pools), see [#1007](https://github.com/TabularEditor/TabularEditor3/issues/1007).
- When Tabular Editor generates the deployment TMSL script, we now automatically add a dummy partition to tables governed by incremental refresh, in case no partitions have been defined (otherwise, deployment would fail).
- The Best Practice Analyzer should now gracefully handle BPA rules where the rule expression itself has an error (just like TE2).
- Fixed an issue where the **Last accessed** column of VertiPaq Analyzer did not show correct info.
- Fixed a minor glitch with VertiPaq Analyzer buttons not indicating correct state.
- Emojis in the DAX editor should no longer cause random crashes, although auto-complete, auto-formatting, etc. will still not work.
- Fixed an issue where setting the OLS Column Permission to "None" would cause the TOM Explorer to lock up.
- Fixed a glitch in the "Save as Macro" dialog, which could cause a crash in some cases.
- M partitions containing a comment on the last line should no longer produce an error when performing a schema update through Analysis Services/Power BI, see [#1167](https://github.com/TabularEditor/TabularEditor3/issues/1167).
- The auto-complete popup should now have a suitable width on its first appearance, see [#1152](https://github.com/TabularEditor/TabularEditor3/issues/1152).

---
## Coming from Tabular Editor 2.x?

Watch [this video](https://www.youtube.com/watch?v=pt3DdcjfImY) to get an idea of the new features in Tabular Editor 3. Also, make sure to check our [onboarding guide](https://docs.tabulareditor.com/onboarding/index.html).

**Tabular Editor 3 major features overview:**
- Fully customizable IDE, with multi-monitor, Hi-DPI support and themes
- New powerful DAX code editor with auto-complete, syntax checking, code folding and much, much more
- *Workspace mode, allowing you to save your changes to disk and synchronise model metadata to Analysis Services simultaneously
- *Preview table data with infinite scrolling, create PivotGrids or write DAX queries to browse the model or test calculation logic
- *Schedule data refreshes
- Update Table Schemas on both Provider and Structured Data Sources (yes, even for M queries!)
- Create data model diagrams
- Create DAX scripts that allow you to edit multiple measures or other calculated objects in a single document
- Record C# scripts and save as macros (formerly known as "Custom Actions")
- VertiPaq Analyzer integration
- DAX debugger

*=Only while connected to an instance of Analysis Services or Power BI

---
4 changes: 2 additions & 2 deletions whats-new/3-12-0.html
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ <h2>Tabular Editor 3.12.0</h2>
<ul>
<li>We now have this <b>What's New'</b> page, to keep you informed of the latest Tabular Editor news and updates</li>
<li>Add/update measures directly from the <code>DEFINE</code>-section of your DAX queries</li>
<li>Updated AMO/TOM to 19.69.6.2, which adds support for the <code>DirectLakeBehavior</code> model property</li>
<li>DAX editor improvements</li>
<li>Updated AMO/TOM which adds support for the new Fabric <code>DirectLakeBehavior</code> model property</li>
<li>DAX editor improvements to e.g. show warnings with unused variables</li>
<li>Snowflake and ODBC table import/schema update improvements</li>
<li>Better handling of T-SQL Stored Procedures in table partitions, when the table schema can't be statically determined'</li>
<li><a href="https://docs.tabulareditor.com/te3/other/release-notes">And more...</a></li>
Expand Down
1 change: 1 addition & 0 deletions whats-new/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -110,6 +110,7 @@ <h2>Community</h2>
<p>Ask questions, suggest enhancements and help other TE fans get their answers at our <a href="https://github.com/TabularEditor/TabularEditor3/discussions"> GitHub community</a>:</p>
<h3>Articles</h3>
<ul>
<li><a href="https://blog.tabulareditor.com/2023/11/17/semantic-models-in-simple-terms/">Semantic models in simple terms</a></li>
<li><a href="https://blog.tabulareditor.com/2023/09/27/ci-cd-scripts-for-tabular-editor-2s-cli/">CI/CD scripts for Tabular Editor</a></li>
<li><a href="https://www.oliviervs.be/analysis-services/sortbycolumn-property-set-to-an-invalid-column-id/">SortByColumn property set to an invalid column ID</a> by Oliver Van Steenlandt</li>
<li><a href="https://github.com/PowerBI-tips/TabularEditor-Scripts">Tabular Editor scripts</a> by <a href="https://powerbi.tips">PowerBI.tips</a></li>
Expand Down

0 comments on commit 8228247

Please sign in to comment.