Partager via

Prise en charge de Microsoft Power Platform CLI pour Power Pages

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

Microsoft Power Platform CLI est également la première étape pour une gestion de cycle de vie des applications (ALM) 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 Présentation de 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 le contrôle de code source, puis transférer la configuration du site web vers n’importe quel environnement à l’aide de Microsoft Power Platform CLI.

Remarque

  • 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, accédez à la rubrique Installation de Microsoft Power Platform CLI.
  • Avec Power Platform CLI version 1.32, la commande "pac powerpages" a été modifiée en "pac pages". Avec pac cli version 1.27, la commande pac paportal a été modifiée en pac powerpages. Powerpages et paportal continueront de fonctionner, mais nous vous recommandons d’utiliser des pages à l’avenir.

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

  • Exploitez 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 à la rubrique Installation de Microsoft Power Platform CLI.

Tables prises en charge

La prise en charge des portails pour Microsoft Power Platform CLI est limitée aux tableaux 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 tables personnalisées et les tables spécifiques au modèle de portail (telles que le blog, la communauté ou le portail idées) ne sont pas prises en charge pour la personnalisation à l’aide de l’interface CLI Microsoft Power Platform.
  • Les pièces jointes de fichiers image aux enregistrements publicitaires (adx_ad) ne sont pas téléchargées à l’aide de l’interface 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 de Microsoft Power Platform CLI, accédez à la rubrique Installation de 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 portails Power Apps.

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

Vous pouvez ajouter le paramètre -v pour indiquer si le site utilise le modèle de données standard ou amélioré		 pac pages list
download Téléchargez le contenu du site web du portail de l’environnement Dataverse actuel. Elle contient les paramètres suivants :
- path : chemin d’accès où est téléchargé le contenu du site web (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à le contenu de site web (alias : -o)
- modelVersion : 1 ou 2 pour indiquer si les données de site à télécharger utilisent le modèle de données standard (1) ou amélioré (2).		 pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
upload Chargez le contenu du site web du portail vers l’environnement Dataverse actuel. Elle contient le paramètre suivant :
- path : chemin d’accès où est stocké le contenu du site web (alias : -p)
- deploymentProfile : Charger des données du portail avec des détails d’environnement définis par le biais de variables de profil dans le fichier deployment-profiles/[profile-name].deployment.yaml
- modelVersion : 1 ou 2 pour indiquer si les données de site à charger utilisent le modèle de données standard (1) ou le modèle de données amélioré (2).
- forceUploadAll : envoie tous les fichiers locaux à l’environnement. Utilisez cette option lorsque vous pensez que l’état distant est endommagé, hors synchronisation ou lorsque le dernier téléchargement provient d’une autre branche.		 pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Remarque

  • Lorsque vous téléchargez un portail à partir de l’environnement A et que vous le chargez dans l’environnement B, l’interface CLI PAC effectue un chargement complet. Ce comportement se produit parce que le suivi des modifications utilise des fichiers manifestes, qui ne contiennent pas d’informations d’état dans les environnements.
  • Les chargements delta , où seuls les fichiers modifiés sont chargés, sont pris en charge uniquement lorsque les opérations de téléchargement et de chargement se produisent dans le même environnement. Dans ce cas, PAC CLI détecte les modifications locales et charge uniquement les fichiers mis à jour. Pour en savoir plus sur le fonctionnement du suivi des modifications, consultez Fichiers manifestes.
  • Utilisez --forceUploadAll dans ces situations. (Ce paramètre est actuellement réservé à la ligne de commande uniquement. Les tâches Azure DevOps ne l’affichent pas encore.)
    • Dérive de l’état du pipeline (vous avez rebasé ou trié sur le volet les validations, de sorte que le dernier état du serveur ne correspond plus à votre branche).
    • Échec delta soupçonné (par exemple, seules les modifications partielles apparaissent après une normale upload).

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 pages upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

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 à la rubrique Commandes courantes dans Microsoft Power Platform CLI.

Fichiers manifestes

Lorsque vous téléchargez le contenu du site web à l'aide de la commande CLI pac pages download, il génère également deux fichiers manifestes.

  • 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 d’environnement est généré chaque fois que la commande de téléchargement des pages pac 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 de chargement des pages pac 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 de l’environnement est en lecture seule lorsqu’il se connecte au même environnement (l’URL de l’environnement correspond au nom du fichier), afin d’éviter des modifications accidentelles.

Remarque

  • 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 pages download , cela ajoute les enregistrements supprimés du fichier manifeste d’environnement (org-url-manifest.yml) au fichier manifest.yml. Par conséquent, lorsque vous chargez le contenu du site web à l'aide de la commande pac pages upload, il supprime les fichiers de l'environnement (même si c'est vers un autre environnement). 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.

Remarque

Pour supprimer les enregistrements de contenu du site dans un environnement et supprimer les mêmes enregistrements de contenu dans un autre environnement à l’aide de l’interface PAC CLI, vous devez exécuter la commande de téléchargement des pages pacavant et après la suppression du contenu de l’enregistrement du site web. Le manifest.yml effectue le suivi de ces modifications et supprime les enregistrements correspondants dans l’environnement cible lorsque la commande de chargement de pages pac est exécutée.

Utiliser l’extension Visual Studio Code

Vous pouvez également utiliser l’extension VS Code Extension de Power Platform 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 Microsoft Power Platform CLI utilisant le 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

  • Last updated on