Partager via

Prise en charge des portails pour Microsoft Power Platform CLI

  • Article

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.

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é, les portails Microsoft Power Apps prend en charge la CLI Microsoft Power Platform pour activer CI/CD (Intégration continue/Déploiement continu) de la configuration du portail. Vous pouvez désormais archiver la configuration du portail pour le contrôle de code source et déplacer la configuration du portail vers n’importe quel environnement à l’aide de la CLI Microsoft Power Platform.

Notes

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.

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

Avec la prise en charge des portails pour Microsoft Power Platform CLI, vous pouvez désormais utiliser une fonctionnalité de type hors ligne pour la personnalisation des portails en modifiant le contenu des portails. Et une fois toutes les personnalisations ou modifications enregistrées, chargez-les sur le portail. Lorsque vous téléchargez du contenu de portails 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 du portail 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 portail 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 la CLI Microsoft Power Platform

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. 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)		 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 : Charger les données du portail avec les détails de l’environnement définis via les variables de profil dans le fichier deployment-profiles/[profile-name].deployment.yaml		 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

Notes

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.

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

Notes

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 download avant 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)

Considérations supplémentaires

  • 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