Comparteix via

pac canvas

Funcionament amb fitxers .msapp del Power Apps

[Aquest article forma part de la documentació preliminar i està subjecte a canvis.]

Important

  • Les pack ordres i unpack estan obsoletes.
  • Per controlar el codi font de l'aplicació de llenç, utilitzeu la integració de Git del Power Platform.
  • L'ordre create està disponible generalment.

Comandes

Ordre Descripció
pac canvas create Generar una aplicació de llenç des d'un connector personalitzat
pac canvas download Baixeu l'aplicació de llenç com a fitxer .msapp
pac canvas list Llista d'aplicacions de llenç
pac canvas pack (Vista prèvia) Empaquetar fonts en un fitxer msapp
pac canvas unpack (Vista prèvia) Extreu un fitxer msapp en fonts
pac canvas validate (Vista prèvia) Validar l'origen .pa.yaml d'un fitxer msapp descomprimit

pac canvas create

Generar una aplicació de llenç des d'un connector personalitzat

Aquesta ordre generarà una .msapp aplicació de llenç basada en la definició d'OpenAPI d'un connector personalitzat existent. L'aplicació contindrà pantalles, disseny de control i codi Power Fx generat en funció de com es defineixen les accions del connector personalitzat, amb un aspecte predefinit. L'aplicació es pot utilitzar per exercir directament les accions definides al connector personalitzat.

Els creadors poden importar el generat .msapp al Power Apps Studio per reproduir l'aplicació o per fer edicions i fer personalitzacions addicionals. Importeu l'aplicació generada al Power Apps Studio navegant finsa> per obrir el fitxer> dins de l'Studio.

Exemples

Els exemples següents mostren l'ús de l'ordre pac canvas create .

Crear una aplicació de llenç basada en una definició d'API oberta per nom de visualització

En aquest exemple es crea una aplicació de llenç (com a fitxer *.msapp) basada en una definició d'API oberta mitjançant el nom de visualització del connector.

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

Crear una aplicació de llenç basada en una definició d'API oberta per id

En aquest exemple es crea una aplicació de llenç (com a fitxer *.msapp) basada en una definició d'API oberta mitjançant l'identificador del connector.

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

O connector-display-nameconnector-id són obligatoris.

Paràmetres requerits per a canvas create

--msapp

Camí al fitxer .msapp que s'ha de generar

Paràmetres opcionals per a canvas create

--connector-display-name

El nom de visualització del connector des del qual generar el Power App.

--connector-id

L'identificador del connector des del qual generar el Power App.

--environment

L'identificador o l'URL de l'entorn de destinació. El valor per defecte és l'entorn del perfil d'autenticació del Dataverse actiu actualment.

Observacions

Consideracions i limitacions:

  • El connector personalitzat al qual es fa referència amb els connector-display-name paràmetres or connector-id ha de formar part d'una solució.
  • Després d'importar l'aplicació a Studio, no hi haurà cap associació amb el connector personalitzat. El creador ha d'afegir manualment una referència al connector personalitzat des del qual s'ha generat l'aplicació abans de poder reproduir-la. Vegeu Afegir connexions de dades a les aplicacions de llenç per veure els passos. Fins que no es faci això, és possible que vegeu errors de fórmula a l'aplicació que es resoldran un cop s'afegeixi la referència del connector. El nom del connector personalitzat que afegiu a l'aplicació ha de coincidir amb el nom de visualització del connector personalitzat al qual es fa referència a l'ordre canvas create .
  • L'aplicació contindrà una pantalla per a cadascuna POST i GET l'acció que defineix el connector.
    • No s'admeten altres verbs disponibles en connectors personalitzats.
  • Els controls representats a la pantalla de cada acció es generen dinàmicament en funció de com es defineixen els tipus d'entrada i sortida de cada acció. Determinats tipus d'entrada i sortida definits al connector personalitzat no són compatibles amb canvas createel . L'ordre generarà avisos a la consola quan es trobin. Casos concrets:
    • Les matrius d'objectes i les matrius de matrius no s'admeten com a entrades
    • No es generen controls per a objectes ni matrius imbricades més enllà d'una profunditat de 20
    • Els tipus "Fitxer" i "format binari" no són compatibles per a l'entrada o la sortida.

pac canvas download

Baixeu l'aplicació de llenç com a fitxer .msapp

Paràmetres requerits per a canvas download

--name -n

Nom exacte, parcial o identificador de l'aplicació de llenç

Paràmetres opcionals per a canvas download

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--extract-to-directory -d

Nom del directori per extreure l'aplicació de llenç

--file-name -f

Nom del fitxer (normalment amb extensió .msapp). Si no es proporciona, el fitxer es desa al directori actual amb 'appname'.msapp

--overwrite -o

Permet la sobreescriptura de fitxers

Aquest paràmetre no requereix cap valor. És un canvi.

pac canvas list

