Freigeben über

Vorhandene Websites auf Bootstrap version 5 migrieren

Bootstrap-Version 5 bietet neue Features und Updates, die Ihre Power Pages-Websites reaktionsfähiger und einfacher anpassbar machen.

Wichtig

  • Sie können jede Ihrer Bootstrap-Websites der Version 3 auf Version 5 migrieren, unabhängig von der Vorlage, mit der sie erstellt wurden.
  • Wenn Sie vorhandene Bootstrap-Websites der Version 3 auf Version 5 migrieren, können Sie entweder das Standarddatenmodell oder das erweiterte Datenmodell verwenden.
  • Erwägen Sie, die Migration mit einer Entwicklerwebsite zu testen.
  • Um die aktuelle Version von Bootstrap zu überprüfen, sehen Sie sich die Bootstrap.min.css-Webdatei für Ihre Website an.

Führen Sie die folgenden Schritte aus, um Ihre Website mit Bootstrap-Version 3 zu migrieren:

  1. Laden Sie den Website-Ordner herunter.
  2. Führen Sie das Migrationstool für den Ordner aus.
  3. Überprüfen Sie Ihre Änderungen.
  4. Laden Sie den migrierten Websitedatensatz hoch.
  5. Löschen Sie den serverseitigen Cache.

Da für die Migrationsschritte die Verwendung der Microsoft Power Platform CLI erforderlich ist, stellen Sie sicher, dass Sie mit der Nutzung von Power Pages vertraut sind:

Anforderungen

Website-Ordner herunterladen

Ab der Microsoft Power Platform CLI-Version 1.27 wird der pac paportal-Befehl in pac pages geändert. paportal funktioniert immer noch. Wir empfehlen Ihnen jedoch, in Zukunft powerpages zu verwenden. Das ist das Formular, das wir in der folgenden Anleitung verwenden. Wenn Sie Microsoft Power Platform CLI-Version 1.26.6 verwenden, stellen Sie sicher, dass Sie pac paportal anstelle von pac pages verwenden.

  1. Öffnen Sie eine Eingabeaufforderung.

  2. Geben Sie den folgenden Befehl ein, um sich bei der Dataverse-Organisation für Ihre Power Platform-Umgebung zu authentifizieren: pac auth create -u [Dataverse URL]

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

    Weitere Informationen: pac auth create

  3. Geben Sie den folgenden Befehl ein, um eine Liste der Websites in der Organisation zu erstellen: pac pages list

    Notieren Sie sich die WebSiteId der Website, die Sie migrieren möchten.

    Weitere Informationen: pac pages list

  4. Geben Sie den folgenden Befehl ein, um den Website-Ordner herunterzuladen: pac pages download --path [PATH] -id [WebSiteId-GUID]

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

    Benutzen Sie für den ID-Parameter die WebSiteId, die Sie im vorherigen Schritt notiert haben.

    Weitere Informationen: pac pages download

Migrationstool für den Ordner ausführen

Geben Sie den folgenden Befehl ein, um das Migrationstool für den heruntergeladenen Website-Ordner auszuführen: pac pages bootstrap-migrate -p "WebsiteFolderPath"

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

Der Befehl erstellt einen Ordner mit dem Zusatz „V5“ an den Ordnernamen.

Wenn beim Upgrade auf Bootstrap Version 5 Probleme auftreten oder Sie zu Bootstrap Version 3 zurückkehren möchten, finden Sie weitere Informationen unter Wiederherstellen von Bootstrap Version 5 auf Version 3.

Änderungen überprüfen

Wenn Sie vor der Migration eine Kopie Ihrer Website erstellt haben, vergleichen Sie diese mit der Website der Version 5.

  1. Öffnen Sie den Ordner V5, den Sie im vorherigen Schritt erstellt haben.

  2. Öffnen Sie eine HTML- oder CSS-Datei.

  3. Drücken Sie im Visual Studio Code Strg+Umschalt+P, um eine Eingabeaufforderung zu öffnen. Geben Sie bootstrap diff ein.

  4. Die Datei der Version 3 und die Datei der Version 5 werden geöffnet. Bewegen Sie den Mauszeiger über jede hervorgehobene Änderung, um sie zu überprüfen.

Migrierten Websitedatensatz hochladen

Geben Sie den folgenden Befehl ein, um den migrierten Websitedatensatz in die Organisation hochzuladen: pac pages upload --path [Folder-location]

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

Weitere Informationen: pac pages upload

Nachdem Sie den Datensatz hochgeladen haben, handelt es sich bei der migrierten Website um eine Bootstrap-Website der Version 5. Wir empfehlen, dass Sie die Website noch einmal mit Ihrer Version 3-Website vergleichen und die Website mit Bootstrap-Version 5 nach Bedarf ändern.

Löschen des serverseitigen Caches

Leeren Sie den serverseitigen Cache für die Metadaten/Konfiguration und Datentabellen.

So stellen Sie Bootstrap Version 5 auf Version 3 wieder her

Sie müssen zu Bootstrap Version 3 zurückkehren:

  1. Führen Sie den Upload-Befehl aus, um den Ordner Version 5 durch einen Bootstrap-Ordner der Version 3 zu ersetzen. Weitere Informationen finden Sie unter den pac-Seiten bootstrap-migrate.
  2. Öffnen Sie die Portalverwaltungs-App und löschen Sie die Websiteeinstellung Site/BootstrapV5Enabled. Weitere Informationen unter Site-Einstellungen für Website konfigurieren.
  3. Löschen Sie den serverseitigen Cache. Weitere Informationen finden Sie unter So funktioniert serverseitiges Zwischenspeichern in Power Pages.

Siehe auch