Blank, Coalesce, IsBlankja IsEmpty funktsioonid

Funktsioone	Kehtib järgmiste puhul
Blank	Canvas apps Copilot Studio Desktop flows Dataverse formula columns Model-driven apps Power Platform CLI Dataverse functions
Coalesce IsEmpty	Lõuendirakendused Copilot Studio töölauavood Mudelipõhised rakendused Power Platform CLI Dataverse funktsioonid Power Pages
IsBlank	Lõuendirakendused Copilot Studio töölauavood Dataverse formula columns Mudelipõhised rakendused Power Platform CLI Dataverse functions Power Pages

Kontrollib, kas väärtus on tühi või tabel ei sisalda kirjeid, ja võimaldab luua väärtusi tühi.

Ülevaade

Blank on "väärtuseta" või "tundmatu väärtuse" kohatäide. Näiteks liitboksi juhtelemendi atribuut Selected on tühi , kui kasutaja pole valikut teinud. Paljud andmeallikad saavad salvestada ja tagastada NULL-väärtusi, mis on tähistatud Power Appsis kui tühi.

Suvaline atribuut või arvutatud väärtus Power Apps võib olla tühi. Näiteks on loogikaväärtusel tavaliselt üks kahest väärtusest: tõene või väär. Kuid lisaks nendele kahele võib see olla tühi , mis näitab, et osariik pole teada. See on sarnane Microsoft Exceliga, kus töölehe lahter käivitub ilma sisuta, tühjana, kuid võib mahutada väärtusi tõene või väär (muuhulgas). Lahtri sisu saab igal ajal uuesti tühjendada, tagastades selle tühjale olekule.

Tühi string viitab stringile, mis ei sisalda märke. Funktsioon Len tagastab sellise stringi jaoks nulli ja seda saab valemites kirjutada kahe kahekordse jutumärgina, mille vahel pole midagi "". Teatud juhtelemendid ja andmeallikad kasutavad tühja stringi, mis näitab, et väärtust pole. Rakenduste loomise lihtsustamiseks testivad IsBlank ja Coalesce funktsioonid nii tühjade väärtuste kui ka tühjade stringide jaoks.

Funktsiooni kontekstis IsEmpty on tühi väärtus seotud tabelitega, mis ei sisalda kirjeid. Tabeli struktuur võib olla terve, koos veergude nimedega, kuid tabelis pole andmeid. Tabel võib alata tühjana, võtta kirjeid ja mitte enam olla tühi ning seejärel eemaldada kirjed ja need uuesti tühjendada.

Blank

Funktsioon Blank tagastab tühja väärtuse. Selle abil saate talletada NULL-väärtuse andmeallikas, mis toetab neid väärtusi, eemaldades tegelikult kõik väärtused väljalt.

IsBlank

Funktsioon IsBlank testib tühja väärtust või tühja stringi. Test sisaldab rakenduse loomise hõlbustamiseks tühje stringe, kuna mõned andmeallikad ja juhtelemendid kasutavad tühja stringi, kui väärtust pole. Konkreetse tühja väärtuse testimiseks kasutage if(Value = Blank(), ... funktsiooni asemel IsBlank. Funktsioon IsBlank peab tühje tabeleid mitte tühjaks ja IsEmpty seda tuleks kasutada tabeli testimiseks.

Olemasolevate rakenduste tõrketöötluse lubamisel kaaluge olemasoleva rakenduse käitumise säilitamiseks asendamist IsBlank funktsiooniga IsBlankOrError . Enne tõrkekäsitluse kasutamist kasutati tühi väärtust, et tähistada nii andmebaasi nullväärtusi kui ka tõrkeväärtusi. Tõrketöötlus eraldab need kaks tühja tõlgendust, mis võivad muuta olemasolevate rakenduste käitumist, mis jätkavad kasutamist IsBlank.

Tagastatav väärtus IsBlank on loogikaväärtus (tõene või väär).

Coalesce

Funktsioon Coalesce hindab argumente järjest ja tagastab esimese väärtuse, mis pole tühi ega tühi string. Selle funktsiooni abil saate asendada tühja väärtuse või tühja stringi teistsuguse väärtusega, kuid jätke mitte-tühjad väärtused ja mittetühjad stringid muutmata. Kui kõik argumendid on tühjad või tühjad stringid, tagastab funktsioon tühja väärtuse, võimaldades Coalesce tühjad stringid teisendada tühjadeks väärtusteks.

Coalesce( value1, value2 ) on kokkuvõtlikum ekvivalent If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) ja ei nõua väärtust1 ja väärtus2 kahekordset hindamist. Kui siin pole valemit "else", tagastab funktsioon Iftühja väärtuse.

