Blank, Coalesce, IsBlank, a IsEmpty funkcie

Funkcie	Vzťahuje sa na
Blank	Aplikácie plátna Copilot Studio Desktop postupy dataverse vzorca stĺpce Modelom riadené aplikácie Power Platform CLI Dataverse funkcie
Coalesce IsEmpty	Aplikácie plátna Copilot Studio Desktop postupy modelom riadené aplikácie Power Platform CLI Dataverse funkcie Power Pages
IsBlank	Aplikácie plátna Copilot Studio Desktop – postupy vzorcov Dataverse stĺpce Modelom riadené aplikácie Power Platform CLI Dataverse funkcie Power Pages

Testuje, či je hodnota prázdna alebo či tabuľka neobsahuje žiadne záznamy a umožňuje vytvárať prázdne hodnoty.

Prehľad

Blankje zástupným symbolom pre "žiadnu hodnotu" alebo "neznámu hodnotu". Napríklad vlastnosť Selected ovládacieho prvku Rozbaľovacie pole je prázdna, ak používateľ nevybral možnosť. Mnohé zdroje údajov môžu ukladať a vracať hodnoty NULL, ktoré sú v službe Power Apps zastúpené ako prázdne.

Akákoľvek vlastnosť alebo vypočítaná hodnota v Power Apps môže byť prázdna. Napríklad logická hodnota obsahuje za normálnych okolností jednu z dvoch hodnôt: pravda alebo nepravda. Okrem týchto dvoch možností však môže byť aj prázdna hodnota, ktorá označuje, že stav nie je známy. Je to podobné ako v programe Microsoft Excel, kde bunka hárka je najskôr prázdna bez obsah, ale môže mať, okrem iných, aj hodnoty PRAVDA alebo NEPRAVDA. Obsah bunky sa dá kedykoľvek znova vymazať a tým sa obnoví jej prázdny stav.

Prázdny reťazec označuje reťazec, ktorý neobsahuje žiadne znaky. Funkcia Len vráti nulu pre taký reťazec a dá sa zapísať do vzorcov ako dve dvojité úvodzovky bez toho, aby medzi nimi bolo niečo "". Niektoré ovládacie prvky a zdroje údajov používajú prázdny reťazec na označenie stavu „žiadna hodnota“. Ak chcete zjednodušiť vytváranie aplikácie, IsBlank funkcie a Coalesce testujú prázdne hodnoty aj prázdne reťazce.

V kontexte funkcie je prázdna IsEmpty hodnota špecifická pre tabuľky, ktoré neobsahujú žiadne záznamy. Štruktúra tabuľky môže byť neporušená, môže obsahovať názvy stĺpcov, ale nebudú v nej žiadne údaje. Tabuľka môže byť na začiatku prázdna, po vložení záznamov už prázdna nebude a keď sa z nej záznamy odoberú, stane sa opäť prázdnou.

Blank

Funkcia Blank vráti prázdnu hodnotu. Používa sa na ukladanie hodnoty NULL do zdroja údajov podporujúceho tieto hodnoty, čím sa z daného poľa odstránia všetky hodnoty.

IsBlank

Funkcia IsBlank testuje, či je hodnota prázdna alebo prázdny reťazec. Test zahŕňa prázdne reťazce na zjednodušenie vytvárania aplikácie, pretože niektoré zdroje údajov a ovládacie prvky používajú prázdny reťazec, keď nie je prítomná žiadna hodnota. Ak chcete testovať konkrétne pre použitie if(Value = Blank(), ...prázdnej hodnoty namiesto hodnoty IsBlank. Funkcia IsBlank považuje prázdne tabuľky za prázdne a IsEmpty mala by sa použiť na testovanie tabuľky.

Pri povoľovaní spracovania chýb v existujúcich aplikáciách zvážte nahradenie IsBlank funkciou IsBlankOrError , aby ste zachovali správanie existujúcej aplikácie. Pred pridaním spracovania chýb sa používala prázdna hodnota bola použitá na vyjadrenie nulových hodnôt z databáz aj chybových hodnôt. Spracovanie chýb oddeľuje tieto dva interpretácie typu blank, čo by mohlo zmeniť správanie existujúcich aplikácií, ktoré budú naďalej používať IsBlank.

Vrátená hodnota pre IsBlank je booleovská hodnota true alebo false.

Coalesce

Funkcia Coalesce vyhodnotí svoje argumenty po poradí a vráti prvú hodnotu, ktorá nie je prázdna , alebo prázdny reťazec. Túto funkciu použite na nahradenie prázdnej hodnoty alebo prázdneho reťazca s inou hodnotou, ale neprázdne hodnoty a hodnoty bez reťazcov zostanú nezmenené. Ak sú všetky argumenty prázdne alebo prázdne reťazce, funkcia vráti prázdnu hodnotu, čo Coalesce predstavuje dobrý spôsob, ako skonvertovať prázdne reťazce na prázdne hodnoty.

Coalesce( value1, value2 ) je výstižnejším ekvivalentom If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) a nevyžaduje hodnota1 a hodnota2 na byť hodnotené dvakrát. Funkcia If vráti prázdnu hodnotu, ak neexistuje žiadny vzorec "else", ako je to v tomto prípade.

