Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 ejecutar código e implementar artefactos cuando se aprovisiona un sitio de SharePoint es diferente en el nuevo modelo de complementos 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, las definiciones de sitio listas para usar se modificaron con características grapadas. Las características se usaban para empaquetar e implementar artefactos, configuraciones y activos de marca asociados a un sitio de SharePoint y las características se grapan a la definición del sitio. Luego, las funciones grapadas se instalaron y activaron automáticamente al aprovisionar el sitio.
En un escenario de modelo de complemento de SharePoint, puede grapar características, grapar complementos o usar el modelo de objetos del lado cliente (CSOM) de SharePoint para crear y configurar colecciones de sitios y subsitios y, a continuación, implementar artefactos, configuraciones y activos de marca en ellos. Este patrón se conoce como patrón de aprovisionamiento remoto.
Directrices avanzadas
Como regla general, nos gustaría proporcionar las siguientes directrices de alto nivel para crear y configurar colecciones de sitios y subsitios y, a continuación, implementar artefactos, configuraciones y activos de marca en ellos.
- La única forma en que puede seguir utilizando el grapado de entidades es cuando grapa entidades en colecciones de sitios y usa soluciones de espacio aislado para implementar las definiciones de sitio y las entidades grapadas.
- Puede usar el modelo de grapado de complementos con complementos implementados por el inquilino para implementar una funcionalidad similar al grapado de características.
- Puede usar el patrón de aprovisionamiento remoto para implementar una funcionalidad similar al grapado de características activando características adicionales sobre la definición de sitio lista para usar a través de API remotas.
Opciones para crear y configurar colecciones de sitios y subsitios, y luego implementar artefactos, configuraciones y activos de marca en ellos
Tiene varias opciones para crear y configurar colecciones de sitios y subsitios, y luego implementar artefactos, configuraciones y activos de marca en ellos.
- Características básicas
- Complementos básicos
- Uso del patrón de aprovisionamiento remoto
Características básicas
En este patrón, puede grapar características a las definiciones de sitio.
- Este patrón solo está disponible en el nivel de colección de sitios.
- No es posible grapar características a subsitios.
- Este no es un enfoque óptimo o recomendado porque usa soluciones de espacio aislado obsoletas y no le prepara bien para las actualizaciones.
¿Cuándo es una buena opción?
Cuando está migrando código heredado en un entorno de SharePoint local y no tiene tiempo para reescribirlo correctamente.
Introducción
En el siguiente artículo se describe cómo grapar características a una definición de sitio.
Complementos básicos
En este patrón, implementa complementos almacenados en el catálogo de aplicaciones en colecciones de sitios, rutas de acceso administradas y plantillas de sitio específicas.
- Consulte Implementación de aplicaciones de SharePoint 2013 a través del grapado de aplicaciones (artículo del blog de MSDN: Richard DiZerega) para obtener más información sobre el modelo de grapado de complementos.
- Dado que un administrador inserta el complemento, los propietarios del sitio no podrán quitar el complemento de un sitio que cumpla los criterios de implementación. Ni siquiera un administrador de colección de sitios puede quitar el complemento.
- Esta implementación centralizada también comparte los mismos recursos de complemento centralizados (web de complemento y web remota). Básicamente, el complemento se implementa, pero no se instala en los sitios. Todos los sitios aprovecharán la Web del complemento y la Web remota de la instancia instalada en el catálogo de aplicaciones.
- Debido a la implementación centralizada, los eventos remotos como "Controlar aplicación instalada", "Gestionar aplicación desinstalada" y "Gestionar actualización de aplicación" solo se activarán una vez (cuando el Add-In se instale en el catálogo de aplicaciones).
- Esto puede dificultar el uso del patrón de grapado de complemento para aplicar automáticamente cambios en los sitios donde se implementa, ya que estos eventos no se activan cuando se implementa en sitios.
- Los elementos de complemento no son compatibles cuando los complementos se grapan a sitios.
- Este patrón requiere acciones manuales del usuario para implementar los complementos.
Uso del patrón de aprovisionamiento remoto
En este patrón, se usa el modelo de objetos del lado cliente (CSOM) de SharePoint para crear y configurar colecciones de sitios y subsitios, y luego implementar artefactos, configuraciones y activos de marca en ellos.
Este patrón no requiere empaquetar artefactos, configuraciones y activos de marca en características o complementos independientes. Todo se puede empaquetar en un único complemento.
Cuando se usa este patrón para el aprovisionamiento de sitios, normalmente se reemplaza la página de configuración rápida para crear un sitio nuevo.
Para obtener más información acerca de este patrón, consulte el aprovisionamiento del sitio (receta del complemento de SharePoint)
Si desea implementar complementos en un sitio de SharePoint, puede hacerlo a través del CSOM. A continuación se muestra un ejemplo en el que se carga un complemento de Office a través de un archivo de manifiesto de .app y se instala en un sitio de SharePoint.
//Create a FileStream object to access the Mail Office Add-in .app file using (FileStream fsSource = new FileStream(System.Web.Hosting.HostingEnvironment.ApplicationPhysicalPath + "Innovation.Management.AFO.app", FileMode.Open, FileAccess.Read)) { //Return the subweb where you want to install the Add-in var subweb = ctx.Web; ctx.Load(subweb); ctx.ExecuteQuery(); //Load and Install the Add-in on the subweb AppInstance appInstance = subweb.LoadAndInstallApp(fsSource); ctx.Load(appInstance); ctx.ExecuteQuery(); }- Vea el vídeo Creación de aplicaciones de línea de negocio hospedadas en la nube con complementos para Office, O365, Azure y WP8 (Todd Baginski, Michael Sherman - SharePoint Conference 2014) para ver cómo se usó este enfoque para instalar complementos de Office en sitios de SharePoint durante el aprovisionamiento del sitio.
- La automatización completa solo es posible con complementos que tengan permiso completo de inquilino que ya sean de confianza.
- Consulte Core.Sideloading (ejemplo de O365 PnP) para ver un ejemplo.
Vínculos relacionados
- Aprovisionamiento de sitios sin intervención del administrador con complementos de SharePoint 2013 (Blog de MSDN)
- Implementación de aplicaciones de SharePoint 2013 a través del "grapado de aplicaciones" (artículo del blog de MSDN: Richard DiZerega)
- Aprovisionamiento de sitios (receta del complemento de SharePoint)
- Creación de aplicaciones de línea de negocio hospedadas en la nube con complementos para Office, O365, Azure y WP8 (Todd Baginski, Michael Sherman - Conferencia de SharePoint 2014)
- Artículos de orientación en https://aka.ms/OfficeDevPnPGuidance
- Referencias en MSDN en https://aka.ms/OfficeDevPnPMSDN
- Videos en https://aka.ms/OfficeDevPnPVideos
Ejemplos de PnP
- Provisioning.Cloud.Sync (ejemplo de PnP de O365)
- Provisioning.SubSiteCreationApp (ejemplo de PnP de O365)
- Provisioning.Services.SiteManager (ejemplo de PnP de O365)
- Provisioning.SiteCollectionCreation (ejemplo PnP de O365)
- Ejemplos y contenido en Microsoft 365 Patrones y prácticas (PnP)
Se aplica a
- Office 365 multiempresa (MT)
- Office 365 dedicado (D)
- SharePoint 2013 local