Acciones personalizadas 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.

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.
  • 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.

    Aparecerá el menú de configuración de Office 365 con la opción de menú Modificar sitio resaltada.

    Aquí puede ver la ventana emergente abierta a través del enlace Modificar sitio.

    La ventana emergente Modificar sitio se muestra con un grupo de casillas de verificación llamado Listas que contiene dos casillas de verificación, Proyectos y Contactos. Debajo de Listas hay un grupo de casillas llamado Varios que contiene la casilla de verificación denominada Aplicar tema. Debajo hay dos botones denominados Confirmar y Cancelar.

Ejemplos de PnP

Se aplica a

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