Definição de lista/modelo de lista 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 criar definições de lista/modelos de lista é 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, definições de lista/modelos de lista personalizados foram criados com código declarativo e implantados por meio de Soluções do SharePoint.

Em um cenário de modelo de suplemento do SharePoint, não é possível criar definições de lista personalizadas. É simplesmente impossível fazer isso. No entanto, o padrão de provisionamento remoto pode ser usado para implantar modelos de lista personalizados (arquivos .stp) no Office 365.

Diretrizes de Alto Nível

Como regra geral, gostaríamos de fornecer as seguintes diretrizes de alto nível para implementar definições de lista / modelos de lista.

  • Use o padrão de provisionamento remoto para implantar modelos de lista (arquivos .stp) em sites do SharePoint.
  • Você pode substituir o comportamento de criação de lista pronto para uso para aplicar configurações padronizadas a todas as listas criadas em um site do SharePoint. Veja mais detalhes sobre essa abordagem abaixo.
  • Você pode criar um Suplemento do SharePoint para criar listas com configurações padronizadas. Veja mais detalhes sobre essa abordagem abaixo.

Opções para garantir que configurações padronizadas (modelos) sejam aplicadas às listas do SharePoint após a criação da lista

Você tem algumas opções para garantir que as configurações padronizadas (modelos) sejam aplicadas às listas do SharePoint após a criação da lista.

  • Substitua o comportamento de criação de lista pronta para uso.
  • Criar um suplemento do SharePoint.

Substituir o comportamento de criação de lista pronta para uso

Nesse padrão, você modifica o comportamento de criação de lista pronta para uso adicionando um receptor de eventos ao evento ListAdded. Em seguida, no receptor de eventos configurado para o evento ListAdded, você usa o padrão de provisionamento remoto para aplicar configurações padronizadas a cada lista criada.

Essas configurações padronizadas podem incluir a adição de tipos de conteúdo, a definição do tipo de conteúdo padrão, a adição de colunas de lista, a definição das configurações de versão e quaisquer outras configurações de tipo de lista que possam ser definidas.

  • Essa abordagem permite que você aplique configurações padronizadas para todas as listas.
  • Essa abordagem permite aplicar configurações padronizadas a diferentes tipos de listas.
    • Por exemplo: Se você criar uma biblioteca de documentos e uma lista de tarefas, poderá determinar no receptor de eventos ListAdded que tipo de lista você criou e poderá aplicar diferentes configurações padronizadas com base no tipo de lista. Talvez todas as bibliotecas de documentos precisem de um conjunto de tipos de conteúdo aplicado a elas, enquanto todas as listas de tarefas precisam de um conjunto diferente de tipos de conteúdo aplicado a elas.
  • Essa abordagem não dá suporte à aplicação de várias opções de modelo diferentes a listas.
    • Por exemplo: Se você criar uma biblioteca de documentos e uma lista de tarefas, poderá determinar no receptor de eventos ListAdded que tipo de lista você criou e poderá aplicar diferentes configurações padronizadas com base no tipo de lista. No entanto, você não pode aplicar modelos diferentes a uma biblioteca de documentos criada versus outra biblioteca de documentos criada por você.

Quando isso é apropriado?

Quando você precisar aplicar configurações globais padronizadas a todas as listas ou listas de um tipo específico.

Quando não é uma boa opção?

Quando você precisar aplicar várias opções de modelos diferentes a listas.

Guia de Introdução

A seguinte receita de modelo de suplemento do SharePoint descreve como implementar receptores de eventos.

Criar um suplemento do SharePoint

Nesse padrão, você cria um Suplemento do SharePoint para criar listas com configurações padronizadas e instrui os usuários a usar o Suplemento do SharePoint para criar novas listas. Essencialmente, o Suplemento do SharePoint fornece aos usuários opções de diferentes listas para criar. As diferentes listas que o Suplemento do SharePoint permite que os usuários criem são definidas pela empresa e implementadas por um desenvolvedor. Os usuários preenchem um formulário no Suplemento do SharePoint para especificar os metadados da lista e escolhem qual lista criar entre as opções que o Suplemento oferece. O suplemento usa o padrão de provisionamento remoto para criar a lista de acordo.

  • Essa abordagem permite que você aplique configurações padronizadas para todas as listas.
  • Essa abordagem permite aplicar configurações padronizadas a diferentes tipos de listas.
  • Essa abordagem permite que você aplique várias opções de modelo diferentes a listas.

Quando isso é apropriado?

Quando você precisar aplicar várias opções de modelos diferentes a listas.

Guia de Introdução

O seguinte exemplo e vídeo de código PnP do O365 demonstra como criar um suplemento do SharePoint que fornece uma interface de usuário que permite que os usuários finais criem novas bibliotecas de documentos. Ele também demonstra como criar uma biblioteca de documentos com configurações específicas que representam coletivamente um modelo.

O vídeo a seguir explica o exemplo de código.

Exemplos de PnP

Aplicável a

  • Office 365 Multilocatário (MT)
  • Office 365 dedicado (D) parcialmente
  • SharePoint 2013 local, parcialmente

Os padrões para dedicados e locais são idênticos às técnicas de modelo do suplemento do SharePoint, mas há diferenças nas possíveis tecnologias que podem ser usadas.