Notify функція

Застосовується до: Програми canvas Model-driven apps Power Platform CLI

Показує користувачеві повідомлення банера.

Опис

Функція Notify відображає повідомлення банера користувачу у верхній частині екрана. Сповіщення залишається до тих пір, поки користувач не закриє його або не закінчиться тайм-аут, який за замовчуванням становить 10 секунд.

Залежно від типу повідомлення використовуються відповідний колір і піктограма. Цей тип визначається другим аргументом функції.

Нотатка

Обмеження кількості символів для Notify функції становить 500 символів.

Аргумент NotificationType Опис
NotificationType.Error Відображає повідомлення як помилку.
NotificationType.Information (за замовчуванням) Відображає повідомлення як інформаційне.
Тип сповіщення.Успіх Відображає повідомлення як сповіщення про успішне виконання.
Тип сповіщення.Попередження Відображає повідомлення як попередження.

Повідомлення відображаються як під час створення програми, так і коли користувачі використовують програму.

Notify можна використовувати лише у формулах поведінки.

Notify можна з'єднати з функцією IfError , щоб виявити помилки та повідомити про помилки з настроюваним повідомленням про помилку.

Power Apps також може надсилати push-сповіщення, використовуючи зовсім інший механізм від Notify. Щоб отримати докладнішу інформацію, перегляньте статтю Надсилання сповіщень у. Power Apps

Notify завжди повертає значення true.

Нотатка. Ця функція раніше називалася ShowError, коли вона могла відображати лише повідомлення про помилки.

Нотатка

Notify можна використовувати в автономній програмі canvas, настроюваній сторінці та командуванні Power Fx . Значення за замовчуванням для NotificationType і Timeout залежать від інтерфейсу, в якому вони використовуються. Ви можете вказати значення, які ви хочете встановити для NotificationType і Timeout, явно встановивши їх у своєму Power Fx виразі, і ці значення будуть дотримані незалежно від досвіду.

Синтаксис

Notify( Повідомлення [, NotificationType [ , Час очікування ] )

  • Повідомлення – Обов’язковий. Повідомлення, яке потрібно відобразити для користувача.
  • NotificationType – необов’язковий. Тип повідомлення, яке потрібно відобразити з таблиці вище. Значення за замовчуванням: NotificationType.Information.
  • Тайм-аут – необов’язковий. Кількість мілісекунд, які необхідно буде зачекати перед автоматичним закриттям сповіщення. Значення за замовчуванням: 10 секунд (10 000 мілісекунд). Сповіщення відображається нескінченно довго з тайм-аутом 0.

Приклади

Покрокові інструкції

  1. Додайте елемент керування Кнопка на екран.

  2. Встановить для властивості OnSelect елемента керування Кнопка формулу:

    Notify( "Hello, World" )
    
  3. Натисніть кнопку.

    Після кожного натискання кнопки повідомлення Hello, world відображатиметься користувачу як інформаційне. Він автоматично закривається через 10 секунд (тайм-аут за замовчуванням), якщо користувач не закриє його або не натисне кнопку знову.

    У середовищі створення відображається кнопка.OnSelect calling and displaying the resulting Hello, World message as a blue banner message for the user.OnSelect calling Notify and displaying the resulting Hello, World message as a blue banner message for the user.

  4. Змініть тип повідомлення, щоб повідомити про помилку. Додайте другий аргумент до формули.

    Notify( "Hello, World", NotificationType.Error )
    
  5. Натисніть кнопку.

    Зараз після кожного натискання кнопки повідомлення Hello, world відображатиметься користувачу як помилка. Він автоматично закривається через 10 секунд (тайм-аут за замовчуванням), якщо користувач не закриє його або не натисне кнопку знову.

    У середовищі створення відображається кнопка.OnSelect calling and displaying the resulting Hello, World message as a red banner message for the user.OnSelect calling Notify and displaying the resulting Hello, World message as a red banner message for the user.

  6. Змініть тип повідомлення, щоб відобразити попередження. Змініть другий аргумент у формулі.

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. Натисніть кнопку.

    Зараз після кожного натискання кнопки повідомлення Hello, world відображатиметься користувачу як попередження. Він автоматично закривається через 4 секунди (4 000 мілісекунд), якщо користувач не закриє його або не натисне кнопку знову.

    У середовищі створення відображається кнопка.OnSelect calling Notify and displaying the resulting Hello, World message as an orange banner message for the user.

  8. Змініть тип повідомлення, щоб повідомити про успішне виконання. Змініть другий аргумент у формулі.

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. Натисніть кнопку.

    Зараз після кожного натискання кнопки повідомлення Hello, world відображатиметься користувачу як повідомлення про успішне виконання. Якщо вибрано час очікування 0, сповіщення може закрити лише користувач або потрібно буде натиснути на кнопку ще раз.

    У середовищі створення відображається кнопка.OnSelect calling and displaying the resulting Hello, World message as a green banner message for the user.OnSelect calling Notify and displaying the resulting Hello, World message as a green banner message for the user.