Llista d'aplicacions de llenç

Paràmetres opcionals per a canvas list

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac canvas pack

(Vista prèvia) Empaquetar fonts en un fitxer msapp

Exemple

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

Paràmetres requerits per a canvas pack

--msapp

Camí al fitxer .msapp

--sources

Directori de fonts a empaquetar

Observacions

Crea un .msapp fitxer a partir dels fitxers d'origen desempaquetats anteriorment. El resultat es pot obrir al Power Apps Studio navegant fins aNavega>>.

Després de desempaquetar-los, els fitxers font es poden editar i gestionar amb eines externes com Visual Studio Code i GitHub.

pac canvas unpack

(Vista prèvia) Extreu un fitxer msapp en fonts

Exemple

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

pac canvas unpack --msapp HelloWorld.msapp

Desempaqueta al directori per defecte HelloWorld_src .

Paràmetres requerits per a canvas unpack

--msapp

Camí al fitxer .msapp

Paràmetres opcionals per a canvas unpack

--sources

Directori de fonts a desempaquetar

Observacions

Desempaqueta el fitxer d'origen .msapp .

Baixeu el .msapp fitxer del Power Apps Studio navegant a Desa el fitxer>com>a aquest ordinador.

Si no s'especifica el paràmetre sources, s'utilitza un directori amb el mateix nom i ubicació que el fitxer amb .msapp sufix_src.

Estructura de carpetes

Les propietats de desempaquetament i empaquetament utilitzen l'estructura de carpetes següent:

  • \src - Fitxers de control i components. Això conté les fonts.
    • *.fx.yaml - Les fórmules extretes del control.json fitxer.

      Nota

      Aquest és el lloc on podeu editar les vostres fórmules.

    • CanvasManifest.json - Un fitxer de manifest que conté la informació normalment present a la capçalera, les propietats i publishInfo.
    • *.json - El fitxer raw control.json .
    • \EditorState*.editorstate.json - Informació emmagatzemada a la memòria cau per utilitzar-la al Power Apps Studio.
  • \DataSources : totes les fonts de dades utilitzades per l'aplicació.
  • \Connexions : instàncies de connexió desades amb l'aplicació i utilitzades en tornar a carregar al Power Apps Studio.
  • \Assets - Fitxers multimèdia incrustats a l'aplicació.
  • \pkgs - Còpia baixada de referències externes, com ara plantilles, fitxers de definició d'API i biblioteques de components. Són similars a les referències de NuGet/NPM.
  • \other - Tots els fitxers diversos necessaris per tornar a crear el .msappfitxer .
    • entropy.json - Els elements volàtils (com les marques de temps) s'extreuen a aquest fitxer. Això ajuda a reduir les diferències sorolloses en altres fitxers alhora que garanteix que encara puguem fer un viatge d'anada i tornada.
    • Conté altres fitxers del msapp, com ara el que hi ha en \referències.

Format de fitxer

Els .fx.yaml fitxers utilitzen un subconjunt de YAML. De manera similar a l'Excel, totes les expressions haurien de començar amb un signe =igual . Més informació: Gramàtica de la fórmula YAML del Power Fx

Combinació de canvis amb el Power Apps Studio

Quan es combinen els canvis que es fan en dues sessions diferents del Power Apps Studio:

  • Assegureu-vos que tots els noms de control siguin únics. Per exemple, inserir un botó en dues sessions diferents pot donar lloc a dos Button1 controls. Us recomanem que anomeneu els controls poc després de crear-los. L'eina no accepta dos controls amb el mateix nom.
  • Per a aquests fitxers, fusioneu-los com feu normalment:
    • \src*.fx.yaml
  • Si hi ha conflictes o errors, podeu suprimir aquests fitxers:
    • \src\editorstate*.json - Aquests fitxers contenen informació opcional al Power Apps Studio.
    • \other\entropy.jsen
  • Per a qualsevol conflicte en aquests fitxers, està bé acceptar la darrera versió:
    • \checksum.jsen
  • Si hi ha conflictes de fusió sota aquests camins, no és segur fusionar-lo. Feu-nos saber si això passa sovint; Treballarem en la reestructuració del format de fitxer per evitar conflictes.
    • \Connexions*
    • \Fonts de dades*
    • \paquets*
    • CanvasManifest.json

Codi obert

Les ordres de llenç de la CLI del Microsoft Power Platform són de codi obert. Discutiu les millores, plantegeu problemes i accediu al codi des del repositori d'eines de llenguatge del Power Apps.

pac canvas validate

(Vista prèvia) Validar l'origen .pa.yaml d'un fitxer msapp descomprimit

Paràmetres requerits per a canvas validate

--directory -d

Camí al directori msapp extret que conté fitxers .pa.yaml per validar

Vegeu també

Grups d'ordres de l'CLI del Microsoft Power Platform
Informació general de la CLI del Microsoft Power Platform

  • Last updated on