Blank, , CoalesceIsBlank, dan IsEmpty fungsi

Functions	Berlaku pada
Blank	Aplikasi Kanvas Copilot Studio Desktop mengalir kolom rumus Dataverse Fungsi Power Platform CLI Dataverse aplikasi berbasis model
Coalesce IsEmpty	Aplikasi Kanvas Copilot Studio Desktop mengalir aplikasi berbasis model Power Platform CLI Fungsi Dataverse Power Pages
IsBlank	Aplikasi Kanvas Copilot Studio Desktop mengalir kolom rumus Dataverse Aplikasi berbasis model Power Platform CLI Fungsi Dataverse Power Pages

Menguji apakah nilai kosong atau tabel tidak berisi rekaman, dan menyediakan cara untuk membuat nilai kosong.

Gambaran Umum

Blankadalah tempat penampung untuk "tidak ada nilai" atau "nilai yang tidak diketahui." Misalnya, properti Terpilih kontrol kotak Kombokosong jika pengguna belum membuat pilihan. Banyak sumber data dapat menyimpan dan mengembalikan nilai NULL yang ditunjukkan dalam Power Apps sebagai kosong.

Setiap properti atau nilai yang dihitung di Power Apps dapat kosong. Misalnya, nilai Boolean biasanya memiliki salah satu dari dua nilai: true atau false. Tetapi selain keduanya, itu juga dapat kosong yang menunjukkan bahwa status tidak diketahui. Ini mirip dengan Microsoft Excel, saat sel lembar kerja dimulai kosong tanpa isi namun dapat menyimpan nilai TRUE atau FALSE (antara lain). Setiap saat, isi sel dapat kembali dikosongkan, mengembalikannya ke status kosong.

String kosong mengacu pada string yang tidak mengandung karakter. Fungsi Len menghasilkan nol untuk string tersebut dan dapat ditulis dalam rumus sebagai dua tanda kutip ganda dengan tidak ada apa pun di antara "". Beberapa kontrol dan sumber data menggunakan string kosong untuk menunjukkan kondisi "tidak ada nilai". Untuk menyederhanakan pembuatan aplikasi, IsBlank fungsi dan Coalesce menguji nilai kosong atau string kosong.

Dalam konteks IsEmpty fungsi, kosong khusus untuk tabel yang tidak berisi rekaman. Struktur tabel mungkin utuh, lengkap dengan nama kolom, namun tidak ada data dalam tabel. Tabel mungkin awalnya kosong, mengambil rekaman dan tidak lagi kosong, dan kemudian memiliki rekaman yang dihapus dan lagi menjadi kosong.

Blank

Fungsi Blank mengembalikan nilai kosong . Gunakan ini untuk menyimpan nilai NULL di sumber data yang mendukung nilai ini, secara efektif menghilangkan nilai apa pun dari bidang.

IsBlank

Fungsi menguji IsBlank nilai kosong atau string kosong. Pengujian ini mencakup string kosong untuk memudahkan pembuatan aplikasi karena beberapa sumber data dan kontrol menggunakan string kosong saat tidak ada nilai yang ada. Untuk menguji khusus untuk penggunaan if(Value = Blank(), ... nilai kosong alih-alih IsBlank. Fungsi ini IsBlank menganggap tabel kosong sebagai tidak kosong, dan IsEmpty harus digunakan untuk menguji tabel.

Saat mengaktifkan penanganan kesalahan untuk aplikasi yang ada, pertimbangkan untuk mengganti IsBlank dengan IsBlankOrError untuk mempertahankan perilaku aplikasi yang ada. Sebelum penambahan penanganan kesalahan, nilai kosong digunakan untuk menunjukkan nilai nihil dari database dan nilai kesalahan. Penanganan kesalahan memisahkan kedua interpretasi kosong ini, yang dapat mengubah perilaku aplikasi yang ada yang terus menggunakan IsBlank.

Nilai yang dikembalikan untuk IsBlank adalah boolean true atau false.

Coalesce

Fungsi Coalesce mengevaluasi argumennya secara berurutan dan mengembalikan nilai pertama yang tidak kosong atau string kosong. Gunakan fungsi ini untuk mengganti nilai kosong atau string kosong dengan nilai yang berbeda, namun tidak mengubah nilai non-kosong dan string non-kosong. Jika semua argumen adalah string kosong atau kosong, maka fungsi mengembalikan kosong, membuat Coalesce cara yang baik untuk mengonversi string kosong ke nilai kosong .

Coalesce( value1, value2 ) adalah yang lebih ringkas setara dengan dan If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) tidak mengharuskan value1 dan value2 dievaluasi dua kali. Fungsi If mengembalikan kosong jika tidak ada rumus "lainnya" seperti halnya di sini.

