Compartir a través de

Migrar sitios existentes a Bootstrap versión 5

Bootstrap versión 5 ofrece nuevas características y actualizaciones que hacen que sus sitios de Power Pages sean más receptivos y más fáciles de personalizar.

Importante

  • Puede migrar cualquiera de sus sitios Bootstrap versión 3 a la versión 5 independientemente de la plantilla que se utilizó para crearlos.
  • Cuando migra sitios existentes de Bootstrap versión 3 a la versión 5, puede usar el modelo de datos estándar o el modelo de datos mejorado.
  • Considere probar la migración con un sitio de desarrollador.
  • Para verificar la versión actual de Bootstrap, consulte el bootstrap.min.cssarchivo web para su sitio web.

Para migrar su sitio de Bootstrap versión 3, siga estos pasos:

  1. Descargue la carpeta del sitio web.
  2. Ejecute la herramienta de migración en la carpeta.
  3. Revisar los cambios.
  4. Cargue el registro del sitio web migrado.
  5. Borre la memoria caché del servidor.

Dado que los pasos de migración requieren el uso de Microsoft Power Platform CLI, asegúrese de comprender cómo utilizarla en Power Pages:

Requisitos previos

Descargar la carpeta del sitio web

A partir de Microsoft Power Platform CLI versión 1.27, el comando pac paportal cambia a pac pages. paportal todavía funciona, pero le recomendamos que utilice powerpages en el futuro. Esa es la forma que utilizamos en las siguientes instrucciones. Si está usando Microsoft Power Platform CLI versión 1.26.6, asegúrese de usar pac paportal en lugar de pac pages.

  1. Abra un símbolo del sistema.

  2. Ingrese el siguiente comando para autenticarse en la organización de Dataverse de su entorno de Power Platform: pac auth create -u [Dataverse URL]

    Ejemplo:pac auth create -u https://contoso-org.crm.dynamics.com

    Más información: pac auth create

  3. Introduzca el siguiente comando para generar una lista de sitios web en la organización: pac pages list

    Anote el WebSiteId del sitio que planea migrar.

    Más información: pac pages list

  4. Introduzca el siguiente comando para descargar la carpeta del sitio web: pac pages download --path [PATH] -id [WebSiteId-GUID]

    Ejemplo: pac pages download --path "c:\pac-powerpages\downloads" -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

    Para el parámetro id., utilice el WebSiteId que anotó en el paso anterior.

    Más información: pac pages download

Ejecute la herramienta de migración en la carpeta

Introduzca el siguiente comando para ejecutar la herramienta de migración en la carpeta del sitio web descargado: pac pages bootstrap-migrate -p "WebsiteFolderPath"

Ejemplo: pac pages bootstrap-migrate -p "c:\pac-powerpages\downloads\bootstrap-dev-site"

El comando crea una nueva carpeta con "V5" añadido al nombre de la carpeta.

Si tiene problemas al actualizar a la versión 5 de Bootstrap o desea volver a la versión 3 de Bootstrap, consulte Cómo revertir de la versión 5 de Bootstrap a la versión 3.

Revisar los cambios

Si creó una copia de su sitio antes de migrarlo, compárelo con el sitio de la versión 5.

  1. Abra la carpeta V5 que ha creado en el paso anterior.

  2. Abra un archivo HTML o CSS.

  3. En Visual Studio Code, presione Ctrl+Mayús+P para abrir un símbolo del sistema. Introduzca bootstrap diff.

  4. Se abren el archivo de la versión 3 y el archivo de la versión 5. Pase el cursor sobre cada cambio resaltado para revisarlo.

Cargue el registro del sitio web migrado

Introduzca el siguiente comando para cargar el registro del sitio web migrado a la organización: pac pages upload --path [Folder-location]

Ejemplo: pac pages upload --path C:\pac-portals\downloads\custom-portal\

Más información: pac pages upload

Después de cargar el registro, el sitio migrado es un sitio web Bootstrap versión 5. Le recomendamos que compare el sitio con su sitio de la versión 3 una vez más y modifique el sitio de Bootstrap versión 5 según sea necesario.

Borrar la memoria caché del servidor

Borre la caché del lado del servidor para las tablas de metadatos/configuración y datos.

Cómo revertir de la versión 5 de Bootstrap a la versión 3

Para volver a la versión 3 de Bootstrap:

  1. Ejecute el comando upload para reemplazar la carpeta de la versión 5 por una carpeta de la versión 3 de Bootstrap. Obtenga más información en las páginas pac bootstrap-migrate.
  2. Abra la aplicación Administración del portal y elimine la configuración del sitio Site/BootstrapV5Enabled. Más información en Configurar los ajustes del sitio para sitios web.
  3. Borre la memoria caché del servidor. Obtenga más información en Cómo funciona el almacenamiento en caché del lado del servidor en Power Pages.

Consulte también