Partilhar via

Tipos de conteúdo e colunas de site no modelo de Suplemento do SharePoint

  • Artigo

A abordagem que você adota para criar colunas de site e tipos de conteúdo em sites do 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, você usa código declarativo para criar colunas de site e tipos de conteúdo. Na abordagem de código declarativa, você define as colunas do site e os tipos de conteúdo no XML e, em seguida, usa os elementos da estrutura de recursos do SharePoint para empacotar e implantá-los.

Em um cenário de modelo de suplemento do SharePoint, você usa as APIs REST do SharePoint Client Side Model (CSOM) ou SharePoint REST para criar colunas de site e tipos de conteúdo.

Diretrizes de alto nível

Como regra geral, recomendamos as diretrizes de alto nível a seguir para criar colunas de site e tipos de conteúdo.

  • Você deve usar as APIs CSOM ou REST do SharePoint para criar colunas de site e tipos de conteúdo.
  • Você não deve usar elementos da estrutura de recursos para criar colunas de site e tipos de conteúdo.
    • A única exceção a essa diretriz é quando você está usando provisionamento declarativo baseado em XML em uma Web de suplemento do SharePoint em um Suplemento do SharePoint hospedado no SharePoint. Isso se deve ao fato de que o CSOM não está disponível em um Suplemento do SharePoint hospedado no SharePoint.
  • Você pode automatizar a criação de colunas de site e tipos de conteúdo como parte do processo de provisionamento do site. Consulte a receita de provisionamento do site para obter mais detalhes.

Desafios ao criar colunas de site e tipos de conteúdo em sites do SharePoint

Criar em um navegador da Web versus Criar com código

É importante entender que a criação de colunas de site e tipos de conteúdo por meio do navegador da Web ou por meio de código é diferente. Esta lista descreve as diferentes opções.

  • Criando por meio de um navegador da Web
    • Nesta opção, os usuários acessam um site do SharePoint por meio de um navegador da Web e usam as Páginas Administrativas para criar colunas de site e tipos de conteúdo.
    • Normalmente, a única vez que você usará o navegador da Web para criar manualmente colunas de site e tipos de conteúdo é quando você está prototipando ou modificando um único site do SharePoint que não está planejado para crescer para incluir outras coleções de sites ou sub sites.
  • Criando com código
    • Nesta opção, você executa o código CSOM/REST do SharePoint para criar colunas de site e tipos de conteúdo.
    • Posteriormente neste artigo, você aprenderá sobre algumas opções que você pode usar para executar o código CSOM/REST do SharePoint.

Ao criar por meio de um navegador da Web, considere os pontos a seguir.

  • Criar colunas de site e tipos de conteúdo por meio do navegador da Web normalmente é um processo complicado e demorado.
    • Esses fatores o tornam propenso a erros.
  • Você não controla os GUIDs para colunas de site ou tipos de conteúdo que você cria por meio de um navegador da Web.
    • Isso dificulta a implantação consistente das colunas do site e dos tipos de conteúdo em diferentes ambientes e referenciá-los em aplicativos de linha de negócios.

Ao criar com código , considere os pontos a seguir.

  • Criar colunas de site e tipos de conteúdo com código normalmente envolve o uso de bibliotecas de utilitários personalizados para executar o código CSOM/REST do SharePoint.
    • Você encontrará essas bibliotecas disponíveis em muitos projetos no Repositório GitHub PnP do OfficeDev. Eles são referenciados ao longo do artigo e no final.
    • Esses fatores tornam a criação de colunas de site e tipos de conteúdo com código propenso ao sucesso.
  • Você pode controlar os GUIDs para colunas de site ou tipos de conteúdo que são criados por meio do CSOM/REST do SharePoint.
    • Isso facilita a implantação de colunas de site e tipos de conteúdo em diferentes ambientes e referenciá-los em aplicativos de linha de negócios de forma consistente.

Deve acontecer rapidamente!

Normalmente, você cria colunas de site e tipos de conteúdo ao provisionar um site do SharePoint. Os usuários finais não aceitarão ter que esperar várias horas para que você provisione seus novos sites do SharePoint.

Deve ser consistentemente perfeito!

Colunas de site e tipos de conteúdo são a base que define sua arquitetura de informações no nível mais baixo, elas devem ser perfeitas!

O provisionamento incorreto da coluna do site e do tipo de conteúdo pode afetar todo um aplicativo de linha de negócios no site do SharePoint em que eles são provisionados, bem como outras partes do SharePoint e outros aplicativos de linha de negócios que acessam os serviços do SharePoint.

Por exemplo: se sua empresa usar sites do SharePoint para gerenciar projetos, provavelmente você criará um esquema de lista comum para todos eles. Isso exigirá que você crie colunas de site e tipos de conteúdo. Ao pesquisar informações nesses sites por meio da página de pesquisa do SharePoint, você filtra os resultados por tipo de conteúdo ou marca (coluna do site). Se as colunas do site e os tipos de conteúdo não forem perfeitamente consistentes em todos os sites de projeto, você não receberá resultados precisos da pesquisa.

Você pode aplicar este exemplo a Web parts do Content By Search, suplementos do SharePoint, suplementos móveis do SharePoint e outros sistemas que acessam as informações nos sites do SharePoint.

Opções para criar colunas de site e tipos de conteúdo em sites do SharePoint

Há várias maneiras de chamar o código CSOM/REST para criar colunas de site e tipos de conteúdo. Todos esses padrões se enquadram na abordagem Criar com código descrita acima. Você verá cada um desses padrões descritos em detalhes na receita de provisionamento do site.

  • Substituir o link criar site
  • Substituir o link criar sub-site
  • Usar um suplemento do SharePoint hospedado pelo provedor
  • Usar aplicativos Windows/Java/iOS ou scripts do PowerShell

Independentemente da opção que você escolher implementar, você usará o CSOM/REST para criar colunas de site e tipos de conteúdo.

Há muitos artigos e exemplos diferentes que você pode usar para aprender a criar colunas de site e tipos de conteúdo com o CSOM. Aqui você encontrará esses exemplos (classificados pelo padrão usado para invocar o código CSOM) para criar colunas de site e tipos de conteúdo.

Usar um suplemento do SharePoint hospedado pelo provedor

Essa opção funciona bem quando você precisa fornecer aos usuários finais uma capacidade de autoatendimento para criar coleções de sites e sub sites do SharePoint com base em modelos personalizados.

  • Core.ContentTypesAndFields (Exemplo de PnP O365)
    • Demonstra como criar um novo tipo de conteúdo na Web do host, criar um campo de taxonomia na Web do host e conectá-lo à taxonomia, criar uma lista e associá-la a um tipo de conteúdo e criar tipos de conteúdo e campos em linguagens específicas.

Usar aplicativos Windows/Java/iOS ou scripts do PowerShell

Essa opção funciona bem em cenários Dev-Ops. Ele permite que você crie aplicativos ou scripts personalizados criados especificamente para trabalhar com seus processos de Dev-Ops. Essa opção fornece o nível final de automação porque você pode criar os suplementos e scripts do SharePoint para serem executados sem qualquer interação do usuário.

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.