Функція сповіщень
Застосовується до:
програм Canvas Програм Power Platform CLI на основі моделі
Показує користувачеві повідомлення банера.
Опис
Функція Notify відображає користувачеві банерне повідомлення у верхній частині екрана. Сповіщення залишатиметься доти, доки користувач не закриє його або не закінчиться тайм-аут, який за замовчуванням становить 10 секунд.
Залежно від типу повідомлення використовуються відповідний колір і піктограма. Цей тип визначається другим аргументом функції.
Нотатка
Граничне значення функції Notify становить 500 символів.
| Аргумент NotificationType | Опис |
|---|---|
| NotificationType.Error | Відображає повідомлення як помилку. |
| NotificationType.Information (За замовчуванням) | Відображає повідомлення як інформаційне. |
| NotificationType.Success | Відображає повідомлення як сповіщення про успішне виконання. |
| NotificationType.Warning | Відображає повідомлення як попередження. |
Повідомлення відображаються як під час створення програми, так і коли користувачі використовують програму.
Функцію Notify можна використовувати лише у формулах поведінки.
Функцію Notify можна використовувати разом з функцією IfError для виявлення помилок та повідомлення про них за допомогою настроюваного повідомлення про помилку.
Power Apps також може надсилати push-сповіщення за допомогою зовсім іншого механізму, ніж функція Notify. Щоб дізнатися більше, перегляньте статтю Надсилання сповіщень у Power Apps.
Функція Notify завжди повертає значення true.
Нотатка. Ця функція раніше називалася ShowError, коли вона могла відображати лише повідомлення про помилки.
Нотатка
Notify можна використовувати в окремій програмі canvas, користувацькій сторінці та Power Fx командному досвіді. Значення за замовчуванням для NotificationType і Timeout залежать від інтерфейсу, в якому вони використовуються. Ви можете вказати значення, які потрібно встановити для параметрів NotificationType і Timeout, явно встановивши їх у виразі Power Fx , і ці значення будуть враховуватися незалежно від досвіду.
Синтаксис
Notify( Повідомлення [, NotificationType [ , Час очікування ] ] )
- Message — обов’язковий аргумент. Повідомлення, яке потрібно відобразити для користувача.
- NotificationType — необов’язковий аргумент. Тип повідомлення, яке потрібно відобразити з таблиці вище. Значення за замовчуванням: NotificationType.Information.
- Timeout — необов’язковий аргумент. Кількість мілісекунд, які необхідно буде зачекати перед автоматичним закриттям сповіщення. Значення за замовчуванням: 10 секунд (10 000 мілісекунд). Сповіщення відображається нескінченно довго з тайм-аутом 0.
Приклади
Покрокові інструкції
Додайте елемент керування Кнопка на екран.
Встановить для властивості OnSelect елемента керування Кнопка формулу:
Notify( "Hello, World" )Натисніть кнопку.
Після кожного натискання кнопки повідомлення Hello, world відображатиметься користувачу як інформаційне. Він автоматично закривається через 10 секунд (тайм-аут за замовчуванням), якщо користувач не закриває його або не натискає кнопку знову.
Змініть тип повідомлення, щоб повідомити про помилку. Додайте другий аргумент до формули.
Notify( "Hello, World", NotificationType.Error )Натисніть кнопку.
Зараз після кожного натискання кнопки повідомлення Hello, world відображатиметься користувачу як помилка. Він автоматично закривається через 10 секунд (тайм-аут за замовчуванням), якщо користувач не закриває його або не натискає кнопку знову.
Змініть тип повідомлення, щоб відобразити попередження. Змініть другий аргумент у формулі.
Notify( "Hello, World", NotificationType.Warning, 4000 )Натисніть кнопку.
Зараз після кожного натискання кнопки повідомлення Hello, world відображатиметься користувачу як попередження. Він автоматично закривається через 4 секунди (4 000 мілісекунд), якщо користувач не закриває його або не натискає кнопку знову.
Змініть тип повідомлення, щоб повідомити про успішне виконання. Змініть другий аргумент у формулі.
Notify( "Hello, World", NotificationType.Success, 0 )Натисніть кнопку.
Зараз після кожного натискання кнопки повідомлення Hello, world відображатиметься користувачу як повідомлення про успішне виконання. Якщо вибрано час очікування 0, сповіщення може закрити лише користувач або потрібно буде натиснути на кнопку ще раз.
