Partilhar via


Controles de usuário e controles Web no modelo de suplemento do SharePoint

A abordagem que você adota para implementar controles personalizados em seu código é diferente no novo modelo de Suplemento do SharePoint do que com o Código de Confiança Total. Em um cenário típico de FTC (Código de Confiança Total) /Farm Solution, os controles personalizados foram criados como controles de usuário ou controles Web e implantados por meio da SharePoint Solutions.

Em um cenário de modelo de suplemento do SharePoint, o JavaScript está inserido nas páginas do SharePoint para implementar controles personalizados.

Diretrizes de alto nível

Como regra geral, gostaríamos de fornecer as diretrizes de alto nível a seguir para criar controles personalizados no novo modelo de Suplemento do SharePoint.

  • Use JavaScript inserido para criar controles personalizados.
  • Use o CSOM (Modelo de Objeto lateral do cliente) do SharePoint ECMA e/ou as APIs REST do SharePoint/Office 365 para interagir com os dados e serviços do SharePoint.

Opções para inserir JavaScript em páginas do SharePoint

Você tem algumas opções para inserir JavaScript em páginas do SharePoint.

  • Usar ações personalizadas do usuário
  • Insira JavaScript diretamente em layouts de página
  • Insira JavaScript diretamente em páginas de master personalizadas (não recomendadas)

Usar ações personalizadas do usuário

Nesse padrão, as ações personalizadas do usuário são usadas para inserir o JavaScript em uma página em tempo de execução.

  • Essa abordagem é absolutamente compatível e é uma abordagem válida.

Quando isso é apropriado?

Quando você precisa inserir o JavaScript em todas as suas páginas do SharePoint, essa opção é um bom ajuste.

Introdução

O artigo a seguir e o vídeo que acompanha demonstra como usar ações personalizadas do usuário para inserir JavaScript em páginas do SharePoint.

Insira JavaScript diretamente em layouts de página

Nesse padrão, o JavaScript é inserido diretamente em layouts de página em sites de publicação.

  • Essa abordagem é absolutamente compatível e é uma abordagem válida.
  • Essa abordagem funciona com sites de publicação.

Quando isso é apropriado?

Quando você precisa inserir JavaScript em layouts de página específicos do SharePoint em sites de publicação em um cenário WCM, essa opção é um bom ajuste.

Insira JavaScript diretamente em páginas de master personalizadas

Nesse padrão, o JavaScript é inserido diretamente em páginas de master personalizadas.

  • Essa abordagem não é recomendada.
  • Essa abordagem é uma abordagem válida.
  • Você pode inserir o JavaScript diretamente em páginas de master personalizadas, mas tenha em mente que isso causará custos e desafios adicionais a longo prazo com atualizações futuras.
    • Se você optar por usar as páginas mestras personalizadas, prepare-se para aplicar as alterações às páginas mestras personalizadas quando as atualizações funcionais principais forem aplicadas ao Office 365.

Quando isso é apropriado?

Quando você precisa inserir o JavaScript de acordo com master página, essa é uma boa opção porque permite controlar em quais páginas master o JavaScript está inserido.

Exemplos de PnP

Aplicável a

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