Panduan dan pemecahan masalah untuk aplikasi kanvas tertanam

2025-05-21

Panduan menanamkan aplikasi kanvas

Artikel ini menyediakan petunjuk mengenai bekerja dengan aplikasi kanvas tertanam serta tips berguna untuk mengatasi masalah apa pun yang Anda mungkin temui.

Aplikasi kanvas tertanam hanya didukung dengan aplikasi berdasarkan model Antarmuka Terpadu.
Anda hanya dapat mengaktifkan tiga aplikasi Canvas tertanam untuk setiap formulir dengan web, dan satu untuk jenis klien tablet dan ponsel.
Anda dapat memiliki beberapa aplikasi kanvas tertanam yang ditambahkan ke formulir, namun hanya dapat mengaktifkan tiga pada satu waktu untuk web dan satu untuk jenis klien tablet dan ponsel.
Jika lebih dari tiga aplikasi kanvas tertanam diaktifkan dengan jenis klien Web pada aplikasi berbasis model dari pesan kesalahan menunjukkan sebagai berikut "Anda memiliki lebih dari tiga aplikasi kanvas dengan faktor formulir Web, maksimum adalah tiga untuk faktor bentuk ini. Jumlah aplikasi Canvas dibatasi hingga tiga untuk web dan satu untuk bentuk tablet dan ponsel. "
Untuk mengaktifkan atau menonaktifkan aplikasi kanvas tersemat, lihat Mengaktifkan aplikasi kanvas tertanam dan Menonaktifkan aplikasi kanvas tersemat.
Sebaiknya Anda memiliki aplikasi kanvas tersemat tunggal untuk setiap tab formulir.
Saat menambahkan aplikasi kanvas yang disematkan ke formulir berdasarkan model, selalu gunakan kolom wajib yang dijamin memiliki nilai. Jika kolom Anda tidak memiliki nilai, aplikasi kanvas yang disematkan tidak akan di-refresh sebagai respons terhadap perubahan data apa pun pada formulir berbasis model host.
Memublikasikan formulir berbasis model tidak juga menerbitkan aplikasi kanvas yang disematkan.
- Aplikasi kanvas tertanam harus dipublikasikan independen terhadap formulir berdasarkan model host. Informasi selengkapnya: Memublikasikan aplikasi.
Jika pembukaan Power Apps Studio untuk membuat atau mengedit aplikasi kanvas yang disematkan melalui tombol Sesuaikan di properti kontrol aplikasi kanvas diblokir karena pemblokir pop-up browser web, Anda harus mengaktifkan situs make.powerapps.com atau menonaktifkan pemblokir pop-up untuk sementara, lalu pilih Sesuaikan lagi.
Aplikasi kanvas yang disematkan tidak ditampilkan saat membuat baris baru karena memerlukan konteks baris untuk diteruskan kepada mereka.
Objek ModelDrivenFormIntegration.Item hanya baca.
- Untuk menulis kembali data, Anda harus menggunakan Dataverse konektor. Informasi lebih lanjut: Microsoft Dataverse
Aplikasi kanvas tertanam hanya dapat dibuat melalui formulir berdasarkan model host.
Bila Anda melihat formulir berdasarkan model dengan aplikasi kanvas tertanam, jika Anda melihat pesan kesalahan yang berbunyi "Sepertinya Anda tidak memiliki akses ke aplikasi ini" minta pemiliknya untuk berbagi dengan Anda "pastikan penulis telah berbagi aplikasi Canvas yang disematkan dengan Anda. Informasi selengkapnya: Bagikan aplikasi kanvas yang disematkan.
Menambahkan aplikasi kanvas pada kontrol subkisi tidak lagi tersedia.
- Di rilis pratinjau, pembuat dapat menambahkan aplikasi kanvas pada kontrol subkisi. Karena menyematkan aplikasi kanvas pada formulir berdasarkan model kini tersedia secara umum, menambahkan aplikasi kanvas tertanam pada formulir berdasarkan model akan dirampingkan ke kolom.
- Hal ini memudahkan pembuat karena mereka tidak harus memutuskan terlebih dahulu apakah akan meneruskan baris (formulir utama) saat ini sebagai konteks data atau daftar baris yang terkait dengan baris formulir saat ini (formulir utama).
- Pembuat selalu memulai dengan kolom dan dapat mengakses baris saat ini (formulir utama) atau daftar baris yang terkait dengan baris (formulir utama) saat ini.
- Untuk mengakses daftar baris terkait di aplikasi kanvas, pembuat dapat menggunakan Dataverse fungsi konektor dan Filter dengan kemampuan Tingkatkan pengalaman dan Dataverse tampilan sumber data yang diaktifkan di aplikasi kanvas.
  Misalnya, untuk mengakses tampilan Kontak Aktif dari tabel Kontak , pembuat dapat menggunakan: Filter(Kontak, 'Kontak (Tampilan)'.' Kontak Aktif').
