Bagikan melalui

Panduan dan pemecahan masalah untuk aplikasi kanvas tertanam

  • Artikel

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 yang disematkan diaktifkan dengan jenis klien Web pada aplikasi berbasis model dari pesan kesalahan menunjukkan sebagai berikut "Anda memiliki lebih dari tiga aplikasi kanvas dengan Web bentuk dan ukuran, maksimum adalah tiga untuk bentuk dan ukuran ini. Jumlah aplikasi Canvas dibatasi hingga tiga untuk web dan satu untuk bentuk tablet dan ponsel. "
  • Untuk mengaktifkan atau menonaktifkan aplikasi kanvas tertanam Lihat mengaktifkan aplikasi kanvas tertanam dan menonaktifkan aplikasi kanvas tertanam.
  • 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 direfresh sebagai respons terhadap perubahan data apa pun pada formulir berbasis model host.
  • Memublikasikan formulir berdasarkan model juga tidak memublikasikan aplikasi kanvas yang disematkan.
    • Aplikasi kanvas tertanam harus dipublikasikan independen terhadap formulir berdasarkan model host. Informasi selengkapnya: Memublikasikan aplikasi.
  • Jika membuka Power Apps Studio untuk membuat atau mengedit aplikasi kanvas tertanam melalui tombol Sesuaikan di properti kontrol aplikasi kanvas diblokir karena blocker pop-up iklan browser web, Anda harus mengaktifkan situs make.powerapps.com atau menonaktifkan sementara iklan pop-up dan kemudian pilih Sesuaikan lagi.
  • Aplikasi kanvas yang disematkan tidak ditampilkan saat membuat baris baru karena memerlukan konteks baris untuk diteruskan ke aplikasi tersebut.
  • 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 lebih lanjut: berbagi aplikasi kanvas tertanam.
  • 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 tampilan Dataverse sumber data yang diaktifkan di aplikasi kanvas.
      Contohnya, untuk mengakses tampilan kontak aktif dari tabel kontak, pembuat dapat menggunakan: memfilter (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 lebih lanjut: Memigrasi aplikasi Canvas yang disematkan pada formulir berdasarkan model yang menggunakan daftar baris yang terkait dengan baris formulir utama saat ini untuk rincian.

Aktifkan aplikasi kanvas tertanam

  1. Pilih kolom yang disesuaikan untuk ditampilkan sebagai aplikasi kanvas tertanam.
  2. Pada kotak dialog Properti Kolom, pilih Kontrol tab.
  3. Dalam daftar kontrol pilih aplikasi kanvas lalu pilih Web pilihan.
  4. Pilih OK.

Nonaktifkan aplikasi kanvas tertanam

  1. Pilih Kolom yang disesuaikan untuk ditampilkan sebagai aplikasi kanvas tertanam.
  2. Pada kotak dialog Properti Kolom, pilih Kontrol tab.
  3. Dalam daftar kontrol, pilih kontrol default lalu pilih opsi Web .
  4. 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 dalam aplikasi kanvas terlekat, gunakan konektor Dataverse.
  • 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, telepon dan Tablet jenis klien tidak didukung.
  • Anda tidak dapat menggunakan hak istimewa aplikasi kanvas dalam peran keamanan untuk memberikan akses ke aplikasi kanvas mandiri atau tertanam kepada pengguna aplikasi. Untuk informasi lebih lanjut tentang menyampaikan aplikasi kanvas tertanam, lihat: Berbagi aplikasi kanvas tertanam.
  • 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 menggunakan metode RefreshForm.
  • Kontrol kemampuan offline dan perangkat seperti pemindaian kode batang, pengambilan foto dari perangkat, atau melampirkan file tidak didukung di aplikasi kanvas yang disematkan.

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

Untuk mengakses kolom pembuat tabel terkait dapat menggunakan salah satu dari ekspresi yang tercantum di sini: - LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data).ItemId)).'Primary Contact'.'Full Name'
- ItemId kosong saat penulisan namun akan memiliki nilai saat runtime. - LookUp(Accounts, Account = ModelDrivenFormIntegration.Item.Account).'Primary Contact'.'Full Name' (ekspresi ini lebih mudah dibaca, namun ekspresi sebelumnya akan berkinerja sedikit lebih baik.)

Aplikasi kanvas yang tertanam tidak ditampilkan dengan benar

