Definición de lista o plantilla de lista 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 adopte para crear definiciones o plantillas de lista 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 confianza total (FTC)/solución de granja de servidores, se crearon definiciones de lista personalizadas o plantillas de lista con código declarativo y se implementaron mediante soluciones de SharePoint.

En un escenario de modelo de complemento de SharePoint, no se pueden crear definiciones de lista personalizadas. Es simplemente imposible hacer esto. Sin embargo, el patrón de aprovisionamiento remoto se puede usar para implementar plantillas de lista personalizadas (archivos .stp) en Office 365.

Directrices avanzadas

Como regla general, nos gustaría proporcionar las siguientes pautas de alto nivel para implementar definiciones de listas / plantillas de listas.

  • Use el patrón de aprovisionamiento remoto para implementar plantillas de lista (archivos .stp) en sitios de SharePoint.
  • Puede invalidar el comportamiento de creación de listas listas para usar para aplicar una configuración estandarizada a todas las listas creadas en un sitio de SharePoint. Consulte más detalles sobre este enfoque a continuación.
  • Puede crear un complemento de SharePoint para crear listas con una configuración estandarizada. Consulte más detalles sobre este enfoque a continuación.

Opciones para garantizar que la configuración estandarizada (plantillas) se aplica a las listas de SharePoint tras la creación de la lista

Tiene un par de opciones para asegurarse de que se aplica una configuración estandarizada (plantillas) a las listas de SharePoint tras la creación de la lista.

  • Invalidar el comportamiento de creación de listas listas para usar.
  • Cree un complemento de SharePoint.

Invalidar el comportamiento de creación de listas listas para usar

En este patrón, se modifica el comportamiento de creación de listas listas para usar agregando un receptor de eventos al evento ListAdded. A continuación, en el receptor de eventos configurado para el evento ListAdded, usa el patrón de aprovisionamiento remoto para aplicar configuraciones estandarizadas a cada lista que se crea.

Estas configuraciones estandarizadas pueden incluir la adición de tipos de contenido, la configuración del tipo de contenido predeterminado, la adición de columnas de lista, la configuración de la versión y cualquier otra configuración de tipo de lista que se pueda establecer.

  • Este enfoque le permite aplicar una configuración estandarizada para todas las listas.
  • Este enfoque le permite aplicar una configuración estandarizada a diferentes tipos de listas.
    • Por ejemplo: si crea una biblioteca de documentos y una lista de tareas, puede determinar en el receptor de eventos ListAdded qué tipo de lista ha creado y puede aplicar diferentes configuraciones estandarizadas en función del tipo de lista. Quizás todas las bibliotecas de documentos necesitan un conjunto de tipos de contenido aplicados, mientras que todas las listas de tareas necesitan un conjunto diferente de tipos de contenido aplicados.
  • Este enfoque no admite la aplicación de varias opciones de plantilla diferentes a las listas.
    • Por ejemplo: si crea una biblioteca de documentos y una lista de tareas, puede determinar en el receptor de eventos ListAdded qué tipo de lista ha creado y puede aplicar diferentes configuraciones estandarizadas en función del tipo de lista. Sin embargo, no puede aplicar plantillas diferentes a una biblioteca de documentos que cree frente a otra biblioteca de documentos que cree.

¿Cuándo es una buena opción?

Cuando necesite aplicar una configuración global estandarizada a todas las listas o listas de un tipo específico.

¿Cuándo no encaja?

Cuando necesitas aplicar varias opciones de plantillas diferentes a las listas.

Introducción

En la siguiente receta del modelo de complemento de SharePoint se describe cómo implementar receptores de eventos.

Crear un complemento de SharePoint

En este patrón se crea un complemento de SharePoint para crear listas con una configuración estandarizada e indicar a los usuarios que usen el complemento de SharePoint para crear nuevas listas. Básicamente, el complemento de SharePoint proporciona a los usuarios opciones de diferentes listas para crear. Las diferentes listas que el complemento de SharePoint permite crear a los usuarios son definidas por la empresa e implementadas por un desarrollador. Los usuarios rellenan un formulario en el complemento de SharePoint para especificar los metadatos de la lista y elegir qué lista crear entre las opciones que ofrece el complemento. El complemento usa el patrón de aprovisionamiento remoto para crear la lista en consecuencia.

  • Este enfoque le permite aplicar una configuración estandarizada para todas las listas.
  • Este enfoque le permite aplicar una configuración estandarizada a diferentes tipos de listas.
  • Este enfoque le permite aplicar varias opciones de plantilla diferentes a las listas.

¿Cuándo es una buena opción?

Cuando necesitas aplicar varias opciones de plantillas diferentes a las listas.

Introducción

El siguiente ejemplo de código PnP de O365 y el vídeo muestran cómo crear un complemento de SharePoint que proporciona una interfaz de usuario que permite a los usuarios finales crear nuevas bibliotecas de documentos. También se muestra cómo crear una biblioteca de documentos con una configuración específica que representa de manera colectiva una plantilla.

El siguiente vídeo le guiará por el ejemplo de código.

Ejemplos de PnP

Se aplica a

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

Los modelos para Office 365 dedicado y local son idénticos a las técnicas del modelo de complemento de SharePoint, pero existen algunas diferencias en las posibles tecnologías que se pueden usar.