Transformación de soluciones de granja en el modelo de complementos de SharePoint

Artículo
04/08/2023

Si ha extendido su entorno de SharePoint mediante soluciones de granja y desea migrar sus extensiones al modelo de complementos de SharePoint para que su transición a SharePoint Online le resulte más sencilla, tiene que transformar sus soluciones de granja en el modelo de complementos de SharePoint.

La transformación de las soluciones de granja en el modelo de complementos de SharePoint implica analizar las extensiones existentes, diseñar y desarrollar el nuevo complemento de SharePoint y realizar las pruebas e implementar el complemento en su entorno de producción.

Este artículo describe el proceso y los procedimientos recomendados que se deben usar para transformar soluciones de granja en el modelo de complementos de SharePoint.

Planeamiento del proceso de transformación

Al transformar las soluciones de granja en el modelo de complementos de SharePoint, debe asegurarse de que el impacto para los usuarios sea mínimo. Analice detenidamente las soluciones de granja actuales y diseñe su nuevo complemento de SharePoint para satisfacer las necesidades de su organización. Se recomienda el siguiente proceso para asegurarse de que la transformación es correcta.

Preparación

Obtenga información sobre:

El modelo de complementos de SharePoint, diferentes tipos de complementos y opciones de hospedaje. Para obtener más información, consulte Complementos de SharePoint.
Tecnología de acceso remoto para acceder a los datos locales.

Evaluación de la solución

Analice los requisitos funcionales y empresariales con los siguientes pasos:

Identifique las soluciones de granja implementadas en su entorno actual. Puede usar herramientas de terceros para identificar extensiones implementadas. Realice un análisis detallado de cada solución de granja identificada.
Revise los requisitos con los usuarios. Considere pedir a los usuarios que muestren cómo usan las soluciones de granja existentes para realizar su trabajo diario.
Identificar, documentar y diseñar nuevas funciones para incluir en el nuevo complemento de SharePoint. Considere revisar la lista de solicitudes de características nuevas de los usuarios para obtener más ideas.
Identificar las características que no se usan y acordar con los usuarios omitir estas funcionalidades en el nuevo complemento de SharePoint.
Determinar si se debe reemplazar una solución de granja por un complemento de SharePoint. Algunas soluciones, como las extensiones de administración de SharePoint, no pueden duplicarse en el modelo de complementos de SharePoint. Para obtener más información, vea SharePoint Application Lifecycle Management (Administración del ciclo de vida de la aplicación de SharePoint) y Complementos de SharePoint en comparación con las soluciones de SharePoint.

Planificación de la solución

Diseñe la nueva aplicación mediante el modelo de complementos de SharePoint basándose en:

Los requisitos que ha obtenido en el paso Evaluación de la solución.
El análisis del código existente. Durante el análisis del código, considere la posibilidad de identificar las partes del código que se pueden quitar (por ejemplo, el código ya no se usa o han cambiado los requisitos).

Desarrolle y pruebe la versión del modelo del complemento de SharePoint de la aplicación

Este suele ser el paso más largo en el proceso de transformación.

Implemente el nuevo complemento

Dependiendo de sus necesidades, puede decidir que las soluciones de granja se sigan ejecutando en paralelo con el nuevo complemento de SharePoint, o puede retirar la solución de granja de servidores y permitir únicamente que los usuarios utilicen el nuevo complemento de SharePoint. En cualquier caso, asegúrese de que la implementación sea estable y envíe la información correspondiente a los usuarios.

Si su contenido en las colecciones de sitios existentes depende de las soluciones de granja (por ejemplo, si el contenido se creó utilizando un tipo de contenido), antes retirar por completo la solución de granja, deberá transformar el contenido existente para poder usar la nueva solución de modelo de complementos de SharePoint. Asegúrese de que deja tiempo suficiente para que se complete esta tarea, ya que puede ser difícil y llevar mucho tiempo.

Métodos de transformación para implementar el nuevo complemento de SharePoint

Cuando termine el desarrollo y la prueba unitaria de su nuevo complemento de SharePoint, comience a transformar su solución de granja en el nuevo complemento de SharePoint utilizando uno de los métodos de transformación enumerados en la tabla siguiente.

