Migration de la configuration du site web

Le développement du site web Power Pages comporte plusieurs configurations et personnalisations pour obtenir une expérience souhaitée pour les utilisateurs finaux du site web.

Une fois le développement ou la configuration de votre instance de site web terminés, vous pouvez migrer votre dernière configuration de site web, de votre environnement de développement vers des environnements de test ou de production.

La migration implique l’exportation de vos données de configuration existantes depuis l’environnement Microsoft Dataverse source, et leur importation dans l’environnement Dataverse cible.

Préparer l’environnement cible

Vous devrez préparer l’environnement cible si vous utilisez le modèle de données standard. Un environnement qui utilise le modèle de données amélioré ne nécessite pas ces étapes et vous pouvez procéder au transfert de la configuration du site web.

Note

• Préparer l’environnement cible est un processus ponctuel. Vous devrez approvisionner un nouveau portail afin d’installer les solutions Power Pages gérées sur Dataverse et de configurer l’application web Power Pages. Le processus installe également les métadonnées de site web par défaut qui seront remplacées par les métadonnées de site web de votre environnement source.
• Assurez-vous que la taille maximale des pièces jointes de l’environnement cible est définie sur une taille identique ou supérieure à celle de votre environnement source.
• La taille maximale des fichiers pouvant être chargés est déterminée par le paramètre Taille de fichier maximale dans l’onglet e-mail des paramètres système dans la boîte de dialogue des paramètres du système d’environnement.
• Notez la différence entre les sites Web de développeur, d’évaluation et de production et les environnements de développeur, d’évaluation, de bac à sable et de production.
• Vous pouvez migrer un site Web d’évaluation, de développement ou de production vers un autre site Web d’évaluation, de développement ou de production dans le même environnement ou dans un autre environnement. Notez qu’un site Web de production doit être provisionné dans un environnement de bac à sable ou de production.

1. Approvisionner un nouveau site web dans votre environnement cible. Utilisez le même modèle de site web comme vous l’avez approvisionné sur votre environnement source. Par exemple, si vous avez approvisionné un site avec le modèle client en libre-service Dynamics 365 sur votre environnement source, approvisionnez le site avec le client en libre-service Dynamics 365 sur votre environnement cible.

2. Sur l’environnement cible, avec l’application de gestion des portails, supprimez l’enregistrement de site Web récemment créé. Cela supprimera les données de configuration du site web par défaut de l’environnement cible.

   

3. Sur l’environnement cible, dans Power Apps, supprimez l’application de portail. Cela supprimera le site web actuellement configuré pour afficher le site par défaut.

   Note

   Ne supprimez pas l’application de gestion de portail !

   

Transférer la configuration du site web vers l’environnement cible

Transférez les métadonnées du site depuis l’environnement source à l’aide de la Power Platform CLI, de la Configuration Migration Tool ou à l’aide de solutions.

Réactivation du site sur l’environnement cible

Une fois que le site web a été transféré vers l’environnement cible, vous devrez le réactiver.

1. Dans l’environnement cible, sur l’écran d’accueil Power Pages, sélectionnez Sites inactifs. Vous devriez voir le site web que vous avez migré dans l’environnement.

2. Sélectionnez Réactiver.

   

3. Vous pouvez spécifier le nom du Site web réactivé et sélectionner Créer une adresse web ou laisser les valeurs par défaut.

4. Cliquez sur Terminé.

5. Les mises à jour du site web à partir de l’environnement source doivent être reflétées dans ce nouvel environnement cible. À l’avenir, vous devrez pouvoir transférer la configuration de vos environnements source vers cible en transférant les données de configuration du site web.

Note

Un site web qui apparaît dans la liste Sites inactifs de la page d’accueil Power Pages apparaît dans la liste des Sites web actifs dans l’application de gestion du portail.

Transférer les métadonnées du site web

Solutions

Si votre site web est configuré avec le modèle de données amélioré, vous pouvez transférer la configuration du site web en utilisant les solutions Power Platform. Pour plus d’informations, accédez à Utilisation des solutions avec Power Pages.

Note

Assurez-vous que l’environnement cible dispose également du modèle de données amélioré activé.

Power Platform CLI

Transférer la configuration du site web à l’aide de Power Platform CLI

Microsoft Power Platform CLI offre de nombreuses fonctionnalités spécifiques à Power Pages. Ces commandes vous permettent de télécharger la configuration du site à partir d’un environnement source et de la transférer vers un environnement cible. Ces commandes peuvent également être intégrées à vos processus ALM.

1. Créez des profils d’authentification Power Platform CLI pour vous connecter à la fois à vos environnements source et cible. Vous pouvez leur donner un nom pour identifier facilement les environnements cible et source.

   pac auth create --name [name] --url [environment url]
   

   Exemple

   pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
   