Anda dapat membuat aplikasi kanvas yang responsif, yaitu kemampuan aplikasi untuk mensejajarkan secara otomatis dengan berbagai ukuran layar dan bentuk dan ukuran untuk menggunakan ruang layar yang tersedia secara wajar. Bergantung pada apakah aplikasi Anda dibuat agar responsif atau tidak, kami merekomendasikan pengaturan yang berbeda untuk memastikan bahwa aplikasi kanvas Anda dapat dirender dengan benar dalam bidang pada formulir aplikasi berdasarkan model. Jika Anda mengalami spasi kosong atau scroll bar tambahan di sekitar aplikasi kanvas, sebaiknya periksa hal berikut di aplikasi Anda.

Untuk aplikasi yang responsif:

  • Nonaktifkan opsi Skalakan 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 ditampilkan dengan benar dalam bidang pada formulir aplikasi berdasarkan model, seperti spasi kosong tambahan atau bilah gulir di sekitar aplikasi kanvas.

Untuk aplikasi yang tidak responsif:

  • Sebaiknya aktifkan pilihan Skalakan agar sesuai. Ini membantu aplikasi mengubah ukuran agar sesuai dengan ruang yang tersedia.

Dalam kedua skenario, pastikan bahwa Nilai properti Nama Aplikasi diatur dan didefinisikan 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 melakukan penyesuaian terhadap tinggi komponen aplikasi kanvas, sebaiknya kustomisasi 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.

  1. Buka aplikasi kanvas yang disematkan pada formulir aplikasi berdasarkan model untuk diedit.
  2. Di Power Apps studio, pilih File > Pengaturan > ukuran Layar + orientasi.
  3. Dalam Pengaturan Tingkat Lanjut, atur Skalakan agar sesuai ke Aktif. Skalakan agar sesuai dengan pengaturan aplikasi kanvas.

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 aplikasi kanvas Beri nama persis seperti yang muncul dalam daftar komponen. Contohnya, contoso_flooringestimatesapp_624d7. Salin nama unik aplikasi kanvas.

    3. Dalam solusi yang sama, edit aplikasi berdasarkan model yang memiliki kontrol aplikasi kanvas yang disematkan, lalu atur Nama Aplikasi kanvas ke kontrol aplikasi kanvas yang disematkan menggunakan nilai dari langkah sebelumnya. Informasi selengkapnya: Tambahkan aplikasi kanvas yang disematkan pada formulir berdasarkan model

    4. Ekspor solusi dari lingkungan pengembangan, lalu impor solusi tersebut ke lingkungan target Anda.

  • Solusi tidak terkelola: Jika solusi diimpor ke lingkungan sebagai solusi tidak terkelola, edit aplikasi berbasis model yang memiliki kontrol aplikasi kanvas yang disematkan, lalu ikuti langkah-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: Memberikan hak istimewa baca untuk tabel Metadata Tambahan 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
  1. Di Power Apps, pilih lingkungan, dan di panel navigasi kiri, pilih Aplikasi.
  2. Pilih aplikasi yang diinginkan, pilih ..., lalu pilih Bagikan.
  3. Pada panel kiri, pilih aplikasi, lalu pilih Kelola peran keamanan.
  4. Buka peran keamanan yang ditetapkan ke aplikasi, seperti peran keamanan Pengguna Dasar.
  5. Pilih tab Entitas Kustom, dan atur hak baca cakupan organisasi untuk tabel Metadata Tambahan CanvasApp. Atur hak istimewa baca cakupan organisasi di tabel Metadata Tambahan CanvasApp
  6. Pilih Simpan dan Tutup untuk menutup jendela peran keamanan.

Lihat juga

Menyematkan aplikasi kanvas pada formulir yang diarahkan model
Tambahkan aplikasi kanvas yang disematkan pada formulir berdasarkan model
Edit aplikasi kanvas yang disematkan pada formulir berdasarkan model
Sesuaikan ukuran layar dan orientasi aplikasi Canvas yang disematkan pada formulir berdasarkan model
Melakukan tindakan yang telah ditetapkan pada formulir host dari dalam aplikasi kanvas tertanam
Properti dan tindakan kontrol ModelDrivenFormIntegration
Bagikan aplikasi kanvas tersemat
Memigrasi aplikasi Canvas yang disematkan pada formulir berdasarkan model yang dibuat menggunakan rilis pratinjau publik ke terbaru

Catatan

Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)

Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).