Функция Notify

Применимо к: приложениям на основе холста приложениям на основе модели интерфейс командной строки Power Platform

Отображает баннер с сообщением для пользователя.

Description

Функция Notify отображает баннер с сообщением для пользователя в верхней части экрана. Уведомление будет оставаться до тех пор, пока пользователь не закроет его или не истечет время ожидания, которое по умолчанию составляет 10 секунд.

Используемые цвет и значок зависят от типа сообщения. Тип определяется вторым аргументом функции.

Заметка

Предел символов для функции Notify составляет 500 символов.

Аргумент NotificationType	Description
NotificationType.Error	Выводится сообщение об ошибке.
NotificationType.Information (по умолчанию)	Выводится информационное сообщение.
NotificationType.Success	Выводится сообщение об успешном выполнении.
NotificationType.Warning	Выводится предупреждение.

Сообщения отображаются как при разработке, так и при использовании приложения.

Функция Notify может использоваться только в формулах поведения.

Функцию Notify можно использовать совместно с функцией IfError для определения ошибок и выдачи пользовательских сообщений об ошибках.

Power Apps может также отправлять push-уведомления из функции Notify с помощью совершенно другого механизма. Дополнительные сведения см. в разделе Отправка уведомления в Power Apps.

Функция Notify всегда возвращает true.

Примечание. Ранее эта функция называлась ShowError и могла выводить только сообщения об ошибках.

Заметка

Уведомление можно использовать в автономном приложении на основе холста, на пользовательской странице и интерфейсе команд Power Fx. Значения по умолчанию для NotificationType и Timeout различаются в зависимости от того, как они используются. Вы можете указать значения, которые хотите установить для NotificationType и Timeout, явно задав их в выражении Power Fx, и эти значения будут учитываться независимо от интерфейса.

Синтаксис

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

• Message — обязательный аргумент. Сообщение, отображаемое для пользователя.
• NotificationType — необязательный аргумент. Тип сообщения для отображения из приведенной выше таблицы. Тип по умолчанию — NotificationType.Information.
• Timeout — необязательный аргумент. Время ожидания в миллисекундах перед автоматическим закрытием уведомления. По умолчанию это значение составляет 10 секунд (или 10000 миллисекунд). Уведомление будет отображаться бесконечно со значением Timeout, равным 0.

Примеры

Пошаговое руководство

1. Добавьте элемент управления Button на экран.

2. Задайте для свойства OnSelectкнопки эту формулу:

   Notify( "Hello, World" )
   

3. Щелкните или нажмите кнопку.

   При каждом нажатии на кнопку для пользователя будет отображаться информационное сообщение Hello, World. Оно будет автоматически закрыто через 10 секунд (время ожидания по умолчанию), если пользователь не закроет его или не нажмет кнопку еще раз.

   

4. Измените тип сообщения на сообщение об ошибке. Добавьте в формулу второй аргумент:

   Notify( "Hello, World", NotificationType.Error )
   

5. Щелкните или нажмите кнопку.

   Теперь при каждом нажатии кнопки для пользователя будет отображаться сообщение об ошибке Hello, World. Оно будет автоматически закрыто через 10 секунд (время ожидания по умолчанию), если пользователь не закроет его или не нажмет кнопку еще раз.

   

6. Измените тип сообщения на предупреждение. Измените второй аргумент в формуле:

   Notify( "Hello, World", NotificationType.Warning, 4000 )
   

7. Щелкните или нажмите кнопку.

   Теперь при каждом нажатии кнопки для пользователя будет отображаться предупреждение Hello, World. Оно будет автоматически закрыто через 4 секунды (4000 миллисекунд), если пользователь не закроет его или не нажмет кнопку еще раз.

   

8. Измените тип сообщения на сообщение об успешном выполнении. Измените второй аргумент в формуле:

   Notify( "Hello, World", NotificationType.Success, 0 )
   

9. Щелкните или нажмите кнопку.

   Теперь при каждом нажатии кнопки для пользователя будет отображаться сообщение об успешном выполнении Hello, World. С выдержкой времени 0 уведомление будет закрываться только пользователем или повторным нажатием кнопки.