Пользовательские действия в модели надстройки SharePoint

Статья
04/08/2023

Сводка

Подход, который вы используете для изменения меню элементов списка и ленты в SharePoint, отличается в новой модели надстройки SharePoint, чем в коде полного доверия. В типичном сценарии с кодом полного доверия (FTC) или решением фермы меню элементов списка и изменения ленты определялись в ФОРМАТЕ XML (пользовательские действия), упаковывались в компоненты и развертывались с помощью решений SharePoint.

В сценарии модели надстройки SharePoint вы используете клиентскую объектную модель SharePoint (CSOM) или REST API для создания пользовательских действий, изменяющих меню элементов списка и ленту. Этот шаблон обычно называется шаблоном удаленной подготовки.

Рекомендации высокого уровня

Как правило, мы хотели бы предоставить следующие общие рекомендации по созданию и развертыванию пользовательских действий в новой модели надстройки SharePoint.

Пользовательские действия можно использовать для изменения меню элементов списка и ленты.
Нельзя скрыть элементы меню с помощью настраиваемого действия непосредственно из надстройки, реализующей пользовательское действие.
- Это связано с тем, что элемент HideCustomAction (документация по API MSDN) недоступен в объектной модели ide клиентов (CSOM) SharePoint ECMA — свойствах UserCustomAction (документация по API MSDN) или sharePoint/Office 365 REST API — SP. Объект UserCustomActionCollection (sp.js) (документация по API MSDN).
- Если необходимо скрыть элементы меню, необходимо использовать пользовательское действие для внедрения JavaScript или настроенного CSS на страницы SharePoint. JavaScript или CSS, внедренный на страницы SharePoint, скрывает элемент меню.
Используйте клиентскую объектную модель SharePoint (CSOM) и (или) ИНТЕРФЕЙСы REST API SharePoint/Office 365 для реализации пользовательских действий.

Начало работы

В следующем примере показано, как добавить пользовательское действие в меню параметров сайта на хост-сайте, как отобразить диалоговое окно в настраиваемом действии, как скрыть диалоговое окно, в котором размещена страница, из удаленного веб-сайта надстройки, а также как использовать настраиваемое действие для создания списков и задания темы веб-сайта.

Provisioning.SiteModifier (пример PnP O365)

Здесь вы можете увидеть ссылку, добавляемую настраиваемым действием в меню Параметры сайта.

Здесь вы увидите всплывающее окно, открытое по ссылке Изменить сайт.