Sdílet prostřednictvím


Notify Funkce

Platí pro: Rozhraní příkazového řádku Power Platform cli pro aplikace plátna modelem řízené aplikacemi

Zobrazí uživateli nápis.

Description

Funkce Notify zobrazí uživateli v horní části obrazovky bannerovou zprávu. Oznámení zůstává, dokud ho uživatel neodmítne nebo dokud nevyprší časový limit, který je ve výchozím nastavení 10 sekund.

V závislosti na typu zprávy se použije příslušná barva a ikona. Typ se určuje druhým argumentem funkce:

Poznámka:

Limit znaků pro Notify funkci je 500 znaků.

Argument NotificationType Description
NotificationType.Error Zobrazí zprávu jako chybu.
NotificationType.Information (výchozí) Zobrazí zprávu jako informační.
NotificationType.Success Zobrazí zprávu jako úspěch.
NotificationType.Warning Zobrazí zprávu jako upozornění.

Zprávy se zobrazují při vytváření aplikace i tehdy, kdy koncoví uživatelé používají vaši aplikaci.

Notify lze použít pouze ve vzorcích chování.

Notify lze spárovat s funkcí IfError k detekci a hlášení chyb vlastní chybovou zprávou.

Power Apps může také posílat nabízená oznámení pomocí zcela jiného mechanismu než Notify. Další informace naleznete v tématu Odeslání oznámení v Power Apps.

Notify vždy vrátí hodnotu true.

Poznámka: Tato funkce měla dříve název ShowError a uměla zobrazovat pouze chybové zprávy.

Poznámka:

Notify lze použít v samostatné aplikaci plátna, ve vlastních prostředích propříkazy Power Fx a na vlastní stránce. Výchozí hodnoty pro NotificationType a Timeout se liší podle prostředí, ve kterém se používá. Hodnoty, které chcete nastavit pro NotificationType a Timeout, můžete určit tak, že je explicitně nastavíte ve vašem výrazu Power Fx a tyto hodnoty budou respektovány bez ohledu na prostředí.

Syntaxe

Notify( Zpráva [, NotificationType [ , Časový limit ] ] )

  • Zpráva – Povinné. Zpráva, která se zobrazí uživateli.
  • NotificationType – Volitelné. Typ zprávy z tabulky výše, který se zobrazí. Výchozím typem je NotificationType.Information.
  • Časový limit – volitelné. Počet milisekund, než bude oznámení automaticky zrušeno. Výchozí hodnota je 10 sekund (nebo 10 000 milisekund). Oznámení se bude zobrazovat na neurčito s Časovým limitem 0.

Příklady

Podrobný postup

  1. Přidejte na obrazovku ovládací prvek Button.

  2. Do vlastnosti OnSelecttlačítka nastavte tento vzorec:

    Notify( "Hello, World" )
    
  3. Klikněte nebo klepněte na tlačítko.

    Při každém kliknutí na tlačítko se uživateli zobrazí zpráva Hello, World jako informace. Pokud to uživatel nezruší nebo znovu nestiskne tlačítko, automaticky se zruší za 10 sekund (výchozí časový limit).

    V prostředí pro vytváření obsahu se zobrazí volání Notify Button.OnSelect a zobrazí výslednou zprávu Hello, World jako modrou bannerovou zprávu pro uživatele.

  4. Změňte typ zprávy na chybovou zprávu. Přidejte do vzorce druhý argument:

    Notify( "Hello, World", NotificationType.Error )
    
  5. Klikněte nebo klepněte na tlačítko.

    Při každém kliknutí na tlačítko se teď uživateli zobrazí zpráva Hello, World jako chyba. Pokud to uživatel nezruší nebo znovu nestiskne tlačítko, automaticky se zruší za 10 sekund (výchozí časový limit).

    V prostředí pro vytváření obsahu se zobrazuje volání Notify Button.OnSelect a zobrazí výslednou zprávu Hello, World jako červenou bannerovou zprávu pro uživatele.

  6. Změňte typ zprávy na zprávu upozornění. Změňte ve vzorci druhý argument:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. Klikněte nebo klepněte na tlačítko.

    Při každém kliknutí na tlačítko se teď uživateli zobrazí zpráva Hello, World jako upozornění. Pokud to uživatel nezruší nebo znovu nestiskne tlačítko, automaticky se zruší za 4 sekundy (4 000 milisekund).

    V prostředí pro vytváření obsahu se zobrazí volání Notify Button.OnSelect a zobrazí výslednou zprávu Hello, World jako oranžovou bannerovou zprávu pro uživatele.

  8. Změňte typ zprávy na zprávu o úspěchu. Změňte ve vzorci druhý argument:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. Klikněte nebo klepněte na tlačítko.

    Při každém kliknutí na tlačítko se teď uživateli zobrazí zpráva Hello, World jako úspěch. U časového limitu 0 bude oznámení zrušeno pouze uživatelem nebo dalším stisknutím tlačítka.

    V prostředí pro vytváření obsahu se zobrazí volání Notify Button.OnSelect a zobrazí výslednou zprávu Hello, World jako zelenou bannerovou zprávu pro uživatele.