Fungsi DataSourceInfo
Berlaku untuk:
Aplikasi kanvas Aplikasi berdasarkan model
Menyediakan informasi tentang sumber data.
Gambaran Umum
Sumber data dapat memberikan banyak informasi untuk mengoptimalkan pengalaman pengguna.
Anda dapat menggunakan informasi tingkat kolom untuk memvalidasi input pengguna dan memberikan tanggapan langsung kepada pengguna sebelum menggunakan fungsi Patch. Fungsi Validate menggunakan informasi yang sama ini.
Anda dapat menggunakan informasi di tingkat sumber data, misalnya untuk menonaktifkan atau menyembunyikan tombol Edit dan Baru bagi pengguna yang tidak memiliki izin untuk mengedit dan membuat rekaman.
Sumber data bervariasi dalam jumlah informasi yang disediakan, termasuk tidak menyediakan sama sekali. Koleksi tidak memberikan informasi. Jika informasi tidak diberikan, default akan digunakan atau kosong dihasilkan.
Catatan
Saat ini, fungsi DataSourceInfo tidak didukung di Microsoft Lists.
Description
Informasi kolom
Anda dapat menggunakan DataSourceInfo untuk mendapatkan informasi tentang kolom sumber data tertentu:
| Argumen Informasi | Jenis Hasil | KETERANGAN |
|---|---|---|
| DataSourceInfo.DisplayName | String | Nama tampilan untuk kolom. Jika nama tampilan tidak didefinisikan, menghasilkan nama kolom. |
| DataSourceInfo.MaxLength | Nomor | Jumlah maksimum karakter yang dapat disimpan kolom. Hanya berlaku untuk kolom yang berisi string. Jika maksimum tidak diatur, menghasilkan kosong. |
| DataSourceInfo.MaxValue | Nomor | Nilai numerik maksimum yang dapat disimpan kolom. Hanya berlaku untuk kolom yang berisi angka. Jika maksimum tidak diatur, menghasilkan kosong. |
| DataSourceInfo.MinValue | Nomor | Nilai numerik minimum yang dapat disimpan kolom. Hanya berlaku untuk kolom yang berisi angka. Jika minimum tidak diatur, menghasilkan kosong. |
| DataSourceInfo.Required | Boolean | Apakah nilai diperlukan untuk kolom ini? Jika tidak diatur oleh sumber data, menghasilkan false. |
Argumen ketiga adalah nama kolom sebagai string. Misalnya, kolom Telepon dalam koleksi Orang akan diteruskan sebagai "Telepon" termasuk tanda kutip ganda.
Informasi sumber data
Anda juga dapat menggunakan DataSourceInfo untuk mendapatkan informasi tentang sumber data secara keseluruhan:
| Argumen Informasi | Jenis Hasil | KETERANGAN |
|---|---|---|
| DataSourceInfo.AllowedValues | Boolean | Apa saja jenis izin apa yang dapat diberikan kepada pengguna untuk sumber data ini? Jika tidak diatur oleh sumber data, menghasilkan kosong. |
| DataSourceInfo.CreatePermission | Boolean | Apakah pengguna saat ini memiliki izin untuk membuat rekaman di sumber data ini? Jika tidak diatur oleh sumber data, menghasilkan true. |
| DataSourceInfo.DeletePermission | Boolean | Apakah pengguna saat ini memiliki izin untuk menghapus rekaman di sumber data ini? Jika tidak diatur oleh sumber data, menghasilkan true. |
| DataSourceInfo.EditPermission | Boolean | Apakah pengguna saat ini memiliki izin untuk mengedit rekaman di sumber data ini? Jika tidak diatur oleh sumber data, menghasilkan true. |
| DataSourceInfo.ReadPermission | Boolean | Apakah pengguna saat ini memiliki izin untuk membaca rekaman di sumber data ini? Jika tidak diatur oleh sumber data, menghasilkan true. |
Catatan
DataSourceInfo mengembalikan true jika tidak dapat menentukan apakah pengguna saat ini memiliki izin yang diminta. Izin akan diperiksa lagi oleh server ketika operasi aktual dilakukan dan kesalahan ditampilkan jika tidak diizinkan. Pada saat ini, pemeriksaan izin dengan DataSourceInfo hanya mungkin bila menggunakan Microsoft Dataverse.
Sintaks
DataSourceInfo( DataSource,Information [, ColumnName] )
- DataSource – wajib. Sumber data yang akan digunakan.
- Information – Wajib. Jenis informasi yang ingin Anda ambil.
- ColumnName – Opsional. Nama kolom untuk mengambil informasi tingkat kolom. Untuk informasi di tingkat sumber data, argumen ColumnName tidak dapat digunakan.
Catatan
Sebelum Power Apps versi 3.24042, nama kolom ditentukan dengan string teks menggunakan tanda kutip ganda, dan jika terhubung ke sumber data mereka juga harus nama logis. Misalnya, nama logis"cr43e_name" dengan tanda kutip ganda digunakan sebagai pengganti nama tampilan Nama tanpa tanda kutip. Untuk SharePoint dan sumber data Excel yang berisi nama kolom dengan spasi, setiap spasi ditentukan dengan "_x0020_", misalnya "Nama Kolom"sebagai"Column_x0020_Name". Setelah versi ini, semua aplikasi secara otomatis diperbarui ke sintaks baru yang dijelaskan dalam artikel ini.
Contoh
Contoh di bagian tersebut menggunakan sumber data ini bernama IceCream:
Sumber data juga menyediakan informasi ini:
- Nama tampilan untuk Quantity adalah "Quantity on Hand".
- Panjang maksimum Flavor adalah 30 karakter.
- Kolom Flavor harus berisi nilai. Kolom Quantity tidak diperlukan.
- Quantity minimum adalah 0.
- Quantity maksimum adalah 100.
- Pengguna saat ini dapat membaca dan mengedit rekaman sumber data IceCream, tetapi tidak dapat membuat atau menghapus rekaman.
| Rumus | KETERANGAN | Hasil |
|---|---|---|
| DataSourceInfo (IceCream, DataSourceInfo.DisplayName, Kuantitas) | Menghasilkan nama tampilan untuk kolom Quantity dari sumber data IceCream. | "Quantity on Hand" |
| DataSourceInfo (Es Krim, DataSourceInfo.MaxLength, Rasa) | Menghasilkan panjang maksimum string untuk kolom Flavor dari sumber data IceCream. | 30 |
| DataSourceInfo (IceCream, DataSourceInfo.Required, Flavor) | Apakah kolom Flavor dari sumber data IceCream diperlukan? | benar |
| DataSourceInfo (IceCream, DataSourceInfo.Required, Kuantitas) | Apakah kolom Quantity dari sumber data IceCream diperlukan? | false |
| DataSourceInfo (IceCream, DataSourceInfo.MaxValue, Kuantitas) | Menghasilkan nilai numerik maksimum untuk kolom Quantity dari sumber data IceCream. | 100 |
| DataSourceInfo (IceCream, DataSourceInfo.MinValue, Kuantitas) | Menghasilkan nilai numerik minimum untuk kolom Quantity dari sumber data IceCream. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Dapatkah pengguna saat ini membaca rekaman dalam sumber data IceCream? | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Dapatkah pengguna saat ini mengedit rekaman dalam sumber data IceCream? | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Dapatkah pengguna saat ini membuat rekaman dalam sumber data IceCream? | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Dapatkah pengguna saat ini menghapus rekaman dalam sumber data IceCream? | false |