Partajați prin

pac canvas

Operarea cu fișiere .msapp Power Apps

[Acest articol este documentație de prelansare și poate suferi modificări.]

Important

  • Comenzile pack și unpack sunt perimate.
  • Pentru a controla sursa aplicației pânză, utilizați integrarea Power Platform Git.
  • Comanda create este disponibilă în general.

Comenzi

Comanda Descriere
pac canvas create Generați o aplicație pânză de la un conector particularizat
pac canvas download Descărcați aplicația pânză ca fișier .msapp
pac canvas list Listați aplicațiile de pânză pentru pânză
pac canvas pack (Previzualizare) Împachetați surse într-un fișier msapp
pac canvas unpack (Previzualizare) Extragerea unui fișier msapp în surse
pac canvas validate (Previzualizare) Validați sursa .pa.yaml pentru un fișier msapp dezarhivat

pac canvas create

Generați o aplicație pânză de la un conector particularizat

Această comandă va genera o .msapp aplicație pânză pe baza definiției OpenAPI a unui conector particularizat existent. Aplicația va conține ecrane, aspect de control și cod Power Fx generat pe baza modului în care sunt definite acțiunile conectorului particularizat, cu un aspect și un stil predefinit. Aplicația poate fi utilizată pentru a exercita direct acțiunile definite în conectorul particularizat.

Makers can import the generate .msapp în Power Apps Studio pentru a reda aplicația sau pentru a face editări și a efectua particularizări suplimentare. Importați aplicația generată în Power Apps Studio navigând la Răsfoire fișier>- Deschidere> în studio.

Exemple

Următoarele exemple arată utilizarea comenzii pac canvas create .

Crearea unei aplicații pe pânză pe baza unei definiții Open API după numele afișat

Acest exemplu creează o aplicație pânză (ca fișier *.msapp) bazată pe o definiție Open API utilizând numele afișat al conectorului.

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

Crearea unei aplicații pe pânză pe baza unei definiții Open API după ID

Acest exemplu creează o aplicație pânză (ca fișier *.msapp) bazată pe o definiție Open API utilizând ID-ul conectorului.

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

connector-display-name Fie connector-id sunt necesare.

Parametri obligatorii pentru canvas create

--msapp

Calea către fișierul .msapp de generat

Parametri opționali pentru canvas create

--connector-display-name

Numele afișat al Conectorului din care se generează aplicația Power.

--connector-id

ID-ul conectorului din care se generează aplicația Power.

--environment

ID-ul sau URL-ul de mediu țintă. Valoarea implicită este mediul profilului Dataverse Auth activ în prezent.

Remarci

Considerații și limitări:

  • Conectorul particularizat la care connector-display-name se face referire cu parametrii sau connector-id trebuie să facă parte dintr-o soluție.
  • După ce importați aplicația în Studio, nu va exista nicio asociere la conectorul particularizat. Creatorul trebuie să adauge manual o referință la conectorul particularizat din care a fost generată aplicația înainte ca aplicația să poată fi redată. Pentru pașii necesari , consultați Adăugarea conexiunilor de date la aplicațiile pânză . Până când se termină acest lucru, este posibil să vedeți erori de formule în aplicație, care se vor rezolva după ce se adaugă referința conectorului. Numele conectorului particularizat pe care îl adăugați la aplicație trebuie să corespundă cu numele afișat al conectorului particularizat la care se face referire în canvas create comandă.
  • Aplicația va conține un ecran pentru fiecare POST și GET acțiune pe care conectorul o definește.
    • Alte verbe disponibile în conectorii particularizați nu sunt acceptate.
  • Controalele redate pe ecranul fiecărei acțiuni sunt generate dinamic pe baza modului în care sunt definite tipurile de intrare și ieșire ale fiecărei acțiuni. Anumite tipuri de intrare și ieșire definite în conectorul particularizat nu sunt acceptate de canvas create. Comanda va genera avertismente în consolă atunci când apar acestea. Cazuri specifice:
    • Matricele de obiecte și matrice de matrice de matrice nu sunt acceptate ca intrări
    • Controalele nu sunt generate pentru obiecte sau matrice imbricate după o adâncime de 20
    • Tipurile "Fișier" și "format binar" nu sunt acceptate pentru intrare sau ieșire.

pac canvas download

Descărcați aplicația pânză ca fișier .msapp

Parametri obligatorii pentru canvas download

--name -n

Aplicația Pânză exactă, numele parțial sau ID-ul aplicației

Parametri opționali pentru canvas download

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

--extract-to-directory -d

Nume director pentru a extrage aplicația pânză la

--file-name -f

Nume fișier (de obicei cu extensia .msapp). Dacă nu s-a furnizat fișierul este salvat în directorul curent cu 'appname'.msapp

--overwrite -o

Se permite suprascrierea fișierelor

Acest parametru nu necesită nicio valoare. Este un comutator.

pac canvas list

Listați aplicațiile de pânză pentru pânză

