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.
- Core.EmbedJavaScript (Exemplo de PnP O365)
- OD4B. NavLinksInjection (Exemplo de PnP O365)
- Navegação de coleção de sites cruzados (Vídeo PnP do O365)
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.
Links relacionados
- Navegação de coleção de sites cruzados (Vídeo PnP do O365)
- Artigos de diretrizes em https://aka.ms/OfficeDevPnPGuidance
- Referências no MSDN em https://aka.ms/OfficeDevPnPMSDN
- Vídeos em https://aka.ms/OfficeDevPnPVideos
Exemplos de PnP
- Core.EmbedJavaScript (Exemplo de PnP O365)
- OD4B. NavLinksInjection (Exemplo de PnP O365)
- Core.EmbedJavaScript.WeekNumbers (Amostra O365 PnP)
- Core.EmbedJavaScriptJSOM (amostra O365 PnP)
- Core.JavaScriptCustomization (Cenário O365 PnP usando o componente PnP Core)
- Exemplos e conteúdo no Microsoft 365 Patterns and Practices (PnP)
Aplicável a
- Office 365 Multilocatário (MT)
- Office 365 dedicado (D)
- SharePoint 2013 local