Delen via


Bestaande sites migreren naar Bootstrap version 5

Bootstrap versie 5 biedt nieuwe functies en updates die uw Power Pages-sites responsiever en gemakkelijker aanpasbaar maken.

Belangrijk

  • U kunt al uw Bootstrap versie 3-sites naar versie 5 migreren, ongeacht de sjabloon die is gebruikt om ze te maken.
  • Wanneer u bestaande Bootstrap versie 3-sites naar versie 5 migreert, kunt u het standaardgegevensmodel of het verbeterde gegevensmodel gebruiken.
  • Overweeg om de migratie te testen met een ontwikkelaarssite.
  • Als u de huidige versie van Bootstrap wilt controleren, raadpleegt u het bootstrap.min.csswebbestand voor uw website.

Volg deze stappen om uw Bootstrap versie 3-site te migreren:

  1. Download de websitemap.
  2. Voer de migratietool uit op de map.
  3. Bekijk uw wijzigingen.
  4. Upload de gemigreerde websiterecord.
  5. Wis de servercache.

Aangezien de migratiestappen het gebruik van de Microsoft Power Platform CLI vereisen, moet u ervoor zorgen dat u begrijpt hoe u deze kunt gebruiken in Power Pages:

Vereisten

Download de websitemap

Vanaf Microsoft Power Platform CLI versie 1.27 is de opdracht pac paportal gewijzigd in pac pages. paportal werkt nog steeds, maar we raden u aan in de toekomst powerpages te gebruiken. Dat is het formulier dat we gebruiken in de volgende instructies. Als u Microsoft Power Platform CLI versie 1.26.6 gebruikt, zorg er dan voor dat u pac paportal gebruikt in plaats van pac pages.

  1. Open een opdrachtprompt.

  2. Voer de volgende opdracht in om u te verifiƫren bij de Dataverse-organisatie voor uw Power Platform-omgeving: pac auth create -u [Dataverse URL]

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

    Meer info: pac auth create

  3. Voer de volgende opdracht in om een lijst met websites in de organisatie te genereren: pac pages list

    Noteer de WebSiteId van de site die u wilt migreren.

    Meer info: pac pages list

  4. Voer de volgende opdracht in om de websitemap te downloaden: pac pages download --path [PATH] -id [WebSiteId-GUID]

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

    Gebruik voor de parameter id de WebSiteId die u hebt genoteerd in de vorige stap.

    Meer info: pac pages download

De migratietool uitvoeren op de map

Voer de volgende opdracht in om de migratietool uit te voeren op de websitemap die u hebt gedownload: pac pages bootstrap-migrate -p "WebsiteFolderPath"

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

Met de opdracht wordt na de migratie een nieuwe map gemaakt, met 'V5' toegevoegd aan de mapnaam.

Zie Versie 5 van Bootstrap terugdraaien naar versie 3 als u problemen ondervindt bij het upgraden naar Bootstrap-versie 5 of terug wilt naar versie 3 van Bootstrap.

Controleer uw wijzigingen

Als u een kopie van uw site hebt gemaakt voordat u deze migreerde, vergelijk deze dan met de site van versie 5.

  1. Open de map V5 die u in de vorige stap hebt gemaakt.

  2. Open een HTML- of CSS-bestand.

  3. Druk in Visual Studio Code op Ctrl+Shift+P om een opdrachtprompt te openen. Voer bootstrap diff in.

  4. Het versie 3-bestand en het versie 5-bestand worden geopend. Beweeg de muisaanwijzer over elke gemarkeerde wijziging om deze te bekijken.

De gemigreerde websiterecord uploaden

Voer de volgende opdracht in om de gemigreerde websiterecord naar de organisatie te uploaden: pac pages upload --path [Folder-location]

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

Meer info: pac pages upload

Nadat u de record hebt geüpload, is de gemigreerde site een Bootstrap versie 5-website. We raden u aan de site nog een keer te vergelijken met uw versie 3-site en de Bootstrap versie 5-site indien nodig aan te passen.

De servercache wissen

Wis de cache aan de serverzijde voor de metagegevens/configuratie en gegevenstabellen.

Hoe terug te keren van Bootstrap versie 5 naar versie 3

Om terug te keren naar Bootstrap versie 3:

  1. Voer de uploadopdracht uit om de map met versie 5 te vervangen door een map met versie 3 van Bootstrap. Meer informatie vindt u in pac pages bootstrap-migrate.
  2. Open de Portal Management-app en verwijder de site-instelling Site/BootstrapV5Enabled. Meer informatie vindt u in Site-instellingen configureren voor websites.
  3. Wis de servercache. Meer informatie vindt u in Servercache wissen in Power Pages.

Zie ook