Eseguire la migrazione dei siti esistenti a Bootstrap versione 5 (anteprima)

Articolo
06/25/2024

[Questo argomento fa parte della documentazione di pre-rilascio, pertanto è soggetto a modifiche.]

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

Importante

Questa è una funzionalità di anteprima.
Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.
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 Web bootstrap.min.css per il tuo sito Web.

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

Scarica le cartella del sito Web.
Esegui lo strumento di migrazione sulla cartella.
Esamina le modifiche.
Carica il record di sito Web migrato.
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

Installa Microsoft Power Platform CLI versione 1.28.2 o successiva.
Se il tuo sito utilizza file SVG, assicurati che l'impostazione di sistema Impostazione delle estensioni di file bloccate per gli allegati nel tuo ambiente Power Platform consenta l'estensione ".svg".
Considera la possibilità di creare due versioni del tuo sito Power Pages utilizzando Bootstrap versione 3. Esegui la migrazione di uno e utilizza l'altro come riferimento per il confronto con il sito migrato.

Scarica le cartella del sito Web

A partire da Microsoft Power Platform CLI versione 1.27, il comando pac paportal viene modificato in pac powerpages. 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 powerpages.

Apri un prompt dei comandi.
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
Immetti il comando seguente per generare un elenco di siti Web nell'organizzazione: pac powerpages list

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

Per ulteriori informazioni, vedere pac powerpages list
Immetti il seguente comando per scaricare la cartella del sito Web: pac powerpages download --path [PATH] -id [WebSiteId-GUID]

Esempio: pac powerpages 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 powerpages 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 powerpages bootstrap-migrate -p "WebsiteFolderPath"

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

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

Per ripristinare la versione 3 da Bootstrap versione 5, utilizza il comando di caricamento per sostituire la cartella della versione 5 con una cartella di Bootstrap versione 3.

Per ulteriori informazioni, vedere pac powerpages bootstrap-migrate

Esaminare le modifiche

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

Apri la cartella V5 che hai creato nel passaggio precedente.
Apri un file HTML o CSS.
In Visual Studio Code, premi Ctrl+Maiusc+P per aprire un prompt dei comandi. Immetti bootstrap diff.
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 powerpages upload --path [Folder-location]

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

Per ulteriori informazioni, vedere pac powerpages 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

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

Condividi tramite