Semua argumen harus Coalesce berjenis yang sama; misalnya, Anda tidak dapat mencampur angka dengan string teks. Nilai yang dikembalikan dari Coalesce adalah jenis umum ini.

IsEmpty

Fungsi menguji IsEmpty apakah tabel berisi rekaman apa pun. Ini setara dengan menggunakan fungsi CountRows dan memeriksa untuk nol. Anda dapat memeriksa kesalahan sumber data dengan menggabungkan IsEmpty dengan fungsi Kesalahan .

Nilai yang dikembalikan untuk IsEmpty adalah Boolean true atau false.

Sintaks

Blank()

Coalesce( Value1 [, Value2, ... ] )

• Nilai – Wajib. Nilai yang akan diuji. Setiap nilai dievaluasi secara berurutan hingga nilai yang tidak kosong dan bukan string kosong yang ditemukan. Nilai setelah titik ini tidak dievaluasi.

IsBlank( Nilai )

• Nilai – Wajib. Nilai yang akan diuji untuk nilai kosong atau string kosong.

IsEmpty( Tabel )

• Tabel - Wajib. Tabel yang akan diuji untuk rekaman.

Contoh

Blank

1. Buat aplikasi dari awal, dan tambahkan kontrol Tombol.

2. Atur properti OnSelect tombol ke rumus ini:

   ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
   

3. Pratinjau aplikasi, klik atau ketuk tombol yang ditambahkan, lalu tutup Pratinjau.

4. Di menu File, klik atau ketuk Kumpulan.

   Kumpulan Kota muncul, menampilkan satu rekaman dengan "Seattle" dan "Hujan":

   

5. Klik atau ketuk panah kembali untuk kembali ke ruang kerja default.

6. Tambahkan kontrol Label, dan atur properti Teks-nya ke rumus ini:

   IsBlank( First( Cities ).Weather )
   

   Label menunjukkan false karena bidang Cuaca berisi nilai ("Hujan").

7. Tambahkan tombol kedua dan atur properti OnSelect ke rumus ini:

   Patch( Cities, First( Cities ), { Weather: Blank() } )
   

8. Pratinjau aplikasi, klik atau ketuk tombol yang ditambahkan, lalu tutup Pratinjau.

   Bidang Cuaca dari rekaman pertama di Kota digantikan dengan kosong, menghilangkan "Hujan" yang sebelumnya ada di sana.

   

   Label menunjukkan true karena bidang Cuaca tidak lagi berisi nilai.

Coalesce

Rumus	KETERANGAN	Hasil
Coalesce( ( Blank), 1 )	Menguji nilai pengembalian dari Blank fungsi, yang selalu mengembalikan nilai kosong . Karena argumen pertama kosong, evaluasi akan dilanjutkan dengan argumen berikutnya hingga nilai non-kosong dan string non-kosong ditemukan.	1
Coalesce( "", "2" )	Menguji argumen pertama, yang merupakan string kosong. Karena argumen pertama adalah string kosong, evaluasi akan dilanjutkan dengan argumen berikutnya hingga nilai non-kosong dan string non-kosong ditemukan.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesce dimulai di awal daftar argumen dan mengevaluasi setiap argumen secara bergantian hingga nilai yang tidak kosong dan string yang tidak kosong ditemukan. Dalam kasus ini, empat argumen pertama semua mengembalikan kosong atau string kosong, sehingga evaluasi berlanjut ke argumen kelima. Argumen kelima adalah nilai non-kosong dan string non-kosong, sehingga evaluasi berhenti di sini. Nilai argumen kelima dikembalikan, dan argumen keenam tidak dievaluasi.	3
Coalesce( "" )	Menguji argumen pertama, yang merupakan string kosong. Karena argumen pertama adalah string kosong, dan tidak ada lagi argumen, fungsi mengembalikan kosong.	Kosong

