Tambahkan aplikasi kanvas yang disematkan pada formulir berdasarkan model

Artikel ini menjelaskan cara menanamkan aplikasi Canvas pada formulir berbasis model. Aplikasi kanvas dapat dihubungkan ke berbagai sumber data dan menawarkan kontrol yang lebih besar kepada desainer seputar pengalaman pengguna secara keseluruhan.

Dua metode integrasi dijelaskan di artikel ini. Pertama, menggunakan pengalaman Antarmuka Terpadu modern, dan kedua, menggunakan pengalaman klasik.

Catatan

Ada metode ketiga dan yang lebih baru untuk menyematkan aplikasi kanvas di dalam aplikasi modern, yang menggunakan halaman khusus untuk integrasi yang lebih baik dengan aplikasi kanvas. Gambaran umum halaman kustom untuk aplikasi berbasis model.

Menanamkan aplikasi kanvas menggunakan pengalaman modern

Untuk menyematkan aplikasi kanvas pada formulir utama aplikasi berbasis model, seperti formulir utama untuk tabel Akun, ikuti langkah-langkah berikut ini:

1. Masuk ke Power Apps.

2. Pilih lingkungan, lalu pilih Solusi dari panel navigasi kiri. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.

3. Buka solusi yang memiliki tabel tempat Anda ingin menambahkan aplikasi kanvas ke formulir utama.

4. Buka tabel, pilih Formulir, lalu buka formulir Utama yang Anda inginkan.

   Tip

   Secara default, label komponen aplikasi kanvas adalah Aplikasi kanvas baru. Anda mungkin ingin mengubah nama label aplikasi kanvas menjadi sesuatu yang lebih bermakna, seperti nama aplikasi kanvas atau deskripsi singkat aplikasi kanvas yang Anda sematkan ke formulir.

5. Pilih area pada formulir tempat Anda ingin aplikasi kanvas ditampilkan atau buat tab baru untuk menampilkan aplikasi kanvas.

6. Di panel navigasi kiri, pilih Komponen , perluas Tampilan , lalu pilih komponen aplikasi Canvas.

7. Properti berikut dapat dikonfigurasi untuk kontrol.

   • Area nama entitas memungkinkan Anda menentukan properti berikut:

     • Ikat ke kolom tabel: Saat kolom Ikat ke tabel dipilih, properti Nilai statis berubah untuk memungkinkan Anda memilih kolom tabel apa yang akan diikat. Saat Anda memilih untuk mengikat ke kolom tabel, kolom akan ditentukan oleh nilai kolom tabel. Misalnya, saat kolom Ikat ke tabel dipilih untuk Nama entitas, pada runtime aplikasi nilai nama tabel mengambil nilai kolom Tabel yang ditentukan.

     • Nilai statis: Gunakan ini untuk menambahkan nama untuk Anda rujuk ke aplikasi kanvas. Perhatikan bahwa nilai ini tidak berpengaruh pada aplikasi kanvas tertanam. Ini dimaksudkan hanya untuk berfungsi sebagai titik referensi.

   • Area Nama aplikasi menentukan nama unik aplikasi kanvas.

     • Ikat ke kolom tabel: Saat Anda memilih kolom Ikat ke tabel, properti Nilai statis berubah untuk memungkinkan Anda memilih kolom · tabel apa yang akan diikat. Saat Anda memilih untuk mengikat ke kolom tabel, kolom akan ditentukan oleh nilai kolom tabel. Misalnya, saat Anda memilih Ikat ke kolom tabel untuk Nama Aplikasi, di runtime aplikasi, nilai nama aplikasi mengambil nilai kolom Tabel, seperti nilai dari kolom teks kustom.

     • Nilai statis: Menentukan nama unik aplikasi kanvas yang akan disematkan. Masukkan nama unik aplikasi kanvas untuk aplikasi kanvas yang ada. Informasi selengkapnya: Cara menemukan nama unik dan ID aplikasi untuk aplikasi kanvas

   • Area ID Aplikasi yang diperlukan menentukan ID aplikasi untuk aplikasi kanvas.

     • Mengikat ke kolom tabel: Saat Anda memilih Ikat ke kolom tabel, daftar berubah untuk memungkinkan Anda memilih kolom tabel apa yang akan diikat. Saat Anda memilih untuk mengikat ke kolom tabel, kolom akan ditentukan oleh nilai kolom tabel. Misalnya, saat Anda memilih Ikat ke kolom tabel untuk Nama Aplikasi, pada waktu proses aplikasi, nilai nama aplikasi akan mengambil nilai kolom, seperti nilai dari kolom teks kustom.

     Penting

     Untuk sebagian besar situasi, sebaiknya jangan gunakan opsi Ikat ke kolom tabel untuk ID Aplikasi karena ini akan mengharuskan ID aplikasi yang benar ditampilkan dalam bidang dalam rekaman.

     • Nilai statis: Masukkan ID aplikasi untuk aplikasi kanvas yang ada. Informasi selengkapnya: Cara menemukan nama unik dan ID aplikasi untuk aplikasi kanvas

   • Tampilkan Komponen di. Menentukan tipe klien untuk menampilkan aplikasi kanvas tertanam. Pilih dari Web, Seluler, dan Tablet.

