Pustaka komponen

Pada artikel ikhtisar untuk membuat komponen, Anda diperkenalkan pada komponen di dalam aplikasi kanvas. Saat membuat komponen di dalam sebuah aplikasi, Anda juga dapat membuat pustaka komponen yang dapat digunakan kembali. Dengan membuat pustaka komponen, pembuat aplikasi dapat dengan mudah membagikan dan memperbarui satu atau beberapa komponen dengan pembuat lainnya.

Pustaka komponen adalah kontainer definisi komponen yang memudahkan untuk:

  • Menemukan dan mencari komponen.
  • Mempublikasikan pembaruan.
  • Memberi tahu pembuat aplikasi mengenai pembaruan komponen yang tersedia.

Catatan

Pustaka komponen merupakan cara yang disarankan untuk menggunakan kembali komponen di seluruh aplikasi. Saat menggunakan pustaka komponen, aplikasi mempertahankan dependensi pada komponen yang digunakan. Pembuat aplikasi akan diberi pemberitahuan jika pembaruan komponen dependen telah tersedia. Oleh karena itu, semua komponen yang akan digunakan kembali harus dibuat dalam pustaka komponen sebagai gantinya. Fitur Power Apps sebelumnya yang memungkinkan impor komponen dari satu aplikasi kanvas ke aplikasi lainnya dihentikan.

Perbedaan aplikasi dan pustaka komponen

Pustaka komponen menyediakan repositori komponen yang terpusat dan terkelola untuk kemudahan dalam penggunaan kembali.

Panel Sisipkan pada navigasi kiri merupakan default untuk tab komponen jika Anda membuat pustaka komponen. Saat Anda membuat aplikasi, tampilan ini menampilkan layar dan bukan komponen.

Layar di dalam pustaka komponen hanya tersedia untuk pengujian. Hal ini memberikan cara bagi pembuat pustaka untuk dengan cepat menguji komponen yang dibuat pada layar aktual dan juga memvalidasi perilaku pembaruan saat komponen ditingkatkan dari waktu ke waktu. Untuk menggunakan komponen dari pustaka komponen, Anda harus membuat aplikasi yang menggunakan pustaka komponen.

Anda dapat melakukan pratinjau pada komponen dari pustaka komponen menggunakan layar di dalam pustaka menggunakan pilihan putar. Saat Anda memilih tab komponen, pilihan pemutaran dinonaktifkan. Pustaka komponen tidak ditampilkan saat menggunakan Power Apps Mobile.

Catatan

Pustaka komponen yang dibahas dalam artikel ini berbeda dengan Power Apps component framework yang memungkinkan pengembang dan pembuat untuk membuat komponen kode untuk aplikasi berbasis model dan kanvas. Untuk informasi lebih lanjut, buka Gambaran umum Power Apps component framework.

Menggunakan pustaka komponen

Anda dapat membuat pustaka komponen baru atau mengedit pustaka komponen yang sudah ada dari antarmuka yang sama. Buka Power Apps > pilih Lainnya dari navigasi kiri > pilih Temukan semua > pilih Pustaka komponen dari bagian Penyempurnaan aplikasi. Anda juga dapat menyematkan opsi pustaka Komponen ke antarmuka Anda Power Apps . Informasi selengkapnya: Navigasi kiri di Power Apps

Membuat contoh pustaka komponen

Langkah-langkah membuat komponen di dalam pustaka komponen sama seperti membuat komponen di dalam aplikasi. Anda akan membuat pustaka komponen lalu menggunakan kembali langkah-langkah tersebut untuk membuat komponen dari contoh Ikhtisar komponen. Kemudian Anda akan menggunakan pustaka komponen untuk menyediakan komponen yang dapat digunakan kembali pada aplikasi baru.

  1. Masuk ke Power Apps.

  2. Pilih Pustaka komponen di navigasi kiri, lalu pilih Pustaka komponen baru. Atau, pilih Lainnya dari navigasi kiri > pilih Temukan semua > pilih Pustaka komponen dari bagian Peningkatan aplikasi .

  3. Beri nama pustaka komponen sebagai Komponen menu ; Anda juga dapat memberi nama yang berbeda sesuai pilihan Anda.

  4. Ikuti langkah-langkah membuat komponen dari contoh Ikhtisar komponen. Anda tidak perlu membuka Power Apps Studio atau membuat aplikasi kosong baru karena Anda telah membuat pustaka komponen baru. Mulai dengan langkah 2.

    Setelah mengikuti langkah-langkah untuk membuat komponen, ikuti rangkaian langkah-langkah berikutnya untuk menambahkan komponen pada layar juga dan langkah-langkah untuk membuat properti output.

  5. Setelah Anda menyelesaikan pembuatan dan pengujian komponen, simpan pustaka komponen dengan memilih menu File lalu pilih Simpan.

    Anda juga memiliki pilihan untuk menyimpan catatan versi. Catatan versi berguna untuk mengambil versi dari sebuah pustaka komponen dan untuk meningkatkan komponen yang digunakan dalam aplikasi dari pustaka komponen ini.

    Catatan versi saat menyimpan pustaka komponen.

    Tip

    Catatan versi berguna saat meninjau versi dari sebuah pustaka komponen dan untuk pembuat aplikasi yang menggunakan pustaka komponen Anda untuk meninjau perubahan dan memperbarui aplikasi yang menggunakan komponen ini jika diperlukan. Buka memperbarui pustaka komponen untuk rincian selengkapnya.

  6. Pustaka komponen yang tersimpan dapat dipublikasikan. Hanya pembaruan pustaka komponen yang dipublikasikan yang tersedia untuk aplikasi yang menggunakan pustaka komponen. Pilih Publikasikan untuk mempublikasikan versi pustaka komponen:

    Menerbitkan versi pustaka komponen.

