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: docs/embedded/concepts/admin-exp/consuming-tenant-admin/ctaUX.md
+31-55Lines changed: 31 additions & 55 deletions
Original file line number
Diff line number
Diff line change
@@ -2,20 +2,19 @@
2
2
3
3
The organizations that use the SharePoint Embedded applications on their Microsoft 365 (M365) tenants are the consuming tenants and the persona that is responsible for managing these applications on their Microsoft 365 tenancy is the consuming tenant administrator (CTA). Consuming tenant administrators can manage containers through a graphical user interface (GUI) using the [SharePoint Administrator Center](https://go.microsoft.com/fwlink/?linkid=2185219) (SPAC).
4
4
5
-
To manage SharePoint Embedded containers, tenant administrators need to be assigned the Microsoft 365 SharePoint Embedded Administrator role. Global Administrators in Microsoft 365 have all the permissions of the SharePoint Embedded Administrator role. A SharePoint Administrator can assign themselves the SharePoint Embedded Administrator role to act as a Consuming Tenant Admin for SharePoint Embedded. This role is available in both Microsoft Entra and the Microsoft 365 Admin Center.
5
+
To manage SharePoint Embedded containers, CTA need to be assigned the Microsoft 365 SharePoint Embedded Administrator role. Global Administrators in Microsoft 365 have all the permissions of the SharePoint Embedded Administrator role. A SharePoint Administrator can assign themselves the SharePoint Embedded Administrator role to act as a CTA for SharePoint Embedded. This role is available in both Microsoft Entra and the Microsoft 365 Admin Center.
6
6
For information on SharePoint Embedded admin role, [see](https://github.com/cindylay/sp-dev-docs/blob/update-ga/docs/embedded/concepts/admin-exp/adminrole.md).
7
7
8
8
The following actions are supported in SPAC:
9
9
10
10
1. View active containers in the tenant
11
11
2. View deleted containers in the tenant
12
12
3. View detailed information of a container
13
-
4.Soft delete a container
13
+
4.Delete a container
14
14
5. Restore a deleted container
15
-
6. Purge a deleted container
16
-
17
-
Global admin will also see "Active Containers" and "Deleted Containers" page along with Site administration pages when they log in to SharePoint Admin Center.
15
+
6. Permanently deleted a container
18
16
17
+
Global Admin will also see "Active Containers" and "Deleted Containers" page along with Site administration pages when they log in to SharePoint Admin Center.
2.**Membership:** This panel shows the user permissions for different users associated with the container.
49
48
50
49
> [!IMPORTANT]
51
50
> The SharePoint Embedded platform supports four distinct [roles](docs/embedded/concepts/app-concepts/sharing-and-perm.md): Owner, Manager, Writer, and Reader. The SharePoint Embedded application on your tenant may not utilize all four roles and might refer to these roles using different names.
52
51
>
53
-
> Admins should verify the mapping of the roles provided by the platform to those used in the application.
@@ -81,70 +77,50 @@ Deleting a container can have implications on the functionality of a SharePoint
81
77
82
78
2.**Broken Links:** If the SharePoint Embedded application contains links or references to the deleted container, those links become broken, leading to errors or malfunctioning features within the app.
83
79
84
-
3.**Permissions Issues:** Deleting a container can affect permissions settings. If the SharePoint Embedded app relies on specific permissions granted to the deleted container, it might encounter permission issues and fail to function properly.
85
-
Therefore, it's essential to carefully consider the consequences of deleting a container and ensure that appropriate measures are taken to mitigate any potential issues.
86
-
87
-
A container can be soft deleted from the Active containers page for any business reason by the CTA. By default, the delete button is deactivated. On selecting a container, the delete button is activated. The CTA can then select the delete button.
80
+
A container can be deleted from the Active containers page for any business reason by the CTA. By default, the delete button is deactivated. On selecting a container, the delete button is activated. The CTA can then select the delete button.
This opens a side panel that warns the user about the effect on the associated SPE application due to the deletion of a container as well as inform the user about the restoration policy. The CTA can at this stage either cancel the panel and go back to the active containers page or proceed further with the deleting by clicking on “Delete container”.
91
85
92
-
This opens a side panel that warns the user about the effect on the associated SPE application due to the deletion of a container as well as inform the user about the restoration policy. The CTA can at this stage either cancel the panel and go back to the active containers page or proceed further with the deleting by clicking on “Delete container”.
**Any soft deleted container is retained for 93 days post which it is permanently deleted**
92
+
**Deleted containers are permanently purged after 93 days unless there is a retention policy applied to the containers**
102
93
103
94
## Restore a container
104
-
A soft-deleted container can be restored on the Deleted containers page by selecting the container to be restored. This activates the restore button which is by default deactivated.
A container in the deleted container collection can be restored on the Deleted containers page by selecting the corresponding containers by selecting the "Restore" link
The restoring of the container happens in the background and the status of the same is displayed on the top right corner of the page.
100
+
Restoration of the container happens in the background and the status of the same is displayed on the top right corner of the page. Upon successful restoration, the container will be available in the Active Containers page.
>Deleting a container may cause unexpected issues for the SharePoint Embedded application it belongs to and may interrupt the application's usage. This action should only be performed by admins when absolutely necessary.
127
109
128
-
The CTA can permanently delete (purge) a soft-deleted container if they decide to.
110
+
The CTA can permanently delete a deleted container from the deleted container collection if they decide to.
129
111
130
112
The CTA selects the container to be permanently deleted. The “Permanently delete” button is enabled.
On clicking the button, a pop-up appears warning the CTA on the action they are performing. If absolutely sure, the CTA can proceed and click on “Delete”. Else the CTA can cancel the action.
116
+
Upon clicking the button, a pop-up appears warning the CTA on the action they are performing. If absolutely sure, the CTA can proceed and click on “Delete”. Otherwise the CTA can cancel the action.
On successful deletion, the container is permanently deleted.
120
+
Upon clicking Delete, the container is permanently deleted and the status of the same appears in the top-right corner of the page.Upon successful deletion, the container is permanently removed from the deleted container collection and cannot be restored.
0 commit comments