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.
Resumen
El enfoque que adopte para modificar los menús de elementos de lista y la cinta de opciones en SharePoint 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 confianza total (FTC)/solución de granja de servidores, los menús de elementos de lista y las modificaciones de la cinta se definieron en XML (acciones personalizadas), se empaquetaron en características y se implementaron a través de soluciones de SharePoint.
En un escenario de modelo de complemento de SharePoint, se usa el modelo de objetos del lado cliente (CSOM) de SharePoint o la API de REST para crear acciones personalizadas que modifiquen los menús de elementos de lista y la cinta de opciones. Este patrón se conoce como patrón de aprovisionamiento remoto.
Directrices importantes
Como regla general, nos gustaría proporcionar las siguientes directrices de alto nivel para crear e implementar acciones personalizadas en el nuevo modelo de complementos de SharePoint.
- Las acciones personalizadas se pueden usar para modificar los menús de elementos de lista y la cinta de opciones.
- No puede ocultar los elementos de menú mediante una acción personalizada directamente desde un complemento que implementa una acción personalizada.
- Esto se debe a que el elemento HideCustomAction (documentación de la API de MSDN) no está disponible en las propiedades UserCustomAction de SharePoint ECMA Clients-IDE (CSOM) - UserCustomAction (documentación de la API de MSDN) o en las API de REST de SharePoint u Office 365 - SP. Objeto UserCustomActionCollection (sp.js) (documentación de la API de MSDN).
- Si necesita ocultar los elementos del menú, debe usar una acción personalizada para insertar JavaScript o CSS personalizado en las páginas de SharePoint. El JavaScript o CSS incrustado en las páginas de SharePoint oculta el elemento de menú.
- Use el modelo de objetos del lado cliente (CSOM) de SharePoint o las API de REST de SharePoint u Office 365 para implementar acciones personalizadas.
Introducción
En el ejemplo siguiente se muestra cómo agregar una acción personalizada al menú de configuración del sitio en la web host, cómo mostrar un cuadro de diálogo en una acción personalizada, cómo ocultar un cuadro de diálogo que hospeda una página de un complemento web remoto y cómo usar una acción personalizada para crear listas y establecer el tema de una web.
Provisioning.SiteModifier (ejemplo de O365 PnP)
Aquí puede ver el vínculo que la acción personalizada del ejemplo agrega al menú Configuración del sitio.
Aquí puede ver la ventana emergente abierta a través del enlace Modificar sitio.
Vínculos relacionados
- Controles de usuario y controles web (receta del complemento de SharePoint)
- 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.SiteModifier (ejemplo de O365 PnP)
- 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