- Aplikasi kanvas yang ada dan menggunakan kontrol subkisi akan terus berfungsi. Namun, sebaiknya migrasikan aplikasi tersebut untuk menggunakan kolom sebagai gantinya. Informasi selengkapnya: Memigrasikan aplikasi kanvas tertanam pada formulir berbasis model yang menggunakan daftar baris yang terkait dengan baris (formulir utama) saat ini untuk detailnya.

Aktifkan aplikasi kanvas tertanam

Pilih kolom yang disesuaikan untuk ditampilkan sebagai aplikasi kanvas tertanam.
Dalam dialog Properti Kolom , pilih tab Kontrol .
Dalam daftar kontrol, pilih Aplikasi Kanvas, lalu pilih opsi Web .
Pilih OK.

Nonaktifkan aplikasi kanvas tertanam

Pilih Kolom yang disesuaikan untuk ditampilkan sebagai aplikasi kanvas tertanam.
Dalam dialog Properti Kolom , pilih tab Kontrol .
Dalam daftar kontrol, pilih kontrol default, lalu pilih opsi Web .
Pilih OK.

Menyimpan data dalam aplikasi kanvas tersemat

Aktivitas penyimpanan yang dibuat dari aplikasi berdasarkan model, misalnya memilih tombol Simpan di bilah perintah formulir utama, tidak menyimpan perubahan yang dibuat dalam aplikasi kanvas yang disematkan.
Untuk menyimpan perubahan yang dibuat di aplikasi kanvas yang disematkan, gunakan Dataverse konektor.
Tindakan OnDataRefresh kontrol ModelDrivenFormIntegration hanya boleh digunakan untuk me-refresh data dalam aplikasi kanvas yang disematkan. Sebaiknya gunakan tindakan OnDataRefresh untuk menyimpan perubahan dalam aplikasi kanvas tersemat.

Masalah umum dan keterbatasan dengan aplikasi kanvas tertanam

Pembatasan

Kontrol kustom aplikasi kanvas hanya didukung untuk digunakan dengan jenis klien Web . Saat ini, jenis klien Telepon dan Tablet tidak didukung.
Hak istimewa Aplikasi Kanvas dalam peran keamanan tidak dapat digunakan untuk memberikan akses kepada pengguna aplikasi ke aplikasi kanvas yang disematkan atau mandiri. Untuk informasi selengkapnya tentang berbagi aplikasi kanvas tersemat, buka: Bagikan aplikasi kanvas tersemat.
Jika Anda menulis kembali data yang sama yang ditampilkan dalam formulir berbasis model host, formulir akan terus menampilkan data lama hingga disegarkan. Cara mudah untuk melakukannya adalah dengan menggunakan metode RefreshForm .
Kontrol kemampuan offline dan perangkat seperti pemindaian kode batang, pengambilan foto dari perangkat, atau melampirkan file tidak didukung dalam aplikasi kanvas yang disematkan.

Misalnya, ketika kontrol ModelDrivenFormIntegration terhubung ke tabel Akun, menggunakan ModelDrivenFormIntegration.Item.'Kontak Utama'.' Nama Lengkap'tidak akan mengembalikan nilai.