Penyesuaian komponen pustaka

Saat membuat komponen di dalam pustaka komponen, Anda memiliki pilihan untuk memungkinkan komponen disesuaikan bila digunakan oleh aplikasi yang menggunakan komponen pustaka. Secara default, pengaturan ini Aktif. Ubah pengaturan ini menjadi nonaktif untuk menghilangkan kemampuan untuk menyesuaikan komponen saat menggunakan di aplikasi lain.

Pilihan untuk memungkinkan penyesuaian ke komponen ini saat digunakan oleh aplikasi.

Bila menambahkan komponen yang memungkinkan penyesuaian, Anda akan melihat pilihan untuk mengedit komponen ini untuk penyesuaian lainnya. Aplikasi membuat salinan lokal dan Anda dapat membuat perubahan pada salinan komponen lokal. Keterkaitan dengan pustaka komponen dihapus setelah komponen diedit.

Mengedit komponen yang diizinkan untuk penyesuaian.

Memilih Edit komponen akan meminta Anda menyalin komponen secara lokal untuk penyesuaian.

Namun demikian, bila Anda tidak mengizinkan komponen disesuaikan, aplikasi yang digunakan tidak akan menampilkan pilihan untuk mengedit komponen tersebut.

Tidak ada pilihan untuk mengedit komponen di dalam aplikasi.

Dalam kasus ini, satu-satunya cara untuk mengedit komponen adalah dengan mengedit pustaka komponen tempat komponen disimpan.

Impor dari sebuah pustaka komponen

Setelah Anda membuat pustaka komponen dan mempublikasikannya, aplikasi dapat menggunakan komponen dari pustaka komponen ini dengan mengimpor pustaka. Anda juga dapat membagikan pustaka komponen.

Untuk mengimpor dari pustaka komponen, edit aplikasi yang sudah ada atau buat aplikasi baru. Setelah aplikasi dibuka di studio aplikasi kanvas, pilih Sisipkan atau + pada navigasi kiri. Kemudian pilih Dapatkan lebih banyak komponen untuk mencantumkan pustaka komponen yang tersedia di lingkungan saat ini:

Dapatkan lebih banyak komponen.

Anda akan melihat daftar pustaka komponen yang tersedia di lingkungan saat ini pada sisi kanan layar. Pilih sebuah komponen individual dari pustaka komponen. Atau gunakan Pilih semua untuk mengimpor semua komponen dari pustaka sekaligus:

Impor komponen.

Catatan

Jika seorang pembuat tidak menemukan pustaka komponen tercantum pada bagian impor, pastikan pustaka komponen dibagikan dengan pembuat. Buka izin pustaka komponen untuk rincian selengkapnya.

Ketahuilah bahwa Anda dapat memilih dan mengimpor lebih dari satu komponen dan dari berbagai pustaka komponen.

Komponen yang tersedia di dalam aplikasi tercantum dalam kategori Kustom dalam daftar komponen pada panel Sisipkan. Komponen yang tersedia dari pustaka komponen yang diimpor tercantum dalam kategori Komponen pustaka:

Sisipkan komponen ke aplikasi.

Memperbarui pustaka komponen

Anda dapat memodifikasi pustaka komponen yang sudah ada dan menyimpan setiap perubahan dengan catatan versi lainnya. Namun, versi pustaka komponen yang telah diperbarui harus dipublikasikan untuk dapat digunakan pada aplikasi yang sudah ada yang menggunakan pustaka komponen tersebut. Langkah-langkah contoh pustaka komponen di atas menjelaskan cara mempublikasikan pustaka komponen setelah menyimpannya.

Ada dua cara aplikasi yang menggunakan komponen dari pustaka dapat mendapatkan perubahan terbaru.

Metode 1: Pemberitahuan pembaruan komponen pada edit aplikasi

Pembuat aplikasi lain akan diberi tahu bahwa komponen yang diperbarui telah tersedia. Pemberitahuan akan muncul saat pembuat mengedit aplikasi di studio aplikasi kanvas. Mereka dapat memilih untuk memperbarui komponen:

Pembaruan tersedia.

Pilih Tinjau, dan Anda akan melihat pilihan untuk memperbarui komponen:

Perbarui komponen.

