pac canvas

  • Article

Utilisation avec les fichiers .msapp Power Apps

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Important

  • Les commandes pack et unpack sont en version préliminaire publique.
  • Les fonctionnalités préliminaires ne sont pas destinées à une utilisation en production et peuvent avoir des fonctionnalités restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.
  • La commande create est mis à la disposition générale.

Commandes

Command Description
pac canvas create Générer une application canevas à partir d’un connecteur personnalisé
pac canvas download Télécharger l’application canevas en tant que fichier .msapp
pac canvas list Répertorier les applications canevas
pac canvas pack (Version préliminaire) Compresser les sources dans un fichier msapp
pac canvas unpack (Version préliminaire) Extraire les sources d’un fichier msapp

pac canvas create

Générer une application canevas à partir d’un connecteur personnalisé

Cette commande générera une application canevas .msapp basée sur la définition OpenAPI d’un connecteur personnalisé existant. L’application contiendra des écrans, la disposition des commandes et du code Power Fx généré en fonction de la façon dont les actions du connecteur personnalisé sont définies, avec une apparence prédéfinie. L’application peut être utilisée pour exercer directement les actions définies dans le connecteur personnalisé.

Les créateurs peuvent importer le produit généré .msappdans Power Apps Studio pour lire l’application ou pour effectuer des modifications et effectuer d’autres personnalisations. Importez l’application générée dans Power Apps Studio en naviguant vers Fichier>Ouvrir>Parcourir au sein de Studio.

Examples

Les exemples suivants illustrent l’utilisation de la commande pac canvas create.

Créer une application canevas basée sur une définition Open API par nom complet

Cet exemple crée une application canevas (en tant que fichier *.msapp) basée sur une définition Open API en utilisant le nom complet du connecteur.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

Créer une application canevas basée sur une définition Open API par ID

Cet exemple crée une application canevas (en tant que fichier *.msapp) basée sur une définition Open API en utilisant l’ID du connecteur.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

connector-display-name ou connector-id sont obligatoires.

Paramètres obligatoires pour canvas create

--msapp

Chemin d’accès au fichier .msapp à générer

Paramètres facultatifs pour canvas create

--connector-display-name

Nom complet du connecteur à partir duquel générer l’application Power App.

--connector-id

ID du connecteur à partir duquel générer l’application Power App.

--environment

ID ou URL de l’environnement cible. La valeur par défaut est l’environnement de votre profil d’authentification Dataverse actuellement actif.

Remarques

Considérations et limitations :

  • Le connecteur personnalisé référencé avec les paramètres connector-display-name ou connector-id doivent faire partie d’une solution.
  • Après avoir importé l’application dans Studio, il n’y aura aucune association avec le connecteur personnalisé. Le créateur doit ajouter manuellement une référence au connecteur personnalisé à partir duquel l’application a été générée avant que l’application puisse être lue. Voir Ajouter des connexions de données aux applications canevas pour connaître la procédure. Jusqu’à ce que cela soit fait, vous pouvez voir des erreurs de formule dans l’application qui seront résolues une fois la référence du connecteur ajoutée. Le nom du connecteur personnalisé que vous ajoutez à l’application doit correspondre au nom complet du connecteur personnalisé référencé dans la commande canvas create.
  • L’application contiendra un écran pour chaque action POST et GET définie par le connecteur.
    • D’autres verbes disponibles dans les connecteurs personnalisés ne sont pas pris en charge.
  • Les commandes affichées sur l’écran de chaque action sont générées dynamiquement en fonction de la définition des types d’entrée et de sortie de chaque action. Certains types d’entrée et de sortie définis dans le connecteur personnalisé ne sont pas pris en charge par canvas create. La commande générera des avertissements dans la console lorsque ceux-ci seront rencontrés. Cas particuliers :
    • Les tableaux d’objets et les tableaux de tableaux ne sont pas pris en charge en tant qu’entrées
    • Les contrôles ne sont pas générés pour les objets ou les tableaux imbriqués au-delà d’une profondeur de 20
    • Les types "Fichier" et "Format binaire" ne sont pas pris en charge pour l’entrée ou la sortie.

pac canvas download

Télécharger l’application canevas en tant que fichier .msapp

Paramètres obligatoires pour canvas download

--name -n

Application canevas exacte, nom partiel ou ID d’application

Paramètres facultatives pour canvas download

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--extract-to-directory -d

Nom du répertoire dans lequel extraire l’application canevas

--file-name -f

Nom du fichier (généralement avec l’extension .msapp). S’il n’est pas fourni, le fichier est enregistré dans le répertoire actuel avec 'appname'.msapp