8. Pilih Selesai. Kemudian, untuk memublikasikan aplikasi agar tersedia bagi pengguna, pilih Publikasikan.

Setelah menerbitkan aplikasi kanvas tertanam ke formulir berdasarkan model Anda, bagikan aplikasi kanvas tertanam dengan pengguna lain. Informasi lebih lanjut: berbagi aplikasi kanvas tertanam.

Bila pengguna membuka aplikasi berdasarkan model yang mencakup formulir yang telah Anda modifikasi mereka melihat aplikasi kanvas tertanam pada formulir. Mengubah rekaman yang ditampilkan di formulir utama akan mengubah konteks data yang akan diteruskan ke formulir dan aplikasi tertanam di-refresh untuk menampilkan data yang relevan.

artikel ini menunjukkan cara memulai penanaman aplikasi kanvas di formulir berdasarkan model. Anda dapat lebih lanjut menyesuaikan aplikasi kanvas tertanam untuk menghubungkan dan menampilkan data dari berbagai sumber data. Gunakan fungsi Filter, pencarian dan penelusuran dan konteks yang diteruskan dari formulir berdasarkan model host untuk memfilter atau mencari rekaman tertentu dalam sumber data tersebut. Gunakan editor aplikasi kanvas WYSIWYG untuk dengan mudah merancang antarmuka sesuai kebutuhan Anda.

Cara menemukan nama unik dan ID aplikasi untuk aplikasi kanvas

Kontrol aplikasi kanvas mencari aplikasi kanvas terlebih dahulu dengan menggunakan nama unik yang ditemukan di bidang Nama aplikasi. Jika aplikasi kanvas dengan nama unik tersebut tidak dapat ditemukan di lingkungan, kontrol aplikasi kanvas selanjutnya menggunakan nilai yang ditentukan di bidang ID Aplikasi untuk memuat aplikasi kanvas. Meskipun Anda harus memasukkan nilai di bidang Nama aplikasi dan ID Aplikasi, hanya satu nilai yang harus akurat agar aplikasi kanvas yang disematkan dapat dimuat dalam kontrol. Perhatikan bahwa aplikasi kanvas harus berada di lingkungan saat ini.

• Bidang Nama aplikasi adalah nama unik aplikasi kanvas. Untuk menemukan nama unik, tambahkan aplikasi kanvas ke solusi. Nama unik aplikasi kanvas ditampilkan di kolom Nama dan muncul di formulir solutionpublisherprefix_appnamenospaces_appendix. Misalnya,contoso_canvasappwithsharepointlist_5ee16 ·.
• Properti ID aplikasi menentukan ID aplikasi kanvas tertanam. Masukkan ID Aplikasi untuk aplikasi kanvas yang ada. ID aplikasi Canvas dapat ditemukan di Power Apps, buka aplikasi, pilih aplikasi Canvas, lalu pilih rincian pada bilah perintah.

Menanamkan aplikasi kanvas menggunakan pengalaman klasik

1. Masuk ke Power Apps.

