Функция за уведомяване

Статия
03/22/2024

Отнася се за: Canvas apps Model-driven apps Power Platform CLI

Показва съобщение на банер на потребителя.

Описание

Функцията "Уведомяване" показва банерно съобщение на потребителя в горната част на екрана. Известието остава, докато потребителят не го отхвърли или изтече времето за изчакване, което по подразбиране е 10 секунди.

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

Бележка

Ограничението за знаци за функцията Notify е 500 знака.

Аргумент NotificationType	Описание
NotificationType.Error	Показва съобщението като грешка.
NotificationType.Information (Default)	Показва съобщението като информация.
NotificationType.Success	Показва съобщението като успех.
NotificationType.Warning	Показва съобщението като предупреждение.

Съобщенията се показват както при създаването на приложението ви, така и когато крайните потребители използват вашето приложение.

Notify може да се използва само във формули на поведение.

Notify може да се сдвои с IfError функция за откриване и докладване на грешки с персонализирано съобщение за грешка.

Power Apps може също да изпраща насочени известия, използвайки напълно различен механизъм от Notify. За повече информация вижте Изпращане на известие в Power Apps.

Notify винаги връща вярно.

Забележка: Тази функция беше именувана по-рано ShowError, когато можеше да показва само съобщения за грешки.

Бележка

Уведомяването може да се използва в самостоятелно приложение за платно, персонализирана страница и Power Fx командни изживявания. Стойностите по подразбиране за NotificationType и Timeout се различават в зависимост от опита, в който се използва. Можете да зададете стойностите, които искате да зададете за NotificationType и Timeout, като ги зададете изрично във вашия Power Fx израз и тези стойности ще бъдат спазвани независимо от опита.

Синтаксис

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

Message – Задължително. Съобщение за показване на потребителите.
NotificationType – Опционално. Тип на съобщението за показване от таблицата по-горе. По подразбиране е NotificationType.Information.
Timeout – Опционално. Брой милисекунди, за да изчакате, преди автоматично да отхвърлите известието. Стойността по подразбиране е 10 секунди (10,000 милисекунди). Известието се показва за неопределено време с време на изчакване 0.

Примери

Стъпка по стъпка

Добавете контрола Бутон към екрана си.
Задайте свойството OnSelect на бутона на тази формула:
```
Notify( "Hello, World" )
```
Щракнете или натиснете бутона.

Всеки път, когато се натисне бутона, съобщението Здравей свят се показва на потребителя като информационна. Той се отхвърля автоматично за 10 секунди (време на изчакване по подразбиране), ако потребителят не го отхвърли или не натисне бутона отново.
Променете типа съобщение, за да посочите грешка. Добавете втори аргумент към нашата формула:
```
Notify( "Hello, World", NotificationType.Error )
```
Щракнете или натиснете бутона.

Сега всеки път, когато се натисне бутона, съобщението Здравей свят се показва на потребителя като грешка. Той се отхвърля автоматично за 10 секунди (време на изчакване по подразбиране), ако потребителят не го отхвърли или не натисне бутона отново.
Променете типа съобщение, за да посочи предупреждение. Променете втория аргумент в нашата формула:
```
Notify( "Hello, World", NotificationType.Warning, 4000 )
```
Щракнете или натиснете бутона.

Сега всеки път, когато се натисне бутона, съобщението Здравей свят се показва на потребителя като предупреждение. Той се отхвърля автоматично за 4 секунди (4000 милисекунди), ако потребителят не го отхвърли или не натисне бутона отново.
Променете типа съобщение, за да посочи успех. Променете втория аргумент в нашата формула:
```
Notify( "Hello, World", NotificationType.Success, 0 )
```
Щракнете или натиснете бутона.

Сега всеки път, когато се натисне бутона, съобщението Здравей свят се показва на потребителя като успех. С 0 изчакване, известието ще бъде отхвърлено само от потребителя или чрез натискане на бутона отново.

Споделяне чрез