Prise en charge de Microsoft Power Platform CLI pour Power Pages

  • Article

Microsoft Power Platform CLI (Interface de ligne de commande) est une interface de ligne de commande de développeur simple et à guichet unique qui permet aux développeurs et aux créateurs d’applications de créer des composants de code.

L’interface de ligne de commande Microsoft Power Platform est également la première étape pour une gestion de cycle de vie des applications complète où les développeurs d’entreprise et les éditeurs de logiciels indépendants peuvent créer, générer, déboguer et publier leurs extensions et personnalisations d’applications rapidement et efficacement. Pour plus d’informations, consultez la rubrique Qu’est-ce que Microsoft Power Platform CLI ?

Avec cette fonctionnalité, Microsoft Power Platform CLI prend en charge CI/CD (Intégration continue/Déploiement continu) d’une configuration de site Power Pages. Vous pouvez désormais archiver la configuration du site web pour contrôler la source et déplacer la configuration du site web vers n’importe quel environnement à l’aide de Microsoft Power Platform CLI.

Note

  • Cette fonctionnalité est généralement disponible à partir de la version CLI 1.9.8 de Power Platform. Pour en savoir plus sur l’installation de la dernière version, consultez Installer la CLI de Microsoft Power Platform.
  • À 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.

Pourquoi utiliser Microsoft Power Platform CLI pour le développement de sites web ?

Avec la prise en charge de Microsoft Power Platform CLI, vous pouvez désormais utiliser une fonctionnalité de type hors ligne pour la personnalisation de site web en modifiant le contenu du site web. Et une fois toutes les personnalisations ou modifications enregistrées, vous pouvez télécharger la configuration du site web vers Microsoft Dataverse. Lorsque vous téléchargez du contenu de site web en utilisant Microsoft Power Platform CLI, le contenu est structuré aux formats YAML et HTML, ce qui le rend facile à personnaliser, permettant une expérience pro-développement.

Voici une liste des fonctionnalités et capacités dont bénéficient les portails avec la prise en charge de Microsoft Power Platform CLI :

Facilité d’utilisation

  • Prise en charge du téléchargement/chargement des données de configuration du site web vers/depuis le système de fichiers local

  • S’appuyer sur l’outil existant Microsoft Power Platform CLI.

Gestion du cycle de vie des applications (ALM)

  • Suivre les modifications apportées à la configuration du site web au sein d’une organisation

  • Déplacez les fichiers de configuration entre les organisations ou les locataires

Support pro-dev et entreprise

  • Aide à s’intégrer de manière transparente avec tous les outils de contrôle de source, tels que « git »

  • Configurez facilement les pipelines CI/CD

Installer Microsoft Power Platform CLI

Pour obtenir des instructions étape par étape, référez-vous à Installer la CLI Microsoft Power Platform.

Tables prises en charge

Prise en charge des portails pour Microsoft Power Platform CLI est limitée aux tableaux répertoriés ci-dessous.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (téléchargement uniquement)

adx_websitelanguage

adx_webtemplate

annotation

Important

  • Les tableaux personnalisés et les tableaux spécifiques aux modèles de portail (tels que le blog, la communauté ou le portail d’idées) ne sont pas pris en charge pour la personnalisation à l’aide de Microsoft Power Platform CLI.
  • Les fichiers image joints aux enregistrements d’annonces (adx_ad) ne sont pas téléchargés à l’aide de la CLI Power Platform. Pour résoudre ce problème, utilisez le champ URL de l’image ou ajoutez une référence HTML dans le champ Copier d’un enregistrement fichier web contenant un fichier image.

Installer et vérifier Microsoft Power Platform CLI pour les portails

Pour en savoir plus sur l’installation Microsoft Power Platform CLI, allez à Installer Microsoft Power Platform CLI.

Après l’installation de Microsoft Power Platform CLI, ouvrez une invite de commande et exécutez pac pour vérifier que la sortie contient « paportal », la commande pour les portails Power Apps.

Confirmer la commande paportal dans Microsoft Power Platform CLI

Commandes Microsoft Power Platform CLI pour portails

La commande Microsoft Power Platform CLI pour les portails est paportal.

Les sections suivantes fournissent plus de détails sur les différentes propriétés de la commande paportal.

Paramètres

Nom de propriété Description Exemple
list Répertorie tous les sites web du portail de l’environnement Dataverse actuel

Aperçu
Vous pouvez ajouter le paramètre -v pour indiquer si le site utilise le modèle de données standard ou amélioré		 pac paportal list
download Télécharger le contenu du site web du portail de l’environnement Dataverse actuel Elle contient les paramètres suivants :
- path : chemin d’accès dans lequel le contenu du site web sera téléchargé (alias : -p)
- webSiteId : ID du site web du portail à télécharger (alias : -id)
- overwrite : (Facultatif) true pour écraser le contenu existant ; false pour échouer si le dossier contient déjà du contenu de site web (alias : -o)

Prévisualiser
- modelVersion : 1 ou 2 pour indiquer si les données du site à télécharger utiliseront le modèle de données standard (1) ou amélioré (2).		 pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
upload Charger le contenu du site web du portail vers l’environnement Dataverse actuel Elle contient le paramètre suivant :
- path : chemin où est stocké le contenu du site web (alias : -p)
-deploymentProfile : télécharger les données du portail avec les détails de l′environnement définis par les variables de profil dans le fichier deployment-profiles/[nom-profil].deployment.yaml

