Associação de Recursos no modelo de suplementos 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.

A abordagem adotada para executar código e implantar artefatos quando um site do SharePoint é provisionado é 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, as definições de site prontas para uso foram modificadas com recursos grampeados. Os recursos foram usados para empacotar e implantar artefatos, configurações e ativos de marca associados a um site do SharePoint e os recursos foram grampeados à definição do site. Em seguida, os recursos grampeados foram instalados e ativados automaticamente após o provisionamento do site.

Em um cenário de modelo de Suplemento do SharePoint, você pode grampear recursos, grampear Suplementos ou usar o Modelo de Objeto do Lado do Cliente (CSOM) do SharePoint para criar e configurar conjuntos de sites e subsites e, em seguida, implantar artefatos, configurações e ativos de marca neles. 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 configurar conjuntos de sites e subsites e, em seguida, implantar artefatos, configurações e ativos de marca neles.

  • A única maneira de ainda usar o grampeamento de recursos é grampeando recursos em conjuntos de sites e usando soluções de área restrita para implantar as definições de site e os recursos grampeados.
  • Você pode usar o modelo de grampeamento de suplemento com Suplementos implantados pelo locatário para implementar uma funcionalidade semelhante ao grampeamento de recursos.
  • Você pode usar o padrão de provisionamento remoto para implementar uma funcionalidade semelhante ao grampeamento de recursos, ativando recursos adicionais sobre a definição de site de caixa pronta para uso por meio de APIs remotas.

Opções para criar e configurar conjuntos de sites e subsites e, em seguida, implantar artefatos, configurações e ativos de marca neles

Você tem algumas opções para criar e configurar conjuntos de sites e subsites e, em seguida, implantar artefatos, configurações e ativos de marca neles.

  • Recursos de grampos
  • Suplementos de grampos
  • Usar o padrão de provisionamento remoto

Recursos de grampos

Nesse padrão, você grampeia recursos em definições de site.

  • Esse padrão só está disponível no nível do conjunto de sites.
  • Não é possível grampear recursos em subsites.
  • Essa não é uma abordagem ideal ou recomendada porque usa soluções de área restrita obsoletas e não prepara você bem para atualizações.

Quando isso é apropriado?

Quando você está migrando código herdado em um ambiente local do SharePoint e não tem tempo para reescrevê-lo corretamente.

Guia de Introdução

O artigo a seguir descreve como grampear recursos em uma definição de site.

Suplementos de grampos

Nesse padrão, você implanta suplementos armazenados no catálogo de aplicativos em conjuntos de sites, caminhos gerenciados e modelos de site específicos.

  • Consulte a Implantação de aplicativo do SharePoint 2013 por meio de 'Grampeamento de aplicativo' (artigo do blog do MSDN - Richard DiZerega) para obter mais detalhes sobre o modelo de grampeamento do suplemento.
  • Como o suplemento é enviado por push por um administrador, os proprietários de site não poderão remover o suplemento de um site que atenda aos critérios de implantação. Nem mesmo um administrador de conjunto de sites pode remover o suplemento.
  • Essa implantação centralizada também compartilha os mesmos recursos de suplemento centralizados (Web de Suplemento e Web Remota). Essencialmente, o suplemento é implantado, mas não instalado nos sites. Todos os sites aproveitarão o Suplemento Web e a Web Remota da instância instalada no catálogo de aplicativos.
  • Devido à implantação centralizada, eventos remotos como "Lidar com aplicativo instalado", "Lidar com aplicativo desinstalado" e "Lidar com atualização de aplicativo" serão acionados apenas uma vez (quando o Add-In estiver instalado no catálogo de aplicativos).
    • Isso pode dificultar o uso do padrão de grampeamento do Suplemento para aplicar automaticamente alterações aos sites em que ele é implantado porque esses eventos não são disparados quando ele é implantado nos sites.
  • Não há suporte para partes de suplementos quando os suplementos são grampeados em sites.
  • Esse padrão requer ações manuais do usuário para implantar os suplementos.

Usar o padrão de provisionamento remoto

Nesse padrão, você usa o CSOM (Modelo de Objeto do Lado do Cliente) do SharePoint para criar e configurar conjuntos de sites e subsites e, em seguida, implantar artefatos, configurações e ativos de marca neles.

  • Esse padrão não requer artefatos de empacotamento, configurações e ativos de marca em recursos separados ou Suplementos. Tudo pode ser empacotado em um único suplemento.

  • Ao usar esse padrão para provisionamento de sites, você normalmente substitui a página pronta para criar um novo site.

  • Para obter mais informações sobre esse padrão, consulte Provisionamento do Site (Receita de Suplemento do SharePoint)

  • Se você quiser implantar suplementos em um site do SharePoint, isso poderá ser feito por meio do CSOM. Aqui está um exemplo que carrega um Suplemento do Office por meio de um arquivo de manifesto .app e o instala em um site do SharePoint.

    //Create a FileStream object to access the Mail Office Add-in .app file
using (FileStream fsSource = new FileStream(System.Web.Hosting.HostingEnvironment.ApplicationPhysicalPath + "Innovation.Management.AFO.app",
  FileMode.Open, FileAccess.Read))
  {
//Return the subweb where you want to install the Add-in
      var subweb = ctx.Web;
      ctx.Load(subweb);
      ctx.ExecuteQuery();

//Load and Install the Add-in on the subweb
      AppInstance appInstance = subweb.LoadAndInstallApp(fsSource);
      ctx.Load(appInstance);
      ctx.ExecuteQuery();
  }

Exemplos de PnP

Aplicável a

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