Všetky argumenty musia Coalesce byť rovnakého typu. Nemôžete napríklad kombinovať čísla s textovými reťazcami. Vrátená hodnota je Coalesce tohto bežného typu.

IsEmpty

Funkcia IsEmpty testuje, či tabuľka obsahuje nejaké záznamy. Je ekvivalentom používania funkcie CountRows a kontroly nuly. Kombináciou IsEmpty funkcie Errors môžete skontrolovať chyby zdroja údajov.

Vrátená hodnota pre IsEmpty je booleovská hodnota true alebo false.

Syntax

Blank()

Coalesce( Hodnota1 [, Hodnota2, ... ] )

• Hodnoty – povinné. Hodnoty, ktoré sa majú testovať. Každá hodnota sa vyhodnotí poradovo, až kým sa nenájde hodnota, ktorá nie je prázdna a nenájde sa prázdny reťazec. Hodnoty po tomto bode sa nevyhodnocujú.

IsBlank( Hodnota )

• Hodnota – povinné. Hodnota na testovanie na prázdnu hodnotu alebo prázdny reťazec.

IsEmpty( Tabuľka )

• Tabuľka – povinné. Tabuľka, v ktorej sa majú testovať záznamy.

Príklady

Blank

1. Vytvorte úplne novú aplikáciu a pridajte ovládací prvok Tlačidlo.

2. Vlastnosť tlačidla OnSelect nastavte na tento vzorec:

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

3. Zobrazte ukážku aplikácie, kliknite alebo ťuknite na pridané tlačidlo a potom ukážku zatvorte.

4. V ponuke Súbor kliknite alebo ťuknite na položku Kolekcie.

   Zobrazí sa kolekcia Cities (Mestá), a bude zobrazovať jeden záznam s hodnotami „Seattle“ a „Rainy“ (Daždivo):

   

5. Kliknutím alebo ťuknutím na šípku späť sa vráťte do predvoleného pracovného priestoru.

6. Pridajte ovládací prvok Označenie a jeho vlastnosť Text nastavte na tento vzorec:

   IsBlank( First( Cities ).Weather )
   

   Označenie má hodnotu nepravda, pretože pole Weather (Počasie) obsahuje hodnotu („Rainy“ (Daždivo)).

7. Pridajte druhé tlačidlo a jeho vlastnosť OnSelect nastavte na tento vzorec:

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

8. Zobrazte ukážku aplikácie, kliknite alebo ťuknite na pridané tlačidlo a potom ukážku zatvorte.

   Pole Weather prvého záznamu v kolekcii Cities je nahradené prázdnou hodnotou a hodnota „Rainy“, ktorá tam bola predtým, je odstránená.

   

   Označenie zobrazuje pravda, pretože pole Weather už neobsahuje hodnotu.

Coalesce

Vzorec	Popis	Výsledok
Coalesce( Blank(), 1 )	Testuje vrátenú hodnotu z Blank funkcie, ktorá vždy vráti prázdnu hodnotu. Keďže prvý argument je prázdny, vyhodnocovanie pokračuje ďalším argumentom, až kým sa nenájde hodnota, ktorá nie je prázdna a neprázdny reťazec.	1
Coalesce( "", "2" )	Otestuje prvý argument, ktorým je prázdny reťazec. Keďže prvý argument je prázdny reťazec, vyhodnocovanie pokračuje ďalším argumentom, až kým sa nenájde hodnota, ktorá nie je prázdna a neprázdny reťazec.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesce začína na začiatku zoznamu argumentov a vyhodnocuje každý argument, až kým sa nenájde hodnota, ktorá nie je prázdna , a reťazec, ktorý nie je prázdny. V tomto prípade prvé štyri argumenty vrátili prázdne hodnoty alebo prázdny reťazec, takže vyhodnocovanie pokračuje piatym argumentom. Piaty argument nie je prázdny a neprázdny reťazec, takže hodnotenie tu končí. Hodnota piateho argumentu sa vráti a šiesty argument sa nevyhodnocuje.	3
Coalesce( "" )	Otestuje prvý argument, ktorým je prázdny reťazec. Pretože prvý argument je prázdny reťazec a už neexistujú žiadne ďalšie argumenty, funkcia vráti prázdnu hodnotu.	prázdna

