Skip to content

Commit 3376d76

Browse files
authored
Merge pull request #1421 from MicrosoftDocs/doug-image-fixes-8
Updated image metadata to new format - part 8
2 parents ea18dbf + 1638913 commit 3376d76

File tree

7 files changed

+95
-95
lines changed

7 files changed

+95
-95
lines changed

powerquery-docs/connectors/sap-bw/use-advanced-options.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ title: Use advanced options
33
description: Describes how to use the Power Query SAP Business Warehouse connector advanced sign-in options.
44
author: dougklopfenstein
55
ms.topic: concept-article
6-
ms.date: 1/8/2024
6+
ms.date: 12/1/2025
77
ms.author: dougklo
88
ms.subservice: connectors
99
ms.custom: sfi-image-nochange
1010
---
1111

1212
# Use advanced options
1313

14-
When you create a connection to an SAP Business Warehouse server, you can optionally specify a language code, execution mode, batch size, and an MDX Statement. Also, you can select whether you want to enable characteristic structures.
14+
When you create a connection to an SAP Business Warehouse (BW) server, you can optionally specify a language code, execution mode, batch size, and an MDX Statement. Also, you can select whether you want to enable characteristic structures.
1515

1616
> [!NOTE]
1717
> Although the images in this article illustrate the advanced options in the SAP Business Warehouse Application Server connector, they work the same way in the SAP Business Warehouse Message Server connector.
@@ -20,7 +20,7 @@ When you create a connection to an SAP Business Warehouse server, you can option
2020

2121
You can optionally specify a language code when establishing a connection to the SAP BW server.
2222

23-
:::image type="content" source="language-code.png" alt-text="Entering a two-digit language code in the advanced options.":::
23+
:::image type="content" source="language-code.png" alt-text="Screenshot of the SAP BW connection dialog with a two-digit language code in the advanced options emphasized.":::
2424

2525
The expected value is a two-letter language code as defined in the SAP system. In Power Query Desktop, select the Help icon (question mark) next to the Language Code field for a list of valid values.
2626

@@ -29,9 +29,9 @@ After you set the language code, Power Query displays the descriptive names of t
2929
> [!NOTE]
3030
> Not all listed languages might be configured in your SAP BW system, and object descriptions might not be translated in all languages.
3131
32-
:::image type="content" source="navigator-language-option.png" alt-text="Navigator showing language change for descriptive and field names.":::
32+
:::image type="content" source="navigator-language-option.png" alt-text="Screenshot of the Navigator showing the language change for descriptive and field names.":::
3333

34-
If no language code is specified, the default locale from the **Options** dialog will be used and mapped to a valid SAP language code. To view or override the current locale in Power BI Desktop, open the **File** > **Options and settings** > **Options** dialog box and select **Current File** > **Regional settings**. To view or override the current locale in Power Query Online, open the **Home** > **Options** > **Project options** dialog box. If you do override the locale, your setting gets persisted in your M query and would be honored if you copy-paste your query from Power Query Desktop to Power Query Online.
34+
If no language code is specified, the default locale from the **Options** dialog is used and mapped to a valid SAP language code. To view or override the current locale in Power BI Desktop, open the **File** > **Options and settings** > **Options** dialog box and select **Current File** > **Regional settings**. To view or override the current locale in Power Query Online, open the **Home** > **Options** > **Project options** dialog box. If you do override the locale, your setting gets persisted in your M query and would be honored if you copy-paste your query from Power Query Desktop to Power Query Online.
3535

3636
## Execution mode
3737

@@ -41,18 +41,18 @@ The **Execution mode** option specifies the MDX interface is used to execute que
4141
* **BasXmlGzip**: Specifies the *Gzip compressed bXML flattening mode* option for MDX execution in SAP Business Warehouse. This option is recommended for low latency or high volume queries. The default value for the execution mode option.
4242
* **DataStream**: Specifies the *DataStream flattening mode* option for MDX execution in SAP Business Warehouse.
4343

44-
:::image type="content" source="execution-mode.png" alt-text="Sign in dialog box showing location of the Execution mode option.":::
44+
:::image type="content" source="execution-mode.png" alt-text="Screenshot of the SAP BW connection dialog showing location of the Execution mode option.":::
4545

4646
## Batch size
4747

48-
Specifies the maximum number of rows to retrieve at a time when executing an MDX statement. A small number translates into more calls to the server when retrieving a large data set. A large number of rows may improve performance, but could cause memory issues on the SAP BW server. The default value is 50000 rows.
48+
Specifies the maximum number of rows to retrieve at a time when executing an MDX statement. A small number translates into more calls to the server when retrieving a large data set. A large number of rows might improve performance, but could cause memory issues on the SAP BW server. The default value is 50000 rows.
4949

5050
## MDX Statement
5151

5252
> [!NOTE]
5353
>The MDX statement option isn't available in Power Query Online.
5454
55-
Instead of using the navigator to browse through and select from available data objects in SAP BW, a user who's familiar with the MDX query language can specify an MDX statement for direct execution in SAP BW. However, be aware that no further query folding will be applied when using a custom MDX statement.
55+
Instead of using the navigator to browse through and select from available data objects in SAP BW, a user who's familiar with the MDX query language can specify an MDX statement for direct execution in SAP BW. However, be aware that no further query folding is applied when using a custom MDX statement.
5656

5757
The statement for the example used here would look as shown in the following sample, based on the technical names of the objects and properties in SAP BW.
5858

