Migrer les sites existants vers Bootstrap version 5 (version préliminaire)

Article
06/25/2024

[Cette rubrique fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

La version 5 de Bootstrap offre de nouvelles fonctionnalités et mises à jour qui rendent vos sites Power Pages plus réactifs et faciles à personnaliser.

Important

Cette fonctionnalité est en version préliminaire.
Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.
Vous pouvez migrer l’un de vos sites de la version 3 de Bootstrap vers la version 5, quel que soit le modèle utilisé pour les créer.
Lorsque vous migrez des sites existants de Bootstrap version 3 vers la version 5, vous pouvez utiliser le modèle de données standard ou le modèle de données amélioré.
Envisagez de tester la migration avec un site de développeur.
Pour vérifier la version actuelle de Bootstrap, consultez le fichier Web bootstrap.min.css pour votre site Web.

Pour migrer votre site de la version 3 de Bootstrap, procédez comme suit :

Téléchargez le dossier du site Web.
Exécutez l’outil de migration sur le dossier.
Vérifiez vos modifications.
Chargez l’enregistrement du site Web migré.
Effacez le cache côté serveur.

Étant donné que les étapes de migration nécessitent l’utilisation de Microsoft Power Platform CLI, assurez-vous de bien comprendre comment l’utiliser dans Power Pages :

Conditions préalables

Installez Microsoft Power Platform CLI version 1.28.2 ou ultérieure.
Si votre site utilise des fichiers SVG, assurez-vous que le paramètre système Définir les extensions de fichier bloqué pour les pièces jointes dans votre environnement Power Platform autorise l’extension « .svg ».
Pensez à créer deux versions de votre site Power Pages à l’aide de Bootstrap version 3. Migrez l’une d’elles et utilisez l’autre comme référence pour la comparer avec le site migré.

Télécharger le dossier du site web

À partir de la version 1.27 de Microsoft Power Platform CLI, la commande pac paportal est remplacée par pac powerpages. paportal fonctionne toujours, mais nous vous recommandons d’utiliser powerpages à l’avenir. C’est le formulaire que nous utilisons dans les instructions suivantes. Si vous utilisez la version 1.26.6 de Microsoft Power Platform CLI, assurez-vous d’utiliser pac paportal au lieu de pac powerpages.

Ouvrez une invite de commandes.
Saisissez la commande suivante pour vous authentifier dans l’organisation Dataverse pour votre environnement Power Platform : pac auth create -u [Dataverse URL]

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

Pour plus d’informations, voir pac auth create
Saisissez la commande suivante pour générer une liste de sites Web dans l’organisation : pac powerpages list

Notez le WebSiteId du site que vous envisagez de migrer.

Pour plus d’informations, voir pac powerpages list
Saisissez la commande suivante pour télécharger le dossier du site Web : pac powerpages download --path [PATH] -id [WebSiteId-GUID]

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

Pour le paramètre ID, utilisez le WebSiteId que vous avez noté dans l’étape précédente.

Pour plus d’informations, voir pac powerpages download

Exécuter l’outil de migration sur le dossier

Saisissez la commande suivante pour exécuter l’outil de migration sur le dossier du site Web que vous avez téléchargé : pac powerpages bootstrap-migrate -p "WebsiteFolderPath"

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

La commande crée un dossier avec « V5 » ajouté au nom du dossier.

Pour rétablir la version 3 à partir de la version 5 de Bootstrap, utilisez la commande de chargement pour remplacer le dossier de la version 5 par un dossier de la version 3 de Bootstrap.

Pour plus d’informations, voir pac powerpages bootstrap-migrate

Vérifier vos modifications

Si vous avez créé une copie de votre site avant de le migrer, comparez-la avec le site de la version 5.

Ouvrez le dossier V5 créé à l’étape précédente.
Ouvrez un fichier HTML ou CSS.
Dans Visual Studio Code, appuyez sur Ctrl+Maj+P pour ouvrir une invite de commande. Entrez bootstrap diff.
Le fichier de la version 3 et le fichier de la version 5 s’ouvrent. Passez la souris sur chaque modification mise en surbrillance pour l’examiner.

Charger l’enregistrement du site Web migré

Saisissez la commande suivante pour charger l’enregistrement du site Web migré dans l’organisation : pac powerpages upload --path [Folder-location]

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

Pour plus d’informations, voir pac powerpages upload

Après avoir chargé l’enregistrement, le site migré est un site Web de la version 5 de Bootstrap. Nous vous recommandons de comparer le site avec votre site de la version 3 une nouvelle fois et de modifier le site de la version 5 de Bootstrap, si nécessaire.

Effacer le cache côté serveur

Effacez le cache côté serveur pour les métadonnées/la configuration et les tables de données.

Partager via