Поділитися через


Функція сповіщень

Застосовується до: програм Canvas Командного Power Platform рядка на основі моделі

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

Опис

Функція 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( Message [, NotificationType [, Timeout ] ] )

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

Приклади

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

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

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

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

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

    У середовищі створення відображається Button.OnSelect, що викликає функцію Notify та відображає вихідне повідомлення

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

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

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

    У середовищі створення відображається Button.OnSelect, що викликає функцію Notify та відображає вихідне повідомлення

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

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

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

    У середовищі створення відображається Button.OnSelect, що викликає функцію Notify та відображає вихідне повідомлення

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

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

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

    У середовищі створення відображається Button.OnSelect, що викликає функцію Notify та відображає вихідне повідомлення