Migrer la configuration du portail

Notes

À compter du 12 octobre 2022, le portail Power Apps devient Power Pages. Plus d’informations : Microsoft Power Pages est maintenant généralement disponible (blog)
Nous allons bientôt migrer et fusionner la documentation des portails Power Apps avec la documentation de Power Pages.

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

Une fois le développement ou la configuration de votre instance de portail terminés, vous pouvez migrer votre dernière configuration de portail, 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

Notes

• Préparer l’environnement cible est un processus ponctuel. Vous devrez approvisionner un nouveau portail afin d’installer les solutions de portail géré sur Dataverse et de configurer l’application Web du portail. Le processus installe également les métadonnées de portail par défaut qui seront remplacées par les métadonnées de portail 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.

1. Approvisionner un nouveau portail dans votre environnement cible. Utilisez le même modèle de portail comme vous l’avez approvisionné sur votre environnement source. Par exemple, si vous avez approvisionné le portail client en libre-service Dynamics 365 sur votre environnement source, approvisionnez le portail 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 portail par défaut de l’environnement cible.

   

3. Sur l’environnement cible, supprimez l’application de portail. Cela supprimera l’application de portail actuellement configurée pour afficher le portail par défaut.

   Notes

   Ne supprimez pas l’application de gestion de portail !

   

4. Transférez les métadonnées de portail depuis l’environnement source avec la CLI Power Platform ou l’outil de migration de la configuration.

5. Sur l’environnement cible, approvisionnez un nouveau portail à l’aide de l’option de site Web de portail existant. Ce processus configurera un portail à l’aide de la configuration de portail que vous avez transférée depuis l’environnement source.

   

6. Les mises à jour du portail à 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 portail.

Transférer les métadonnées du portail

Power Platform CLI

Notes

À compter du 12 octobre 2022, le portail Power Apps devient Power Pages. Plus d’informations : Microsoft Power Pages est maintenant généralement disponible (blog)
Nous allons bientôt migrer et fusionner la documentation des portails Power Apps avec la documentation de Power Pages.

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

Microsoft Power Platform CLI offre de nombreuses fonctionnalités spécifiques aux portails. Ces commandes vous permettent de télécharger la configuration du portail à 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 portail source.

   pac paportal list
   

   

5. Téléchargez les données de configuration du portail 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 portail 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 portail vers l’environnement cible.

   pac paportal upload --path [path]
   

   Exemple

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

Notes

L’outil Power Platform CLI ne migre pas les tables ou le schéma de table. 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 portail 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.

Outil de migration de configuration

Notes

À compter du 12 octobre 2022, le portail Power Apps devient Power Pages. Plus d’informations : Microsoft Power Pages est maintenant généralement disponible (blog)
Nous allons bientôt migrer et fusionner la documentation des portails Power Apps avec la documentation de Power Pages.

Transférer la configuration du portail à l’aide de l’outil Migration de configuration

Notes

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

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

Notes

• 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 portails 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 portails suivants :

• Portails 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)

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

  • Portail personnalisé (Portail vierge)
  • 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 portail, relations et définitions d’unicité pour chaque entité. Plus d’informations : Exporter des données de configuration de portail

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 portail

Notes

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. 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 portail 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 portail 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 des données de configuration du portail

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

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 portail avec des liens fournis ci-dessus pour votre type de portail.

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.

   Notes

   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 portail à 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 le statut 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 des données de configuration du portail

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.

   Notes

   • 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 nouveau portail à l’aide de données migrées

Si le processus de migration met à jour un portail existant, les mises à jour doivent maintenant être visibles dans l’environnement cible. Si la migration est destiné à un nouveau portail, vous pouvez maintenant créer le nouveau portail pour l’enregistrement de site Web importé en utilisant l’option Utiliser les données de l’enregistrement de site Web existant. Pour plus d’informations : Créer un portail

Migration de client à client

Les portails Power Apps pas en charge la migration client vers client. Pour migrer un portail d’un client à un autre, vous devez suivre ces étapes :

1. Réinitialisez votre portail dans le client source.

2. Approvisionner un nouveau portail dans un environnement avec Dataverse ou contenant des applications Customer Engagement.

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

Voir aussi

• Suivre les modifications apportées à la configuration des portails Power Apps.
• Prise en charge des portails 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.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).