Skip to content

Commit

Permalink
Minor Fixes to Documentation (#83)
Browse files Browse the repository at this point in the history
* Added scripts links to references

* Clarification of XMLA warning

* Fixing broken link

* Moving user interface to view

* Clarifications to text

* Changing TOC so the fold outs function the same across sections

* Update csharp-script-library-beginner.md

fixed typos

* Update direct-lake-dataset.md

typos

---------

Co-authored-by: Daniel Otykier <[email protected]>
  • Loading branch information
mlonsk and otykier authored Jan 16, 2024
1 parent 2bff92f commit c621347
Show file tree
Hide file tree
Showing 8 changed files with 29 additions and 22 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@ author: Morten Lønskov
updated: 2023-11-29
applies_to:
versions:
- version: 2.x
- version: 3.x
---
# Format Numeric Measures
Expand Down
10 changes: 8 additions & 2 deletions common/CSharpScripts/csharp-script-library-beginner.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,13 @@ These are more basic scripts that are easy to understand or modify. They have a
| --- | --- | --- |
| [Count Table Rows](Beginner/script-count-rows.md) | Evaluates a COUNTROWS ( 'Table' ) of a selected table. | When you want to check how many rows are in a table, or if it's been loaded. |
| [Count Model Objects](Beginner/script-count-things.md) | Counts all the different objects by type in a model. | When you need an overview of the model contents or want to count objects by type. |
| [Create Sum Measures from Columns](Beginner/create-sum-measures-from-columns.md) | Create SUM ( 'Table'[Column] ) measures from any selected column. | When you have many columns in a new table / model and must make many measures at once. |
| [Create Sum Measures from Columns](Beginner/script-create-sum-measures-from-columns.md) | Create SUM ( 'Table'[Column] ) measures from any selected column. | When you have many columns in a new table / model and must make many measures at once. |
| [Create M Parameter](Beginner/script-create-m-parameter.md) | Create a new M Parameter in 'Shared Expressions' | When you want to create a parameter to use in other Power Query queries (M Partitions / Shared Expressions). |
| [Edit Hidden Partitions](Beginner/script-edit-hidden-partitions.md) | Reveals the properties of hidden partitions in Calc. Groups & Calc. Tables | When you need to see or edit the TOM properties of these hidden partitions. |
| [Find & Replace in Selected Measures](Beginner/script-find-replace-selected-measures.md) | Searches for a substring in the DAX of selected measures, replacing with another substring. | When you need to quickly find/replace values in multiple DAX measures (i.e. `CALCULATE` filter or broken object references). |
| [Find & Replace in Selected Measures](Beginner/script-find-replace-selected-measures.md) | Searches for a substring in the DAX of selected measures, replacing with another substring. | When you need to quickly find/replace values in multiple DAX measures (i.e. `CALCULATE` filter or broken object references). |
| [Create Measure Table](Beginner/script-create-measure-table.md) | Create a measure table | When you want to create an empty table to use as an organizing measure table|
| [Create Table Groups](Beginner/script-create-table-groups.md) | Organize the model into Table Groups | When you want to have an automatic organization of your tables using the table group feature of Tabular Editor 3 |
| [Format Numeric Measures](Beginner/script-format-numeric-measures.md) | Formats the chosen measures | When you want to quickly apply a format string to the currently selected measures |
| [Show Data Source Dependencies](Beginner/script-show-data-source-dependencies.md) | Shows dependencies for data sources | For explicit (legacy) data sources it can be hard to know exactly where they are used. This script shows you which partition reference the chosen data source |


5 changes: 2 additions & 3 deletions common/Datasets/direct-lake-dataset.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,7 @@ applies_to:
Direct Lake semantic models connect directly to data sources stored in [Fabric One Lake](https://learn.microsoft.com/en-us/fabric/onelake/onelake-overview).

> [!IMPORTANT]
> Changing a Direct Lake dataset through the XMLA endpoint will block your ability to change the Direct Lake dataset inside the Fabric Service. Only XMLA endpoint can then edit the Direct Lake This is one of the current limitations of this preview
feature.
> Changing a Direct Lake dataset through the XMLA endpoint will block your ability to change the Direct Lake dataset inside the Fabric Service. The Direct Lake model can then only be opened and edited through the XMLA endpoint. This is one of the current limitations of this preview feature.
Tabular Editor 3 can create and connect to this type of dataset. For a tutorial on this please refer to our blog article: [Direct Lake semantic models: How to use them with Tabular Editor](https://blog.tabulareditor.com/2023/09/26/fabric-direct-lake-with-tabular-editor-part-2-creation/).
Tabular Editor 3 can create direct lake semantic models with both the Lakehouse and Datawarehouse SQL Endpoint.
Expand All @@ -38,4 +37,4 @@ Tabular Editor 2 can connect to Direct Lake semantic models, but does not have a
</div>

## Identifying a Direct Lake model
The TOM Explorer informs what object type your tables are. A Direct Lake model's tables will have the object type 'Table (DirectLake)' to make clear that the open model is a Direct Lake model.
The top title bar of Tabular Editor shows which type of model is open in that instance of Tabular Editor. Additionally, the TOM Explorer displays the type and mode of every table (Import, DirectQuery, Dual or Direct Lake). If a model contains a mix of table modes, the title bar will show "Hybrid". Currenctly, it is not possible for a DirectLake model to contain tables in Import, DirectQuery or Dual mode.
4 changes: 2 additions & 2 deletions te3/features/dax-query.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Unlike the [DAX Script feature](xrefid:dax-scripts), only the expression propert

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)
![Dax Query New](~/images/features/dax_query_window/dax_query_apply_measure_right_click.png)

The shortcuts for these commands are:

Expand All @@ -79,7 +79,7 @@ It is also possible to return the value of a measure but a table constructor {}
EVALUATE
{ [Invoice Lines] }
```
![Dax Query New](~/images/features/dax_query_window/evaluate_measusre.png)
![Dax Query New](~/images/features/dax_query_window/evaluate_measure.png)

### Multiple EVALUATE statements
It is perfectly possible to have multiple EVALUATE statements inside the same DAX query. This type of query is most often encountered with Power BI Performance Analyzer queries.
Expand Down
4 changes: 2 additions & 2 deletions te3/powerbi-xmla-pbix-workaround.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,14 +13,14 @@ applies_to:
---
# Downloading a Power BI dataset to a .pbix using the XMLA endpoint

Once a change is made to a Power BI semantic model through the XMLA endpoint, it's not possible to download the dataset as a .pbix file from the Power BI service.
Once a change is made to a Power BI semantic model through the XMLA endpoint, it's not possible to download the model as a .pbix file from the Power BI service.

However, with the Power BI Project file, it's possible to create a .pbix file from the remote model by following the three-step process, which is described as follows.

![XLMA to PBIX Overview](~/images/power-bi/create-pbix-from-xmla-overview.png)

> [!NOTE]
> The described workaround isn't officially supported by Microsoft. There's no guarantee that it works for every model. Specifically, if you've added custom partitions or other objects [not listed here](https://learn.microsoft.com/en-us/power-bi/transform-model/desktop-external-tools#data-modeling-operations), Power BI Desktop may not be able to correctly open the file following this approach.
> The described workaround isn't officially supported by Microsoft. There's no guarantee that it works for every model. Specifically, if you've added custom partitions or other objects [listed here](https://learn.microsoft.com/en-us/power-bi/transform-model/desktop-external-tools#data-modeling-operations), Power BI Desktop may not be able to correctly open the file following this approach.
## Step 1: Create and save an empty Power BI projects (.pbip) file

Expand Down
2 changes: 1 addition & 1 deletion te3/powerbi-xmla.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
uid: powerbi-xmla
title: Power BI XMLA endpoint
title: Editing through XMLA endpoint
author: Daniel Otykier
updated: 2021-10-01
applies_to:
Expand Down
9 changes: 6 additions & 3 deletions te3/toc.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,13 @@
## @whats-new
## @editions
## @desktop-limitations-te3
## @powerbi-xmla
## Power BI XMLA Endpoint
### @powerbi-xmla
### @powerbi-xmla-pbix-workaround

# Documentation
## @user-interface
## User interface
### @user-interface
### @tom-explorer-view
### @bpa-view
### @messages-view
Expand All @@ -24,7 +26,8 @@
### @metadata-translation-editor
### @dax-debugger
### @dax-query
## @supported-files
## Files formats
### @supported-files
### @tmdl
## @preferences
## @shortcuts
Expand Down
16 changes: 8 additions & 8 deletions te3/features/user-interface.md → te3/views/user-interface.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
uid: user-interface
title: User interface
title: Basic user interface
author: Daniel Otykier
updated: 2021-09-08
---
Expand Down Expand Up @@ -62,7 +62,7 @@ The **File** menu primarily contains menu items for dealing with loading and sav

![File Menu](~/images/file-menu.png)

- **New**: Opens a submenu that allows you to create a new blank data model (Ctrl+N), or create various [supporting files](supported-files.md#tabular-editor-supporting-files) such as a new DAX Query or DAX Script (text files) or a data model diagram (JSON file). Supporting files (with the exception of C# scripts), can be created only when a model is already loaded in Tabular Editor.
- **New**: Opens a submenu that allows you to create a new blank data model (Ctrl+N), or create various [supporting files](xref:supported-files.#supported-file-types) such as a new DAX Query or DAX Script (text files) or a data model diagram (JSON file). Supporting files (with the exception of C# scripts), can be created only when a model is already loaded in Tabular Editor.

![File Menu New](~/images/file-menu-new.png)

Expand All @@ -81,7 +81,7 @@ The **File** menu primarily contains menu items for dealing with loading and sav
![Supported File Types](~/images/supported-file-types.png)

> [!IMPORTANT]
> In Tabular Editor 3 Desktop Edition the **Open > Model from file...** and **Open > Model from folder...** options are not available and the **Open > File...** dialog only allows opening [supporting files](supported-files.md#tabular-editor-supporting-files), not files containing metadata.
> In Tabular Editor 3 Desktop Edition the **Open > Model from file...** and **Open > Model from folder...** options are not available and the **Open > File...** dialog only allows opening [supporting files](xref:supported-files#supported-file-types), not files containing metadata.
- **Revert**: This option lets you reload the model metadata from the source, discarding any changes that are made in Tabular Editor, which have not yet been saved. This option is useful when Tabular Editor 3 is used as an External Tool for Power BI Desktop, and a change is made in Power BI Desktop while Tabular Editor 3 is connected. By choosing **Revert**, Tabular Editor 3 can reload the model metadata from Power BI Desktop without having to reconnect.
- **Close**: This closes the active document (for example a DAX Query, a C# script or a data model diagram). If the document has unsaved changes, Tabular Editor will prompt you to save the changes before closing.
Expand All @@ -94,7 +94,7 @@ The **File** menu primarily contains menu items for dealing with loading and sav
- **Recent tabular models**: Displays a list of recently used model metadata files or folders, allowing you to quickly reload model metadata from one of these.

> [!IMPORTANT]
> In Tabular Editor 3 Desktop Edition the **Save to folder** and **Recent tabular models** options are disabled. In addition, the **Save as** option is only enabled for [supporting files](supported-files.md#tabular-editor-supporting-files).
> In Tabular Editor 3 Desktop Edition the **Save to folder** and **Recent tabular models** options are disabled. In addition, the **Save as** option is only enabled for [supporting files](xref:supported-files#supported-file-types).
- **Exit**: Shuts down the Tabular Editor 3 application. You are prompted to save any unsaved files or model metadata before the application is shut down.

Expand All @@ -116,16 +116,16 @@ The **Edit** menu contains standard Windows application menu items for editing a
> [!NOTE]
> Tabular Editor generally only prompts for object deletion when multiple objects are selected, or when there are dependencies to the object(s) being deleted. Object deletion can be undone by using the **Undo** option (CTRL+Z).
- **Select all**: Selects all text in the currently active document, or all objects belonging to the same parent within the TOM Exporer.
- **Code assist**: This option is available when editing DAX code. It provides a shortcut to various code assist features relevant for editing DAX code. See [DAX editor](dax-editor.md#code-assist-features) for more information.
- **Select all**: Selects all text in the currently active document, or all objects belonging to the same parent within the TOM Explorer.
- **Code assist**: This option is available when editing DAX code. It provides a shortcut to various code assist features relevant for editing DAX code. See [DAX editor](xref:dax-editor#code-assist-features) for more information.

## View

The **View** menu lets you navigate between the different views of the Tabular Editor 3 UI. If a view has been hidden, click on the view title in this menu will unhide the view and bring it into focus. Note that documents are not shown in the View menu. To navigate between documents, use the [Window menu](#window).

![View Menu](~/images/view-menu.png)

- **TOM Explorer**: The TOM Explorer presents a hierarchichal view of the entire [Tabular Object Model (TOM)](https://docs.microsoft.com/en-us/analysis-services/tom/introduction-to-the-tabular-object-model-tom-in-analysis-services-amo?view=asallproducts-allversions) of the currently loaded model metadata. See @tom-explorer-view for more information.
- **TOM Explorer**: The TOM Explorer presents a hierarchical view of the entire [Tabular Object Model (TOM)](https://docs.microsoft.com/en-us/analysis-services/tom/introduction-to-the-tabular-object-model-tom-in-analysis-services-amo?view=asallproducts-allversions) of the currently loaded model metadata. See @tom-explorer-view for more information.
- **Best Practice Analyzer**: The Best Practice Analyzer helps improve the quality of your model by letting you specify rules for best practice validation. See @bpa-view for more information.
- **Messages**: The Messages view displays errors, warnings and informational messages from various sources, such as the Tabular Editor 3 Semantic Analyzer. See @messages-view for more information.
- **Data Refresh**: The Data Refresh view allows you to track data refresh operations that are running in the background. See @data-refresh-view for more information.
Expand Down Expand Up @@ -168,7 +168,7 @@ The **Window** menu provides shortcuts for managing and navigating between the v

![View Menu](~/images/window-menu.png)

- **New...** this submenu provides a shortcut for creating new [supporting files](supported-files.md#tabular-editor-supporting-files). The options here are identical to those under **File > New**.
- **New...** this submenu provides a shortcut for creating new [supporting files](xref:supported-files#supported-file-types). The options here are identical to those under **File > New**.
- **Float** undocks the current view or document into a floating window.
- **Pin tab** pins a tab. When a tab is pinned, it is shown at the left-most side of the document tabs, and when right-clicking on the tabs, shortcuts are available for closing only unpinned tabs.

Expand Down

0 comments on commit c621347

Please sign in to comment.