Funkcijos Blank, Coalesce, IsBlank ir IsEmpty
Taikoma:
Drobės programos Darbalaukio srautų Dataverse formulės stulpeliai Modeliu pagrįstos programos Power Pages Power Platform CLI
Patikrina, ar reikšmė yra tuščia, arba, ar lentelėje nėra jokių įrašų, ir suteikia būdą kurti tuščias reikšmes.
Apžvalga
Tuščia yra vietos rezervavimo ženklas, skirtas "nėra reikšmės" arba "nežinoma reikšmė". Pavyzdžiui, pasirinktinio įvedimo lauko valdiklio ypatybė Pasirinkta yra tuščia, jei vartotojas nepasirinko. Daug duomenų šaltinių gali išsaugoti ir pateikti NULINES reikšmes, kurios programoje „Power Apps“ rodomos kaip tuščios.
Tuščia gali būti bet kuri „Power Apps“ ypatybė ar apskaičiuotoji reikšmė. Pavyzdžiui, Bulio logikos reikšmė paprastai turi vieną iš dviejų reikšmių: true arba false. Tačiau, be šių dviejų, ji taip pat gali būti tuščia – tai nurodo, kad būsena yra nežinoma. Tai yra panašu į „Microsoft Excel“, kai darbalapio langelis iš pradžių yra tuščias, be turinio, tačiau jame gali būti reikšmės TRUE arba FALSE (ir kitų). Bet kuriuo metu langelio turinį galima dar kartą išvalyti, grąžinant jo tuščią būseną.
Tuščia eilutė reiškia eilutę, kurioje nėra simbolių. Funkcija Len tokią eilutę pateikia kaip nulį ir ji formulėse gali būti parašyta kaip dvi dvigubos kabutės, tarp kurių nieko nėra "". Kai kurie valdikliai ir duomenų šaltiniai tuščią eilutę naudoja, kad nurodytų sąlygą „reikšmės nėra“. Kad programų kūrimas būtų paprastesnis, funkcijos IsBlank ir Coalesce tikrina ieškodamos tiek tuščių reikšmių, tiek tuščių eilučių.
Funkcijos IsEmpty kontekste tuščia reikšmė būdinga lentelėms, kuriuose nėra įrašų. Lentelės struktūra gali būti nepakeista, užpildyta stulpelių pavadinimais, tačiau joje nėra duomenų. Lentelė iš pradžių gali būti tuščia, joje gali atsirasti įrašų (tada ji nebėra tuščia), o tada įrašai gali būti pašalinami ir lentelė vėl būna tuščia.
Pastaba.
Esame pereinamajame laikotarpyje. Iki šiol tuščia reikšmė taip pat naudota norint pranešti apie klaidas, todėl buvo neįmanoma tikros būsenos „nėra reikšmės“ atskirti nuo klaidos. Todėl šiuo metu tuščias reikšmes galima saugoti tik vietiniuose rinkiniuose. Galite laikyti tuščias reikšmes kituose duomenų šaltiniuose, jei įjungėte Formulės lygio klaidos valdymo eksperimentinę funkciją Nuostatos>Būsimos funkcijos>Eksperimentinės. Aktyviai dirbame, kad baigtume šią funkciją ir tuščias reikšmes visiškai atskirtume nuo klaidų.
Tuščias
Taikoma: Drobės programoms Modeliu pagrįstų programų Dataverse formulių stulpeliai
Funkcija Blank pateikia tuščią reikšmę. Naudodami šią funkciją, NULINĘ reikšmę galite saugoti duomenų šaltinyje, palaikančiame šias reikšmes, taip pašalindami bet kurią lauko reikšmę.
IsBlank
Taikoma: drobės programoms Modeliu pagrįstoms programoms
Funkcija IsBlank tikrindama ieško tuščios reikšmės arba tuščios eilutės. Į patikrą įtraukiamos tuščios eilutės, kad programų kūrimas būtų paprastesnis, nes, kai nėra reikšmės, kai kurie duomenų šaltiniai ir valdikliai naudoja tuščią eilutę. Jei norite tikrindami ieškoti konkrečiai tuščios reikšmės, vietoj IsBlank naudokite if( Value = Blank(), .... Funkcija IsBlank tuščias lenteles laiko ne tuščiomis, o IsEmpty turėtų būti naudojama lentelei tikrinti.
Įjungiant klaidos valdymą esančioms programoms, apgalvokite pakeist IsBlank su IsBlankOrError Įjungiant klaidos valdymą esančioms programoms, apgalvokite pakeisti. Prieš pridedant klaidų apdorojimo, tuščia reikšmė buvo naudojama tiek neapibrėžtoms reikšmėms iš duomenų bazių, tiek klaidų reikšmėms atvaizduoti. Klaidų apdorojimas atskiria šias dvi tuščios interpretacijas, kurios gali pakeisti esamų programų, kurios ir toliau naudoja IsBlank veikimą.
Pateikiama reikšmė yra IsBlank boolean teisinga ar klaidinga.
Coalesce
Taikoma: drobės programoms Modeliu pagrįstoms programoms
Funkcija Coalesce eilės tvarka įvertina savo argumentus ir pateikia pirmąją reikšmę, kuri nėra tuščia ar tuščia eilutė. Šią funkciją naudokite, jei tuščią reikšmę arba tuščią eilutę norite pakeisti kita reikšme, bet ne tuščias ir ne tuščių eilučių reikšmes palikti nepakeistas. Jei visi argumentai yra tuščios arba tuščios eilutės, funkcija grąžina tuščią, todėl Coalesce yra geras būdas konvertuoti tuščias eilutes į tuščias reikšmes.
Coalesce( value1, value2 ) yra glaustesnis atitikmuo If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) ir nereikalauja , kad reikšmė1 ir reikšmė2 būtų vertinamos du kartus. Jei nėra „else“ formulės (kaip šiuo atveju), funkcija If pateikia tuščią reikšmę.
Visi Coalesce argumentai turi būti tokio paties tipo; pavyzdžiui, negalite maišyti skaičių su teksto eilutėmis. Coalesce grąžinama vertė yra šio bendro tipo.
IsEmpty
Taikoma: drobės programoms Modeliu pagrįstoms programoms
Funkcija IsEmpty tikrina, ar lentelėje yra įrašų. Jos rezultatas toks pats, kaip naudojant funkciją CountRows ir tikrinant ieškant nulio. Ieškoti duomenų šaltinio klaidų galite IsEmpty sujungdami su funkcija Errors.
Pateikiama reikšmė yra IsEmpty Boolean teisinga ar klaidinga.
Sintaksė
Tuščias()
Coalesce( Reikšmė1 [, Reikšmė2, ... ] )
- Vertybės – būtina. Reikšmės, kurias reikia patikrinti. Eilės tvarka vertinama kiekviena reikšmė, kol randama reikšmė, kuri nėra tuščia ir nėra tuščia eilutė. Po šio momento reikšmės nevertinamos.
IsBlank( reikšmė )
- reikšmė – būtina. Reikšmė, kurią reikia patikrinti, ar ji nėra tuščia ir ar nėra tuščia eilutė.
IsEmpty( lentelė )
- Lentelė - būtina. Lentelė, kurią reikia tikrinti ieškant įrašų.
Pavyzdžiai
Tuščias
Pastaba.
Šiuo metu toliau pateikiamas pavyzdys yra tinkamas tik vietinių rinkinių atveju. Galite laikyti tuščias reikšmes kituose duomenų šaltiniuose, jei įjungėte Formulės lygio klaidos valdymo eksperimentinę funkciją Nuostatos>Būsimos funkcijos>Eksperimentinės. Aktyviai dirbame, kad baigtume šią funkciją ir tuščias reikšmes visiškai atskirtume nuo klaidų.
Sukurkite programą nuo nulio ir įtraukite mygtuko valdiklį.
Mygtuko ypatybę OnSelect nustatykite kaip šią formulę:
ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )Peržiūrėkite programą, spustelėkite arba bakstelėkite įtrauktą mygtuką, tada uždarykite peržiūrą.
Meniu Failas spustelėkite arba bakstelėkite Rinkiniai.
Rodomas rinkinys Miestai, kuriame pateikiamas vienas įrašas su „Sietlas“ ir „Lietingas“:
Spustelėkite arba bakstelėkite rodyklę atgal, kad grįžtumėte į numatytąją darbo sritį.
Įtraukite žymos valdiklį ir jo ypatybę Text nustatykite kaip šią formulę:
IsBlank( First( Cities ).Weather )Žymoje rodoma false, nes lauke Oras yra reikšmė („Lietingas“).
Įtraukite antrą mygtuką ir jo ypatybę OnSelect nustatykite kaip šią formulę:
Patch( Cities, First( Cities ), { Weather: Blank() } )Peržiūrėkite programą, spustelėkite arba bakstelėkite įtrauktą mygtuką, tada uždarykite peržiūrą.
Pirmojo Miestai įrašo laukas Oras pakeičiamas tuščia reikšme, pašalinant anksčiau buvusią reikšmę „Lietingas“.
Žymoje rodoma true, nes lauke Oras reikšmės nebėra.
Coalesce
| Formulė | Aprašas | Rezultatas |
|---|---|---|
| Susiliejimas( tuščias(), 1 ) | Patikrina funkcijos Blank pateikiamą reikšmę, kuri visada yra tuščia. Kadangi pirmasis argumentas yra tuščias, toliau vertinimas kitas argumentas, kol randama ne tuščia reikšmė ir ne tuščia eilutė. | 1 |
| Susiliejimas( "", "2" ) | Patikrina pirmąjį argumentą, kuris yra tuščia eilutė. Kadangi pirmasis argumentas yra tuščia eilutė, toliau vertinimas kitas argumentas, kol randama ne tuščia reikšmė ir ne tuščia eilutė. | 2 |
| Susiliejimas( Blank(), "", Blank(), "", "3", "4" ) | Sujungimas prasideda argumentų sąrašo pradžioje ir įvertina kiekvieną argumentą paeiliui, kol randama ne tuščia reikšmė ir ne tuščia eilutė. Šiuo atveju pirmieji keturi argumentai pateikia tuščią reikšmę arba tuščią eilutę, todėl toliau vertinamas penktasis argumentas. Penktasis argumentas nėra tuščias ir nėra tuščia eilutė, todėl įvertinimas sustabdomas čia. Pateikiama penktojo argumento reikšmė, o šeštasis argumentas nevertinamas. | 3 |
| Susiliejimas( "" ) | Patikrina pirmąjį argumentą, kuris yra tuščia eilutė. Kadangi pirmasis argumentas yra tuščia eilutė ir daugiau argumentų nėra, funkcija pateikia tuščią reikšmę. | Tuščią |
IsBlank
Sukurkite programą nuo nulio, įtraukite teksto įvesties valdiklį ir jį pavadinkite FirstName.
Įtraukite žymą ir jos ypatybę Tekstas nustatykite kaip šią formulę:
If( IsBlank( FirstName.Text ), "First Name is a required field." )Numatyta, kad teksto įvesties valdiklio ypatybė Tekstas yra nustatyta kaip „Teksto įvestis“. Kadangi ypatybėje yra reikšmė, ji nėra tuščia ir žymoje nerodomas joks pranešimas.
Iš teksto įvesties valdiklio pašalinkite visus simbolius, įskaitant visus tarpus.
Kadangi ypatybėje Tekstas simbolių nebėra, ji yra tuščia eilutė ir IsBlank( FirstName.Text ) bus true. Rodomas būtino lauko pranešimas.
Norėdami gauti informacijos apie tai, kaip tikrinti naudojant kitus įrankius, žr. straipsnį apie funkciją Validate ir darbą su duomenų šaltiniais.
Kiti pavyzdžiai:
| Formulė | Aprašas | Rezultatas |
|---|---|---|
| IsBlank( Blank() ) | Patikrina funkcijos Blank pateikiamą reikšmę, kuri visada yra tuščia. | Tiesa |
| IsBlank( "" ) | Eilutė, kurioje nėra simbolių. | Tiesa |
| IsBlank( "Labas" ) | Eilutė, kurioje yra vienas arba daugiau simbolių. | klaidinga |
| IsBlank( AnyCollection ) | Kadangi rinkinys yra, jis nėra tuščias, net jei jame nėra jokių įrašų. Jei norite patikrinti, ar yra tuščias rinkinys, naudokite IsEmpty. | klaidinga |
| IsBlank( Mid( "Labas", 17, 2 ) ) | Pradinis Mid simbolis yra už eilutės pabaigos ribos. Rezultatas yra tuščia eilutė. | Tiesa |
| IsBlank( If( klaidingas, klaidingas ) ) | Funkcija If be ElseResult. Kadangi sąlyga visada yra klaidinga, ši If visada pateikia tuščią reikšmę. | Tiesa |
IsEmpty
Sukurkite programą nuo nulio ir įtraukite mygtuko valdiklį.
Mygtuko ypatybę OnSelect nustatykite kaip šią formulę:
Surinkti( Ledai,Skonis { : "Braškė", Kiekis: 300,Skonis } { : "Šokoladas", Kiekis: 100 } )
Peržiūrėkite programą, spustelėkite arba bakstelėkite įtrauktą mygtuką, tada uždarykite peržiūrą.
Sukuriamas rinkinys pavadinimu Ledai ir jame yra šie duomenys:
Šiame rinkinyje yra du įrašai ir jis nėra tuščias. IsEmpty( IceCream ) grąžina false, o CountRows( IceCream ) grąžina 2.
Įtraukite antrą mygtuką ir jo ypatybę OnSelect nustatykite kaip šią formulę:
Skaidrus( IceCream )
Peržiūrėkite programą, spustelėkite arba bakstelėkite antrąjį mygtuką, tada uždarykite peržiūrą.
Dabar rinkinys tuščias:
Funkcija Clear pašalina visus rinkinio įrašus, todėl rinkinys tampa tuščias. IsEmpty( IceCream ) grąžina true, o CountRows( IceCream ) grąžina 0.
IsEmpty taip pat galite naudoti norėdami patikrinti, ar apskaičiuotoji lentelė yra tuščia, kaip parodyta šiuose pavyzdžiuose:
| Formulė | Aprašas | Rezultatas |
|---|---|---|
| IsEmpty( [ 1, 2, 3 ] ) | Vieno stulpelio lentelėje yra trys įrašai, todėl ji nėra tuščia. | klaidinga |
| IsEmpty( [ ] ) | Vieno stulpelio lentelėje įrašų nėra, todėl ji yra tuščia. | Tiesa |
| IsEmpty( filtras( [ [ 1, 2, 3 ], reikšmė > 5 ) ) | Vieno stulpelio lentelėje nėra reikšmių, didesnių nei 5. Filtro rezultate nėra jokių įrašų, todėl jis tuščias. | Tiesa |