Kongsi melalui

pac canvas

Beroperasi dengan fail .msapp Power Apps

[Artikel ini merupakan dokumentasi prapelancaran dan tertakluk pada perubahan.]

Penting

  • Perintah pack dan unpack ditamatkan.
  • Untuk mengawal sumber apl kanvas anda, gunakan Penyepaduan Git Power Platform.
  • Perintah ini create tersedia secara umum.

Perintah

Perintah Description
pac canvas create Jana apl kanvas daripada penyambung tersuai
pac canvas download Muat turun aplikasi kanvas sebagai fail .msapp
pac canvas list Senaraikan apl kanvas
pac canvas pack (Pratonton) Pek sumber ke dalam fail msapp
pac canvas unpack (Pratonton) Ekstrak fail msapp ke dalam sumber
pac canvas validate (Pratonton) Sahkan sumber .pa.yaml untuk fail msapp yang dinyahzip

pac canvas create

Jana apl kanvas daripada penyambung tersuai

Perintah ini akan menjana .msapp apl kanvas berdasarkan definisi OpenAPI bagi penyambung tersuai sedia ada. Apl ini akan mengandungi skrin, susun atur kawalan dan kod Power Fx yang dijana berdasarkan cara tindakan penyambung tersuai ditakrifkan, dengan rupa dan rasa yang telah ditetapkan. Apl ini boleh digunakan untuk melaksanakan tindakan secara langsung yang ditakrifkan dalam penyambung tersuai.

Pembuat boleh mengimport yang dijana .msapp ke dalam Power Apps Studio untuk memainkan apl atau untuk melakukan pengeditan dan membuat penyesuaian selanjutnya. Import apl yang dijana ke Power Apps Studio dengan menavigasi keBuka>Fail>Semak imbas dalam Studio.

Contoh

Contoh berikut menunjukkan penggunaan pac canvas create arahan.

Cipta aplikasi kanvas berdasarkan Definisi API Terbuka mengikut nama paparan

Contoh ini mencipta aplikasi kanvas (sebagai fail *.msapp) berdasarkan Definisi API Terbuka dengan menggunakan nama paparan penyambung.

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

Cipta apl kanvas berdasarkan Definisi API Terbuka mengikut id

Contoh ini mencipta aplikasi kanvas (sebagai fail *.msapp) berdasarkan Definisi API Terbuka dengan menggunakan ID penyambung.

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

Sama ada connector-display-name atau connector-id diperlukan.

Parameter yang diperlukan untuk canvas create

--msapp

Laluan ke fail .msapp yang akan dijana

Parameter Pilihan untuk canvas create

--connector-display-name

Nama paparan Penyambung untuk menjana Power App daripadanya.

--connector-id

ID Penyambung untuk menjana Power App daripada.

--environment

ID atau URL Persekitaran sasaran. Nilai lalai ialah persekitaran Profil Pengesahan Dataverse anda yang sedang aktif.

Ucapan

Pertimbangan dan batasan:

  • Penyambung tersuai yang dirujuk dengan connector-display-name parameter atau connector-id mestilah sebahagian daripada Penyelesaian.
  • Selepas mengimport apl ke Studio, tiada perkaitan kepada penyambung tersuai. Pembuat mesti menambah rujukan secara manual kepada penyambung tersuai dari mana apl dijana sebelum apl boleh dimainkan. Lihat Tambah sambungan data pada aplikasi kanvas untuk peringkat. Sehingga ini selesai, anda mungkin melihat ralat formula dalam apl yang akan diselesaikan sebaik sahaja rujukan penyambung ditambah. Nama penyambung tersuai yang anda tambahkan pada aplikasi mesti sepadan dengan nama paparan penyambung tersuai yang dirujuk dalam canvas create arahan.
  • Apl ini akan mengandungi satu skrin untuk setiap dan POSTGET tindakan yang ditakrifkan oleh penyambung.
    • Kata kerja lain yang tersedia dalam penyambung tersuai tidak disokong.
  • Kawalan yang dipaparkan pada skrin setiap tindakan dijana secara dinamik berdasarkan cara jenis input dan output setiap tindakan ditakrifkan. Jenis input dan output tertentu yang ditakrifkan dalam penyambung tersuai tidak disokong oleh canvas create. Perintah akan menjana amaran dalam konsol apabila ini ditemui. Kes tertentu:
    • Tatasusunan objek dan tatasusunan tatasusunan tidak disokong sebagai input
    • Kawalan tidak dijana untuk objek atau tatasusunan bersarang melebihi kedalaman 20
    • Jenis "Fail" dan "format binari" tidak disokong untuk input atau output.

pac canvas download

Muat turun aplikasi kanvas sebagai fail .msapp

Parameter yang diperlukan untuk canvas download

--name -n

Apl kanvas tepat, nama separa atau ID Apl

Parameter Pilihan untuk canvas download

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

--extract-to-directory -d

Nama direktori untuk mengekstrak aplikasi kanvas kepada

--file-name -f

Nama fail (biasanya dengan sambungan .msapp). Jika tidak disediakan, fail disimpan dalam direktori semasa dengan 'appname'.msapp

--overwrite -o

Benarkan menulis ganti fail

Parameter ini tidak memerlukan nilai. Ia adalah suis.

pac canvas list

Senaraikan apl kanvas