Prévisualiser
- modelVersion : 1 ou 2 pour indiquer si les données du site à télécharger utiliseront le modèle de données standard (1) ou amélioré (2).		 pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

Utiliser le profil de déploiement

Le commutateur deploymentProfile permet de définir un ensemble de variables pour l’environnement au format YAML. Par exemple, vous pouvez avoir différents profils de déploiement (tels que dev, test, prod) qui ont des détails de schéma différents définis dans le profil.

Si vous créez un profil de test, vous pouvez créer un fichier sous deployment-profiles avec le nom « test.deployment.yml » (c’est-à-dire, <profileTag>.deployment.yml). Et vous pouvez exécuter la commande avec tag (<profileTag>) pour utiliser ce profil :

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

Dans ce fichier, vous pouvez avoir le nom de la table (entité) avec l’ID de la table, la liste des attributs et les valeurs que vous souhaitez remplacer lors du téléchargement de la configuration du portail à l’aide du paramètre deploymentProfile.

De plus, vous pouvez utiliser la variable OS pour accéder aux variables d’environnement du système d’exploitation.

Voici un exemple de ce fichier YAML de profil « test.deployment.yml » qui a des détails de schéma uniques :

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Note

Pour en savoir plus sur toutes les commandes utilisées dans la CLI en plus des portails, accédez à Commandes courantes dans Microsoft Power Platform CLI.

Fichiers manifestes

Lorsque vous téléchargez le contenu du site web avec la commande CLI pac paportal download, en plus du téléchargement du contenu du site, deux fichiers manifestes seront générés :

  • Fichier manifeste d’environnement (org-url-manifest.yml)
  • Fichier manifeste de suivi de suppression (manifest.yml)

Fichier manifeste d’environnement (org-url-manifest.yml)

Le fichier manifeste de l’environnement est généré chaque fois que la commande pac paportal download est exécutée.

Après chaque téléchargement, l’outil PAC CLI lit le fichier manifeste de l’environnement existant et met à jour les entrées supprimées dans l’environnement, ou crée le fichier manifeste de l’environnement s’il n’existe pas.

Lorsque vous exécutez la commande pac paportal download pour charger le contenu du site web du portail. Elle lit le fichier manifeste de l’environnement et identifie les modifications apportées depuis le dernier téléchargement, et ne charge que le contenu mis à jour. Cela aide à optimiser le processus de chargement, car seul le contenu du site web mis à jour est chargé, au lieu de charger tout le contenu à chaque commande de chargement.

Le fichier manifeste d’environnement sera en lecture seule lorsqu’il se connectera au même environnement (l’URL de l’environnement correspond au nom du fichier), pour éviter les modifications accidentelles.

Note

  • Le fichier manifeste d’environnement n’est pas conçu pour suivre les modifications lors du déploiement du site web dans différents environnements.
  • Le fichier manifeste d’environnement est conçu pour être utilisé par les développeurs pour un déploiement local dans leur environnement de développement et doit être ajouté pour obtenir la liste Ignorer.

Fichier manifeste de suivi de suppression (manifest.yml)

Ce fichier est utilisé pour suivre les enregistrements supprimés de l’environnement.

Lorsque le contenu du site web est téléchargé avec la commande pac paportal download, les enregistrements supprimés du fichier manifeste de l’environnement (org-url-manifest.yml) seront ajoutés au fichier manifest.yml. Ainsi, lorsque vous chargez le contenu du site web avec la commande pac paportal download, les fichiers de l’environnement seront supprimés (même dans un environnement différent). Ce fichier n’est pas supprimé et est utilisé quel que soit l’environnement auquel vous êtes connecté. Ce fichier doit être pris en compte lors de la transmission des modifications au contrôle de code source afin d’envisager la suppression d’éléments dans l’environnement cible.

Note

Pour supprimer les enregistrements de contenu du site dans un environnement et supprimer aussi les mêmes enregistrements de contenu dans un autre environnement avec PAC CLI, vous devrez exécuter la commande pac paportal downloadavant et après la suppression du contenu de l’enregistrement du site web. Le fichier manifest.yml suivra ces modifications et supprimera les enregistrements correspondants dans l’environnement cible lorsque la commande pac paportal download sera exécutée.

Utiliser l’extension Visual Studio Code

Vous pouvez également utiliser l’extension VS Code Power Platform Extension de VS Code pour bénéficier du langage Liquid intégré d’IntelliSense, de l’assistance à la complétion du code, des conseils et interagir avec la CLI Microsoft Power Platform à l’aide du terminal intégré de VS Code. Plus d’informations : Utiliser l’extension Visual Studio Code (version préliminaire)

Autres considérations

  • Une erreur est signalée si votre chemin de fichier dépasse la limite de longueur de chemin maximale. Plus d’information : Limitation de la longueur maximale du chemin sous Windows
  • Pour les enregistrements en double tels qu’un nom de page web en double, Microsoft Power Platform CLI crée deux dossiers différents ; l’un avec le nom de la page web et l’autre avec le même nom préfixé d’un code de hachage. Par exemple, "Ma-page" et "Ma-page-code de hachage".

Étapes suivantes

Tutoriel : Utiliser Microsoft Power Platform CLI avec des portails

Voir aussi