Notify-funktio
Koskee seuraavia:
Pohjaan perustuvat sovellukset Mallipohjaiset sovellukset Power Platform CLI
Näyttää ilmoitussanoman käyttäjälle.
Description
Notify-funktio näyttää käyttäjälle ilmoitussanoman näytön yläreunassa. Ilmoitus säilyy, kunnes käyttäjä hylkää sen tai oletusarvoltaan 10 sekunnin aikakatkaisu toteutuu.
Sopivaa väriä ja kuvaketta käytetään sanoman tyypin mukaan. Funktion toinen argumentti määrittää tyypin:
Muistiinpano
Notify-funktion merkkirajoitus on 500 merkkiä.
| NotificationType-argumentti | Kuvaus |
|---|---|
| NotificationType.Error | Näyttää sanoman virheenä. |
| NotificationType.Information (oletus) | Näyttää sanoman tietona. |
| NotificationType.Success | Näyttää sanoman onnistumisena. |
| NotificationType.Warning | Näyttää sanoman varoituksena. |
Sanomat näkyvät, kun kehität sovellustasi ja kun käyttäjät käyttävät sovellustasi.
Notify-funktiota voidaan käyttää vain toimintokaavoissa.
Notify voidaan yhdistää IfError-funktion kanssa havaitsemaan virheitä ja ilmoittamaan niistä mukautetulla virhesanomalla.
Power Apps voi lähettää myös palveluilmoituksia käyttämällä täysin Notify-funktiosta poikkeavaa tapaa. Lisätietoja on kohdassa Ilmoituksen lähettäminen Power Appsissa.
Notify palauttaa aina arvon true.
Huomautus: Tämä funktio oli aiemmin nimeltään ShowError, kun se pystyi näyttämään vain virhesanomia.
Muistiinpano
Ilmoitusta voi käyttää erillisen pohjaan perustuvan sovelluksen, mukautetun sivun ja Power Fx -komentojen kokemuksissa. NotificationType- ja Timeout-oletusarvot vaihtelevat käytettävän kokemuksen mukaan. Määritä arvot, jotka haluat määrittää NotificationType- ja Timeout-kohtiin, määrittämällä ne erikseen Power Fx -lausekkeessa. Näitä arvoja käytetään kokemuksesta riippumatta.
Syntaksi
Notify( Message [, NotificationType [ , Timeout ] ] )
- Message – pakollinen. Sanoma, joka näytetään käyttäjälle.
- NotificationType – valinnainen. Näytettävän sanoman tyyppi edellä olevasta taulukosta. Oletus on NotificationType.Information.
- Timeout – valinnainen. Aika, joka odotetaan, ennen kuin ilmoitus hylätään automaattisesti millisekunteina. Oletusarvo on 10 sekuntia (tai 10 000 millisekuntia). Ilmoitus näkyy rajattomasti, jos Timeout on 0.
Esimerkkejä
Vaihe vaiheelta
Lisää Button-ohjausobjekti näyttöön.
Määritä Button-ohjausobjektin OnSelect-ominaisuudeksi tämä kaava:
Notify( "Hello, World" )Napsauta tai paina painiketta.
Aina kun painiketta napsautetaan, käyttäjä näkee sanoman Hei maailma tietona. Se hylätään automaattisesti 10 sekunnin kuluttua (aikakatkaisun oletus), jos käyttäjä ei hylkää sitä tai painaa painiketta uudelleen.
Muuta sanoman tyyppi ilmoittamaan virheestä. Lisää toinen argumentti kaavaan:
Notify( "Hello, World", NotificationType.Error )Napsauta tai paina painiketta.
Aina kun painiketta napsautetaan, käyttäjä näkee nyt sanoman Hei maailma virheenä. Se hylätään automaattisesti 10 sekunnin kuluttua (aikakatkaisun oletus), jos käyttäjä ei hylkää sitä tai painaa painiketta uudelleen.
Muuta sanoman tyyppi antamaan varoituksen. Muuta toista argumenttia kaavassa:
Notify( "Hello, World", NotificationType.Warning, 4000 )Napsauta tai paina painiketta.
Aina kun painiketta napsautetaan, käyttäjä näkee nyt sanoman Hei maailma varoituksena. Se hylätään automaattisesti 4 sekunnin (4 000 millisekunnin) kuluttua, jos käyttäjä ei hylkää sitä tai painaa painiketta uudelleen.
Muuta sanoman tyyppi ilmoittamaan onnistumisesta. Muuta toista argumenttia kaavassa:
Notify( "Hello, World", NotificationType.Success, 0 )Napsauta tai paina painiketta.
Aina kun painiketta napsautetaan, käyttäjä näkee nyt sanoman Hei maailma onnistumisena. Kun aikakatkaisu on 0, ilmoitus hylätään vain käyttäjän toimesta tai painamalla painiketta uudelleen.