IsBlank

1. Buat aplikasi dari awal, tambahkan kontrol input teks, dan beri nama FirstName.

2. Tambahkan label dan atur properti Teks ke formula ini:

   If( IsBlank( FirstName.Text ), "First Name is a required field." )
   

   Secara default, properti Teks dari kontrol input teks diatur ke "Input teks". Karena properti berisi nilai, maka tidak kosong, dan label tidak menampilkan pesan apa pun.

3. Hapus semua karakter dari kontrol input teks, termasuk spasi.

   Karena properti Teks tidak lagi berisi karakter apa pun, itu adalah string kosong, dan IsBlank( FirstName.Text )adalah benar. Pesan bidang wajib diisi ditampilkan.

Untuk informasi tentang cara melakukan validasi menggunakan alat lain, lihat fungsi Validate dan bekerja dengan sumber data.

Contoh lainnya:

Rumus	KETERANGAN	Hasil
IsBlank( ( Blank) ( )	Menguji nilai pengembalian dari Blank fungsi, yang selalu mengembalikan nilai kosong .	benar
IsBlank( "" )	String yang tidak berisi karakter.	benar
IsBlank( "Halo" )	String yang berisi satu atau beberapa karakter.	palsu
IsBlank( AnyCollection )	Karena kumpulan ada, ini tidak kosong, bahkan jika ini tidak berisi rekaman apa pun. Untuk memeriksa koleksi kosong, gunakan IsEmpty sebagai gantinya.	palsu
IsBlank(Mid( "Hello", 17, 2 ) )	Karakter awal untuk Mid berada di luar akhir string. Hasilnya adalah string kosong.	benar
IsBlank( Jika( false, false ) )	Fungsi If tanpa ElseResult. Karena kondisi selalu false, If ini selalu mengembalikan kosong.	benar

IsEmpty

1. Buat aplikasi dari awal, dan tambahkan kontrol Tombol.

2. Atur properti OnSelect tombol ke rumus ini:

   Collect( IceCream, {Flavor: "Strawberry", Quantity: 300}, {Flavor: "Chocolate", Quantity: 100} )

3. Pratinjau aplikasi, klik atau ketuk tombol yang ditambahkan, lalu tutup Pratinjau.

   Kumpulan yang bernama IceCream dibuat dan berisi data ini:

   

   Kumpulan ini memiliki dua rekaman dan tidak kosong. IsEmpty( IceCream ) mengembalikan false, dan CountRows( IceCream ) mengembalikan 2.

4. Tambahkan tombol kedua dan atur properti OnSelect ke rumus ini:

   Clear ( Es Krim )

5. Pratinjau aplikasi, klik atau ketuk tombol kedua, lalu tutup Pratinjau.

   Kumpulan sekarang kosong:

   

   Fungsi Clear akan menghapus semua rekaman dari kumpulan yang menghasilkan kumpulan kosong. IsEmpty( IceCream ) mengembalikan true, dan CountRows( IceCream ) mengembalikan 0.

Anda juga dapat menggunakan IsEmpty untuk menguji apakah tabel terhitung kosong, seperti yang ditunjukkan contoh berikut:

Rumus	KETERANGAN	Hasil
IsEmpty( [ 1, 2, 3 ] )	Tabel kolom tunggal berisi tiga rekaman dan, karenanya, tidak kosong.	palsu
IsEmpty( [ ] )	Tabel kolom tunggal tidak berisi rekaman dan kosong.	benar
IsEmpty( Filter( [ 1, 2, 3 ], Nilai > 5 ) )	Tabel kolom tunggal berisi nilai tidak lebih dari 5. Hasil dari filter tidak berisi rekaman dan kosong.	benar