Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Pustaka komponen adalah jenis aplikasi kanvas khusus yang dapat berisi satu atau beberapa komponen kanvas. Selanjutnya, komponen pustaka ini dapat digunakan oleh semua aplikasi kanvas lainnya di lingkungan. Kemampuan ini memungkinkan Anda membuat komponen bersama yang dapat digunakan kembali di semua aplikasi di lingkungan, tidak seperti komponen tingkat aplikasi yang dibatasi ke satu aplikasi.
Untuk menggunakan komponen dari pustaka komponen, Anda harus mengimpor terlebih dulu komponen tersebut ke aplikasi kanvas. Setelah diimpor, Anda dapat menambahkan komponen ke layar aplikasi apa pun. Pembaruan apa pun dalam definisi komponen dari pustaka komponen akan meminta Anda untuk meninjau dan memasukkan perubahan sesuai permintaan atau saat aplikasi dibuka untuk pengeditan. Pustaka komponen dan aplikasi dependen juga dapat dipindahkan ke lingkungan lain menggunakan solusi Microsoft Dataverse standar.
Catatan
Pada artikel ini, istilah "impor" mengacu pada mengimpor komponen dari pustaka komponen ke aplikasi dan tidak perlu dipertukarkan dengan mengimpor solusi ke Dataverse.
Bila komponen dari pustaka komponen diimpor ke aplikasi kanvas, definisi komponen tersebut disalin ke definisi aplikasi kanvas. Setelah definisi komponen diimpor, aplikasi tersebut adalah "mandiri" selama menyangkut definisi komponen. Pembuat aplikasi dapat memilih untuk mengedit komponen dan membuat instans lokal komponen dalam aplikasi. Pada titik ini tidak ada tautan langsung ke pustaka komponen tempat komponen berasal. Karakteristik mandiri ini juga berlaku jika aplikasi kanvas kemudian dimigrasi ke lingkungan yang berbeda dengan pustaka komponen tidak ada. Anda dapat terus membuat instans dari definisi komponen impor dalam aplikasi dalam lingkungan target, serta aplikasi tersebut tetap dapat dipublikasikan dan berjalan. Tidak ada pembaruan baru yang akan diminta atau diterima dalam aplikasi yang menggunakan dalam kasus ini.
Untuk mempertahankan relasi dari aplikasi ke pustaka komponen, pastikan Anda menggunakan pustaka komponen untuk melakukan perubahan pada komponen, bukan mengedit komponen dalam aplikasi yang digunakan.
Dukungan solusi aplikasi kanvas dan pustaka komponen
Sesuai dengan dependensi objek solusi lainnya, jika aplikasi kanvas mengimpor komponen kanvas dari pustaka komponen, maka aplikasi ini akan memiliki dependensi pada pustaka komponen tersebut. Untuk memindahkan aplikasi ke lingkungan baru, Anda harus mengemas pustaka komponen di dalam solusi yang sama atau menginstalnya sebagai prasyarat. Dependensi pustaka aplikasi ke komponen dipertahankan di lingkungan target. Pada titik berikutnya, bila pustaka komponen dengan komponen yang diperbarui diimpor menggunakan solusi ke lingkungan target, aplikasi yang ada akan mendapatkan definisi komponen baru menggunakan alur pembaruan komponen biasa.
Membuat dan mengekspor pustaka komponen dalam solusi
Anda dapat membuat pustaka komponen secara langsung dari dalam solusi, atau menambahkannya ke solusi yang ada.
Bila pustaka komponen disimpan di lingkungan yang telah menyediakan Dataverse, pustaka komponen secara otomatis ditambahkan ke solusi default. Nama logis unik dibuat untuk pustaka komponen dengan prefiks Penerbit CDS Default. Perilaku ini adalah untuk memastikan bahwa sistem solusi mengetahui keberadaannya, dan dapat menghubungkan dependensi dari aplikasi yang menggunakan nama logis pustaka komponen.
Catatan
Pustaka komponen yang dibuat sebelum rollout fitur ALM pustaka komponen harus diedit, dipublikasikan, dan editor harus ditutup secara eksplisit sebelum diaktifkan untuk kemampuan ALM. Anda dapat memeriksa kesiapan ALM pustaka komponen dengan kehadirannya di solusi default.
Pustaka komponen di dalam solusi juga mendukung properti terkelola Izinkan penyesuaian yang mengatur perilaku pustaka komponen di lingkungan target.
Jika Anda menonaktifkan pengaturan ini dan mengekspor solusi ke lingkungan target, Anda tidak akan dapat mengedit pustaka komponen.
Dependensi pustaka komponen
Aplikasi yang menggunakan komponen dari pustaka komponen akan ditandai sebagai tergantung pada infrastruktur solusi. Perilaku ini berlaku untuk semua aplikasi yang ditambahkan ke solusi Dataverse apa pun di lingkungan tertentu. Anda tetap dapat membuat aplikasi di luar solusi, namun aplikasi tersebut tidak akan memiliki dependensi solusi. Anda kemudian dapat menambahkan aplikasi ini ke solusi untuk menjadikannya bagian dari solusi ALM.
Jika Anda mengimpor solusi yang hanya memiliki aplikasi yang menggunakan komponen dari pustaka komponen, namun mengecualikan pustaka komponen, Anda akan melihat pesan berikut:
"Impor gagal karena tidak ada dependensi untuk <app name>".
Dalam hal ini, Anda dapat memilih untuk menginstal solusi pustaka komponen lebih dulu atau menggabungkan pustaka komponen dengan solusi yang berisi aplikasi kanvas. Salah satu langkahnya akan memastikan aplikasi akan memiliki dependensi yang dibuat dalam lingkungan target.
Bila pustaka diperbarui dan versi komponen yang lebih baru diimpor melalui solusi, aplikasi akan mendapatkan pemberitahuan dan menerima pembaruan saat aplikasi dibuka untuk pengeditan.
Catatan
Jika properti terkelola pustaka komponen Izinkan penyesuaian dinonaktifkan, pustaka komponen tidak dapat diedit di lingkungan target.
Dependensi dihitung berdasarkan status aplikasi yang dipublikasikan terakhir. Jika Anda mengembalikan versi lama aplikasi yang tidak menggunakan komponen pustaka, dependensi akan dihapus dari aplikasi dan solusi. Mengimpor komponen ke dalam aplikasi dari pustaka komponen tanpa benar-benar menggunakannya juga membuat dependensi karena komponen pustaka yang tidak digunakan tetap tersedia dalam aplikasi untuk penggunaan yang akan datang.
Tip
Mengedit komponen dari pustaka komponen di dalam aplikasi yang menggunakannya akan membuat salinan lokal. Pada titik ini, komponen pustaka masih tersedia untuk digunakan melalui panel Sisipkan. Untuk menghilangkan dependensi sepenuhnya, hapus komponen dari komponen Sisipkan > Komponen pustaka > ... (elipsis) > Hilangkan dari aplikasi.
Praktik terbaik dan pemecahan masalah
Batasi jumlah komponen dalam pustaka ke 20 untuk mendapatkan kinerja optimal. Rencanakan dan buat beberapa pustaka komponen sebelumnya karena jumlah komponen di dalamnya kemungkinan akan berkembang seiring waktu. Pendekatan ini juga akan mengurangi muatan solusi saat aplikasi dipindahkan ke seluruh lingkungan.
Ada waktu tunda dari waktu publikasi pustaka komponen saat tersedia untuk aplikasi, dan dapat berlangsung hingga 5 menit.
Jika aplikasi tidak dapat menerima pembaruan dari komponen pustaka di lingkungan target tempat solusi diinstal, periksa menggunakan tindakan di bawah ini:
- Perubahan yang dibuat ke pustaka komponen dalam lingkungan target berada di lapisan atas komponen. Selanjutnya, penyesuaian ini menentukan perilaku runtime komponen. Untuk menghilangkan penyesuaian yang tidak terkelola ini, lihat Menghilangkan lapisan yang tidak terkelola.
- Menentukan nama logika pustaka komponen dari tampilan solusi. Gunakan solusi default jika pustaka tidak ditambahkan secara eksplisit ke solusi.
- Unduh aplikasi menggunakan komponen pustaka ke komputer lokal menggunakan File > Simpan sebagai > Komputer ini. Ganti nama file yang diunduh untuk memiliki ekstensi .zip, dan pilih paket dengan paket. Buka file Properties.json, lalu cari kata kunci "LibraryDependencies". Anda seharusnya melihat nama logika pustaka yang cocok.
- Jika Anda menggunakan solusi, pastikan aplikasi kanvas telah mengidentifikasi pustaka komponen dengan benar sebagai dependensi solusi. Jika solusi tidak mengidentifikasi pustaka komponen sebagai dependensi solusi dengan benar, artinya dependensi aplikasi ke tautan pustaka komponen belum dibuat dengan benar. Dalam kasus tersebut, periksa penyedia solusi untuk menangani masalah.
- Jika Anda pengguna penerbit solusi, pastikan pustaka komponen disimpan dengan nama logis pustaka pada solusi, dan bahwa pustaka tersebut sama dengan yang direferensikan dalam paket .msapp pustaka komponen.
Ekspor solusi selalu mengekspor pustaka komponen versi terbaru. Oleh karena itu, selalu perbarui aplikasi dengan versi komponen terbaru sebelum mengekspornya melalui solusi. Tindakan ini akan memastikan aplikasi memiliki versi komponen yang sama seperti yang tersedia di pustaka komponen versi terbaru. Aplikasi dan pustaka dianggap tersinkronisasi satu sama lain saat aplikasi dipindahkan ke lingkungan target untuk pertama kali; dan oleh karena itu, Anda tidak diminta memperbarui apa pun yang tersedia saat mengedit aplikasi.
Baca juga
- Komponen kanvas
- Pustaka komponen
- Memetakan bidang input komponen
- Menambahkan multimedia ke komponen
- Rumus perilaku untuk komponen
- Power Apps component framework
- Tambahkan komponen kanvas ke halaman kustom di aplikasi berdasarkan model Anda
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).