2. Lorsque les profils d’authentification sont créés, ils ont un index associé qui peut être déterminé à l’aide de la commande list.

   pac auth list
   

   

3. Sélectionnez le profil d’authentification Power Platform CLI connecté à l’environnement source.

   pac auth select --index [source environment index]
   

   Exemple

   pac auth select --index 1
   

4. Déterminez l’ID de site Web pour le site source.

   pac paportal list
   

   

5. Téléchargez les données de configuration du site web vers votre poste de travail local. Utilisez le groupe d’options --overwrite sur true si vous avez déjà téléchargé la configuration du site web sur le même chemin.

   pac paportal download --path [path] --webSiteId [website id]
   

   Exemple

   pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
   

6. Sélectionnez le profil d’authentification Power Platform CLI connecté à l’environnement cible.

   pac auth select --index [target environment index]
   

   Exemple

   pac auth select --index 2
   

7. Téléchargez les données de configuration du site web vers l’environnement cible.

   pac paportal upload --path [path]
   

   Exemple

   pac paportal upload --path "C:\paportals\portaldev"
   

Note

• L’outil Power Platform CLI ne migre pas les tables ou le schéma de table Dataverse. La migration peut échouer avec des éléments manquants tels que des tables et des champs lorsque les données de configuration ne correspondent pas au schéma sélectionné.
• Lors de l’importation, assurez-vous que l’environnement de destination contient le même type de modèle de site web déjà installé avec toutes les personnalisations supplémentaires telles que des tables, des champs, des formulaires ou des vues importées séparément en tant que solutions.

Configuration Migration Tool

Transférer la configuration du site Web à l’aide du Configuration Migration Tool

Note

La méthode préférée consiste à utiliser les solutions ou Power Platform CLI pour transférer les métadonnées du site web.

Pour exporter des données de configuration, vous devez utiliser l’outil Migration de configuration et un fichier de schéma de configuration de site web spécifique. Pour plus d’informations sur cet outil, voir Gérer des données de configuration.

Note

• Nous vous recommandons d’utiliser la dernière version de l’outil Migration de configuration. L’outil Migration de configuration est téléchargeable depuis NuGet. Pour plus d’informations sur le téléchargement de l’outil : Télécharger des outils à partir de NuGet.
• La version minimale de solution des sites web pris en charge par les fichiers de schémas pour la migration de la configuration est 8.4.0.275. Toutefois, il est recommandé d’utiliser la dernière version de la solution.
• Les organisations source et de destination doivent avoir la même langue par défaut pour que la migration fonctionne correctement.

Les fichiers de schéma sont disponibles pour les types de site web suivants :

• Sites web créés dans un environnement avec Dataverse

  • Portail personnalisé (Portail vide)
  • Portail personnalisé (Portail vierge) (pour la version 9.2.2103.x)
  • Portail personnalisé (Portail vierge) (pour la version 9.3.2201.x ou supérieure)

• Sites web créés dans un environnent contenant des applications d’engagement client (telles que Dynamics 365 Sales et Dynamics 365 Customer Service)

  • Portail personnalisé (Portail vide)
  • Portail personnalisé (Portail vierge) (pour la version 9.2.2103.x)
  • Portail personnalisé (Portail vierge) (pour la version 9.3.2201.x ou supérieure)
  • Portail communautaire
  • Portail libre-service client
  • Portail partenaire
  • Portail des employés en libre-service

Les fichiers de schéma par défaut contiennent des informations sur toutes les tables de site web, relations et définitions d’unicité pour chaque entité. Plus d’informations : Exporter des données de configuration de site web

Après l’exportation des données de configuration, vous devez les importer vers l’environnement cible. Plus d’informations : Importer des données de configuration de site web

Note

• L’outil Migration de la configuration utilise un schéma pour exporter et importer des données de configuration. L’outil ne migre pas les tables ou le schéma de table Dataverse. La migration peut échouer avec des éléments manquants tels que des tables et des champs lorsque les données de configuration ne correspondent pas au schéma sélectionné.
• Lors de l’exportation, assurez-vous que l’environnement source contient des tables de site web comme spécifié dans le fichier de schéma de l’outil de migration de configuration. Vous pouvez toujours modifier les fichiers de schémas pour ajouter, supprimer et modifier des tables, des attributs etc. pour migrer un sous-jeu de données de configuration.
• Lors de l’importation, assurez-vous que l’environnement de destination contient le même type de site web déjà installé avec toutes les personnalisations supplémentaires telles que des tables, des champs, des formulaires ou des vues importées séparément en tant que solutions.

Exporter les données de configuration du site web

Vous pouvez exporter des données de configuration du site web depuis un système source à l’aide de fichiers de schéma de données de configuration spécifiques au site web.

