Bagikan melalui

pac canvas

Beroperasi dengan file .msapp Power Apps

[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]

Penting

  • Perintah pack dan unpack tidak digunakan lagi.
  • Untuk mengontrol sumber aplikasi kanvas Anda, gunakan Integrasi Power Platform Git.
  • Perintah create ini umumnya tersedia.

Commands

Command Description
pac canvas create Membuat aplikasi kanvas dari konektor kustom
pac canvas download Unduh aplikasi kanvas sebagai file .msapp
pac canvas list Mencantumkan aplikasi kanvas
pac canvas pack (Pratinjau) Mengemas sumber ke dalam file msapp
pac canvas unpack (Pratinjau) Mengekstrak file msapp ke dalam sumber
pac canvas validate (Pratinjau) Memvalidasi sumber .pa.yaml untuk file msapp yang tidak di-zip

pac canvas create

Membuat aplikasi kanvas dari konektor kustom

Perintah ini akan menghasilkan .msapp aplikasi kanvas berdasarkan definisi OpenAPI dari konektor kustom yang ada. Aplikasi ini akan berisi layar, tata letak kontrol, dan kode Power Fx yang dihasilkan berdasarkan bagaimana tindakan konektor kustom ditentukan, dengan tampilan dan nuansa yang telah ditentukan sebelumnya. Aplikasi ini dapat digunakan untuk langsung menjalankan tindakan yang ditentukan dalam konektor kustom.

Pembuat dapat mengimpor yang dihasilkan .msapp ke Power Apps Studio untuk memutar aplikasi, atau melakukan pengeditan dan melakukan penyesuaian lebih lanjut. Impor aplikasi yang dihasilkan ke Power Apps Studio dengan menavigasi keBuka>File>Telusuri dalam Studio.

Examples

Contoh berikut menunjukkan penggunaan pac canvas create perintah.

Membuat aplikasi kanvas berdasarkan Definisi OPEN API menurut nama tampilan

Contoh ini membuat aplikasi kanvas (sebagai file *.msapp) berdasarkan Definisi API Terbuka dengan menggunakan nama tampilan konektor.

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

Membuat aplikasi kanvas berdasarkan Definisi Open API menurut id

Contoh ini membuat aplikasi kanvas (sebagai file *.msapp) berdasarkan Definisi Api Terbuka dengan menggunakan ID konektor.

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

Baik connector-display-name atau connector-id diperlukan.

Parameter yang Diperlukan untuk canvas create

--msapp

Jalur ke file .msapp yang akan dihasilkan

Parameter Opsional untuk canvas create

--connector-display-name

Nama tampilan Konektor untuk menghasilkan Power App.

--connector-id

ID Konektor untuk menghasilkan Power App.

--environment

ID lingkungan target atau URL. Nilai default adalah lingkungan Profil Dataverse Auth Anda yang saat ini aktif.

Komentar

Pertimbangan dan batasan:

  • Konektor kustom yang dirujuk connector-display-name dengan parameter atau connector-id harus menjadi bagian dari Solusi.
  • Setelah mengimpor aplikasi ke Studio, tidak akan ada asosiasi ke konektor kustom. Pembuat harus menambahkan referensi secara manual ke konektor kustom tempat aplikasi dihasilkan sebelum aplikasi dapat diputar. Lihat Menambahkan koneksi data ke aplikasi kanvas untuk langkah-langkahnya. Hingga ini selesai, Anda mungkin melihat kesalahan rumus di aplikasi yang akan diselesaikan setelah referensi konektor ditambahkan. Nama konektor kustom yang Anda tambahkan ke aplikasi harus cocok dengan nama tampilan konektor kustom yang dirujuk dalam canvas create perintah.
  • Aplikasi akan berisi satu layar untuk setiap POST dan GET tindakan yang ditentukan konektor.
    • Kata kerja lain yang tersedia di konektor kustom tidak didukung.
  • Kontrol yang dirender pada layar setiap tindakan dihasilkan secara dinamis berdasarkan bagaimana jenis input dan output dari setiap tindakan ditentukan. Jenis input dan output tertentu yang ditentukan dalam konektor kustom tidak didukung oleh canvas create. Perintah akan menghasilkan peringatan di konsol ketika ini ditemui. Kasus tertentu:
    • Array objek dan array array tidak didukung sebagai input
    • Kontrol tidak dihasilkan untuk objek atau array berlapis di luar kedalaman 20
    • Jenis "File" dan "format biner" tidak didukung untuk input atau output.

pac canvas download

Unduh aplikasi kanvas sebagai file .msapp

Parameter yang Diperlukan untuk canvas download

--name -n

Aplikasi Kanvas tepat, nama parsial, atau ID Aplikasi

Parameter Opsional untuk canvas download

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

--extract-to-directory -d

Nama direktori untuk mengekstrak aplikasi kanvas ke

--file-name -f

Nama file (biasanya dengan ekstensi .msapp). Jika tidak disediakan, file disimpan di direktori saat ini dengan 'appname'.msapp

--overwrite -o

Perbolehkan penimpaan file

Parameter ini tidak memerlukan nilai. Ini saklar.