Método de transformación	Descripción	Ventajas	Desventajas
En contexto	Implemente el nuevo complemento de SharePoint en su entorno existente de SharePoint. Debe asegurarse de que el sitio usa el nuevo complemento de SharePoint antes de retirar la solución de granja.	Menor impacto general para los usuarios. Se precisan menos recursos, ya que está usando su entorno existente de SharePoint. No son necesarias herramientas de terceros. Tiempo de inactividad del sitio mínimo. Actualizar una colección de sitios de cada vez en lugar de actualizar la granja de servidores al completo de una sola vez. Las URL no cambian.	Es difícil realizar un seguimiento del progreso de finalización de todos los activos afectados en un sitio. Aumenta la posibilidad de crear huérfanos (cuando un activo señala a un archivo en el sistema que no existe, esto se conoce como huérfano).
Recorrido o migración de contenido	Extraiga el contenido de las colecciones de sitios existentes donde están implementadas actualmente sus soluciones de granja e implemente el contenido en una nueva colección de sitios que utilice el nuevo complemento de SharePoint. Al migrar contenido a SharePoint Online, normalmente se utiliza este proceso.	Limpiar el entorno de SharePoint sin dependencias de solución de granja previas. La nueva colección de sitios está aislada de su entorno de producción. Lance la colección de sitios actualizada cuando esté lista. .	Requiere herramientas de terceros para ayudarle con la migración de contenido. Requiere un entorno de SharePoint adicional. Requiere tiempo de inactividad del sitio. Las URL pueden cambiar si ejecuta ambos sitios en paralelo durante un tiempo.

Procedimientos recomendados para soluciones de granja específicas

Siga los procedimientos recomendados a continuación para transformar soluciones específicas.

Diseños de página y páginas maestras

Es posible que haya diseños de página y páginas maestras en sitios de publicación o de grupo con características de publicación activadas.

Para reemplazar diseños de página y páginas maestras:

Cargue el nuevo diseño de página o la nueva página maestra en el sitio. Cargue nuevas páginas maestras y diseños de página a la colección de sitios manualmente o con API remotas. Las API remotas incluyen el modelo de objetos del lado cliente (CSOM) o REST. Así se asegura de que las páginas maestras y diseños de página no tienen dependencias en una solución de granja.
Configure el sitio para usar los nuevos diseños de página y páginas maestras.
Retire la versión anterior de las páginas maestras y diseños de página.

Controles y elementos web

Para reemplazar los controles y elementos web:

Examine todas las páginas existentes para determinar cuáles tienen elementos web.
(Opcional) Revise los elementos web integrados para determinar si alguno puede reemplazar el elemento web personalizado.
Reemplace los elementos web con instancias de elementos de aplicación o con otras técnicas (como JavaScript incrustados en páginas o diseños de página) para obtener la misma funcionalidad.
Use JavaScript incrustados para manipular los elementos de la UI.

Nota:

Para reemplazar los elementos web existentes con elementos de aplicación, debe:

Habilitar la instalación de prueba de complementos en su suscripción de Office 365. Ponerse en contacto con su administrador de Office 365.
Usar CSOM para habilitar la instalación de prueba de complementos en el sitio. Para obtener más información, vea el ejemplo de código Core.SideLoading.
Instalar el elemento de aplicación en el sitio.
Deshabilitar la instalación de prueba de complementos en el sitio.
Deshabilitar la instalación de prueba de complementos en su suscripción de Office 365. Póngase en contacto con su administrador de Office 365.

Manipulación de página

Es posible que deba implementar la manipulación de página durante el proceso de aprovisionamiento del sitio personalizado. El ejemplo de código Provisioning.Pages muestra técnicas de manipulación de páginas, como la creación de una página wiki, la adición de contenido HTML a la página, la creación de una lista de vínculos promocionados, la creación de páginas con diseños diferentes, la adición de elementos web de fábrica a la página y la eliminación de la página.

Columnas de sitio, definiciones de lista y tipos de contenido

Si los tipos de contenido, definiciones de lista y columnas de sitio se crearon con elementos de marco de características implementados con soluciones de granja, debe usar el método de transformación de migración de contenido o el recorrido. Esto no se aplica a los elementos de marco de características implementados mediante soluciones de espacio aislado. Para usar el método de transformación de migración de contenido, debe usar herramientas de terceros para eliminar las dependencias de soluciones de granja.

Módulos o marco de características

Los módulos utilizan punteros a archivos, lo que significa que los archivos no están personalizados y se implementan en el sistema de archivos. Si sus soluciones de granja usan módulos, personalice los archivos implementando versiones alternativas de los mismos archivos en la base de datos de contenido, examine y actualice las soluciones para que apunten a los nuevos archivos almacenados en la base de datos de contenido y después retire la solución de granja que apuntaba a los archivos almacenados en el sistema de archivos.

Plantillas de sitio y plantillas web

Debe centrarse en transformar los elementos de marco de características implementados por la plantilla de sitio o plantilla web. Por ejemplo, asegúrese de que la página default.aspx del sitio no se reemplaza al retirar la solución de granja.

Trabajos de temporizador

Si usa SharePoint Online, no puede crear ni administrar trabajos de temporizador. En su lugar, puede crear una aplicación de consola que usa el programador de tareas de Windows o Azure WebJob para programar y ejecutar la aplicación de consola de forma remota.

Al crear un trabajo de temporizador personalizado, determine si necesita usar una cuenta específica o un token solo de aplicación basado en OAuth. El ejemplo de código Core.TimerJobs.Samples muestra cómo crear su propio trabajo de temporizador personalizado.