Ketahuilah bahwa catatan versi yang Anda tambahkan saat mempublikasikan versi pustaka komponen akan muncul di sini.

Pilih Perbarui untuk memperbarui komponen.

Aplikasi diperbarui dengan komponen terbaru

Metode 2: Pemeriksaan proaktif untuk pembaruan

Metode ini adalah memeriksa pembaruan aplikasi secara proaktif saat bekerja pada aplikasi di Studio.

Untuk melakukan pemeriksaan ini, pilih Masukkan panel komponen di sisi kiri, lalu pilih ... (elipsis) di sebelah tombol pencarian. Lalu, pilih Periksa pembaruan.

Periksa komponen terbaru

Jika ada pembaruan pada komponen yang digunakan dari pustaka, pembuat akan menerima pesan tersebut untuk ditinjau dan mendapatkan perubahan terbaru. Setelah ditinjau dan diperbarui, aplikasi diperbarui dengan komponen terbaru.

Animasi berikut menampilkan proses untuk mendapatkan komponen terbaru.

Langkah-langkah untuk mendapatkan komponen terbaru

Memperbarui komponen dari pustaka komponen dalam aplikasi yang menggunakan

Jika Anda mengimpor komponen dari pustaka komponen, Anda tidak dapat mengeditnya di dalam aplikasi yang menggunakannya. Jika Anda memilih Edit komponen, Anda akan melihat pilihan untuk membuat salinan komponen di dalam aplikasi saat ini untuk Anda ubah:

Mengedit komponen pustaka.

Jika Anda memilih Buat salinan, komponen akan disalin ke aplikasi lokal. Salinan lokal dari komponen akan muncul dalam kategori Kustom pada panel sisipkan . Salinan lokal komponen ini tidak akan menerima pembaruan jika versi baru pustaka komponen asalnya dipublikasikan.

Catatan

Instans komponen yang digunakan dari pustaka komponen tidak akan terpengaruh setelah Anda membuat salinan lokal komponen, dan akan tetap ditautkan ke definisi pustaka komponen. Hanya instans dari komponen yang disalin secara lokal (dari kategori Kustom) yang dianggap sebagai komponen aplikasi lokal.

Menghapus pustaka komponen

Jika pustaka komponen direferensikan oleh aplikasi kanvas, pustaka tidak dapat dihapus. Hal ini berlaku untuk lingkungan Power Platform dan lingkungan non-Power Platform. Hilangkan komponen dari aplikasi sebelum menghapus pustaka. Anda dapat menemukan informasi tentang aplikasi menggunakan pustaka komponen di tampilan dependensi solusi atau pesan yang ditampilkan saat Anda mencoba menghapus pustaka.

Hapus komponen pustaka.

Izin pustaka komponen

Berbagi pustaka komponen mempunyai cara kerja yang sama seperti Anda berbagi aplikasi kanvas. Saat Anda membagikan pustaka komponen, Anda mengizinkan orang lain menggunakan kembali pustaka komponen tersebut. Setelah dibagikan, orang lain dapat mengedit pustaka komponen dan mengimpor komponen dari pustaka komponen yang dibagikan ini untuk membuat dan mengedit aplikasi. Jika dibagikan sebagai pemilik bersama, pengguna dapat menggunakan, mengedit, dan berbagi pustaka komponen namun tidak dapat menghapus atau mengubah pemiliknya.

Pertimbangan tambahan saat berbagi pustaka komponen ke grup keamanan:

  • Anda tidak dapat menggunakan UI berbagi saat berbagi pustaka komponen yang dibuat sebagai bagian dari solusi. Melainkan, gunakan cmdlet Set-PowerAppRoleAssignment dengan tingkat izin CanEdit untuk berbagi pustaka komponen dengan grup keamanan yang dipilih.
  • Pustaka komponen yang dibuat di lingkungan Power Platform tanpa database Dataverse yang dibagikan sebagai Pemilik bersama secara otomatis memberikan izin CanEdit ke grup keamanan yang dipilih.

Pembatasan yang diketahui

  • Keterbatasan yang diketahui yang berlaku pada komponen juga berlaku pada pustaka komponen.

  • Anda tidak dapat mengimpor komponen dari pustaka komponen yang tersimpan secara lokal. Anda dapat menyimpan pustaka komponen menggunakan File > Simpan Sebagai > Komputer Ini. Namun jika Anda mencoba mengimpor pustaka komponen yang tersimpan tersebut, Anda akan melihat pesan kesalahan berikut:

    Impor file pustaka komponen.

  • Jika Anda mengimpor aplikasi dan pustaka komponen di lingkungan untuk pertama kali, pastikan aplikasi menggunakan komponen versi terbaru yang tercakup dengan pustaka komponen. Jika tidak, aplikasi tidak akan menerima pembaruan setelah impor. Aplikasi akan mengenali dan meminta versi yang diperbarui setelah mengimpor pustaka komponen berikutnya ke lingkungan yang sama.

  • Komponen kode tidak didukung di dalam pustaka komponen.

Baca juga

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).