Kõik argumendid Coalesce peavad olema sama tüüpi ( näiteks ei saa arve tekstistringidega segada). Tagastatav väärtus Coalesce on seda tüüpi.

IsEmpty

Funktsioon IsEmpty kontrollib, kas tabel sisaldab kirjeid. See on samaväärne funktsiooni CountRows kasutamisega ja nulliga kontrollimisega. Andmeallikatõrgete otsimiseks kombineerige IsEmpty see funktsiooniga Errors .

Tagastatav väärtus IsEmpty on kahendmuutuja tõene või väär.

Süntaks

Blank()

Coalesce( Väärtus1 [, väärtus2; ... ] )

• Väärtused – nõutav. Väärtused testimiseks. Iga väärtust väärtustatakse järjekorras, kuni leitakse väärtus, mis pole tühi ja mitte tühi string. Sellele punktile järgnevaid väärtusi ei hinnata.

IsBlank( Väärtus )

• Väärtus – nõutav. Väärtus, mis testib väärtuse tühi või tühja stringi oemasolu.

IsEmpty( Tabel )

• Tabel - nõutav. Tabel kirjete testimiseks.

Näited

Blank

1. Looge rakendus nullist ja lisage juhtelement Nupp.

2. Määrake nupu atribuut OnSelect järgmisele valemile.

   ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
   

3. Rakenduse eelvaate kuvamiseks klõpsake või koputage lisatud nuppu ja siis sulgege eelvaade.

4. Menüüs Fail klõpsake või koputage valikut Kogumikud.

   Kuvatakse kogumik Linnad, kus on kuvatud üks kirje sõnadega "Seattle" ja "vihmane".

   

5. Klõpsake või koputage tagasinoolt, et naasta vaiketööruumi.

6. Lisage juhtelement silt ja seadke selle atribuudiks Tekst see valem:

   IsBlank( First( Cities ).Weather )
   

   Silt kuvab väärtust väär, sest väli Ilm sisaldab väärtust ("vihmane").

7. Lisage teine nupp ja seadke selle väärtuseks OnSelect see valem:

   Patch( Cities, First( Cities ), { Weather: Blank() } )
   

8. Rakenduse eelvaate kuvamiseks klõpsake või koputage lisatud nuppu ja siis sulgege eelvaade.

   Esimese kirje väli Ilm kogumikus Linnad asendatakse väärtusega tühi, eemaldades sealt eelneva väärtuse "vihmane".

   

   Silt kuvab väärtust tõene, sest väli Ilm ei sisalda enam väärtust.

Coalesce

Valem	Kirjeldus	Tulem
Coalesce( Blank(), 1 )	Testib funktsiooni tagastatud Blank väärtust, mis tagastab alati tühja väärtuse. Kuna esimene argument on tühi, jätkub hindamine järgmise argumendiga, kuni leitakse väärtus mitte-tühi mittetühi string.	1
Coalesce( "", "2" )	Testib esimest argumenti, mis on tühi string. Kuna esimene argument on tühi string, jätkub hindamine järgmise argumendiga, kuni leitakse väärtus mitte-tühi ja mittetühi string.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesce algab argumendiloendi algusest ja hindab iga argumenti omakorda, kuni leitakse mittetühja väärtus ja mittetühja string. Sellisel juhul esimesed neli argumenti tagastavad väärtuse tühi või tühja stringi, seega hindamine läheb edasi viiendale argumendile. Viies argument on mitte-tühi ja mittetühi string, seega siinne hindamine peatub siin. Tagastatakse viienda argumendi väärtus ja kuuendat argumenti ei hinnata.	3
Coalesce( "" )	Testib esimest argumenti, mis on tühi string. Kuna esimene argument on tühi string ja rohkem argumente pole, tagastab funktsioon väärtuse tühi.	tühi

