Marco de aprovisionamiento PnP

El marco de trabajo de aprovisionamiento PnP proporciona una plataforma centrada en el código y basada en plantillas para el aprovisionamiento de las colecciones de sitios. El nuevo motor de aprovisionamiento le permite conservar y volver a usar los modelos de aprovisionamiento de Office 365 y SharePoint Online, así como las colecciones de sitios locales.

Nota:

El marco de aprovisionamiento de PnP & motor de aprovisionamiento de PnP son soluciones de código abierto con una comunidad activa que proporciona soporte técnico para él. No hay ningún contrato de nivel de servicio para el soporte de la herramienta de código abierto de Microsoft.

¿Por qué el enfoque nuevo?

Con la introducción de los complementos de SharePoint y el modelo de complemento (anteriormente conocido como el "modelo de aplicación"), Microsoft se ha alejado de las soluciones de plena confianza y las soluciones de espacio aislado en favor de las soluciones locales y complementos hospedados por el proveedor. Estas innovaciones han impulsado una reestructuración del modelo de aprovisionamiento y la introducción de un nuevo motor de aprovisionamiento.

Ventajas del nuevo modelo de aprovisionamiento

Hay muchas ventajas al usar este enfoque en lugar de soluciones de espacio aislado y de plena confianza. Con el nuevo modelo de aprovisionamiento, puede:

  • Personalizar plantillas. Puesto que las colecciones de sitios siempre empiezan con una plantilla de fábrica, las personalizaciones que introduce utilizando el nuevo modelo de aprovisionamiento remoto incorporan actualizaciones automáticas sin que sea necesaria ninguna tarea de mantenimiento adicional por su parte. Además, este método evita problemas que se producen por tener diferentes plantillas que se usan en diferentes colecciones de sitios.

  • Usar un modelo basado en plantillas. Proporciona un modelo de aprovisionamiento simple, basado en plantillas, que le permite guardar un diseño de sitio existente como una plantilla de aprovisionamiento.

  • Definir plantillas mediante diferentes métodos. Como alternativa, puede definir manualmente la plantilla en XML, que se valida con el esquema de aprovisionamiento PnP, o puede definir la plantilla mediante código administrado para generar una jerarquía de objetos. También se pueden mezclar los métodos.

  • Serializar y volver a usar plantillas. Puede serializar y volver a usar las plantillas de aprovisionamiento.

  • Conservar plantillas en formato serializado. Puede conservar las plantillas de aprovisionamiento en el formato de serialización que mejor le convenga, como JSON o XML.

  • Aprovisionar nuevas colecciones de sitios. Puede aprovisionar fácilmente nuevas colecciones de sitios al aplicar la plantilla de aprovisionamiento a un sitio de destino en cualquier formato de serialización que seleccione.

  • Integración con el modelo de objetos de cliente. La integración del modelo de objetos de cliente (CSOM) le ofrece una gran flexibilidad al habilitar el aprovisionamiento automatizado y basado en código. Puede aprovisionar una nueva colección de sitios con la plantilla de aprovisionamiento utilizando código CSOM/REST o secuencias de comandos de Windows PowerShell.

  • Usar el aprovisionamiento delta. Puede aplicar plantillas de aprovisionamiento sobre sitios existentes. El motor de aprovisionamiento admite el aprovisionamiento delta y, por lo tanto, puede agregar o actualizar sitios en función del ámbito proporcionado en la definición de plantilla.

  • Ampliar el motor de aprovisionamiento. Puede ampliar el motor de aprovisionamiento fácilmente a través de proveedores de extensibilidad personalizados que permiten ejecutar lógica personalizada que haya escrito con código administrado CSOM o REST.

  • Trabajar en implementaciones de Office 365 y locales. El motor de aprovisionamiento ahora le permite trabajar sin problemas entre implementaciones de Office 365 y locales. Esto supone una mejora frente a las anteriores técnicas de aprovisionamiento, donde las definiciones de sitio personalizadas no se admitían en Office 365 ya que requerían implementaciones con ámbito de granja de servidores.

El aprovisionamiento remoto en pocas palabras

En esta sección se profundiza en cada fragmento de aprovisionamiento remoto. Sin embargo, sería útil tener una visión general y comprender el aprovisionamiento remoto en su forma más sencilla. De esa manera, el aprovisionamiento remoto implica solo tres elementos:

  1. Diseñar y crear la personalización del sitio.

  2. Crear y, opcionalmente, almacenar la plantilla de aprovisionamiento en el formato de serialización que elija.

  3. Aplicar la plantilla de aprovisionamiento a una colección de sitios nueva o existente creada utilizando una plantilla de sitio de fábrica.

1. Diseñar y crear la personalización del sitio

El primer paso es crear las personalizaciones del sitio que desea guardar y aplicarlas a una colección de sitios. Hay varias maneras de hacerlo.

La forma más sencilla es realizar las modificaciones deseadas en una página de sitio existente y, después, guardar la página como una plantilla de aprovisionamiento. Para obtener más información, vea Plantillas de aprovisionamiento PnP.

También puede crear manualmente la plantilla de aprovisionamiento como un archivo XML o mediante código administrado (CSOM/REST) para crear una jerarquía de objetos para representar la estructura y los objetos del sitio. Si va a crear un archivo de esquema, debe validar el archivo en el esquema de aprovisionamiento XSD (consulte esquema de aprovisionamiento PnP).

Encontrará más información sobre el modelado del sitio en el artículo Motor de aprovisionamiento PnP y la biblioteca principal.

2. Crear y conservar la plantilla de aprovisionamiento en un formato de serialización

Exporte el modelo de sitio personalizado en el formato de serialización que prefiera; el motor de aprovisionamiento es independiente con respecto al formato de conservación. Esta instancia guardada de su personalización es la plantilla de aprovisionamiento, que, con un esfuerzo mínimo, puede aplicar a nuevas colecciones de sitios.

Tenga en cuenta que serializar y conservar la plantilla es un paso opcional que solo es necesario si desea conservar la plantilla. No es necesario serializar la plantilla para aplicarla a una colección de sitios.

3. Aplicar la plantilla de aprovisionamiento a una colección de sitios

Puede usar un script de Windows PowerShell o código CSOM/REST para aplicar la plantilla de aprovisionamiento a colecciones de sitios nuevas o existentes. También puede aprovisionar una colección de sitios completa o solo una parte de ella.

Para ver un ejemplo de aprovisionamiento remoto en acción, incluida la serialización de la plantilla de aprovisionamiento a XML, vea Ejemplo de aplicación de consola de aprovisionamiento.

Vea también