Gunakan pengaturan untuk memberikan pengalaman aplikasi kustom

Pengaturan adalah komponen solusi yang memungkinkan pembuat dan administrator mengonfigurasi aplikasi dengan cepat agar memberikan pengalaman kustom. Pengaturan dapat digunakan untuk mengaktifkan atau menonaktifkan fitur atau mengkonfigurasikan perilaku fitur untuk satu aplikasi atau semua aplikasi dalam lingkungan.

Pengaturan terdiri dari tiga subkomponen: Pengaturan definisi, pengaturan nilai lingkungan, dan pengaturan nilai aplikasi.

Subkomponen	Description
Penentuan pengaturan	Penulis aplikasi, administrator, atau mitra dapat membuat definisi pengaturan yang mencakup properti seperti nama, deskripsi, jenis data, nilai default, dan banyak lagi. Selanjutnya mereka dapat, melalui kode, menggunakan nilai pengaturan untuk mengaktifkan atau menonaktifkan atau mengkonfigurasikan fitur yang mereka berikan. Mereka dapat mencakup definisi pengaturan dalam solusi yang digunakan untuk memberikan fitur tersebut kepada pelanggan mereka. Contoh: Penanganan penyimpanan asinkron untuk aplikasi berdasarkan model adalah fitur dari Power Apps yang menggunakan pengaturan. Pengaturannya adalah jenis Ya/Tidak dan nilai default dari pengaturan ini adalah Tidak. Oleh karena itu, secara default, fitur penanganan penyimpanan asinkron akan dinonaktifkan untuk semua aplikasi berdasarkan model.
Nilai lingkungan Pengaturan	Nilai lingkungan pengaturan dapat digunakan untuk menimpa nilai default, sebagaimana ditentukan dalam definisi pengaturan. Contoh: Memperluas contoh di atas, administrator lingkungan di organisasi pelanggan dapat menambahkan nilai lingkungan pengaturan untuk penanganan penyimpanan asinkron dan mengaturnya ke Ya. Nilai lingkungan pengaturan ini akan menimpa nilai default dan akan diterapkan ke semua aplikasi di lingkungan tersebut. Langkah ini akan mengaktifkan fitur penanganan penyimpanan asinkron untuk semua aplikasi berdasarkan model di lingkungan tersebut.
Nilai aplikasi pengaturan	Nilai aplikasi pengaturan dapat digunakan untuk menimpa nilai default, sebagaimana ditentukan dalam definisi pengaturan, dan nilai lingkungan pengaturan (jika ada). Contoh: Sekali lagi, dengan memperluas contoh di atas, penulis aplikasi dalam lingkungan yang sama di atas, dapat menambahkan nilai aplikasi pengaturan untuk pengaturan penanganan penyimpanan asinkron untuk aplikasi yang mereka tulis dan mengaturnya ke Tidak Nilai aplikasi pengaturan ini akan menimpa nilai lingkungan pengaturan dan menerapkan hanya ke aplikasi tunggal tersebut. Ini akan mengaktifkan fitur penanganan penyimpanan asinkron untuk aplikasi tunggal tersebut.

Catatan

Untuk mengikuti langkah-langkah yang tercantum di bawah ini, Anda harus mengaktifkan pratinjau Solusi. Dari area Solusi dalam Power Apps, pada bilah perintah, pastikan Anda memiliki pratinjau Solusi. Jika pratinjau Solusi tidak ditampilkan, pilih pilihan untuk mengaktifkan pratinjau. Informasi selengkapnya: tampilan solusi

Penentuan pengaturan

Definisi pengaturan menentukan properti dasar dari pengaturan. Daftar lengkap properti yang dapat dikonfigurasi pada definisi pengaturan tercantum di bawah ini. Sebagian properti ini tidak dapat diubah setelah pengaturan dibuat.