2. Buat atau edit formulir utama suatu tabel, tabel akun dalam contoh kami.

3. Di bilah perintah, pilih beralih ke klasik untuk membuka formulir di desainer formulir klasik.

4. Dalam desainer formulir klasik, pilih bagian pada formulir tempat Anda ingin memunculkan aplikasi kanvas tertanam.

5. Menggunakan panel kolom, tambahkan kolom yang diperlukan, seperti nama akun.

   Penting

   Selalu gunakan kolom wajib yang dijamin untuk memiliki nilai. Jika kolom Anda tidak memiliki nilai aplikasi kanvas tertanam akan me-refresh sebagai respons terhadap perubahan data pada formulir berdasarkan model host.

6. Dengan kolom dipilih, pada tab Beranda, di grup Edit, pilih Ubah Properti.

7. Pada kotak dialog properti kolom, pilih kontrol tab.

8. Pada tab Kontrol pilih Tambahkan kontrol.

9. Pada kotak dialog Tambahkan kontrol, di daftar kontrol yang tersedia, pilih aplikasi kanvas lalu pilih Tambah.

10. Di kotak dialog Properti kolom, di daftar kontrol pilih aplikasi kanvas, pilih pilihan Web.

11. Di bagian bawah daftar kontrol, daftar properti yang tersedia untuk kontrol aplikasi kanvas akan ditampilkan.

    • Properti Nama tabel menentukan tabel yang akan memberikan data untuk aplikasi kanvas tertanam. Ini akan diatur ke tabel yang berisi kolom yang Anda ditambahkan pada langkah sebelumnya.
      • Perhatikan bahwa, meskipun properti ini terlihat dapat berubah, mengubahnya tidak berpengaruh pada aplikasi kanvas tertanam. Ini dimaksudkan hanya untuk melayani sebagai referensi untuk Anda.
    • Properti Nama aplikasi menentukan nama aplikasi kanvas yang akan disematkan. Formulir yang diarahkan model mencari aplikasi Canvas dengan nama yang ditentukan di lingkungan saat ini. Jika aplikasi Canvas dengan nama tersebut tidak dapat ditemukan di lingkungan, kontrol aplikasi Canvas akan menggunakan ID aplikasi untuk memuat aplikasi Canvas. Masukkan nama aplikasi untuk aplikasi Canvas yang ada.
    • Properti ID aplikasi menentukan ID aplikasi kanvas tertanam. Anda dapat memasukkan ID aplikasi untuk aplikasi Canvas yang ada atau ID aplikasi akan secara otomatis dibuat dan diisi untuk Anda saat membuat atau mengedit aplikasi Canvas dengan memilih Sesuaikan. ID aplikasi Canvas dapat ditemukan di Power Apps, buka aplikasi, pilih aplikasi Canvas, lalu pilih rincian pada bilah perintah.

    Catatan

    Perhatikan bahwa, apa pun perubahan ke ID aplikasi nilai memecah tautan dari formulir berdasarkan model ke aplikasi kanvas tertanam.

    Jika tidak ada nama aplikasi atau ID aplikasi yang cocok dengan aplikasi Canvas yang ada, formulir akan menampilkan pesan "Maaf, kami tidak menemukan aplikasi tersebut".

12. Buka langkah 20 jika Anda menambahkan aplikasi Canvas yang telah selesai. Jika Anda membuat aplikasi kanvas baru atau mengedit yang ada, terus ikuti langkah-langkah berikut. Pilih Sesuaikan untuk membuat atau mengedit aplikasi kanvas. Ini membuka Power Apps Studio di tab baru.

    Catatan

    Jika membuka Power Apps Studio diblokir karena iklan pop-up browser web Anda harus mengaktifkan situs make.powerapps.com atau menonaktifkan sementara iklan pop-up dan kemudian pilih Sesuaikan lagi.

