Bagikan melalui


fungsi Notify

Berlaku untuk: Aplikasi Kanvas Aplikasi berbasis model Power Platform CLI

Menampilkan pesan banner ke pengguna.

Description

Fungsi ini Notify menampilkan pesan banner 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 Notify fungsi adalah 500 karakter.

Argumen NotificationType Description
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 kustom.

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 pengalaman perintah Power Fx . 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

Notify( Pesan [, NotificationType [ , Timeout ] ] )

  • 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, memperlihatkan Tombol.OnPilih panggilan Notify dan menampilkan pesan Hello, World yang dihasilkan sebagai pesan banner biru untuk pengguna.

  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, memperlihatkan Tombol.OnPilih panggilan Notify dan menampilkan pesan Halo, Dunia yang dihasilkan sebagai pesan banner merah untuk pengguna.

  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, memperlihatkan Tombol.OnPilih panggilan Notify dan menampilkan pesan Hello, World yang dihasilkan sebagai pesan banner oranye untuk pengguna.

  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, memperlihatkan Tombol.OnPilih panggilan Notify dan menampilkan pesan Hello, World yang dihasilkan sebagai pesan banner hijau untuk pengguna.