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


Notify функция

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

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

Description

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

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

Заметка

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

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

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

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

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

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

Notify всегда возвращает значение true.

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

Заметка

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

Синтаксис

Notify( Сообщение [, NotificationType [ , timeout ] ] )

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

Примеры

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

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

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

    Notify( "Hello, World" )
    
  3. Щелкните или нажмите кнопку.

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

    В среде разработки отображается вызов Notify Button.OnSelect и отображается полученное сообщение Hello, World в виде синего баннера для пользователя.

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

    Notify( "Hello, World", NotificationType.Error )
    
  5. Щелкните или нажмите кнопку.

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

    В среде разработки отображается вызов Notify Button.OnSelect и отображение полученного сообщения Hello, World в виде красного баннера для пользователя.

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

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. Щелкните или нажмите кнопку.

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

    В среде разработки отображается вызов Notify Button.OnSelect и отображается полученное сообщение Hello, World в виде сообщения оранжевого баннера для пользователя.

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

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. Щелкните или нажмите кнопку.

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

    В среде разработки отображается вызов Notify Button.OnSelect и отображается полученное сообщение Hello, World в виде зеленого баннера для пользователя.