Ações personalizadas no modelo de suplemento do SharePoint

Artigo
09/28/2023

Resumo

A abordagem que você adota para modificar menus de item de lista e a faixa de opções no SharePoint é diferente no novo modelo de suplemento do SharePoint do que era com o Full Trust Code. Em um cenário típico de FTC (Full Trust Code) / Farm Solution, menus de item de lista e modificações de faixa de opções foram definidos em XML (ações personalizadas), empacotados em recursos e implantados por meio das Soluções do SharePoint.

Em um cenário de modelo de suplemento do SharePoint, você usa o CSOM (Modelo de Objeto do Lado do Cliente do SharePoint) ou a API REST para criar ações personalizadas que modificam menus de item de lista e a faixa de opções. Esse padrão é comumente chamado de padrão de provisionamento remoto.

Diretrizes de alto nível

Como regra geral, gostaríamos de fornecer as diretrizes de alto nível a seguir para criar e implantar ações personalizadas no novo modelo de Suplemento do SharePoint.

Ações personalizadas podem ser usadas para modificar menus de item de lista e a faixa de opções.
Você não pode ocultar itens de menu usando uma ação personalizada diretamente de um Suplemento que implementa uma ação personalizada.
- Isso ocorre porque o Elemento HideCustomAction (Documentação da API MSDN) não está disponível no CSOM (Modelo de Objeto do SharePoint ECMA Clients-ide) – propriedades UserCustomAction (Documentação da API MSDN)ou nas APIs REST do SharePoint/Office 365 – SP. Objeto UserCustomActionCollection (sp.js) (Documentação da API MSDN).
- Se precisar ocultar itens de menu, use uma ação personalizada para inserir o JavaScript ou o CSS personalizado nas páginas do SharePoint. O JavaScript ou O CSS inserido nas páginas do SharePoint oculta o item do menu.
Use o CSOM (modelo de objeto do lado do cliente) do SharePoint e/ou as APIs REST do SharePoint/Office 365 para implementar ações personalizadas.

Introdução

O exemplo a seguir demonstra como adicionar uma ação personalizada ao menu de configurações do site na Web do host, como mostrar uma caixa de diálogo em uma ação personalizada, como ocultar uma caixa de diálogo que hospeda uma página de uma Web de suplemento remoto e como usar uma ação personalizada para criar listas e definir o tema de uma Web.

Provisioning.SiteModifier (exemplo O365 PnP)

Aqui você pode ver o link que a ação personalizada no exemplo adiciona ao menu Configurações do Site.

Aqui você pode ver a janela pop-up aberta por meio do link Modificar Site.