Parameter Pilihan untuk canvas list

--environment -env

Menentukan Dataverse sasaran. Nilai mungkin URL Guid atau https mutlak. Apabila tidak ditentukan, organisasi aktif yang dipilih untuk profil pengesahan semasa akan digunakan.

pac canvas pack

(Pratonton) Pek sumber ke dalam fail msapp

Contoh

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

Parameter yang diperlukan untuk canvas pack

--msapp

Laluan ke fail .msapp

--sources

Direktori kepada sumber yang akan dibungkus

Ucapan

Mencipta .msapp fail daripada fail sumber yang dibongkar sebelum ini. Hasilnya boleh dibuka dalam Power Apps Studio dengan menavigasi keSemakan Imbas>>.

Selepas dibongkar, fail sumber boleh diedit dan diuruskan dengan alatan luaran seperti Visual Studio Code dan GitHub.

pac canvas unpack

(Pratonton) Ekstrak fail msapp ke dalam sumber

Contoh

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

pac canvas unpack --msapp HelloWorld.msapp

Membongkar ke direktori lalai HelloWorld_src .

Parameter yang diperlukan untuk canvas unpack

--msapp

Laluan ke fail .msapp

Parameter Pilihan untuk canvas unpack

--sources

Direktori kepada sumber yang akan dibongkar

Ucapan

Membongkar .msapp fail sumber.

Muat turun .msapp fail daripada Power Apps Studio dengan menavigasi ke Simpan Fail>sebagai>Komputer ini.

Jika parameter sumber tidak ditentukan, direktori dengan nama dan lokasi yang sama seperti .msapp fail digunakan dengan _src akhiran.

Struktur folder

Nyahpek dan pek sifat menggunakan struktur folder berikut:

  • \src - Fail kawalan dan komponen. Ini mengandungi sumber.
    • *.fx.yaml - Formula yang diekstrak daripada control.json fail.

      Nota

      Ini adalah tempat untuk mengedit formula anda.

    • CanvasManifest.json - Fail manifes yang mengandungi maklumat yang biasanya terdapat dalam pengepala, sifat dan publishInfo.
    • *.json - Fail mentah control.json .
    • \EditorState*.editorstate.json - Maklumat cache untuk digunakan oleh Power Apps Studio.
  • \DataSources - Semua sumber data yang digunakan oleh apl.
  • \Connections - Tika sambungan disimpan dengan apl dan digunakan apabila memuatkan semula ke dalam Power Apps Studio.
  • \Assets - Fail media yang dibenamkan dalam apl.
  • \pkgs - Salinan rujukan luaran yang dimuat turun, seperti templat, fail definisi API dan pustaka komponen. Ini serupa dengan rujukan NuGet/NPM.
  • \other - Semua fail pelbagai yang diperlukan untuk mencipta semula file .msapp.
    • entropy.json - Elemen yang tidak menentu (seperti cap masa) diekstrak ke fail ini. Ini membantu mengurangkan perbezaan bising dalam fail lain sambil memastikan kami masih boleh pergi balik.
    • Memegang fail lain daripada msapp, seperti perkara yang ada dalam rujukan \r.

Format fail

.fx.yaml Fail menggunakan subset YAML. Sama seperti Excel, semua ungkapan hendaklah bermula dengan tanda =sama . Maklumat lanjut: Tatabahasa Formula Power Fx YAML

Menggabungkan perubahan dengan Power Apps Studio

Apabila menggabungkan perubahan yang dibuat dalam dua sesi Power Apps Studio yang berbeza:

  • Pastikan semua nama kawalan adalah unik. Sebagai contoh, memasukkan butang dalam dua sesi berbeza boleh menghasilkan dua Button1 kawalan. Kami mengesyorkan agar anda menamakan kawalan sejurus selepas anda menciptanya. Alat ini tidak menerima dua kawalan dengan nama yang sama.
  • Untuk fail ini, gabungkannya seperti biasa:
    • \src*.fx.yaml
  • Jika terdapat konflik atau ralat, anda boleh memadamkan fail ini:
    • \src\editorstate*.json - Fail ini mengandungi maklumat pilihan dalam Power Apps Studio.
    • \other\entropy.js
  • Untuk sebarang konflik dalam fail ini, anda boleh menerima versi terkini:
    • \checksum.js
  • Jika terdapat sebarang konflik penggabungan di bawah laluan ini, ia tidak selamat untuk digabungkan. Beritahu kami jika ini sering berlaku; Kami akan berusaha untuk menstrukturkan semula format fail untuk mengelakkan konflik.
    • \Sambungan*
    • \Sumber Data*
    • \pkgs*
    • CanvasManifest.json

Sumber terbuka

Arahan kanvas dalam Microsoft Power Platform CLI adalah sumber terbuka. Bincangkan penambahbaikan, bangkitkan isu dan akses kod daripada repositori perkakas bahasa Power Apps.

pac canvas validate

(Pratonton) Sahkan sumber .pa.yaml untuk fail msapp yang dinyahzip

Parameter yang diperlukan untuk canvas validate

--directory -d

Laluan ke direktori msapp yang diekstrak yang mengandungi fail .pa.yaml untuk disahkan

Lihat juga

Kumpulan Perintah CLI Microsoft Power Platform
Gambaran keseluruhan CLI Microsoft Power Platform

  • Last updated on