Properti	Description
Nama tampilan	Nama yang ditampilkan kepada konsumen pengaturan di semua antarmuka pengguna tempat pengaturan ditampilkan.
Nama	Nama unik pengaturan di lingkungan. Nama dibuat secara otomatis berdasarkan nama tampilan yang diberikan tetapi dapat diubah sebelum pengaturan dibuat. Setelah pengaturan dibuat, nama tidak dapat diubah seperti yang dapat direferensikan dalam aplikasi atau kode Anda. Nama memiliki prefiks yang berkaitan dengan penerbit solusi. Prefiks ini ditujukan untuk memberikan pengaturan nama unik jika Anda ingin mengimpornya ke solusi atau lingkungan lain di masa mendatang (yang akan memiliki prefiks yang berbeda).
KETERANGAN	Deskripsi membantu orang lain memahami jenis pengaturan yang digunakan untuk semua antarmuka pengguna tempat pengaturan ditampilkan.
Jenis Data	Jenis data dari pengaturan mengontrol cara menyimpan nilai pengaturan. Jenis data dapat diatur ke Angka, String, atau Ya/Tidak. Jenis data tidak dapat diubah setelah pengaturan dibuat.
Nilai default	Nilai default akan tersedia setelah Anda memilih jenis Data. Pengaturan akan menentukan nilai pengaturan yang akan digunakan kecuali jika ditimpa oleh nilai lingkungan pengaturan atau nilai aplikasi pengaturan.
Nilai dapat diubah untuk	Pengaturan dapat ditimpa di salah satu level berikut: Lingkungan dan aplikasi, memungkinkan pengaturan nilai lingkungan dan mengatur nilai aplikasi untuk menimpa nilai default. Hanya lingkungan, memungkinkan hanya nilai lingkungan pengaturan untuk menimpa nilai default. Hanya aplikasi, memungkinkan hanya nilai aplikasi yang menimpa nilai default. Tidak ada, Pengaturan tidak dapat ditimpa.
Tingkat rilis	Tingkat rilis digunakan untuk menginformasikan framework dan konsumen lain pengaturan tentang status fitur yang digunakan dengan pengaturan. Tingkat rilis dapat diatur ke Tersedia secara umum atau Pratinjau.
URL Informasi	Tautan ke dokumentasi untuk membantu konsumen pengaturan memahami tujuan pengaturan. Akan digunakan sebagai tautan Pelajari lebih lanjut di semua antarmuka pengguna tempat pengaturan ditampilkan.

Menambahkan definisi pengaturan baru

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin tambahkan pengaturannya.
4. Di bilah perintah, pilih Baru > Lainnya >Pengaturan > Definisi Lainnya.
5. Dalam dialog Pengaturan baru, berikan nilai untuk masing-masing properti berdasarkan kebutuhan Anda. Untuk informasi tentang mengatur properti definisi, buka: Pengaturan definisi
6. Ketika Anda sudah selesai memberikan nilai properti, pilih Simpan.

Menambahkan definisi pengaturan yang ada

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin tambahkan pengaturannya.
4. Di bilah perintah, pilih Tambahkan yang ada > Lainnya >Pengaturan.
5. Dalam data Tambahkan definisi pengaturan yang ada, pilih satu atau lebih pengaturan yang ingin Anda tambahkan.
6. Setelah selesai memilih pengaturan, pilih Berikutnya
7. Dalam dialog Definisi pengaturan yang dipilih, untuk setiap pengaturan yang telah Anda pilih, Anda akan memiliki pilihan untuk Sertakan definisi pengaturan. Anda juga dapat Sertakan nilai lingkungan pengaturan untuk setiap pengaturan, jika ada.
8. Pilih Tambah untuk menambahkan definisi pengaturan dan/atau mengatur nilai lingkungan.

Memperbarui definisi pengaturan

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin buat pengaturannya.
4. Pada tampilan hierarki, pilih Pengaturan > definisi Pengaturan.
5. Pilih definisi pengaturan yang ingin Anda perbarui.
6. Dalam dialog Edit pengaturan, perbarui nilai untuk properti yang ingin Anda ubah.
   Perhatikan bahwa beberapa properti tidak dapat diperbarui setelah pengaturan dibuat. Selain itu, di kebanyakan kasus, Anda tidak akan dapat memperbarui definisi pengaturan yang tidak Anda miliki.
7. Ketika Anda sudah selesai memperbarui nilai properti, pilih Simpan.

Menghapus definisi pengaturan

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin buat atau tambah pengaturannya.
4. Pada tampilan hierarki, pilih Pengaturan > definisi Pengaturan.
5. Pilih definisi pengaturan yang ingin Anda hilangkan.
6. Pada bilah perintah, pilih Hapus > Hapus dari solusi ini.
   Menghilangkan dari solusi ini akan menghilangkan definisi pengaturan dari solusi saat ini, namun akan terus menjadi bagian dari solusi default atau solusi lain yang ditambahkan.

Menghapus definisi pengaturan

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin buat atau tambah pengaturannya.
4. Pada tampilan hierarki, pilih Pengaturan > definisi Pengaturan.
5. Pilih definisi pengaturan yang ingin Anda hapus.
6. Pada bilah perintah, pilih Hapus > Hapus dari lingkungan ini.
   Menghapus dari lingkungan ini akan menghapus definisi pengaturan dari lingkungan saat ini dan lingkungan tidak lagi menjadi bagian dari solusi apa pun di lingkungan tersebut. Anda hanya dapat menghapus definisi pengaturan yang Anda miliki.

Nilai lingkungan Pengaturan

Nilai lingkungan pengaturan digunakan untuk menimpa nilai default pengaturan untuk semua aplikasi di lingkungan tersebut. Gunakan lingkungan pengaturan jika nilai default pengaturan bukan yang ingin Anda gunakan untuk aplikasi di lingkungan Anda.