Parametri opționali pentru canvas list

--environment -env

Specifică dataverse țintă. Valoarea poate fi un URL GUID sau absolut https. Când nu este specificată, se va utiliza organizația activă selectată pentru profilul de autentificare curent.

pac canvas pack

(Previzualizare) Împachetați surse într-un fișier msapp

Exemplu

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

Parametri obligatorii pentru canvas pack

--msapp

Calea către fișierul .msapp

--sources

Director la surse de împachetat

Remarci

Creează un .msapp fișier din fișierele sursă despachetate anterior. Rezultatul poate fi deschis în Power Apps Studio navigând laRăsfoire>>.

După despachetare, fișierele sursă pot fi editate și gestionate cu instrumente externe, cum ar fi Visual Studio Code și GitHub.

pac canvas unpack

(Previzualizare) Extragerea unui fișier msapp în surse

Exemplu

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

pac canvas unpack --msapp HelloWorld.msapp

Despachetați directorul implicit HelloWorld_src .

Parametri obligatorii pentru canvas unpack

--msapp

Calea către fișierul .msapp

Parametri opționali pentru canvas unpack

--sources

Director la surse de despachetat

Remarci

Despachetează .msapp fișierul sursă.

Descărcați .msapp fișierul din Power Apps Studio navigând la Salvare fișiere>ca>acest computer.

Dacă parametrul surse nu este specificat, un director cu același nume și locație ca .msapp fișierul este utilizat cu _src sufix.

Structură folder

Despachetarea și proprietățile pachetului utilizează următoarea structură de foldere:

  • \src - Control și fișiere componente. Aceasta conține sursele.
    • *.fx.yaml - formulele extrase din control.json fișier.

      Notă

      Acesta este locul în care editați formulele.

    • CanvasManifest.json - un fișier manifest care conține informațiile prezente în mod normal în antet, proprietăți și publicareInfo.
    • *.json - Fișierul brut control.json .
    • \EditorState*.editorstate.json - informații memorate în cache pentru power Apps Studio de utilizat.
  • \DataSources - toate sursele de date utilizate de aplicație.
  • \Connections - Instanțe de conexiune salvate cu aplicația și utilizate la reîncărcarea în Power Apps Studio.
  • \Assets - fișiere media încorporate în aplicație.
  • \pkgs - o copie descărcată a referințelor externe, cum ar fi șabloane, fișiere de definiții API și biblioteci de componente. Acestea sunt similare referințelor NuGet/NPM.
  • \other - Toate fișierele diverse necesare pentru a recrea .msapp.
    • entropy.json - elementele volatile (cum ar fi marcajele de timp) sunt extrase în acest fișier. Acest lucru vă ajută să reduceți diferențele zgomotoase din alte fișiere, asigurându-vă că încă ne putem întoarce.
    • Păstrează alte fișiere din msapp, cum ar fi ceea ce se află în \referențe.

Format fișier

Fișierele .fx.yaml utilizează un subset de YAML. Similar cu Excel, toate expresiile ar trebui să înceapă cu semnul egal =. Mai multe informații: Gramatica formulei YAML Power Fx

Îmbinarea modificărilor cu Power Apps Studio

Când se îmbină modificările efectuate în două sesiuni Power Apps Studio diferite:

  • Asigurați-vă că toate numele controlului sunt unice. De exemplu, inserarea unui buton în două sesiuni diferite poate avea ca rezultat două Button1 controale. Vă recomandăm să denumiți controalele imediat după ce le creați. Instrumentul nu acceptă două controale cu același nume.
  • Pentru aceste fișiere, îmbinați-le așa cum procedați în mod normal:
    • \src*.fx.yaml
  • Dacă există conflicte sau erori, puteți șterge aceste fișiere:
    • \src\editorstate*.json - aceste fișiere conțin informații opționale în Power Apps Studio.
    • \other\entropy.jsactivat
  • Pentru orice conflict din aceste fișiere, este în regulă să acceptați cea mai recentă versiune:
    • \checksum.jsactivat
  • Dacă există conflicte de îmbinare în aceste căi, nu este sigur să îmbinați. Spuneți-ne dacă acest lucru se întâmplă adesea; vom lucra la restructurarea formatului de fișier pentru a evita conflictele.
    • \Conexiuni*
    • \DataSources*
    • \Pkgs*
    • CanvasManifest.json

Open source

Comenzile de pe pânză din Microsoft Power Platform CLI sunt open source. Discutați despre îmbunătățiri, ridicați probleme și accesați codul din depozitul de instrumente lingvistice Power Apps.

pac canvas validate

(Previzualizare) Validați sursa .pa.yaml pentru un fișier msapp dezarhivat

Parametri obligatorii pentru canvas validate

--directory -d

Calea către directorul msapp extras care conține fișiere .pa.yaml pentru a valida

Consultați și

Grupuri de comenzi CLI Microsoft Power Platform
Prezentare generală Microsoft Power Platform CLI

  • Last updated on