Bagikan melalui


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

  1. Tambahkan kontrol Tombol ke layar Anda.

  2. Atur properti OnSelect dari Tombol ke rumus ini:

    Notify( "Hello, World" )
    
  3. 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.

    Di lingkungan penulisan, menampilkan Button.OnSelect memanggil Notify dan menampilkan hasil pesan Hello, World sebagai pesan banner biru untuk pengguna tersebut.

  4. Ubah jenis pesan untuk menunjukkan kesalahan. Tambahkan argumen kedua ke rumus kami:

    Notify( "Hello, World", NotificationType.Error )
    
  5. 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.

    Di lingkungan penulisan, menampilkan Button.OnSelect memanggil Notify dan menampilkan hasil pesan Hello, World sebagai pesan banner mérah untuk pengguna tersebut.

  6. Ubah jenis pesan untuk menunjukkan peringatan. Ubah argumen kedua dalam rumus kami:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. 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.

    Di lingkungan penulisan, menampilkan Button.OnSelect memanggil Notify dan menampilkan hasil pesan Hello, World sebagai pesan banner oranye untuk pengguna tersebut.

  8. Ubah jenis pesan untuk menunjukkan keberhasilan. Ubah argumen kedua dalam rumus kami:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. 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.

    Di lingkungan penulisan, menampilkan Button.OnSelect memanggil Notify dan menampilkan hasil pesan Hello, World sebagai pesan banner hijau untuk pengguna tersebut.