Mpenuh lingkungan pengaturan baru

1. Masuk ke Power Apps.

2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.

3. Dari daftar solusi, buka solusi yang Anda ingin tambahkan nilai lingkungan pengaturannya.

4. Jika definisi pengaturan tersedia dalam solusi:

   1. Pilih definisi Pengaturan.
   2. Dalam dialog Edit nilai pengaturan, di bagian Pengaturan nilai lingkungan, pilih Nilai baru.
   3. Berikan nilai, kemudian pilih Simpan.

   Jika definisi pengaturan tidak tersedia dalam solusi:

   1. Di bilah perintah, pilih Baru > Lainnya >Pengaturan > nilai lingkungan pengaturan.
   2. Pilih pengaturan yang akan ditambahkan nilai lingkungan pengaturan, lalu pilih Tambah.
   3. Dalam dialog Edit nilai lingkungan pengaturan baru, di bagian Pengaturan nilai lingkungan, pilih Nilai baru.
   4. Berikan nilai, kemudian pilih Simpan.

Menambahkan nilai lingkungan pengaturan yang lama

1. Masuk ke Power Apps.

2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.

3. Dari daftar solusi, buka solusi yang Anda ingin tambahkan nilai lingkungan pengaturannya.

4. Jika definisi pengaturan tersedia dalam solusi:

   1. Pilih definisi Pengaturan.
   2. Dalam dialog Edit nilai pengaturan, di bagian Pengaturan nilai lingkungan, pilih Tambahkan Nilai yang ada.
   3. Perbarui nilai jika diperlukan, dan kemudian pilih Simpan.

   Jika definisi pengaturan tidak tersedia dalam solusi:

   1. Di bilah perintah, pilih Tambahkan yang ada > Lainnya >Pengaturan.
   2. Dalam data Tambahkan definisi pengaturan yang ada, pilih satu atau lebih pengaturan yang ingin Anda tambahkan nilai lingkungan pengaturannya.
   3. Setelah selesai memilih pengaturan, pilih Berikutnya
   4. Dalam dialog Definisi pengaturan yang dipilih, untuk setiap pengaturan yang telah Anda pilih, Anda akan memiliki pilihan untuk Sertakan nilai lingkungan pengaturan, jika ada. Anda juga dapat Sertakan definisi pengaturan untuk setiap pengaturan, jika diinginkan.
   5. Pilih Tambah untuk menambahkan nilai lingkungan pengaturan dan/atau definisi pengaturan.

Memperbarui nilai lingkungan pengaturan

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang ingin Anda tambahkan nilai lingkungan pengaturannya.
4. Pada tampilan hierarki, pilih Pengaturan > Nilai lingkungan Pengaturan.
5. Pilih nilai lingkungan pengaturan yang ingin Anda perbarui.
6. Dalam dialog Edit nilai pengaturan, di bagian Pengaturan nilai lingkungan, pilih, perbarui nilainya, kemudian pilih Simpan.

Menghapus nilai lingkungan pengaturan

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin buat atau tambah pengaturannya.
4. Pada tampilan hierarki, pilih Pengaturan > Nilai lingkungan Pengaturan.
5. Pilih nilai lingkungan pengaturan yang ingin Anda hapus.
6. Pada bilah perintah, pilih Hapus > Hapus dari solusi ini.
   Menghilangkan dari solusi ini akan menghilangkan nilai lingkungan pengaturannya dari solusi saat ini, namun akan terus menjadi bagian dari solusi default atau solusi lain yang ditambahkan.

Menghapus nilai lingkungan pengaturan

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin buat atau tambah pengaturannya.
4. Pada tampilan hierarki, pilih Pengaturan > Nilai lingkungan Pengaturan.
5. Pilih nilai lingkungan pengaturan yang ingin Anda hapus.
6. Pada bilah perintah, pilih Hapus > Hapus dari lingkungan ini.
   Menghapus dari lingkungan ini akan menghapus nilai lingkungan pengaturan dari lingkungan saat ini dan lingkungan tidak lagi menjadi bagian dari solusi apa pun di lingkungan tersebut.

Nilai aplikasi pengaturan

Nilai aplikasi pengaturan digunakan untuk menimpa nilai default pengaturan dan nilai lingkungan pengaturan apa pun untuk satu aplikasi. Gunakan nilai aplikasi pengaturan jika nilai lingkungan pengaturan bukan yang ingin Anda gunakan untuk aplikasi Anda. Jika nilai lingkungan pengaturan tidak ada, gunakan nilai aplikasi pengaturan jika nilai default pengaturan bukan yang ingin Anda gunakan untuk aplikasi Anda.

Catatan

