Elemento web en el modelo de complemento de SharePoint

Importante

Los complementos de SharePoint alcanzaron la finalización de su vida útil en SharePoint Online el 2 de abril de 2026. Tanto los complementos hospedados por SharePoint como los hospedados por el proveedor se retiran y ya no funcionan en SharePoint Online, incluidas las nubes de administración pública. Las instrucciones de uso, implementación y desarrollo de complementos se conservan como referencia histórica y para escenarios de SharePoint Server aplicables, no para nuevas soluciones de SharePoint Online.

Los complementos de SharePoint Server implementados a través de un catálogo de aplicaciones local no se retiran por este cambio. La adquisición de complementos de SharePoint en el marketplace público finalizó el 2 de abril de 2026 para SharePoint Server.

Esta retirada no retira las API de REST DE SHAREPOINT, CSOM, JSOM o SharePoint Framework (SPFx). Para SharePoint Online, use SPFx para las extensiones de la interfaz de usuario y Microsoft Entra ID para la autenticación en aplicaciones externas. Consulte el anuncio de retirada y las instrucciones de migración de complementos.

El enfoque que adopta para crear componentes de página portátiles es diferente en el nuevo modelo de complemento de SharePoint que con el código de plena confianza. En un escenario típico de código de plena confianza (FTC)/solución de granja de servidores, los elementos web se crearon para implementar componentes de página portátiles.

En un escenario de modelo de complemento de SharePoint, los elementos de complemento (elementos de aplicación) se crean para implementar componentes de página portátiles. Los elementos del complemento usan código del lado cliente.

Directrices avanzadas

Como regla general, nos gustaría proporcionar las siguientes directrices de alto nivel con respecto a los elementos de complemento.

  • No se puede ejecutar el código del lado servidor en los elementos de complemento.
  • No se pueden crear elementos del editor personalizados para elementos de complemento.
  • Use el elemento de script de complemento para vincular a JavaScript, que se usa para interactuar con SharePoint y otros servicios, y para crear una interfaz de usuario.
  • De forma predeterminada, las propiedades personalizadas que agregue a los elementos del editor siempre se muestran como el grupo final en un elemento del editor.

Introducción

Los elementos de complemento se pueden crear fácilmente mediante el elemento de script de complemento listo para usar. Esto le permite proporcionar un vínculo a un archivo JavaScript hospedado en cualquier lugar. El archivo JavaScript usa código del lado cliente para interactuar con SharePoint u otros servicios y representar una interfaz de usuario.

En el siguiente artículo se describe el patrón de elemento de script de complemento y cómo usarlo.

En el ejemplo siguiente se muestra cómo usar un elemento de script de complemento para integrarse con Yammer, Mapas de Bing y Google Maps.

El siguiente vídeo le guiará a través del ejemplo de código.

Ejemplos de PnP

Se aplica a

  • Office 365 multiempresa (MT)
  • Office 365 dedicado (D)
  • SharePoint 2013 local