Acciones personalizadas en el modelo de complemento de SharePoint

Resumen

El enfoque que se usa para modificar los menús de elementos de lista y la cinta de opciones de 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 solución de granja o código de plena confianza (FTC), los menús de elementos de lista y las modificaciones de la cinta de opciones se definieron en XML (acciones personalizadas), se empaquetaron en características e 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 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 complemento de SharePoint.

• Las acciones personalizadas se pueden usar para modificar los menús de elementos de lista y la cinta de opciones.
• No se pueden ocultar 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 el modelo de objetos (CSOM) de clientes ECMA de SharePoint: propiedades UserCustomAction (documentación de la API de MSDN) o las API REST de SharePoint/Office 365 : SP. Objeto UserCustomActionCollection (sp.js) (documentación de LA API de MSDN).
  • Si necesita ocultar elementos de menú, debe usar una acción personalizada para insertar JavaScript o CSS personalizado en páginas de SharePoint. JavaScript o CSS incrustados en las páginas de SharePoint ocultan el elemento de menú.
• Use el modelo de objetos del lado cliente de SharePoint (CSOM) o las API REST de SharePoint/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 desde una web de complemento remoto y cómo usar una acción personalizada para crear listas y establecer el tema de una web.

• Provisioning.SiteModifier (ejemplo PnP de O365)

  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 vínculo Modificar sitio.

  

Vínculos relacionados

• Controles de usuario y controles web (receta de complemento de SharePoint)
• Artículos de orientación en https://aka.ms/OfficeDevPnPGuidance
• Referencias en MSDN en https://aka.ms/OfficeDevPnPMSDN
• Vídeos en https://aka.ms/OfficeDevPnPVideos

Ejemplos de PnP

• Provisioning.SiteModifier (ejemplo PnP de O365)
• Ejemplos y contenido en Patrones y prácticas de Microsoft 365 (PnP)

Se aplica a

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