--overwrite -o

Autoriser le remplacement du fichier

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

pac canvas list

Répertorier les applications canevas

Paramètres facultatifs pour canvas list

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

pac canvas pack

(Version préliminaire) Compresser les sources dans un fichier msapp

Exemple

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

Paramètres obligatoires pour canvas pack

--msapp

Chemin d’accès au fichier .msapp

--sources

Répertoire des sources à compresser

Remarques

Crée un fichier .msapp à partir des fichiers source précédemment décompressés. Le résultat peut être ouvert dans Power Apps Studio en naviguant vers Fichier>Ouvrir>Parcourir.

Après décompression, les fichiers source peuvent être édités et gérés avec des outils externes tels que Visual Studio Code et GitHub.

pac canvas unpack

(Version préliminaire) Extraire les sources d’un fichier msapp

Exemple

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

Décompresse dans le répertoire HelloWorld_src par défaut.

Paramètres obligatoires pour canvas unpack

--msapp

Chemin d’accès au fichier .msapp

Paramètres facultatifs pour canvas unpack

--sources

Répertoire des sources à décompresser

Remarques

Décompresse le fichier source .msapp.

Téléchargez le fichier .msapp de Power Apps Studio en naviguant vers Fichier>Enregistrer sous>Cet ordinateur.

Si le paramètre sources n’est pas spécifié, un répertoire avec le même nom et le même emplacement que le fichier .msapp est utilisé avec le suffixe _src.

Structure de dossiers

Les propriétés de décompression et de compression utilisent la structure de dossiers suivante :

  • \src – Fichiers de contrôle et de composants. Celui-ci contient les sources.
    • *.fx.yaml – Les formules extraites du fichier control.json.

      Note

      C’est l’endroit pour modifier vos formules.

    • CanvasManifest.json – Un fichier manifeste qui contient les informations normalement présentes dans l’en-tête, les propriétés et publishInfo.
    • *.json – Le fichier control.json brut.
    • \EditorState*.editorstate.json – Informations mises en cache pour Power Apps Studio à utiliser.
  • \DataSources – Toutes les sources de données utilisées par l’application.
  • \Connections – Instances de connexion enregistrées avec l’application et utilisées lors du rechargement dans Power Apps Studio.
  • \Assets – Fichiers multimédias intégrés dans l’application.
  • \pkgs – Une copie téléchargée de références externes, telles que des modèles, des fichiers de définition d’API et des bibliothèques de composants. ceux-ci sont similaires aux références NuGet/NPM.
  • \other – Tous les fichiers divers nécessaires pour recréer .msapp.
    • entropy.json – Les éléments volatiles (comme les horodatages) sont extraits dans ce fichier. Cela permet de réduire les différences bruyantes dans d’autres fichiers tout en garantissant que nous pouvons toujours faire un aller-retour.
    • Contient d’autres fichiers du msapp, tels que ceux qui sont dans \references.

Format de fichier

Les fichiers .fx.yaml utilisent un sous-ensemble de YAML. Comme dans Excel, toutes les expressions doivent commencer par un signe égal (=). Pour plus d’informations : Grammaire des formules YAML Power Fx

Fusionner les modifications avec Power Apps Studio

Lorsque vous fusionnez des modifications qui sont apportées dans deux sessions différentes de Power Apps Studio :

  • Assurez-vous que tous les noms de contrôle sont uniques. Par exemple, l’insertion d’un bouton dans deux sessions différentes peut entraîner deux contrôles Button1. Nous conseillons de nommer les contrôles peu de temps après les avoir créés. L’outil n’accepte pas deux contrôles portant le même nom.
  • Pour ces fichiers, fusionnez-les comme vous le faites normalement :
    • \src*.fx.yaml
  • S’il y a des conflits ou des erreurs, vous pouvez supprimer ces fichiers :
    • \src\editorstate*.json – Ces fichiers contiennent des informations facultatives dans Power Apps Studio.
    • \other\entropy.json
  • Pour tout conflit dans ces fichiers, vous pouvez accepter la dernière version :
    • \checksum.json
  • En cas de conflits de fusion sous ces chemins, la fusion n’est pas sûre. Faites-nous savoir si cela se produit souvent et nous travaillerons à la restructuration du format de fichier pour éviter les conflits.
    • \Connections*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open source

Les commandes canevas dans Microsoft Power Platform CLI sont open source. Discuter des améliorations, soulever des problèmes et accéder au code depuis le référentiel d’outils de langage Power Apps.

Voir aussi

Groupes de commandes Microsoft Power Platform CLI
Microsoft Power PlatformVue d’ensemble d’un processus CLI