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


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

Отнася се за: Приложения за платно Управлявани от модел Power Platform приложения CLI

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

Описание

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

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

Бележка

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

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

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

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

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

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

Notify винаги връща true.

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

Бележка

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

Синтаксис

Известяване( Съобщение [, ТипИзвестие [, Време за изчакване ] ] )

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

Примери

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

  1. Добавете контрола Бутон към екрана си.

  2. Задайте свойството OnSelect на бутона на тази формула:

    Notify( "Hello, World" )
    
  3. Щракнете или натиснете бутона.

    Всеки път, когато се натисне бутона, съобщението Здравей свят се показва на потребителя като информационна. Той се отхвърля автоматично след 10 секунди (време за изчакване по подразбиране), ако потребителят не го отхвърли или не натисне бутона отново.

    В създаващата среда, която показва Button.OnSelect с обаждане за известие и показва полученото съобщение „Здравей, свят” като син банер за потребителя.

  4. Променете типа съобщение, за да посочите грешка. Добавете втори аргумент към нашата формула:

    Notify( "Hello, World", NotificationType.Error )
    
  5. Щракнете или натиснете бутона.

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

    В създаващата среда, която показва Button.OnSelect с обаждане за известие и показва полученото съобщение „Здравей, свят” като червен банер за потребителя.

  6. Променете типа съобщение, за да посочи предупреждение. Променете втория аргумент в нашата формула:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. Щракнете или натиснете бутона.

    Сега всеки път, когато се натисне бутона, съобщението Здравей свят се показва на потребителя като предупреждение. Той се изключва автоматично за 4 секунди (4,000 милисекунди), ако потребителят не го отхвърли или не натисне бутона отново.

    В създаващата среда, която показва Button.OnSelect с обаждане за известие и показва полученото съобщение „Здравей, свят” като оранжев банер за потребителя.

  8. Променете типа съобщение, за да посочи успех. Променете втория аргумент в нашата формула:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. Щракнете или натиснете бутона.

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

    В създаващата среда, която показва Button.OnSelect с обаждане за известие и показва полученото съобщение „Здравей, свят” като зелен банер за потребителя.