13. Amati hal berikut:

    • Perhatikan Power Apps Studio bahwa ada kontrol ModelDrivenFormIntegration khusus di panel kiri. Kontrol ini bertanggung jawab untuk membawa data kontekstual dari formulir berdasarkan model host ke aplikasi kanvas tertanam.
    • Perhatikan bahwa kontrol formulir aplikasi Canvas secara otomatis ditambahkan ke aplikasi Canvas yang disematkan dan menampilkan data yang diteruskan kepadanya dari formulir berbasis model host melalui kontrol ModelDrivenFormIntegration.
    • Pilih tab tampilan, lalu pilih sumber data. Perhatikan bahwa sumber data untuk tabel induk formulir berbasis model host Anda, akun dalam kasus ini, akan secara otomatis ditambahkan ke aplikasi Canvas yang disematkan. - Pilih kontrol Form1 dan perhatikan bahwa properti DataSource diatur ke Akun.
    • Dengan kontrol Form1 masih dipilih, perhatikan bahwa properti item diatur ke ModelDrivenFormIntegration.Item.

    Catatan

    Aplikasi Canvas tersemat memiliki akses penuh untuk membaca dari formulir berbasis model host melalui ModelDrivenFormIntegration.Item. Sebagai contoh, untuk mendapatkan nilai kolom dengan nama accountnumber dan nama tampilan Account Number, Anda dapat menggunakan ModelDrivenFormIntegration.Item.accountnumber atau ModelDrivenFormIntegration.Item.'Account Number'.

14. Di panel properti di sebelah kanan, Kolom, pilih Edit kolom.

15. Pilih + Tambah kolom untuk menambahkan kolom lain ke formulir aplikasi canvas atau menyusun ulang kolom yang ada menggunakan drag and drop. Tutup panel data setelah Anda selesai menambahkan dan menyusun ulang kolom.

16. Pilih File tab, dan kemudian pilih Simpan.

17. Pilih cloud tab. Berikan nama unik untuk aplikasi dan kemudian pilih Simpan terletak di kanan bawah. Perhatikan perilaku berikut:

    • Menyimpan aplikasi untuk pertama kali secara otomatis mempublikasikan aplikasi.
    • Pada menyimpan berikutnya, pilih publikasikan lalu pilih mempublikasikan versi ini untuk membuat perubahan tersedia.

18. Di menu, pilih kembali.

19. Pilih tab browser yang memiliki desainer formulir klasik terbuka. Perhatikan bahwa properti ID aplikasi dan Nama Aplikasi dari kontrol aplikasi kanvas sekarang memiliki nilai yang secara otomatis diisi.

    Penting

    • Desainer formulir memiliki tautan langsung dengan Power Apps Studio yang dibuka dalam tab browser lain pada langkah sebelumnya.
    • Pastikan nama aplikasi memiliki nilai yang mirip dengan gambar layar di bawah ini. Properti nama aplikasi menentukan nama unik yang akan digunakan untuk mereferensi aplikasi Canvas saat runtime. Jika nama ini tidak diatur, Properti ID aplikasi akan digunakan untuk mereferensi aplikasi Canvas, yang dapat menyebabkan masalah saat Anda mengimpor aplikasi kanvas sebagai bagian dari solusi. Sebaiknya Anda menetapkan nama ini untuk memastikan adanya referensi aplikasi kanvas yang tepat antara lingkungan. Untuk mengaturnya, kembali ke langkah 12 dan ikuti langkah-langkah untuk membuat aplikasi Canvas untuk disematkan.
    

20. Pada kotak dialog properti kolom, pilih Tampilan tab.

21. Hapus label tampilan pada formulir dan kemudian pilih OK.

    • Jika aplikasi kanvas sudah disematkan pada formulir ini pesan ditampilkan bahwa "hanya satu aplikasi kanvas dapat diaktifkan pada formulir." Untuk menambahkan aplikasi kanvas baru Anda harus terlebih dulu menonaktifkan aplikasi kanvas tertanam saat ini. Selanjutnya, aktifkan aplikasi kanvas tertanam baru.

22. Di tab Beranda, pilih Simpan, lalu publikasikan.

Lihat juga

Edit aplikasi kanvas yang disematkan pada formulir berdasarkan model
Melakukan tindakan yang telah ditetapkan pada formulir host dari dalam aplikasi kanvas tertanam
Properti dan tindakan kontrol ModelDrivenFormIntegration
Pedoman bekerja dengan aplikasi kanvas tertanam