Bestaande sites migreren naar Bootstrap versie 5 (preview)
[Dit onderwerp maakt deel uit van de voorlopige documentatie en kan nog veranderen.]
Bootstrap versie 5 biedt nieuwe functies en updates die uw Power Pages sites responsiever en gemakkelijker aanpasbaar maken.
Belangrijk
- Dit is een preview-functie.
- Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.
- 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:
- Download de websitemap.
- Voer de migratietool uit op de map.
- Controleer uw wijzigingen.
- Upload het gemigreerde website-record.
- Wis de cache aan de serverzijde.
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:
- Microsoft Power Platform CLI-ondersteuning voor Power Pages
- Tutorial: Gebruik Microsoft Power Platform CLI met Power Pages
pac powerpages
Vereisten
Installeer Microsoft Power Platform CLI versie 1.28.2 of hoger.
Als uw site SVG-bestanden gebruikt, zorgt u ervoor dat de systeeminstelling Geblokkeerde bestandsextensie voor bijlagen instellen in uw Power Platform-omgeving de extensie '.svg' toestaat.
Overweeg om twee versies van uw Power Pages-site te maken met Bootstrap versie 3. Migreer een ervan en gebruik de andere als referentie om te vergelijken met de gemigreerde site.
Download de websitemap
Vanaf Microsoft Power Platform CLI versie 1.27 is de opdracht pac paportal
gewijzigd in pac powerpages
. paportal
werkt nog steeds, maar we raden u aan om powerpages
in de toekomst 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 powerpages
.
Open een opdrachtprompt.
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
Voer de volgende opdracht in om een lijst met websites in de organisatie te genereren:
pac powerpages list
Noteer de WebSiteId van de site die u wilt migreren.
Meer info:
pac powerpages list
Voer de volgende opdracht in om de websitemap te downloaden:
pac powerpages download --path [PATH] -id [WebSiteId-GUID]
Voorbeeld:
pac powerpages 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 powerpages 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 powerpages bootstrap-migrate -p "WebsiteFolderPath"
Voorbeeld: pac powerpages 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.
Om vanuit Bootstrap versie 5 terug te keren naar versie 3, gebruikt u de uploadopdracht om de map van versie 5 te vervangen door een Bootstrap versie 3-map.
Meer info: pac powerpages bootstrap-migrate
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.
Open de map V5 die u in de vorige stap hebt gemaakt.
Open een HTML- of CSS-bestand.
Druk in Visual Studio Code op Ctrl+Shift+P om een opdrachtprompt te openen. Voer
bootstrap diff
in.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 powerpages upload --path [Folder-location]
Voorbeeld: pac powerpages upload --path C:\pac-portals\downloads\custom-portal\
Meer info: pac powerpages 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.