Didacticiel : Utiliser Microsoft Power Platform CLI avec Power Pages

Article
10/10/2023

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

Note

Ce tutoriel se concentre sur les commandes Microsoft Power Platform CLI requises pour utilisation de Power Pages. Pour plus d’informations sur les commandes utilisées dans Power Platform CLI, lisez Commandes courantes.
À partir de la version 1.27 de Power Platform CLI, la commande pac paportal est remplacée par pac powerpages. paportal continuera à fonctionner, mais nous vous recommandons d’utiliser powerpages à l’avenir. Cet article sera bientôt mis à jour pour utiliser powerpages au lieu de paportal.

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.

Exemple d’authentification auprès d’un environnement Dataverse utilisant Microsoft Power Platform CLI

Étape 2. Liste des sites web disponibles

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

pac paportal list

Exemple de liste de sites web.

Étape 3. Télécharger le contenu du site web

Téléchargez le contenu du site web à 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.

Texte utilisé par les lecteurs d’écran.

Étape 4. Modifier le contenu du site web

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

Note

Assurez-vous de mettre à jour uniquement les tables prises en charge à utiliser avec Power Platform CLI. Pour plus d’informations, consultez Tables prises en charge.

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

Exemple de texte de page de portails

Ce texte est visible depuis la page web html :

Visual Studio Code avec texte mis en surbrillance pour modification.

Vous pouvez modifier ce texte et enregistrer les modifications :

Texte mis à jour en utilisant Visual Studio Code.

Astuce

Vous pouvez modifier l’emplacement du chemin du dossier dans PowerShell/terminal intégré à l’emplacement téléchargé et entrer « code . » pour ouvrir directement le dossier dans Visual Studio Code.

Étape 5. Télécharger les modifications

Note

Si vous téléchargez vers plusieurs environnements, consultez télécharger les modifications à l’aide du profil de déploiement pour apprendre à télécharger des modifications à l’aide du profil de déploiement.
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 courrier électronique des paramètres système dans la boîte de dialogue des paramètres du système d’environnement.

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\

Démarrage du chargement.

Note

Assurez-vous que le chemin du contenu des portails que vous avez entré est correct. Par défaut, un dossier nommé par le portail (nom convivial) est créé avec le contenu des portails téléchargé. Par exemple, si le nom convivial du portail est custom-portal, le chemin de la commande ci-dessus (--path) doit être 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.

Chargement terminé uniquement pour le contenu modifié.

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.

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.
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".

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:  &nbsp;· Custom Portal (Dev) # Setting value

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.
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

Note

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 :

Sélectionnez Synchroniser dans le studio de conception Power Pages.
Accédez à la page web pour voir le changement.
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 :