Fungsi Notifikasi
Berlaku untuk: Aplikasi kanvas CLI Aplikasi Power Platform berdasarkan model
Menampilkan pesan banner ke pengguna.
Description
Fungsi Notify menampilkan pesan spanduk kepada pengguna di bagian atas layar. Pemberitahuan tetap ada hingga pengguna menutupnya atau batas waktu kedaluwarsa yang default menjadi 10 detik.
Warna dan ikon yang sesuai digunakan tergantung pada jenis pesannya. Jenis ditentukan oleh argumen kedua ke fungsi:
Catatan
Batas karakter untuk fungsi Notify adalah 500 karakter.
Argumen NotificationType | KETERANGAN |
---|---|
NotificationType.Error | Menampilkan pesan sebagai kesalahan. |
NotificationType.Information (Default) | Menampilkan pesan sebagai informasi. |
NotificationType.Sukses | Menampilkan pesan sebagai keberhasilan. |
NotificationType.Peringatan | Menampilkan pesan sebagai peringatan. |
Pesan ditampilkan baik saat menulis aplikasi Anda maupun saat pengguna akhir menggunakan aplikasi Anda.
Notify hanya dapat digunakan dalam rumus perilaku.
Notify dapat dipasangkan dengan fungsi IfError untuk mendeteksi dan melaporkan kesalahan dengan pesan kesalahan khusus.
Power Apps juga dapat mengirim pemberitahuan push menggunakan mekanisme yang sama sekali berbeda dari Notify. Untuk informasi selengkapnya, lihat Mengirim pemberitahuan masuk Power Apps.
Notify selalu mengembalikan true.
Catatan: Fungsi ini sebelumnya bernama ShowError saat hanya dapat menampilkan pesan kesalahan.
Catatan
Notify dapat digunakan dalam aplikasi kanvas mandiri, halaman kustom, dan Power Fx pengalaman perintah . Nilai default untuk NotificationType dan Timeout bervariasi menurut pengalaman yang digunakan. Anda dapat menentukan nilai yang ingin Anda atur untuk NotificationType dan Timeout dengan mengaturnya secara eksplisit dalam ekspresi Anda Power Fx dan nilai-nilai ini akan dihormati terlepas dari pengalamannya.
Sintaks
Beri tahu ( Pesan [, Jenis Pemberitahuan [,Batas Waktu ] ] )
- Pesan – Wajib. Pesan yang ditampilkan kepada pengguna.
- NotificationType – Opsional. Jenis pesan yang akan ditampilkan dari tabel di atas. Default-nya adalah NotificationType.Information.
- Timeout – Opsional. Jumlah milidetik untuk menunggu sebelum secara otomatis menolak pemberitahuan. Default adalah 10 detik (atau 10.000 milidetik). Pemberitahuan ditampilkan tanpa batas waktu dengan Batas Waktu 0.
Contoh
Langkah demi langkah
Tambahkan kontrol Tombol ke layar Anda.
Atur properti OnSelect dari Tombol ke rumus ini:
Notify( "Hello, World" )
Klik atau tekan tombol.
Setiap kali tombol diklik, pesan Hello, World ditampilkan kepada pengguna sebagai informasi. Ini ditutup secara otomatis dalam 10 detik (batas waktu default) jika pengguna tidak menutupnya atau menekan tombol lagi.
Ubah jenis pesan untuk menunjukkan kesalahan. Tambahkan argumen kedua ke rumus kami:
Notify( "Hello, World", NotificationType.Error )
Klik atau tekan tombol.
Sekarang, setiap kali tombol diklik, pesan Hello, World akan ditampilkan kepada pengguna sebagai kesalahan. Ini ditutup secara otomatis dalam 10 detik (batas waktu default) jika pengguna tidak menutupnya atau menekan tombol lagi.
Ubah jenis pesan untuk menunjukkan peringatan. Ubah argumen kedua dalam rumus kami:
Notify( "Hello, World", NotificationType.Warning, 4000 )
Klik atau tekan tombol.
Sekarang setiap kali tombol diklik, pesan Hello, World ditampilkan kepada pengguna sebagai peringatan. Ini ditutup secara otomatis dalam 4 detik (4.000 milidetik) jika pengguna tidak menutupnya atau menekan tombol lagi.
Ubah jenis pesan untuk menunjukkan keberhasilan. Ubah argumen kedua dalam rumus kami:
Notify( "Hello, World", NotificationType.Success, 0 )
Klik atau tekan tombol.
Sekarang setiap kali tombol diklik, pesan Hello, World ditampilkan kepada pengguna sebagai keberhasilan. Dengan batas waktu 0, pemberitahuan hanya akan dihentikan oleh pengguna atau dengan menekan tombol lagi.