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
Document user license requirements for @-mentions in SPE docs (#10301)
* Document user license requirements for @-mentions in SPE docs
* fixup! Document user license requirements for @-mentions in SPE docs
* fix acrolinx findings
* address acronlinx findings
---------
Co-authored-by: Andrew Connell <[email protected]>
Copy file name to clipboardExpand all lines: docs/embedded/development/auth.md
+8-4Lines changed: 8 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -77,25 +77,29 @@ To [register a container type](../getting-started/register-api-documentation.md)
77
77
> [!NOTE]
78
78
> Container type management on owning tenants and registration on consuming tenants will become Microsoft Graph operations soon, and this step will no longer be needed. Stay tuned.
79
79
80
-
To use the [SharePoint Embedded agent](./declarative-agent/spe-da2.md) experience (in the Preview stage) in your application, you will also need the `Container.Selected` permission on the `Office 365 SharePoint Online` resource. Please note that, as mentioned above, this permission is also required to register a container type today, which means that your application must have been granted consent to it interact with SharePoint Embedded in consuming tenants.
80
+
To use the [SharePoint Embedded agent](./declarative-agent/spe-da2.md) experience (in the Preview stage) in your application, you'll also need the `Container.Selected` permission on the `Office 365 SharePoint Online` resource. Note that, as mentioned earlier, this permission is also required to register a container type today, which means that your application must have been granted consent to it interact with SharePoint Embedded in consuming tenants.
This refers only to the search scenarios in [Search Content](./content-experiences/search-content.md), and not the enumeration scenarios.
85
85
86
-
To use [Microsoft Search](/microsoftsearch/overview-microsoft-search) on SharePoint Embedded content, you must request the Delegated [`Files.Read.All`](/graph/permissions-reference#filesreadall) Microsoft Graph permission on top of `FileStorageContainer.Selected` normally used for SharePoint Embedded access. During the Preview stage of this feature, the `Files.Read.All` application permission will grant applications access to search capabilities on all SharePoint Embedded content.
86
+
To use [Microsoft Search](/microsoftsearch/overview-microsoft-search) on SharePoint Embedded content, you must request the Delegated [`Files.Read.All`](/graph/permissions-reference#filesreadall) Microsoft Graph permission on top of `FileStorageContainer.Selected`, normally used for SharePoint Embedded access. During the Preview stage of this feature, the `Files.Read.All` application permission will grant applications access to search capabilities on all SharePoint Embedded content.
87
87
88
88
> [!NOTE]
89
89
> Microsoft Search support for SharePoint Embedded content is in Preview and is subject to change. The access requirements for Microsoft Search on SharePoint Embedded content will align with the SharePoint Embedded authorization model in the future. Stay tuned.
90
90
91
91
#### Operations that require a user license
92
92
93
-
SharePoint Embedded is designed to work without the need for end-users to have any kind of Microsoft 365 product licenses assigned to them. However, there are certain operations that do not abide by this principle yet.
93
+
SharePoint Embedded is designed to work without the need for endusers to have any kind of Microsoft 365 product licenses assigned to them. However, there are certain operations that don't abide by this principle yet.
94
94
95
95
##### List containers
96
96
97
97
The [List containers](/graph/api/filestorage-list-containers?tabs=http) operation will return a `401 Unauthorized` response code if called on behalf of a user that does not have a OneDrive for Business site. There are plans to remove this dependency in the near future. This does not apply to the List containers operation when called without a user context (app-only mode).
98
98
99
+
##### Mention users in Office documents
100
+
101
+
The common [Office experience](./content-experiences/office-experience.md) includes reviewing documents and adding comments to those documents. For users to show up in the @mentions people picker, they'll need to have an Microsoft 365 license assigned to them.
102
+
99
103
### Container type application permissions
100
104
101
105
SharePoint Embedded applications need to be granted container type application permissions by the owner application before they can access containers of the given container type. Container type application permissions are granted to applications via [container type registration](../getting-started/register-api-documentation.md).
@@ -149,7 +153,7 @@ Here are some actions you can take next:
149
153
1.[Grant admin consent](/entra/identity-platform/v2-admin-consent) to your application on both owning and consuming tenants (which can be the same tenant).
150
154
151
155
> [!NOTE]
152
-
> The `Container.Selected` application permission is hidden. This may cause issues with granting admin consent using the Enterprise apps pane in the Azure Portal. Instead, [construct the admin consent URL](/entra/identity-platform/v2-admin-consent#request-the-permissions-from-a-directory-admin) and provide it to your Entra directory administrator. For example:
156
+
> The `Container.Selected` application permission is hidden. This may cause issues with granting admin consent using the Enterprise apps pane in the Azure portal. Instead, [construct the admin consent URL](/entra/identity-platform/v2-admin-consent#request-the-permissions-from-a-directory-admin) and provide it to your Entra directory administrator. For example:
Copy file name to clipboardExpand all lines: docs/embedded/development/content-experiences/office-experience.md
+12-7Lines changed: 12 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Office Experiences
3
3
description: Overview of Office experiences with SharePoint Embedded content
4
-
ms.date: 05/21/2024
4
+
ms.date: 06/18/2025
5
5
ms.localizationpriority: high
6
6
---
7
7
@@ -11,16 +11,21 @@ Office file experiences for SharePoint Embedded platform will work in a similar
11
11
12
12
## Opening Office documents from SharePoint Embedded
13
13
14
-
Office documents from SharePoint Embedded apps can be opened for viewing and editing in Office web, or in Office application for a richer viewing and editing experience. AutoSave feature saves your files automatically as your user's work and is enabled for each Word, Excel and PowerPoint file stored in your SharePoint Embedded Application Apps.
14
+
Office documents from SharePoint Embedded apps can be opened for viewing and editing in Office web or in the Office application for a richer viewing and editing experience. AutoSave feature saves your files automatically as your user's work and is enabled for each Word, Excel, and PowerPoint file stored in your SharePoint Embedded Application Apps.
15
15
16
-
## View or restore a previous version of Office document from SharePoint Embedded
16
+
## View or restore a previous version of an Office document from SharePoint Embedded
17
17
18
-
Versioning is automatically enabled on each Word, Excel and PowerPoint file stored in your SharePoint Embedded Apps that helps your users to see what changes have been made in a file, compare different versions, or restore the version you want. This is incredibly important to your users if a mistake was made, a previous version is preferred or in multi-user coauthoring scenarios when your users are collaborating with others and someone makes changes your users didn't want in a file.
18
+
Versioning is automatically enabled on each Word, Excel, and PowerPoint file stored in your SharePoint Embedded Apps, that helps your users to see what changes have been made in a file, compare different versions, or restore the version you want. This is incredibly important to your users if a mistake was made, a previous version is preferred, or in multi-user coauthoring scenarios when your users are collaborating with others and someone makes changes your users didn't want in a file.
19
19
20
20
## Collaborating on Office documents from SharePoint Embedded
21
21
22
22
It's simple for your users to collaborate on your SharePoint Embedded Application's Office documents – they can **Share documents** with specific peers or with people outside your organization by Creating a shareable link to use wherever needed, Send an email invitation or @mention in comments to tag someone for feedback and, **Collaborate in real time** by co-authoring in Office with SharePoint Embedded Applications.
23
23
24
+
> [!NOTE]
25
+
> Mentions require target users to [have an Microsoft 365 license assigned to them](../auth.md#mention-users-in-office-documents).
26
+
>
27
+
> Mentions are restricted to people inside the consuming tenant's organization. Mentions exclude guests and users from other tenants in a multitenant setting.
28
+
24
29
### Share your documents
25
30
26
31
#### Send an email invite
@@ -34,7 +39,7 @@ Share your SharePoint Embedded documents by sending an email invitation to speci
34
39
35
40
Creating a shareable link makes it simple to share your SharePoint Embedded document in an email, document, or IM.
36
41
37
-
- Select Share, Copy Link and Paste the link wherever you want
42
+
- Select Share, Copy Link, and Paste the link wherever you want
38
43
- Change any permissions of the link if needed
39
44
40
45
#### Co-Author
@@ -45,13 +50,13 @@ If you want others to edit with you, you can easily share files and collaborate
45
50
- A presence indicator shows where someone is making changes. See any changes right as they're being made.
46
51
- See changes made by others and see what's happened while you were away.
47
52
48
-
### Levels of sharing access
53
+
####Levels of sharing access
49
54
50
55
There are different options for sharing SharePoint Embedded Application Office Documents from:
| Allow Anyone who receives the link access to SharePoint Embedded Application File |**Anyone** gives access to anyone who receives this link, whether they receive it directly from you or forwarded from someone else. This might include people outside of your organization. |
59
+
| Allow Anyone who receives the link access to SharePoint Embedded Application File |**Anyone** gives access to anyone who receives this link, whether they receive it directly from you or are forwarded from someone else. This might include people outside of your organization. |
55
60
| Allow anyone in your organization to access to your SharePoint Embedded Application File |**People in \<Your Organization\>** gives anyone in your organization who has the link access to the file, whether they receive it directly from you or forwarded from someone else. |
56
61
| Secure your SharePoint Embedded Application docs only to specific people. | When you need to prevent recipients from forwarding a shared link, use the **Specific People** permission. **Specific people** gives access only to the people you specify, although other people might already have access. If people forward the sharing invitation, only people who already have access to the item will be able to use the link. |
57
62
| Reshare the link with specific people |**People with existing access** can be used by people who already have access to the document or folder. It doesn't change the permissions on the item. Use this if you just want to send a link to somebody who already has access. |
0 commit comments