Transformar las soluciones de espacio aislado para el modelo de complementos de SharePoint
La transformación de las soluciones de espacio aislado en el modelo de Complementos de SharePoint implica analizar las extensiones existentes, diseñar y desarrollar los nuevos complementos de SharePoint y, a continuación, realizar las pruebas e implementar el complemento en su entorno de producción.
Nota:
Las soluciones de espacio aislado basadas en código han quedado en desuso en 2014 y SharePoint online ha iniciado el proceso para quitar esta funcionalidad por completo. Las soluciones de espacio aislado basadas en código también han quedado en desuso en SharePoint 2013 y SharePoint 2016.
Soluciones de espacio aislado basadas en código en SharePoint Online
Las soluciones de espacio aislado son paquetes de personalización que pueden usarse para implementar las personalizaciones de SharePoint en el nivel de colección de sitios. Si una solución de espacio aislado contiene código, se ha ejecutado en un proceso aislado especial con un conjunto limitado de API para acceder a contenido y servicios de SharePoint.
Hay dos tipos de soluciones de espacio aislado:
- Soluciones de espacio aislado basadas en código, que contienen un conjunto personalizado en el paquete.
- Soluciones de espacio aislado declarativas, que solo contienen configuraciones basadas en XML y activos relacionados.
Las soluciones de espacio aislado declarativas (basadas en XML) se dividen en los siguientes tipos en función de sus casos de uso:
- Plantilla de sitio: generada al usar la funcionalidad "Guardar sitio como plantilla" en sitios existentes.
- Paquete de diseño: generado con el Administrador de diseño del sitio de publicación.
- Soluciones de espacio aislado personalizadas: creadas en Visual Studio, por ejemplo, para personalizar los activos de marca, no contienen ensamblados.
Las soluciones de espacio aislado basadas en código se dividen en los siguientes tipos en función de sus casos de uso:
- Solución de espacio aislado declarativa con ensamblado vacío
- Solución de espacio aislado que contiene el formulario de InfoPath con código
- Soluciones de espacio aislado basadas en código con personalizaciones como elementos web, receptores de eventos o receptores de características
- Soluciones de espacio aislado con acción de flujo de trabajo personalizada
Cuando quiere salir de las soluciones de espacio aislado, debe evaluar los requisitos funcionales y empresariales de una solución específica y determinar la dirección del diseño en función de ello.
Planear el proceso de transformación
Al transformar las soluciones de espacio aislado en el modelo de complementos de SharePoint, debe asegurarse de que el impacto para los usuarios sea mínimo. Analice detenidamente las soluciones de espacio aislado 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, vea Complementos de SharePoint y Office 365 guía de desarrollo y solución de SharePoint PnP.
Evaluación de la solución
Analice los requisitos funcionales y empresariales con los siguientes pasos:
Identificar soluciones de espacio aislado implementadas en su entorno actual para las que puede usar cualquiera de las siguientes herramientas que proporciona el equipo de SharePoint PnP como código abierto:
- El Analizador de soluciones de espacio aislado de SharePoint o vídeo: una herramienta que ofrece varias opciones y un inventario detallado.
- Un script de inventario específico de soluciones de espacio aislado: un script de PowerShell que le proporciona un inventario básico.
Revisar los requisitos con los usuarios. Considere pedir a los usuarios para muestren cómo usan las soluciones de espacio aislado 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.
Para cada solución, determinar si se debe reemplazar por un complemento de SharePoint o implementarlo mediante funcionalidades integradas o una solución alternativa.
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
Asegúrese de que la implementación sea estable y envíe la información correspondiente a los usuarios.
Reemplazar las personalizaciones de soluciones de espacio aislado
A continuación se muestran personalizaciones comunes que se incluyen en las soluciones de espacio aislado y posibles opciones de transformación. Tenemos planeado agregar más información para cada uno de los tipos de personalización para que pueda tener ejemplos reales sobre las opciones de transformación.
| Personalización | Opciones de transformación |
|---|---|
| Solución declarativa con ensamblado vacío | Puede controlar la creación del ensamblado desde las propiedades del proyecto de Visual Studio. Para obtener más información, vea Quitar la referencia del conjunto de su solución del espacio aislado creada en Visual Studio. Importante: al usar el Explorador de soluciones de espacio aislado de SharePoint, el resultado del análisis muestra qué soluciones tienen un ensamblado vacío y la herramienta crea automáticamente paquetes de soluciones de espacio aislado actualizadas en las que se quita el ensamblado. Puede reemplazar la solución de espacio aislado existente con la actualizada. |
| Formulario de InfoPath con código | Si ha publicado un formulario de InfoPath desde el cliente de InfoPath que contiene código, se publica realmente en SharePoint como una solución de espacio aislado. Esto significa que el código de formulario se ejecuta realmente con el motor de espacio aislado en SharePoint. Renunciar a los formularios de InfoPath basados en código depende de los casos de uso de negocio. Existen varias opciones para la generación de interfaces de usuario personalizadas como complementos o el uso de otras técnicas de formulario. Para obtener más información, vea Corregir InfoPath en soluciones de espacio aislado. |
| Elemento web | Normalmente los elementos web se convierten partes de complemento o se implementan con tecnologías totalmente del lado cliente mediante el patrón de inserción de JavaScript. Para obtener más información, consulte: |
| Elemento web visual | Los elementos web visuales se transforman de forma similar a los elementos web normales. Los controles de usuario utilizados en elementos web visuales se reemplazan ya que en casos de solución de espacio aislado, se incluyen dentro del ensamblado. |
| Receptores de eventos | En muchos casos los receptores de eventos pueden sustituirse con la implementación del receptor de eventos remoto. Sin embargo, los receptores de eventos remotos necesitan estar hospedados en alguna plataforma, normalmente en complementos específicos hospedados por el proveedor. Para obtener más información, consulte: |
| Receptor de características | Los receptores de características se reemplazan normalmente con una operación remota basada en API, como usando CSOM o REST para aplicar la configuración o personalización necesarias en el nivel de sitio. Si falta una API necesaria en las API remotas (CSOM/REST), informe de ello utilizando SharePoint UserVoice. Los receptores de características se usan, por ejemplo, para configurar una página maestra personalizada o un tema a un sitio cuando se activan. Estos tipos de operaciones pueden sustituirse fácilmente con las soluciones remotas basadas en código o mediante PnP PowerShell, que ofrece comandos fáciles para controlar la configuración del sitio. |
| Acción de flujo de trabajo personalizada | La ruta de migración de código habitual para estos tipos de personalizaciones es usar flujos de trabajo de SharePoint o soluciones alternativas, como Microsoft Flow o soluciones de terceros. |
Quitar el código de espacio aislado del sitio
Al desactivar la solución de espacio aislado existente de sitios, los activos o archivos implementados con opciones declarativas no se eliminarán. Si ha usado soluciones de espacio aislado para introducir nuevos elementos web basados en código, se deshabilitarán dichas funcionalidades de los sitios. Esto significa que las páginas se siguen presentando normalmente, por lo que no hay ningún impacto directo para el usuario final cuando se desactiva la solución, excepto por la eliminación de las funcionalidades basadas en código, como elementos web.
Quitar la compatibilidad para soluciones de espacio aislado basadas en código
La compatibilidad de soluciones de espacio aislado basadas en código se quitará de SharePoint Online al deshabilitar las operaciones basadas en código que se ejecutan a partir de código basados en soluciones de espacio aislado. Esto significa que las soluciones de espacio aislado no se han desactivado explícitamente del almacén de soluciones, pero las operaciones basadas en código no se ejecutarán. Las soluciones de espacio aislado permanecerán en estado activado en la galería de soluciones. Las características implementadas con soluciones de espacio aislado no se desactivarán automáticamente, lo que significa que no se ejecutará posible código asociado a la desactivación de características o a los controladores de desinstalación.
Todas las definiciones declarativas en la solución de espacio aislado seguirán funcionando después de que este cambio se aplique en SharePoint Online.
En esta sección
- Reemplazar elementos web
- Reemplazar receptores de eventos
- Reemplazar receptores de características
- Corregir formularios de InfoPath basados en código