Untuk mengakses kolom tabel terkait, pembuat dapat menggunakan salah satu ekspresi yang tercantum di sini: - LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data). ItemId)).' Kontak Utama'.' Nama Lengkap'
- ItemId kosong pada waktu penulisan tetapi akan memiliki nilai saat runtime. - LookUp(Akun, Akun = ModelDrivenFormIntegration.Item.Account).' Kontak Utama'.' Nama Lengkap' (Ekspresi ini lebih mudah dibaca, tetapi ekspresi sebelumnya akan berkinerja sedikit lebih baik.)

Aplikasi kanvas yang tertanam tidak ditampilkan dengan benar

Anda dapat membuat aplikasi kanvas agar responsif, yang mengacu pada kemampuan aplikasi untuk secara otomatis menyelaraskan dengan berbagai ukuran layar dan faktor bentuk untuk menggunakan ruang layar yang tersedia dengan bijaksana. Bergantung pada apakah aplikasi Anda dibuat untuk responsif atau tidak, sebaiknya setelan yang berbeda untuk memastikan bahwa aplikasi kanvas Anda dapat dirender dengan benar dalam bidang pada formulir aplikasi berbasis model. Jika Anda mengalami spasi kosong atau bilah gulir tambahan di sekitar aplikasi kanvas, sebaiknya periksa hal berikut di aplikasi Anda.

Untuk aplikasi yang responsif:

Nonaktifkan opsi Skala agar sesuai. Hal ini memungkinkan aplikasi Anda menskalakan sesuai dengan dimensi dan properti yang telah Anda tetapkan untuk aplikasi Anda. Aplikasi kanvas yang disematkan mungkin tidak dirender dengan benar dalam bidang pada formulir aplikasi berbasis model, seperti spasi kosong tambahan atau bilah gulir di sekitar aplikasi kanvas.

Untuk aplikasi yang tidak responsif:

Sebaiknya aktifkan opsi Timbangan agar sesuai. Ini membantu aplikasi mengubah ukuran agar sesuai dengan ruang yang tersedia.

Dalam kedua skenario, pastikan nilai properti Nama Aplikasi diatur dan ditentukan dengan benar dalam kontrol aplikasi kanvas yang disematkan.

Aplikasi kanvas yang tertanam tidak memperhitungkan tinggi

Properti tinggi bidang Formulir tidak dihormati oleh komponen aplikasi kanvas. Bila disematkan, dimensi komponen aplikasi kanvas akan memperhatikan aspek perbandingan yang diatur pada aplikasi kanvas. Karena perbandingan aspek tetap, tinggi komponen aplikasi kanvas dihitung relatif terhadap lebar aplikasi. Lebar aplikasi ditentukan berdasarkan ruang horizontal yang tersedia dalam aplikasi berdasarkan model. Jika Anda ingin membuat penyesuaian pada tinggi komponen aplikasi kanvas, sebaiknya sesuaikan rasio aspek pada aplikasi kanvas Anda. Perlu diketahui bahwa untuk menyesuaikan perbandingan aspek, aplikasi harus dalam tata letak tablet.

Aktifkan skalakan agar sesuai

Secara default, aplikasi kanvas memiliki pilihan skalakan agar sesuai yang diaktifkan.

Buka aplikasi kanvas yang disematkan pada formulir aplikasi berdasarkan model untuk diedit.
Power Apps Di studio, pilih Pengaturan>File>Ukuran layar + orientasi.
Di bawah Pengaturan Lanjutan, atur Skala agar sesuai dengan Aktif.

Nilai properti Nama Aplikasi tidak ada atau tidak didefinisikan dengan benar

Untuk menangani masalah ini, pilih pilihan yang benar:

