You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerbi-docs/developer/embedded/datasets-permissions.md
+8-10Lines changed: 8 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ tags: ''
9
9
ms.service: powerbi
10
10
ms.subservice: powerbi-developer
11
11
ms.topic: reference
12
-
ms.date: 11/09/2023
12
+
ms.date: 11/09/2024
13
13
---
14
14
15
15
# Semantic model REST API permissions
@@ -28,7 +28,7 @@ Power BI has two sets of permissions:
28
28
29
29
Workspace permissions, also known as folder permissions or [roles](../../collaborate-share/service-roles-new-workspaces.md), are the highest level of permissions in Power BI. These permissions override permissions that are given to a specific item in the workspace folder.
30
30
31
-
The table below lists the four types of folder roles. It shows each role's level, and the code string returned by the Power BI REST APIs. Admin is the highest workspace permission level, and viewer is the lowest. Every permission level includes the capabilities of the permissions below it. You can review the capabilities of each permission in [Workspace roles](../../collaborate-share/service-roles-new-workspaces.md#workspace-roles).
31
+
The following table lists the four types of folder roles. It shows each role's level, and the code string returned by the Power BI REST APIs. Admin is the highest workspace permission level, and viewer is the lowest. Every permission level includes the capabilities of the permissions below it. You can review the capabilities of each permission in [Workspace roles](../../collaborate-share/service-roles-new-workspaces.md#workspace-roles).
32
32
33
33
|Folder Role |Level |Derived permissions for semantic models created in the workspace |
34
34
|------------|------|--------------------------|
@@ -38,7 +38,7 @@ The table below lists the four types of folder roles. It shows each role's level
38
38
|Viewer |1 |`Read`|
39
39
40
40
>[!NOTE]
41
-
>The *write* permission is applied to Power BI semantic models created by *admin*, *member* and *contributor* users in a workspace they own. The write permission can be granted or deleted using workspace permissions only. It cannot directly be granted to, or deleted from, a Power BI item.
41
+
>The *write* permission is applied to Power BI semantic models created by *admin*, *member*, and *contributor* users in a workspace they own. The write permission can be granted or deleted using workspace permissions only. It can't directly be granted to, or deleted from, a Power BI item.
42
42
43
43
#### Get and add workspace permissions with APIs
44
44
@@ -56,14 +56,14 @@ Power BI items, such as reports, semantic models, and dashboards have their own
56
56
57
57
## Semantic model permissions and REST APIs
58
58
59
-
Semantic model permissions are part of the [item permissions](#item-permissions). The table below lists the Power BI semantic model permissions and their representation in the [Power BI REST APIs](/rest/api/power-bi/).
59
+
Semantic model permissions are part of the [item permissions](#item-permissions). The following table lists the Power BI semantic model permissions and their representation in the [Power BI REST APIs](/rest/api/power-bi/).
60
60
61
61
>[!TIP]
62
62
>Although the API permissions are identical to the Power BI service permissions, [`build`](#build-permissions-and-rest-apis) permissions are referred to as *explore* permissions in the APIs.
|Description |Allows the user to read the content of the semantic model|Equivalent to [build permissions](#build-permissions-and-rest-apis)|Allows the user to share the content of the semantic model with other users who will get read, reshare, or explore permissions for it |
66
+
|Description |Allows the user to read the content of the semantic model|Equivalent to [build permissions](#build-permissions-and-rest-apis)|Allows the user to share the content of the semantic model with other users who get read, reshare, or explore permissions for it |
@@ -74,7 +74,7 @@ Semantic model permissions are part of the [item permissions](#item-permissions)
74
74
75
75
### Build permissions and REST APIs
76
76
77
-
In the [Power BI REST APIs](/rest/api/power-bi/), the `build` permission is returned as *explore*. For example, a string with the *read*, *reshare* and *build* permissions, will look like this: `ReadReshareExplore`.
77
+
In the [Power BI REST APIs](/rest/api/power-bi/), the `build` permission is returned as *explore*. For example, a string with the *read*, *reshare* and *build* permissions, looks like this: `ReadReshareExplore`.
78
78
79
79
When you give a user `build` permission, they can build new content on your semantic model. Examples of content they can build are reports, dashboards, pinned tiles from Q&A, paginated reports, and Insights Discovery.
80
80
@@ -88,7 +88,7 @@ Users also need `build` permissions to work with data outside Power BI:
88
88
89
89
### Row-level security
90
90
91
-
For a semantic model that uses row-level security (RLS), any permissions *higher* than `build`will enable the user to view all the data in the semantic model. `Build`, and permissions lower than `build`, will only give the semantic model user access to the data they're allowed to see as configured in your RLS settings.
91
+
For a semantic model that uses row-level security (RLS), any permissions *higher* than `build`enables the user to view all the data in the semantic model. `Build`, and permissions lower than `build`, only give the semantic model user access to the data they're allowed to see as configured in your RLS settings.
92
92
93
93
### Get and update semantic model permissions with APIs
94
94
@@ -107,9 +107,7 @@ For a semantic model that uses row-level security (RLS), any permissions *higher
107
107
*[Datasets - Get Dataset Users](/rest/api/power-bi/datasets/get-dataset-users)
108
108
*[Datasets - Get Dataset Users In Group](/rest/api/power-bi/datasets/get-dataset-users-in-group)
109
109
110
-
## Considerations and limitations
111
-
112
-
Each of the above APIs comes with certain limitations regarding who can use them and how. To see the limitations of each API, select the link for that API.
110
+
Each of these APIs comes with certain limitations regarding who can use them and how. To see the limitations of each API, select the link for that API.
Copy file name to clipboardExpand all lines: powerbi-docs/developer/visuals/total-subtotal-api.md
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ ms.reviewer: tebercov
7
7
ms.service: powerbi
8
8
ms.subservice: powerbi-custom-visuals
9
9
ms.topic: how-to
10
-
ms.date: 11/22/2023
10
+
ms.date: 11/22/2024
11
11
#customer intent: As a Power BI visual developer, I want to learn how to use the Total and Subtotal API to request aggregated subtotal data from the Power BI host.
12
12
---
13
13
@@ -31,7 +31,7 @@ The API offers the following customization for each data-view type (currently, o
31
31
*`columnSubtotals`: (boolean) Indicates if the *subtotal* data should be requested for all fields in the columns field well.
32
32
*`columnSubtotalsPerLevel`: (boolean) Indicates if the *subtotal* data can be toggled for individual fields in the columns field well.
33
33
*`levelSubtotalEnabled`: (boolean) Indicates if the subtotals are requested for the row or column. Unlike all the other properties, this property is applied to individual rows or columns.
34
-
*`rowSubtotalsType`: ("Top" or "Bottom") Indicates if the row with the *total* data should be retrieved before (`top`) or after (`bottom`) the rest of the data. If this property is set to `bottom`, the total can only be displayed after all the data has been fetched. The default is `bottom`.
34
+
*`rowSubtotalsType`: ("Top" or "Bottom") Indicates if the row with the *total* data should be retrieved before (`top`) or after (`bottom`) the rest of the data. If this property is set to `bottom`, the total can only be displayed after all the data is fetched. The default is `bottom`.
35
35
36
36
Each of these switches is assigned a value based on the related properties in the property pane and the defaults.
Copy file name to clipboardExpand all lines: powerbi-docs/developer/visuals/utils-formatting-model.md
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ ms.reviewer: tebercov
8
8
ms.service: powerbi
9
9
ms.subservice: powerbi-custom-visuals
10
10
ms.topic: reference
11
-
ms.date: 10/23/2023
11
+
ms.date: 10/23/2024
12
12
ms.custom: engagement-fy23
13
13
---
14
14
@@ -347,7 +347,7 @@ new formattingSettings.ColorPicker({
347
347
348
348
## Reset settings to default
349
349
350
-
Formatting model utils will enable you to [reset settings to default](./format-pane-example.md#reset-settings-to-default) by automatically adding all the formatting properties descriptors to the formatting card list of features to revet to default descriptors `revertToDefaultDescriptors`.
350
+
Formatting model utils enable you to [reset settings to default](./format-pane-example.md#reset-settings-to-default) by automatically adding all the formatting properties descriptors to the formatting card list of features to revet to default descriptors `revertToDefaultDescriptors`.
351
351
352
352
You can enable resetting formatting settings from:
0 commit comments