IsBlank

1. Vytvorte úplne novú aplikáciu, pridajte ovládací prvok zadávanie textu a pomenujte ho FirstName.

2. Pridajte označenie a do jeho vlastnosti Text zadajte tento vzorec:

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

   Podľa predvoleného nastavenia je vlastnosť Text ovládacieho prvku zadávania textu nastavená na hodnotu "Text input". Keďže vlastnosť obsahuje hodnotu, nie je prázdna. Označenie nezobrazí žiadnu správu.

3. Odstráňte z ovládacieho prvku zadávanie textu všetky znaky vrátane medzier.

   Keďže vlastnosť Text už neobsahuje žiadne znaky, je to prázdny reťazec a IsBlank( FirstName.Text ) má hodnotu true. Zobrazí sa správa, že pole je povinné.

Informácie o tom, ako vykonať overenie pomocou iných nástrojov nájdete článkoch o funkcii Validate a o práci so zdrojmi údajov.

Ďalšie príklady:

Vzorec	Popis	Výsledok
IsBlankTento článok sa uvádza v článku 2 Blankod 19.	Testuje vrátenú hodnotu z Blank funkcie, ktorá vždy vráti prázdnu hodnotu.	pravda
IsBlank( "" )	Reťazec, ktorý neobsahuje žiadne znaky.	pravda
IsBlank( "Hello" )	Reťazec, ktorý obsahuje jeden alebo viac znakov.	falošné
IsBlank( AnyCollection )	Keďže kolekcia existuje, nie je prázdna, dokonca ani v prípade, že neobsahuje žiadne záznamy. Ak chcete skontrolovať, či je kolekcia prázdna, použite IsEmpty metódu namiesto toho.	falošné
IsBlank( Mid( "Hello", 17, 2 ) )	Počiatočný znak pre funkciu Mid je za koncom reťazca. Výsledkom je prázdny reťazec.	pravda
IsBlank( If( false, false ) )	Funkcia If bez hodnoty ElseResult. Keďže podmienka má vždy hodnotu nepravda, funkcia If vráti vždy prázdnu hodnotu.	pravda

IsEmpty

1. Vytvorte úplne novú aplikáciu a pridajte ovládací prvok Tlačidlo.

2. Vlastnosť tlačidla OnSelect nastavte na tento vzorec:

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

3. Zobrazte ukážku aplikácie, kliknite alebo ťuknite na pridané tlačidlo a potom ukážku zatvorte.

   Vytvorí sa kolekcia s názvom IceCream (Zmrzlina) obsahujúca tieto údaje:

   

   Táto kolekcia obsahuje dva záznamy a nie je prázdna. IsEmpty( IceCream ) vracia hodnotu false a funkcia CountRows( IceCream ) vráti hodnotu 2.

4. Pridajte druhé tlačidlo a jeho vlastnosť OnSelect nastavte na tento vzorec:

   Clear (IceCream)

5. Zobrazte ukážku aplikácie, kliknite alebo ťuknite na druhé tlačidlo a potom ukážku zatvorte.

   Kolekcia je teraz prázdna:

   

   Funkcia Clear odstráni z kolekcie všetky záznamy, takže výsledkom je prázdna kolekcia. IsEmpty( IceCream ) vracia hodnotu true a funkcia CountRows( IceCream ) vracia hodnotu 0.

Môžete tiež otestovať IsEmpty , či je vypočítaná tabuľka prázdna, ako sa zobrazujú v týchto príkladoch:

Vzorec	Popis	Výsledok
IsEmpty( [ 1, 2, 3 ] )	Tabuľka s jedným stĺpcom obsahuje tri záznamy, takže nie je prázdna.	falošné
IsEmpty( [ ] )	Tabuľka s jedným stĺpcom neobsahuje žiadne záznamy, takže je prázdna.	pravda
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) )	Tabuľka s jedným stĺpcom neobsahuje žiadne hodnoty väčšie ako 5. Výsledok z funkcie filter neobsahuje žiadne záznamy a je prázdny.	pravda