Solusi terkelola: Jika solusi diimpor ke lingkungan sebagai solusi terkelola, ikuti langkah-langkah berikut:
1. Masuk ke Power Apps dan buka lingkungan pengembangan tempat Anda awalnya membuat aplikasi kanvas yang disematkan. Lingkungan ini juga tempat solusi diekspor.
2. Buka solusi tidak terkelola yang mencakup aplikasi kanvas, lalu temukan aplikasi kanvas dalam daftar komponen solusi. Salin Nama aplikasi kanvas persis seperti yang muncul dalam daftar komponen. Misalnya, contoso_flooringestimatesapp_624d7.
3. Dalam solusi yang sama, edit aplikasi berbasis model yang memiliki kontrol aplikasi kanvas tertanam, lalu atur Nama Aplikasi kanvas ke kontrol aplikasi kanvas tertanam menggunakan nilai dari langkah sebelumnya. Informasi selengkapnya: Menambahkan aplikasi kanvas yang disematkan pada formulir berbasis model
4. Ekspor solusi dari lingkungan pengembangan, lalu impor solusi tersebut ke lingkungan target Anda.
Solusi tidak dikelola: Jika solusi diimpor ke lingkungan sebagai solusi yang tidak dikelola, edit aplikasi berbasis model yang memiliki kontrol aplikasi kanvas tertanam, lalu ikuti langkah serupa seperti yang dijelaskan untuk solusi terkelola untuk mengatur properti Nama Aplikasi kanvas .

Kontrol aplikasi kanvas tersemat memuat aplikasi kanvas dari lingkungan yang berbeda

Bila solusi yang berisi aplikasi berdasarkan model dengan aplikasi kanvas tersemat diimpor ke lingkungan target, kontrol akan memuat aplikasi kanvas dari lingkungan sumber (tempat solusi diekspor). Kontrol harus memuat aplikasi kanvas dari lingkungan target (saat ini).

Masalah ini terjadi karena pengguna aplikasi tidak memiliki akses membaca tabel Metadata Tambahan CanvasApp di lingkungan target (saat ini). Untuk menangani masalah ini, tambahkan pengguna ke aplikasi peran keamanan yang digunakan untuk aplikasi yang memiliki akses ke tabel Metadata Tambahan CanvasApp. Informasi selengkapnya: Berikan hak baca untuk tabel Metadata Diperluas CanvasApp

Pesan kesalahan: "Anda tidak memiliki hak istimewa baca untuk entitas Aplikasi Kanvas. Hubungi administrator"

Pesan kesalahan ditampilkan pada formulir aplikasi berdasarkan model dengan tampilan aplikasi kanvas yang disematkan.

Masalah ini terjadi karena pengguna aplikasi tidak memiliki akses membaca tabel Metadata Tambahan CanvasApp. Untuk menangani masalah ini, tambahkan pengguna ke aplikasi peran keamanan yang digunakan untuk aplikasi yang memiliki akses ke tabel Metadata Tambahan CanvasApp.

Memberikan hak istimewa baca untuk tabel Metadata Tambahan CanvasApp

Masuk Power Apps, pilih lingkungan, lalu di panel navigasi kiri pilih Aplikasi.
Pilih aplikasi yang Anda inginkan, pilih ..., lalu pilih Bagikan.
Di panel kiri, pilih aplikasi, lalu pilih Kelola peran keamanan.
Buka peran keamanan yang ditetapkan ke aplikasi, seperti peran keamanan Pengguna Dasar.
Pilih tab Entitas Kustom , dan atur hak baca cakupan organisasi untuk tabel Metadata Diperluas CanvasApp.
Pilih Simpan dan Tutup untuk menutup jendela peran keamanan.

Lihat juga

Sematkan aplikasi kanvas pada formulir berbasis model
Menambahkan aplikasi kanvas tertanam pada formulir berbasis model
Mengedit aplikasi kanvas yang disematkan pada formulir berbasis model
Menyesuaikan ukuran layar dan orientasi aplikasi kanvas yang disematkan pada formulir berbasis model
Lakukan tindakan yang telah ditentukan sebelumnya pada formulir host dari dalam aplikasi kanvas yang disematkan
Properti dan tindakan kontrol ModelDrivenFormIntegration
Membagikan aplikasi kanvas yang disematkan
Memigrasikan aplikasi kanvas yang disematkan pada formulir berbasis model yang dibuat menggunakan rilis pratinjau publik ke yang terbaru