IsBlank

1. Looge nullist mõni rakendus, lisage juhtelement tekstisisend ja pange nimeks FirstName.

2. Lisage silt ja määrake atribuut Text järgmisele valemile.

   If( IsBlank( FirstName.Text ), "First Name is a required field." )
   

   Vaikimisi on juhtelemendi tekstisisendi atribuut Text seatud väärtusele tekstisisend. Kuna atribuut sisaldab väärtust, pole see tühi ja silt ei kuva ühtegi teadet.

3. Eemaldage juhtelemendilt tekstisisend kõik tähemärgid, sh kõik tühikud.

   Kuna atribuut Text (Tekst ) ei sisalda enam märke, on see tühi string ja IsBlank( FirstName.Text) on tõene. Kuvatakse nõutava välja sõnum.

Muude tööriistade abil valideerimise teostamise kohta vt Validate funktsioon ja töö andmeallikatega.

Muud näited:

Valem	Kirjeldus	Tulem
IsBlank( Blank) )	Testib funktsiooni tagastatud Blank väärtust, mis tagastab alati tühja väärtuse.	Tõsi
IsBlank( "" )	String, mis ei sisalda tähemärke.	Tõsi
IsBlank( "Tere" )	String, mis sisaldab ühte või mitut tähemärki.	väär
IsBlank( AnyCollection )	Kuna kogum on olemas, pole see tühi, isegi kui see ei sisalda kirjeid. Tühja kogumiku otsimiseks kasutage IsEmpty hoopis seda.	väär
IsBlank( Mid( "Hello", 17, 2 ) )	Midi algustäht on väljaspool stringi lõppu. Tulemuseks tühi string.	Tõsi
IsBlank( If( false, false ) )	Funktsioon If ilma ElseResultita. Kuna tingimus on alati väär, siis If tagastab alati väärtuse tühi.	Tõsi

IsEmpty

1. Looge rakendus nullist ja lisage juhtelement Nupp.

2. Määrake nupu atribuut OnSelect järgmisele valemile.

   Collect( IceCream, {Flavor: "Strawberry", Quantity: 300}, {Flavor: "Chocolate", Quantity: 100} )

3. Rakenduse eelvaate kuvamiseks klõpsake või koputage lisatud nuppu ja siis sulgege eelvaade.

   Luuakse kogumik nimega IceCream, mis sisaldab järgmisi andmeid:

   

   See kollektsioon sisaldab kahte kirjet ja pole tühi. IsEmpty( IceCream ) tagastab väärtuse false ja CountRows( IceCream ) väärtuse 2.

4. Lisage teine nupp ja seadke selle atribuudiks OnSelect see valem:

   Clear( IceCream )

5. Rakenduse eelvaate kuvamiseks klõpsake või koputage teist nuppu ja siis sulgege eelvaade.

   Kogumik on nüüd tühi.

   

   Funktsioonid Clear eemaldab kogumikust kõik kirjed, mille tulemiks on tühi kogumik. IsEmpty( IceCream ) tagastab väärtuse true ja CountRows( IceCream ) tagastab väärtuse 0.

Samuti saate kontrollida IsEmpty , kas arvutatud tabel on tühi, nagu need näited näitavad.

Valem	Kirjeldus	Tulem
IsEmpty( [ 1, 2, 3 ] )	Ühe veeruga tabel sisaldab kolme kirjet ja seetõttu pole see tühi.	väär
IsEmpty( [ ] )	Ühe veeruga tabel ei sisalda ühtki kirjet ja seetõttu on tühi.	Tõsi
IsEmpty( Filter( [ 1, 2, 3 ], väärtus > 5 ) )	Ühe veeruga tabel ei sisalda väärtusi, mis on suuremad kui 5. Filtri tulem ei sisalda kirjeid ja on tühi.	Tõsi