pac canvas list

Mencantumkan aplikasi kanvas

Parameter Opsional untuk canvas list

--environment -env

Menentukan target Dataverse. Nilainya mungkin berupa URL Guid atau https absolut. Ketika tidak ditentukan, organisasi aktif yang dipilih untuk profil autentikasi saat ini akan digunakan.

pac canvas pack

(Pratinjau) Mengemas sumber ke dalam file msapp

Example

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

Parameter yang Diperlukan untuk canvas pack

--msapp

Jalur ke file .msapp

--sources

Direktori ke sumber yang akan dikemas

Komentar

.msapp Membuat file dari file sumber yang sebelumnya tidak dikemas. Hasilnya dapat dibuka di Power Apps Studio dengan menavigasi ke Buka File>>Telusuri.

Setelah dibuka kemasannya, file sumber dapat diedit dan dikelola dengan alat eksternal seperti Visual Studio Code dan GitHub.

pac canvas unpack

(Pratinjau) Mengekstrak file msapp ke dalam sumber

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Membongkas ke direktori default HelloWorld_src .

Parameter yang Diperlukan untuk canvas unpack

--msapp

Jalur ke file .msapp

Parameter Opsional untuk canvas unpack

--sources

Direktori ke sumber yang akan dibuka kemasannya

Komentar

Membuka kemasan .msapp file sumber.

.msapp Unduh file dari Power Apps Studio dengan menavigasi ke Simpan File>sebagai>Komputer ini.

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

Struktur folder

Buka kemasan dan paket properti gunakan struktur folder berikut:

  • \src - Kontrol dan file komponen. Ini berisi sumber.
    • *.fx.yaml - Rumus yang diekstrak dari control.json file.

      Nota

      Ini adalah tempat untuk mengedit rumus Anda.

    • CanvasManifest.json - File manifes yang berisi informasi yang biasanya ada di header, properti, dan publishInfo.
    • *.json - File mentah control.json .
    • \EditorState*.editorstate.json - Informasi cache untuk digunakan Power Apps Studio.
  • \DataSources - Semua sumber data yang digunakan oleh aplikasi.
  • \Koneksi - Instans koneksi disimpan dengan aplikasi dan digunakan saat memuat ulang ke Power Apps Studio.
  • \Aset - File media yang disematkan di aplikasi.
  • \pkgs - Salinan referensi eksternal yang diunduh, seperti templat, file definisi API, dan pustaka komponen. Ini mirip dengan referensi NuGet/NPM.
  • \other - Semua file lain-lain yang diperlukan untuk membuat .msappulang .
    • entropy.json - Elemen volatil (seperti tanda waktu) diekstrak ke file ini. Ini membantu mengurangi perbedaan bising dalam file lain sambil memastikan bahwa kita masih dapat melakukan perjalanan pulang pergi.
    • Menyimpan file lain dari msapp, seperti apa yang ada dalam eferensi \r.

Format berkas

File .fx.yaml menggunakan subset YAML. Mirip dengan Excel, semua ekspresi harus dimulai dengan tanda =sama dengan . Informasi selengkapnya: Tata Bahasa Rumus Power Fx YAML

Menggabungkan perubahan dengan Power Apps Studio

Saat menggabungkan perubahan yang dilakukan dalam dua sesi Power Apps Studio yang berbeda:

  • Pastikan bahwa semua nama kontrol unik. Misalnya, menyisipkan tombol dalam dua sesi berbeda dapat menghasilkan dua Button1 kontrol. Sebaiknya beri nama kontrol segera setelah Anda membuatnya. Alat ini tidak menerima dua kontrol dengan nama yang sama.
  • Untuk file-file ini, gabungkan seperti yang biasa Anda lakukan:
    • \src*.fx.yaml
  • Jika ada konflik atau kesalahan, Anda dapat menghapus file-file ini:
    • \src\editorstate*.json - File ini berisi informasi opsional di Power Apps Studio.
    • \other\entropy.jsaktif
  • Untuk setiap konflik dalam file-file ini, tidak masalah untuk menerima versi terbaru:
    • \checksum.jsaktif
  • Jika ada konflik penggabungan di bawah jalur ini, tidak aman untuk digabungkan. Beri tahu kami jika ini sering terjadi; kita akan bekerja untuk merestrukturisasi format file untuk menghindari konflik.
    • \Koneksi*
    • \DataSources*
    • \Pkgs*
    • CanvasManifest.json

Sumber terbuka

Perintah kanvas di Microsoft Power Platform CLI adalah sumber terbuka. Diskusikan peningkatan, ajukan masalah, dan akses kode dari repositori alat bahasa Power Apps.

pac canvas validate

(Pratinjau) Memvalidasi sumber .pa.yaml untuk file msapp yang tidak di-zip

Parameter yang Diperlukan untuk canvas validate

--directory -d

Jalur ke direktori msapp yang diekstrak yang berisi file .pa.yaml untuk memvalidasi

Lihat juga

Grup Perintah CLI Microsoft Power Platform
Gambaran umum CLI Microsoft Power Platform

  • Last updated on