Partager via


Didacticiel : Utiliser la CLI Microsoft Power Platform avec des portails

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.

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

Notes

  • Vous pouvez également utiliser Power Platform CLI avec Power Pages. Pour plus d'informations : Qu'est-ce que Power Pages
  • Ce tutoriel se concentre sur les Commandes Microsoft Power Platform CLI pour utilisation des portails Power Apps. Pour plus d'informations sur les commandes utilisées dans Power Platform CLI, lisez Commandes courantes.

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 la CLI Microsoft Power Platform

É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

Exemple de liste de portails.

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

Exemple de téléchargement de contenu de portails.

Étape 4. Modifier le contenu des portails

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

Notes

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.

Conseil

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

Étape 5. Télécharger les modifications

Notes

  • 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 e-mail 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.

Notes

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.

  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.

    Dossier pour les profils de déploiement

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

    Profil de déploiement YAML pour le développement

  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:  &nbsp;· 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.

    Afficher le contenu de la page mis à jour.

  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.

    Suffixe du titre du navigateur de l'application Portal Management

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

    Changement de 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