Compartilhar via

Associação de Recursos no modelo de suplementos do SharePoint

  • Artigo

A abordagem que você adota para executar o 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) / Farm Solution, definições de site fora da caixa foram modificadas com recursos grampeados. Os recursos foram usados para empacotar e implantar artefatos, configurações e ativos de branding associados a um site do SharePoint e recursos foram grampeados para a definição do site. Em seguida, os recursos grampeados foram instalados automaticamente e ativados no provisionamento do site.

Em um cenário de modelo de suplemento do SharePoint, você pode grampear recursos, grampear suplementos ou usar o CSOM (Modelo de Objeto Lateral do Cliente) do SharePoint para criar e configurar coleções de sites e sub sites e, em seguida, implantar artefatos, configurações e ativos de branding para eles. 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 configurar coleções de sites e sub-sites e, em seguida, implantar artefatos, configurações e ativos de branding para eles.

  • A única maneira de usar o stapling de recursos é quando você está stapling recursos para coleções de sites e você está usando soluções de área restrita para implantar as definições do site e os recursos grampeados.
  • Você pode usar o modelo de stapling de suplemento com suplementos implantados pelo locatário para implementar funcionalidade semelhante à stapling de recursos.
  • Você pode usar o padrão de provisionamento remoto para implementar a funcionalidade semelhante ao stapling de recursos ativando recursos adicionais em cima da definição de site fora da caixa por meio de APIs remotas.

Opções para criar e configurar coleções de sites e sub sites, em seguida, implantar artefatos, configurações e ativos de branding para eles

Você tem algumas opções para criar e configurar coleções de sites e sub sites e, em seguida, implantar artefatos, configurações e ativos de branding para eles.

  • Recursos básicos
  • Suplementos básicos
  • Usar o padrão de provisionamento remoto

Recursos básicos

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

  • Esse padrão só está disponível no nível da coleção do site.
  • Não é possível grampear recursos para sub sites.
  • Essa não é uma abordagem ideal ou recomendada porque usa soluções de área restrita preteridas e não configura você bem para atualizações.

Quando isso é apropriado?

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

Guia de Introdução

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

Suplementos básicos

Nesse padrão, você implanta suplementos armazenados no catálogo de aplicativos em coleções de sites específicas, caminhos gerenciados e modelos de site.

  • Consulte a Implantação de Aplicativo do SharePoint 2013 por meio de 'App Stapling' (Artigo do Blog do MSDN - Richard DiZerega) para obter mais detalhes sobre o modelo de stapling de suplemento.
  • Como o suplemento é pressionado por um administrador, os proprietários do site não poderão remover o suplemento de um site que atenda aos critérios de implantação. Nem mesmo um administrador de coleção 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 'Manipular Aplicativo Instalado', 'Manipular Aplicativo Desinstalado' e 'Manipular Atualização de Aplicativo' só serão acionados uma vez (quando o Add-In estiver instalado no catálogo de aplicativos).
    • Isso pode dificultar o uso do padrão de stapling de suplemento para aplicar automaticamente alterações aos sites em que ele é implantado porque esses eventos não são disparados quando são implantados em sites.
  • Não há suporte para partes de suplemento quando 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 Lateral do Cliente) do SharePoint para criar e configurar coleções de sites e sub-sites e implantar artefatos, configurações e ativos de branding para eles.

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

  • Quando você usa esse padrão para provisionamento de sites, normalmente substitui a página fora da caixa para criar um novo site.

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

  • Se você quiser implantar suplementos em um site do SharePoint, isso pode 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