Didacticiel : Utiliser la CLI Microsoft Power Platform avec des portails

Dans cet exemple de didacticiel, vous verrez comment démarrer avec Microsoft Power Platform CLI pour mettre à jour la configuration des exemples de portails.

Téléchargez et installez Visual Studio Code

Pour se connecter à portails Power Apps et utiliser les Commandes Microsoft Power Platform CLI, utilisez Visual Studio Code et le terminal intégré. Le terminal intégré facilite la connexion à l'environnement Dataverse et pour télécharger, modifier et charger la configuration des portails. Vous pouvez également utiliser Windows PowerShell au lieu.

Étape 1. Authentifier

Avant de vous connecter, répertoriez, téléchargez ou chargez des modifications pour un portail Power Apps, vous devez d'abord vous authentifier auprès du environnement Dataverse. Pour plus d’informations sur l’authentification à l’aide de Microsoft Power Platform CLI, allez à pac auth.

Pour vous authentifier, ouvrez Windows PowerShell et exécutez la commande pac auth create en utilisant l’URL de votre environnement Dataverse :

pac auth create -u [Dataverse URL]

Exemple

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

Suivez les invites d'authentification pour vous connecter à l'environnement.

Étape 2. Liste des portails disponibles

Utilisez la commande pac paportal list pour lister les portails Power Apps disponibles dans l’environnement Dataverse auquel vous vous êtes connecté à l’étape précédente.

pac paportal list

Étape 3. Télécharger le contenu des portails

Téléchargez le contenu du site Web du portail à partir de l’environnement Dataverse en utilisant la commande pac paportal download.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Exemple

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

Pour le paramètre ID, utilisez le WebSiteId renvoyé par la sortie de l'étape précédente.

Étape 4. Modifier le contenu des portails

Modifiez la configuration en utilisant Visual Studio Code et enregistrez vos modifications.

Par exemple, la page du portail par défaut affiche un texte tel que celui-ci :

Ce texte est visible depuis la page web html :

Vous pouvez modifier ce texte et enregistrer les modifications :

Étape 5. Télécharger les modifications

Après avoir apporté les modifications requises, chargez-les à l’aide de la commande pac paportal upload :

pac paportal upload --path [Folder-location]

Exemple

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Le chargement n'a lieu que pour le contenu qui a été modifié. Dans cet exemple, étant donné que la modification est apportée à une page Web, le contenu est chargé uniquement pour la table adx_webpage.

Télécharger les modifications à l'aide du profil de déploiement

Lorsque vous travaillez avec plusieurs environnements différents, vous pouvez envisager d'utiliser des profils de déploiement pour vous assurer que les modifications sont téléchargées dans le bon environnement à l'aide du profil de déploiement.

1. Créez un dossier nommé deployment-profiles dans le dossier présentant le contenu du portail. Par exemple, si le contenu du portail téléchargé se trouve dans "starter-portal", le dossier des profils de déploiement doit se trouver dans ce dossier.

   

2. Dans le dossier des profils de déploiement, créez un fichier YAML de déploiement qui contient les modifications spécifiques à l'environnement. Par exemple, l'environnement de développement peut être appelé "dev.deployment.yml".

   

3. Modifiez le fichier YAML de déploiement à l'aide de Visual Studio Code avec le format suivant :

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   Par exemple, l'exemple de code YAML suivant met à jour la valeur de "Suffixe de titre de navigateur" de "Portail personnalisé" par défaut à "Portail personnalisé (Dev) ».

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Pour télécharger les modifications dans un environnement différent à l'aide d'un fichier YAML de profil de déploiement, authentifiez-vous dans l'organisation cible en premier.

5. Après vous être authentifié et connecté au bon environnement, utilisez la commande pac paportal upload pour charger le contenu :

   pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

   Notes

   Dans l'exemple ci-dessus, le nom du profil de déploiement utilisé est "dev" après avoir suivi les étapes précédentes pour créer un profil de déploiement dev. Remplacez le nom de "dev" par un autre (comme QA pour "qa.deployment.yml" ou Test pour "test.deployment.yml") si vous avez utilisé un nom de fichier différent pour votre fichier YAML de déploiement.

Étape 6. Confirmer les modifications

Pour confirmer les modifications apportées à la page web du portail :

1. Effacer le cache côté serveur, Ou utiliser Configuration de synchronisation en utilisant Studio des portails Power Apps.

2. Accédez à la page web du portail pour voir le changement.

   

3. Si vous avez utilisé l'exemple de profil de déploiement expliqué précédemment, le YAML extrait mettra à jour la valeur comme indiqué ci-dessous.

   

   Le suffixe du titre du navigateur mis à jour via la modification ci-dessus indique la modification lorsque vous ouvrez le portail dans un navigateur :

   

Cela conclut ce didacticiel. Vous pouvez répéter les étapes ci-dessus et modifier le contenu des portails pour d’autres tables prises en charge.

Étapes suivantes

Utiliser l'extension Visual Studio Code

Voir aussi

• Microsoft Power Platform CLI
• Utiliser l’extension Visual Studio Code (version préliminaire)