Ações personalizadas no modelo de Suplemento do SharePoint

Importante

Os suplementos do SharePoint atingiram o fim da vida útil no SharePoint Online em 2 de abril de 2026. Os suplementos hospedados no SharePoint e hospedados pelo provedor foram desativados e não funcionam mais no SharePoint Online, incluindo nuvens governamentais. As diretrizes de desenvolvimento, implantação e uso de suplementos são mantidas para referência histórica e para cenários aplicáveis do Servidor do SharePoint, não para novas soluções do SharePoint Online.

Os suplementos do Servidor do SharePoint implantados por meio de um catálogo de aplicativos local não são desativados por essa alteração. A aquisição de Suplementos do SharePoint do marketplace público terminou em 2 de abril de 2026 para o Servidor do SharePoint.

Essa desativação não desativa APIs REST do SharePoint, CSOM, JSOM ou SPFx (Estrutura do SharePoint). Para o SharePoint Online, use SPFx para extensões de interface do usuário e o Microsoft Entra ID para autenticação para aplicativos externos. Consulte o anúncio de desativação e as diretrizes de migração de suplemento.

Resumo

A abordagem adotada para modificar os 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 Código de Confiança Total. Em um cenário típico de FTC (Código de Confiança Total)/Solução de Farm, os menus de item de lista e as modificações da faixa de opções foram definidos em XML (ações personalizadas), empacotados em recursos e implantados por meio de 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 os 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 seguintes diretrizes de alto nível para criar e implantar ações personalizadas no novo modelo de suplemento do SharePoint.

  • Ações personalizadas podem ser usadas para modificar os menus dos itens 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.
  • 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 configurações do site no host da Web, 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 um suplemento remoto da Web e como usar uma ação personalizada para criar listas e definir o tema de uma Web.

Exemplos de PnP

Aplicável a

  • Office 365 Multilocatário (MT)
  • Office 365 dedicado (D)
  • SharePoint 2013 local
  • Última atualização a