Chức năng thông báo

Áp dụng cho: Ứng dụng canvas Ứng dụng dựa trên mô hình Power Platform CLI

Hiển thị thông báo biểu ngữ cho người dùng.

Description

Chức năng Thông báo hiển thị thông báo biểu ngữ cho người dùng ở đầu màn hình. Thông báo vẫn còn cho đến khi người dùng loại bỏ nó hoặc hết thời gian chờ mặc định là 10 giây.

Một màu sắc và biểu tượng thích hợp được sử dụng tùy thuộc vào loại thông báo. Loại được chỉ định bởi đối số thứ hai cho hàm:

Lưu ý

Giới hạn ký tự cho hàm Notify là 500 ký tự.

NotificationType Argument Mô tả
NotificationType.Error Hiển thị thông báo lỗi.
NotificationType.Information (Mặc định) Hiển thị thông báo mang tính thông tin.
NotificationType.Success Hiển thị thông báo thành công.
NotificationType.Warning Hiển thị thông báo cảnh báo.

Thông báo được hiển thị cả khi tạo ứng dụng và khi người dùng cuối đang sử dụng ứng dụng.

Bạn chỉ có thể sử dụng hàm Notify trong công thức hành vi.

Hàm Notify có thể kết hợp được với hàm IfError để phát hiện và báo cáo lỗi bằng thông báo lỗi tùy chỉnh.

Power Apps cũng có thể gửi thông báo đẩy bằng một cơ chế hoàn toàn khác với hàm Notify. Để biết thêm thông tin, hãy xem Gửi thông báo Power Apps.

Hàm Notify luôn trả về true.

Lưu ý: Hàm này đã được đặt tên trước đó là ShowError khi chỉ có thể hiển thị thông báo lỗi.

Lưu ý

Bạn có thể sử dụng thông báo trong ứng dụng canvas độc lập, trang tùy chỉnhPower Fx chỉ huy kinh nghiệm. Các giá trị mặc định cho Loại thông báo và Thời gian chờ thay đổi tùy theo trải nghiệm mà chúng được sử dụng. Bạn có thể chỉ định các giá trị bạn muốn đặt cho Loại thông báo và Thời gian chờ bằng cách đặt chúng một cách rõ ràng trong biểu thức Power Fx của mình và những giá trị này sẽ được tôn trọng bất kể trải nghiệm như thế nào.

Cú pháp

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

  • Message – Bắt buộc. Thông báo hiển thị với người dùng.
  • NotificationType – Không bắt buộc. Loại thông báo hiển thị từ bảng trên. Mặc định là NotificationType.Information.
  • Timeout – Không bắt buộc. Số mili giây chờ đợi trước khi tự động tắt thông báo. Giá trị mặc định là 10 giây (hoặc 10.000 mili giây). Thông báo được hiển thị vô thời hạn với Thời gian chờ bằng 0.

Ví dụ

Hướng dẫn chi tiết

  1. Thêm một công cụ điều khiển Button (Nút) vào màn hình.

  2. Đặt thuộc tính OnSelect của Button (Nút) theo công thức sau:

    Notify( "Hello, World" )
    
  3. Bấm hoặc nhấn nút.

    Mỗi lần bấm nút, thông báo Hello, World (Xin chào mọi người) được hiển thị cho người dùng dưới dạng thông tin. Nó tự động tắt sau 10 giây (thời gian chờ mặc định) nếu người dùng không loại bỏ nó hoặc nhấn lại nút.

    Trong môi trường tạo ứng dụng, hiển thị Button.OnSelect khi gọi hàm Notify và hiển thị thông báo Hello, World (Xin chào mọi người) dưới dạng thông báo biểu ngữ màu xanh dương cho người dùng.

  4. Thay đổi loại thông báo để cho biết có lỗi. Thêm một đối số thứ hai vào công thức:

    Notify( "Hello, World", NotificationType.Error )
    
  5. Bấm hoặc nhấn nút.

    Lúc này, mỗi lần bấm nút, thông báo Hello, World (Xin chào mọi người) được hiển thị cho người dùng dưới dạng thông báo lỗi. Nó tự động tắt sau 10 giây (thời gian chờ mặc định) nếu người dùng không loại bỏ nó hoặc nhấn lại nút.

    Trong môi trường tạo ứng dụng, hiển thị Button.OnSelect khi gọi hàm Notify và hiển thị thông báo Hello, World (Xin chào mọi người) dưới dạng thông báo biểu ngữ màu đỏ cho người dùng.

  6. Thay đổi loại thông báo để cảnh báo. Thay đổi đối số thứ hai trong công thức:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. Bấm hoặc nhấn nút.

    Lúc này, mỗi lần bấm nút, thông báo Hello, World (Xin chào mọi người) được hiển thị cho người dùng dưới dạng cảnh báo. Nó tự động tắt sau 4 giây (4.000 mili giây) nếu người dùng không loại bỏ nó hoặc nhấn lại nút.

    Trong môi trường tạo ứng dụng, hiển thị Button.OnSelect khi gọi hàm Notify và hiển thị thông báo Xin chào mọi người dưới dạng thông báo biểu ngữ màu cam cho người dùng.

  8. Thay đổi loại thông báo để cho biết đã thành công. Thay đổi đối số thứ hai trong công thức:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. Bấm hoặc nhấn nút.

    Lúc này, mỗi lần bấm nút, thông báo Hello, World (Xin chào mọi người) được hiển thị cho người dùng dưới dạng thông báo thành công. Với thời gian chờ bằng 0, chỉ người dùng mới tắt được thông báo hoặc thông báo tắt khi nhấn lại nút.

    Trong môi trường tạo ứng dụng, hiển thị Button.OnSelect khi gọi hàm Notify và hiển thị thông báo Hello, World (Xin chào mọi người) dưới dạng thông báo biểu ngữ màu xanh lục cho người dùng.