@@ -69,43 +69,43 @@ DIMENSION PROPERTIES
6969
[0D_VENTOR].[50D_VENDOR] ON ROWS FROM [0D_PU_C01/0D_PU_C01_Q0013]
7070
```
7171

72-
:::image type="content" source="example-mdx-statement.png" alt-text="Example MDX statement shown in MDX statement option.":::
72+
:::image type="content" source="example-mdx-statement.png" alt-text="Screenshot of the SAP BW connection dialog with the example MDX statement shown in the MDX statement option.":::
7373

74-
The SAP BW connector will display a preview of the data that is returned by the MDX statement. You can then either select **Load** to load the data (Power Query Desktop only), or select **Transform Data** to further manipulate the data set in the Power Query Editor.
74+
The SAP BW connector displays a preview of the data returned by the MDX statement. You can then either select **Load** to load the data (Power Query Desktop only), or select **Transform Data** to further manipulate the data set in the Power Query Editor.
7575

76-
:::image type="content" source="mdx-preview-data.png" alt-text="MDX data displayed in the navigator preview.":::
76+
:::image type="content" source="mdx-preview-data.png" alt-text="Screenshot of the MDX data displayed in the navigator preview.":::
7777

7878
To validate and troubleshoot an MDX statement, SAP BW provides the *MDXTEST* transaction for SAP GUI for Windows users. Further, the MDXTEST transaction can be a useful tool for analyzing server errors or performance concerns as a result of processing that occurs within the SAP BW system.
7979

8080
For more detailed information on this transaction, go to [MDX Test Environment](https://help.sap.com/viewer/64e2cdef95134a2b8870ccfa29cbedc3/7.3.15/en-US/19fdd486b13c43e2ad9f562a3222a480.html).
8181

82-
:::image type="content" source="mdxtest-in-sapgui.png" alt-text="Troubleshooting an MDX statement with MDXTEST in the SAPGUI.":::
82+
:::image type="content" source="mdxtest-in-sapgui.png" alt-text="Screenshot of the MDX Test Environment where you troubleshoot an MDX statement with MDXTEST in the SAPGUI.":::
8383

84-
MDXTEST can also be used to construct an MDX statement. The transaction screen includes panels on the left that assist the user in browsing to a query object in SAP BW and generating an MDX statement.
84+
MDXTEST can also be used to construct an MDX statement. The transaction screen includes panels that assist the user in browsing to a query object in SAP BW and generating an MDX statement.
8585

86-
The transaction offers different execution modes/interfaces for the MDX statement. Select *Flattening (basXML)* to mimic how Power Query would execute the query in SAP BW. This interface in SAP BW creates the row set dynamically using the selections of the MDX statement. The resulting dynamic table that's returned to Power Query Desktop has a very compact form that reduces memory consumption.
86+
The transaction offers different execution modes/interfaces for the MDX statement. Select *Flattening (basXML)* to mimic how Power Query would execute the query in SAP BW. This interface in SAP BW creates the row set dynamically using the selections of the MDX statement. The resulting dynamic table returned to Power Query Desktop has a very compact form that reduces memory consumption.
8787

88-
:::image type="content" source="select-flattening.png" alt-text="Shows Flattening selected in Execute in Export mode.":::
88+
:::image type="content" source="select-flattening.png" alt-text="Screenshot that shows Flattening selected in Execute in Export mode.":::
8989

90-
The transaction will display the result set of the MDX statement and useful runtime metrics.
90+
The transaction displays the result set of the MDX statement and useful runtime metrics.
9191

92-
:::image type="content" source="mdx-result-set.png" alt-text="Displays the result set of the MDX statement.":::
92+
:::image type="content" source="mdx-result-set.png" alt-text="Screenshot showing the result set of the MDX statement.":::
9393

9494
## Enable characteristic structures
9595

96-
The **Enable characteristic structures** selection changes the way characteristic structures are displayed in the navigator. A structure is an SAP BW object that can be used when building BEX queries. In the BEX UX they look like the following image.
96+
The **Enable characteristic structures** selection changes the way characteristic structures are displayed in the navigator. A structure is an SAP BW object that can be used when building BEX queries. In the BEX UX, they look like the following image.
9797

98-
:::image type="content" source="characteristic-structures.png" alt-text="Structure used when building BEX queries.":::
98+
:::image type="content" source="characteristic-structures.png" alt-text="Screenshot of the structure used when building BEX queries.":::
9999

100-
If the **Enable characteristic structures** selection is clear (default), the connector will produce a cartesian product of each dimension on the structure with each available measure. For example:
100+
If the **Enable characteristic structures** selection is clear (default), the connector produces a cartesian product of each dimension on the structure with each available measure. For example:
101101

102-
![Image of the navigator showing the Net Value stat curr and Number of documents values each displayed for Calgary, Frankfurt, and Munich.](clear-characteristic-structure.png)
102+
:::image type="content" source="clear-characteristic-structure.png" alt-text="Screenshot of the navigator showing the Net Value stat curr and Number of documents values each displayed for Calgary, Frankfurt, and Munich.":::
103103

104104
If selected, the connector produces only the available measures. For example:
105105

106-
:::image type="content" source="enable-characteristic-structure.png" alt-text="Image of the navigator showing only the Net Value stat curr and Number of documents values displayed.":::
106+
:::image type="content" source="enable-characteristic-structure.png" alt-text="Screenshot of the navigator showing only the Net Value stat curr and Number of documents values displayed.":::
107107

108-
### See also
108+
### Related content
109109

110110
* [Navigate the query objects](navigate-query-objects.md)
111111
* [Transform and filter SAP BW data set](transform-filter-sap-bw-data.md)

0 commit comments

Comments
 (0)