Untuk mengikuti langkah-langkah yang terdaftar di bawah ini, Anda harus menggunakan desainer aplikasi baru. Saat ini desainer aplikasi hanya menampilkan pengaturan platform Power Apps. Untuk pengaturan non-platform, gunakan penjelajah solusi seperti diuraikan di bawah.

Menambahkan atau memperbarui nilai aplikasi pengaturan menggunakan desainer aplikasi

1. Buka aplikasi yang akan ditambahkan nilai aplikasi pengaturan dalam desainer aplikasi.
2. Pilih Pengaturan di baris perintah.
3. Dalam dialog Pengaturan, pilih tab Fitur atau Mendatang.
   Tab Fitur menampilkan semua pengaturan yang memiliki tingkat rilis diatur ke Tersedia secara umum. Tab Mendatang menampilkan semua pengaturan yang memiliki tingkat rilis diatur ke Pratinjau.
4. Tambahkan atau perbarui nilai aplikasi untuk pengaturan yang Anda inginkan.
5. Simpan dan publikasikan aplikasi.

Menghapus nilai aplikasi pengaturan menggunakan desainer aplikasi

1. Buka aplikasi yang akan dihapus nilai aplikasi pengaturannya dalam desainer aplikasi.
2. Pilih Pengaturan di baris perintah.
3. Dalam dialog Pengaturan, pilih tab Fitur atau Mendatang.
4. Pilih Atur ulang ke nilai lingkungan di sebelah nilai aplikasi pengaturan yang akan dihapus. Hal ini akan membuat nilai pengaturan kembali ke nilai lingkungan pengaturan jika ada. Jika tidak ada nilai lingkungan pengaturan, ia akan kembali ke nilai default pengaturan.
   Perhatikan bahwa pilihan untuk Mengatur ulang ke nilai lingkungan hanya ditampilkan jika nilai aplikasi pengaturan sebelumnya ditambahkan untuk pengaturan tersebut.
5. Simpan dan publikasikan aplikasi.

Menambahkan atau memperbarui nilai aplikasi pengaturan menggunakan penjelajah solusi

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin tambahkan nilai aplikasi pengaturannya.
4. Jika definisi pengaturan atau nilai lingkungan pengaturan tidak tersedia di solusi, tambahkan salah satunya. Buka Menambahkan definisi pengaturan yang ada atau Menambahkan nilai lingkungan pengaturan yang ada .
5. Pilih definisi pengaturan atau pengaturan nilai lingkungan.
6. Dalam dialog Edit nilai pengaturan, di bagian Pengaturan nilai aplikasi, cari aplikasi yang akan ditambahkan nilai aplikasi pengaturannya. Perhatikan bahwa menggunakan penjelajah solusi, Anda hanya dapat menambahkan nilai aplikasi pengaturan untuk aplikasi yang ada di solusi saat ini.
7. Berikan nilai, kemudian pilih Simpan.
8. Agar nilai aplikasi pengaturan diterapkan, Anda harus menerbitkan ulang aplikasi menggunakan desainer aplikasi atau penjelajah solusi.

Menghapus nilai aplikasi pengaturan menggunakan penjelajah solusi

1. Masuk ke Power Apps.
2. Di panel navigasi, pilih Solusi. Jika item tidak ada di panel pada panel sisi, pilih …Lainnya, lalu pilih item yang diinginkan.
3. Dari daftar solusi, buka solusi yang Anda ingin hapus nilai aplikasi pengaturannya.
4. Jika definisi pengaturan atau nilai lingkungan pengaturan tidak tersedia di solusi, tambahkan salah satunya. Informasi lebih lanjut: Menambahkan definisi pengaturan yang ada atau Menambahkan nilai lingkungan pengaturan yang ada.
5. Pilih definisi pengaturan atau pengaturan nilai lingkungan.
6. Dalam dialog Edit nilai pengaturan, di bagian Pengaturan nilai aplikasi, cari aplikasi yang akan dihapus nilai aplikasi pengaturannya. Perhatikan bahwa menggunakan penjelajah solusi, Anda hanya dapat menghapus nilai aplikasi pengaturan untuk aplikasi yang ada di solusi saat ini.
7. Pilih ... di samping nilai aplikasi pengaturan, lalu pilih Reset ke lingkungan.
8. Pilih Simpan.
9. Agar penghapusan nilai aplikasi pengaturan diterapkan, Anda harus menerbitkan ulang aplikasi menggunakan desainer aplikasi atau penjelajah solusi.

Mendapatkan atau memperbarui nilai pengaturan melalui kode

Untuk metode yang tersedia, buka Dapatkan atau perbarui nilai pengaturan menggunakan API klien.

Baca juga

Untuk pengembang:

• Fungsi RetrieveSetting
• Tindakan SaveSettingValue