Condividi tramite

Migrare i siti esistenti a Bootstrap version 5

Bootstrap versione 5 offre nuove funzionalità e aggiornamenti che rendono i tuoi siti Power Pages più reattivi e più facili da personalizzare.

Importante

  • Puoi eseguire la migrazione di qualsiasi sito Bootstrap dalla versione 3 alla versione 5 indipendentemente dal modello utilizzato per crearli.
  • Quando si esegue la migrazione dei siti Bootstrap versione 3 esistenti alla versione 5, è possibile utilizzare il modello di dati standard o il modello di dati avanzato.
  • Valuta la possibilità di testare la migrazione con un sito dello sviluppatore.
  • Per verificare la versione corrente di Bootstrap, vedi il file Webbootstrap.min.css per il tuo sito Web.

Per eseguire la migrazione del tuo sito Bootstrap versione 3, procedi nel seguente modo:

  1. Scarica la cartella del sito Web.
  2. Esegui lo strumento di migrazione sulla cartella.
  3. Esamina le modifiche.
  4. Carica il record di sito Web migrato.
  5. Cancella la cache lato server.

Poiché i passaggi della migrazione richiedono l'utilizzo di Microsoft Power Platform CLI, assicurati di comprendere come utilizzarla in Power Pages:

Prerequisiti

Scarica le cartella del sito Web

A partire da Microsoft Power Platform CLI versione 1.27, il comando pac paportal viene modificato in pac pages. paportal funziona ancora, ma ti consigliamo di utilizzare powerpages d'ora in avanti. Questo è il modulo che utilizziamo nelle seguenti istruzioni. Se utilizzi Microsoft Power Platform CLI versione 1.26.6, assicurati di utilizzare pac paportal invece di pac pages.

  1. Apri un prompt dei comandi.

  2. Immetti il comando seguente per autenticarti nell'organizzazione Dataverse per il tuo ambiente Power Platform: pac auth create -u [Dataverse URL]

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

    Per ulteriori informazioni, vedere pac auth create

  3. Immetti il comando seguente per generare un elenco di siti Web nell'organizzazione: pac pages list

    Prendi nota del WebSiteId del sito di cui intendi eseguire la migrazione.

    Per ulteriori informazioni, vedere pac pages list

  4. Immetti il seguente comando per scaricare la cartella del sito Web: pac pages download --path [PATH] -id [WebSiteId-GUID]

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

    Per il parametro id, utilizza il WebSiteId annotato al passaggio precedente.

    Per ulteriori informazioni, vedere pac pages download

Esegui lo strumento di migrazione sulla cartella

Immetti il comando seguente per eseguire lo strumento di migrazione sulla cartella del sito Web che hai scaricato: pac pages bootstrap-migrate -p "WebsiteFolderPath"

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

Il comando crea una cartella con "V5" aggiunto al nome della cartella.

Se si verificano problemi durante l'aggiornamento a Bootstrap versione 5 o desideri ripristinare la versione 3 di Bootstrap, vedi Come ripristinare la versione 5 di Bootstrap alla versione 3.

Esaminare le modifiche

Se hai creato una copia del tuo sito prima di eseguirne la migrazione, confrontala con il sito della versione 5.

  1. Apri la cartella V5 che hai creato nel passaggio precedente.

  2. Apri un file HTML o CSS.

  3. In Visual Studio Code, premi Ctrl+Maiusc+P per aprire un prompt dei comandi. Immetti bootstrap diff.

  4. Si aprono il file della versione 3 e il file della versione 5. Passa il mouse sopra ogni modifica evidenziata per rivederla.

Carica il record di sito Web migrato

Immetti il comando seguente per caricare nell'organizzazione il record del sito Web migrato: pac pages upload --path [Folder-location]

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

Per ulteriori informazioni, vedere pac pages upload

Dopo aver caricato il record, il sito migrato è un sito Web Bootstrap versione 5. Ti consigliamo di confrontare il sito con il sito della versione 3 ancora una volta e di modificare il sito della versione 5 di Bootstrap secondo necessità.

Cancellare la cache lato server

Svuotare la cache lato server per i metadati/la configurazione e le tabelle dei dati.

Come ripristinare Bootstrap versione 5 alla versione 3

Per ripristinare la versione 3 di Bootstrap:

  1. Esegui il comando di caricamento per sostituire la cartella versione 5 con una cartella Bootstrap versione 3. Per altre informazioni, vedi le pagine pac bootstrap-migrate.
  2. Apri l'app Gestione del portale ed elimina l'impostazione del sito Site/BootstrapV5Enabled. Altre informazioni in Configurare le impostazioni del sito per i siti Web.
  3. Cancella la cache lato server. Altre informazioni in Come funziona la memorizzazione nella cache lato server in Power Pages.

Vedi anche

  • Last updated on