1. Téléchargez l’outil Migration de configuration et extrayez son contenu dans le dossier souhaité.

2. Téléchargez un fichier de schéma de configuration du site web avec des liens fournis ci-dessus pour votre type de modèle de site web.

3. Double-sélectionnez le fichier DataMigrationUtility.exe dans le dossier <your_folder>\Tools\ConfigurationMigration pour exécuter l’outil Migration de configuration, puis choisissez Exporter les données dans l’écran principal et sélectionnez Continuer.

   

4. Dans l’écran Connexion, entrez les informations d’authentification pour vous connecter à l’environnement Dataverse à partir duquel vous voulez exporter les données. S’il y a plusieurs organisations sur l’environnement Dataverse à partir duquel vous exportez les données, cochez la case Afficher la liste des organisations disponibles, puis sélectionnez Connexion.

   

5. S’il y a plusieurs organisations et si vous avez activé la case à cocher Afficher la liste des organisations disponibles à l’étape précédente, l’écran suivant vous permet de choisir l’organisation à laquelle vous voulez vous connecter. Sélectionnez un environnement Dataverse auquel se connecter.

   Note

   Si vous n’avez pas plusieurs organisations, cet écran ne s’affiche pas.

6. Dans Fichier de schéma, recherchez et sélectionnez le fichier de schéma de configuration spécifique au site web à utiliser pour l’exportation des données.

7. Dans le fichier Enregistrer dans le fichier de données, spécifiez le nom et l’emplacement du fichier de données à exporter.

   

8. Sélectionnez Exporter les données. L’écran affiche l’état d’avancement de l’exportation et l’emplacement du fichier exporté en bas de l’écran, une fois l’exportation terminée.

   

9. Sélectionnez Quitter pour fermer l’outil.

Importer les données de configuration du site web

1. Exécutez l’outil Migration de configuration et choisissez Importer les données dans l’écran principal, puis sélectionnez Continuer.

   

2. Dans l’écran Connexion, entrez les informations d’authentification pour vous connecter à l’environnement Dataverse à partir duquel vous voulez exporter les données. S’il y a plusieurs organisations sur l’environnement Dataverse à partir duquel vous exportez les données, cochez la case Afficher la liste des organisations disponibles, puis sélectionnez Connexion.

3. S’il y a plusieurs organisations et si vous avez activé la case à cocher Afficher la liste des organisations disponibles à l’étape précédente, l’écran suivant vous permet de choisir l’organisation à laquelle vous voulez vous connecter. Sélectionnez un environnement Dataverse auquel se connecter.

   Note

   • Si vous n’avez pas plusieurs organisations, cet écran ne s’affiche pas.
   • Vérifiez que la solution de portail est déjà installée pour l’organisation vers laquelle vous envisagez d’importer les configurations.

4. L’écran suivant vous invite à fournir le fichier de données (.zip) à importer. Accédez au fichier de données, sélectionnez-le, puis sélectionnez Importer les données.

   

5. L’écran suivant affiche le statut d’importation de vos enregistrements. L’importation des données s’effectue en plusieurs temps. Les données de base sont importées d’abord et les données connexes sont mises en file d’attente. Les données connexes dans les phases successives, afin de gérer les dépendances ou liaisons de données. Cette action garantit une importation précise et cohérente des données.

6. Sélectionnez Quitter pour fermer l’outil.

Créer un site web à l’aide de données migrées

Si le processus de migration met à jour un site web existant, les mises à jour doivent maintenant être visibles dans l’environnement cible.

Si la migration concerne un nouveau site web, le site web migré est répertorié dans l’onglet Sites inactifs de la page d’accueil Power Pages.

1. Dans l’environnement cible, sur l’écran d’accueil Power Pages, sélectionnez Sites inactifs. Vous devriez voir le site web que vous avez migré dans l’environnement.

2. Sélectionnez Réactiver.

   

3. Vous pouvez spécifier le nom du Site web réactivé et sélectionner Créer une adresse web ou laisser les valeurs par défaut.

4. Cliquez sur Terminé.

Migration de client à client

PowerPaqes ne prend pas en charge la migration client vers client. Pour migrer un site web d’un client à un autre, vous devez suivre ces étapes :

1. Réinitialisez votre site web dans le client source.

2. Approvisionnez un nouveau site web dans un environnement.

3. Migrez les configurations et les personnalisations du site web à l’aide de la procédure indiquée précédemment dans cet article.

Voir aussi

• Prise en charge de Power Pages pour Microsoft Power Platform CLI.
• Migration d’un client à l’autre d’un environnement Power Platform.
• Migration d’un client à l’autre des applications pilotées par modèle dans Dynamics 365 telles que Sales, Customer Service, Marketing, Field Service et Project Service Automation.