Información general sobre la asignación de elementos web usada
Importante
La modernización de SharePoint PnP es parte de PnP Framework y evoluciona continuamente; eche un vistazo a las notas de versión para mantenerse al día con los últimos cambios. Si tiene algún problema, preséntelo en la lista de problemas de GitHub para PnP Framework.
Cuando una página se transforma de una página clásica a una página moderna, también se transforman los elementos web más utilizados. Los elementos web clásicos (por ejemplo, XSLTListView) se reemplazan por sus homólogos OOB modernos (por ejemplo, el elemento web Lista), suponiendo que hay alguno disponible. En el capítulo siguiente, se proporciona información general sobre qué elementos web clásicos se transforman y cómo.
Lista de transformación de elementos web
La transformación de página utiliza una asignación de elementos web predeterminada cuando transforma páginas clásicas en páginas modernas. Aquí se describe la asignación utilizada en este elemento web moderno predeterminado, pero puede actualizar la asignación para, por ejemplo, agregar sus propios elementos web de terceros personalizados como objetivo de transformación. El procedimiento que debe seguir para ampliar el modelo de asignación de elementos web se describe en el artículo Modelo de transformación de páginas.
| Elemento web clásico | Elemento web moderno | Comentarios | Compatibilidad entre sitios |
|---|---|---|---|
| Microsoft.SharePoint.WebPartPages.XsltListViewWebPart (visualización de los datos de la lista) | Elemento web Lista, Biblioteca o Eventos | Vea el siguiente capítulo para obtener más información. | Sí, si existe una lista con el mismo nombre |
| Microsoft.SharePoint.WebPartPages.ListViewWebPart (visualización heredada de los datos de la lista) | Elemento web Lista, Biblioteca o Eventos | Vea el siguiente capítulo para obtener más información. | Sí, si existe una lista con el mismo nombre |
| Microsoft.SharePoint.Portal.WebControls.SiteFeedWebPart (fuente del sitio en los sitios de grupo) | Elemento web Noticias | Este elemento web se usa normalmente para mostrar noticias en una página principal; por lo tanto, se reemplaza por el elemento web Noticias OOB. | Sí |
| Microsoft.SharePoint.WebPartPages.ContentEditorWebPart (inserción de contenido) | El elemento web Insertar, el elemento web Texto o un editor de scripts de código abierto de la comunidad como un elemento web de destino | Vea el siguiente capítulo para obtener más información | Sí |
| Microsoft.SharePoint.WebPartPages.ScriptEditorWebPart (inserción de script) | OOB sin transformar, un editor de scripts de código abierto de la comunidad puede configurarse como un elemento web de destino opcional | Vea el siguiente capítulo para obtener más información | Sí |
| Microsoft.SharePoint.WebPartPages.ImageWebPart | Elemento web Imagen | Sí | |
| Microsoft.SharePoint.WebPartPages.ClientSideWebPart (= elemento web moderno basado en SPFX en una página clásica) | Se conservará el mismo elemento web moderno con su configuración | Sí, si el mismo elemento Web de SPFX está disponible en el sitio de destino | |
| Microsoft.SharePoint.WebPartPages.ClientWebPart (= elemento web del Complemento de SharePoint en una página clásica) | El mismo complemento puede funcionar en páginas modernas y se usará el complemento y también su configuración | Sí, si el mismo elemento Web del complemento está disponible en el sitio de destino | |
| Microsoft.SharePoint.Publishing.WebControls.MediaWebPart (inserción de vídeos) | Elemento web Visor de archivos | Sí | |
| Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart (consulta y presentación de datos) | Elemento web Contenido resaltado | No | |
| Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart (consulta y presentación de datos) | Elemento web Contenido resaltado | No | |
| Microsoft.SharePoint.Publishing.WebControls.ResultScriptWebPart (consulta y presentación de datos) | Elemento web Contenido resaltado | No | |
| Microsoft.Office.Excel.WebUI.ExcelWebRenderer (inserción desde archivos de Excel) | Elemento web Visor de archivos | No | |
| Microsoft.Office.Visio.Server.WebControls.VisioWebAccess (inserción desde archivos de Visio) | Elemento web Visor de archivos | No | |
| Microsoft.SharePoint.WebPartPages.PageViewerWebPart (inserción desde otras páginas) | Elemento web Insertar | Sí | |
| Microsoft.SharePoint.WebPartPages.PictureLibrarySlideshowWebPart (presentación con diapositivas de imágenes) | Elemento web Galería de imágenes | Las bibliotecas de imágenes no son compatibles con las CDN, se recomienda copiar el contenido de la biblioteca de imágenes en una biblioteca de documentos normal y, después, configurarla en el elemento web de la galería de imágenes. | Sí, si existe una biblioteca de imágenes con el mismo nombre |
| Microsoft.SharePoint.WebPartPages.SimpleFormWebPart (inserción de formularios HTML) | OOB sin transformar, opcionalmente, puede configurarse un editor de scripts de código abierto de la comunidad | Vea el siguiente capítulo para obtener más información | Sí |
| Microsoft.SharePoint.Publishing.WebControls.SummaryLinkWebPart | Elemento web Vínculos rápidos o elemento web Texto | El HTML de los Vínculos de resumen se transforma en Vínculos rápidos de forma predeterminada pero, opcionalmente, puede generar un HTML que luego se muestra con el elemento web Texto. Vea el siguiente capítulo para obtener más información | Sí |
| Microsoft.SharePoint.Portal.WebControls.ContactFieldControl (tarjeta de persona) | Elemento web Personas | Sí | |
| Microsoft.SharePoint.WebPartPages.UserDocsWebPart (documentos de usuario) | Elemento web Contenido resaltado | Sí | |
| Microsoft.SharePoint.WebPartPages.XmlWebPart (uso de XML y XSL para generar HTML) | Eliminado (se ha agregado el elemento web Texto para explicar el motivo) | Sí | |
| Microsoft.SharePoint.WebPartPages.DataFormWebPart (visualización heredada de los formularios de lista) | Eliminado (se ha agregado el elemento web Texto para explicar el motivo) | Sí | |
| Microsoft.SharePoint.WebPartPages.WikiContentWebpart | Eliminado (se ha agregado el elemento web Texto para explicar el motivo) | Ya no es relevante en SPO. | Sí |
| Microsoft.SharePoint.WebPartPages.SilverlightWebPart (ejecución de aplicaciones de Silverlight) | Eliminado (se ha agregado el elemento web Texto para explicar el motivo) | No existe ningún reemplazo moderno. Además, Silverlight ya no funciona en los exploradores modernos como Microsoft Edge o Chrome. | Sí |
| Microsoft.SharePoint.Publishing.WebControls.MembersWebPart | Eliminado (se ha agregado el elemento web Texto para explicar el motivo) | Para administrar miembros del sitio ahora se usa la funcionalidad de permisos de sitio OOB | Sí |
| Microsoft.Office.InfoPath.Server.Controls.WebUI.BrowserFormWebPart (elemento web de InfoPath) | Eliminado | Sí | |
| Microsoft.SharePoint.WebPartPages.GettingStartedWebPart (mosaicos de introducción) | Eliminado | No tiene sentido mantener una introducción para la experiencia de los sitios de grupo clásicos. | Sí |
| Microsoft.SharePoint.WebPartPages.SPUserCodeWebPart (elemento web Espacio aislado) | Eliminación | Las partes de Sandboxed en la web ya no son posibles en SPO | Sí |
| Microsoft.SharePoint.Publishing.WebControls.TableOfContentsWebPart | Eliminado | Estos datos deben integrarse en la navegación del sitio si siguen siendo relevantes. | Sí |
Nota:
Para los demás elementos web que no se enumeran en la tabla anterior, se realizará una asignación "predeterminada" y en el elemento web Texto se indicará "El elemento web xxx no se transformó". Vea el artículo Experiencias de elementos Web clásicos y modernos para entender la relación entre los elementos web clásicos y los elementos web modernos en cuanto a su función.
Propiedades de asignación
Las propiedades de asignación le permiten definir el comportamiento cuando se usa el archivo de asignación OOB. Un ejemplo típico es habilitar el uso del editor de scripts de la comunidad. A continuación, la tabla define las propiedades de asignación disponibles.
| Propiedad de asignación | Predeterminado | Descripción |
|---|---|---|
| UseCommunityScriptEditor | false | Configurar el uso del editor de scripts de la comunidad en asignaciones aplicables |
| SummaryLinksToQuickLinks | true | Configurar la asignación de los elementos web de vínculos de resumen a los Vínculos rápidos |
Detalles de transformación de elementos web
Habilitar el uso del elemento web del editor de scripts de la comunidad que se usará durante la transformación
No hay ningún elemento web de editor de scripts moderno OOB porque no se recomienda la inserción de scripts por sus riesgos de seguridad intrínsecos. Pero, si quiere transformar elementos web del editor de scripts clásico, puede hacerlo con un editor de scripts moderno de la comunidad de código abierto.
Instalar el editor de scripts de la comunidad
Siga las instrucciones para instalar el elemento web del editor de scripts de código abierto (https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-script-editor) en el inquilino.
Establecer la marca de asignación UseCommunityScriptEditor
Necesita avisar el motor de transformación que instaló el editor de scripts de la comunidad y que quiere usarlo durante la transformación. Al usar el ConvertTo-PnPPage cmdlet de PowerShell PnP, puede especificar la -UseCommunityScriptEditor marca. Al usar .Net puede establecer la marca como se muestra en el siguiente ejemplo
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["UseCommunityScriptEditor"] = "true";
pageTransformator.Transform(pti);
Elementos web XsltListViewWebPart y ListViewWebPart
Estos elementos web son bastante flexibles en su forma clásica y, por lo tanto, se reemplazan por elementos web modernos más específicos. El reemplazo funciona de la siguiente forma:
- Biblioteca de documentos: elemento web Biblioteca
- Lista: elemento web Lista
- Calendario: elemento web Eventos
- Lista de problemas: elemento web Lista
- Lista de tareas: elemento web Texto que explica que no se pudo realizar la asignación
- Panel de discusión: elemento web Texto que explica que no se pudo realizar la asignación
- Lista de encuestas: elemento web Texto que explica que no se pudo realizar la asignación
Durante la transformación a un elemento web Lista o Biblioteca, el motor de transformación intentará detectar la vista utilizada para configurar el elemento web y configurar el elemento web moderno Biblioteca o Lista para mostrar la misma vista.
Elemento web ContentEditorWebPart
El elemento web Editor de contenido puede usarse apuntando a un archivo en otro lugar de SharePoint o, como alternativa, puede tener contenido insertado. Según el modo que se use, se aplicará o no la siguiente lógica:
- Vínculo del archivo:
- Cuando el archivo sea del tipo ASPX, se podrá mostrar a través del elemento web Insertar.
- Cuando el contenido es otro tipo de archivo, el contenido del archivo se lee y analiza:
- Si el contenido del archivo no contiene JavaScript, se transforma en un elemento web del editor de scripts de terceros (cuando está configurado) o se muestra un elemento web Texto con el HTML del contenido del archivo limpio.
- Si el contenido del archivo contiene un script, se transforma en un elemento web del editor de scripts de terceros (cuando está configurado) o se sustituye por un elemento web Texto para indicar que no se puede asignar este contenido
- Contenido insertado:
- Si el contenido insertado no contiene JavaScript, se transforma en un elemento web del editor de scripts de terceros (cuando está configurado) o un elemento web Texto se muestra con el HTML insertado limpio.
- Si el contenido insertado contiene script, se transforma en un elemento web de editor de scripts de terceros (cuando está configurado) o se sustituye por un elemento web Texto para indicar que no se puede asignar este contenido
Elemento web ScriptEditorWebPart
De forma predeterminada, se mostrará un elemento web Texto para explicar que el contenido no se ha transformado o, como alternativa, se usa un editor de scripts de la comunidad si está configurado (como se muestra anteriormente).
Elemento web SummaryLinks
El HTML de los Vínculos de resumen se transforma en Vínculos rápidos de forma predeterminada pero, opcionalmente, puede generar un HTML que luego se muestra con el elemento web Texto. Para usar HTML, debe establecer la propiedad de asignación necesaria: al usar el ConvertTo-PnPPage cmdlet de PowerShell PnP, puede especificar la -SummaryLinksToHtml marca. Al usar .Net puede establecer la marca como se muestra en el siguiente ejemplo
PageTransformationInformation pti = new PageTransformationInformation(page)
{
// If target page exists, then overwrite it
Overwrite = true,
};
pti.MappingProperties["SummaryLinksToQuickLinks"] = "false";
pageTransformator.Transform(pti);