Blank, Coalesce, IsBlanka IsEmpty funkce

Functions	Vztahuje se na
Blank	Aplikace plátna Copilot Studio Desktop toky Dataverse ve sloupcích vzorců Modelem řízené aplikace Power Platform CLI – funkce Dataverse
Coalesce IsEmpty	Aplikace plátna Copilot Studio Desktop toky modelem řízené aplikace Power Platform CLI Dataverse functions Power Pages
IsBlank	Aplikace plátna Copilot Studio Desktop toky Dataverse sloupce vzorců Modelem řízené aplikace Power Platform CLI Funkce Power Pages

Testuje, jestli je hodnota prázdná nebo jestli tabulka neobsahuje žádné záznamy, a umožňuje vytvářet prázdné hodnoty.

Přehled

Blank je zástupný symbol pro "žádná hodnota" nebo "neznámá hodnota". Například vlastnost Pole se seznamem jeprázdná , pokud uživatel nevybere výběr. Mnoho zdrojů dat může ukládat a vracet hodnoty NULL, které se v Power Apps znázorňují jako prázdné.

Jakákoli vlastnost nebo počítaná hodnota v Power Apps může být prázdná. Logická hodnota například obsahuje obvykle jednu z těchto dvou hodnot: true (pravda) nebo false (nepravda). Kromětěchtoch Je to podobné jako v Microsoft Excel, kde buňka listu je na začátku prázdná bez jakéhokoli obsahu, ale může mimo jiné uchovávat i hodnotu PRAVDA nebo NEPRAVDA. Kdykoli lze obsah buňky znovu vymazat a obnovit tak prázdný stav buňky.

Prázdný řetězec označuje řetězec, který neobsahuje žádné znaky. Funkce Len vrací nulu pro takový řetězec a lze jej napsat ve vzorcích jako dvě dvojité uvozovky, mezi nimiž nic není "". Některé ovládací prvky a zdroje dat používají prázdný řetězec k označení stavu „bez hodnoty“. Pro zjednodušení vytváření aplikace testují IsBlank funkce Coalesce jak prázdné hodnoty, tak prázdné řetězce.

V kontextu IsEmpty funkce je prázdné specifické pro tabulky, které neobsahují žádné záznamy. Struktura tabulky může být neporušená a obsahovat názvy sloupců, ale žádná data v tabulce nejsou. Tabulka může být napřed prázdná, pak se do ní umístí záznamy, takže nebude prázdná, a pak se tyto záznamy odeberou a bude znovu prázdná.

Blank

Funkce Blank vrátí prázdnou hodnotu. Používá se k ukládání hodnot NULL do zdroje dat, který tyto hodnoty podporuje. V podstatě to znamená, že se všechny hodnoty z daného pole odeberou.

IsBlank

Funkce IsBlank testuje prázdnou hodnotu nebo prázdný řetězec. Test obsahuje prázdné řetězce, které usnadňují vytváření aplikace, protože některé zdroje dat a ovládací prvky používají prázdný řetězec, pokud neexistuje žádná hodnota. Testování konkrétně pro použití prázdné hodnoty if(Value = Blank(), ... místo IsBlank. Funkce IsBlank považuje prázdné tabulky za prázdné a IsEmpty měla by být použita k otestování tabulky.

Při povolování zpracování chyb u existujících aplikací zvažte nahrazení IsBlank chyb isBlankOrError , aby se zachovalo stávající chování aplikace. Před přidáním zpracování chyb byla k vyjádření jak hodnot null, tak chybových hodnot v databázi používána prázdná hodnota. Zpracování chyb odděluje tyto dvě interpretace prázdných hodnot, což by mohlo změnit chování stávajících aplikací, které nadále používají IsBlank.

Vrácená hodnota IsBlank je logická hodnota true nebo false.

Coalesce

Funkce Coalesce vyhodnotí své argumenty v pořadí a vrátí první hodnotu, která není prázdná nebo prázdný řetězec. Tuto funkci použijte k nahrazení prázdné hodnoty nebo prázdného řetězce jinou hodnotou, ale ponechání hodnot a řetězců, které nejsou prázdné. Pokud jsou všechny argumenty prázdné nebo prázdné řetězce, funkce vrátí prázdnou hodnotu, což představuje Coalesce dobrý způsob, jak převést prázdné řetězce na prázdné hodnoty.

Coalesce( value1, value2 ) je stručnějším ekvivalentem If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) a nevyžaduje hodnota1 a hodnota2 k hodnotit dvakrát. Funkce If vrátí prázdnou hodnotu, pokud neexistuje žádný vzorec "else", jak je tomu v tomto případě.

Všechny argumenty, které musí Coalesce být stejného typu, například nemůžete kombinovat čísla s textovými řetězci. Návratová hodnota z Coalesce tohoto běžného typu.

IsEmpty

Funkce IsEmpty testuje, zda tabulka obsahuje nějaké záznamy. Je ekvivalentem k použití funkce CountRows a následné kontrole, jestli je výsledkem nula. Chyby zdroje dat můžete zkontrolovat kombinací IsEmpty funkce Errors .

Vrácená hodnota IsEmpty je logická hodnota true nebo false.

Syntaxe

Blank()

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

• Hodnoty – Povinné. Hodnoty, které se mají testovat. Každá hodnota se vyhodnocuje v pořadí, dokud se nenajde hodnota, která není prázdná , a ne prázdný řetězec. Hodnoty po tomto bodu se nevyhodnocují.

IsBlank( Hodnota )

• Hodnota – Povinné. Hodnota pro otestování prázdné hodnoty nebo prázdného řetězce.

IsEmpty( Tabulka )

• Tabulka – Povinné. Tabulka, ve které se má testovat výskyt záznamů.

Příklady

Blank

1. Vytvořte aplikaci od začátku a přidejte ovládací prvek Button.

2. Vlastnost OnSelect tlačítka nastavte na tento vzorec:

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

3. Zobrazte náhled aplikace, klikněte nebo klepněte na tlačítko, které jste přidali, a pak zavřete náhled.

4. V nabídce Soubor klikněte nebo klepněte na Kolekce.

   Zobrazí se kolekce Cities, která zobrazuje jeden záznam s položkami Seattle a Rainy:

   

5. Klikněte nebo klepněte na šipku zpět a vraťte se do výchozího pracovního prostoru.

6. Přidejte ovládací prvek Label a jeho vlastnost Text nastavte na tento vzorec:

   IsBlank( First( Cities ).Weather )
   

   Popisek zobrazí hodnotu false, protože pole Weather obsahuje hodnotu (Rainy).

7. Přidejte druhé tlačítko a nastavte jeho vlastnost OnSelect na tento vzorec:

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

8. Zobrazte náhled aplikace, klikněte nebo klepněte na tlačítko, které jste přidali, a pak zavřete náhled.

   Pole Weather prvního záznamu v kolekci Cities se nahradí prázdnou hodnotou, takže položka Rainy, která tam byla dříve, se odebere.

   

   Popisek zobrazí hodnotu true, protože pole Weather už neobsahuje hodnotu.

Coalesce

Vzorec	Popis	Výsledek
Coalesce( Blank(), 1 )	Otestuje návratovou hodnotu z Blank funkce, která vždy vrátí prázdnou hodnotu. První argument je prázdný, takže vyhodnocování pokračuje dalšími argumenty až do nalezení hodnoty, která není prázdná ani prázdný řetězec.	1
Coalesce( "", "2" )	Otestuje první argument, což je prázdný řetězec. První argument je prázdný řetězec, takže vyhodnocování pokračuje dalšími argumenty až do nalezení hodnoty, která není prázdná ani prázdný řetězec.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesce začíná na začátku seznamu argumentů a vyhodnocuje jednotlivé argumenty, dokud se nenajde neprázdná hodnota a neprázdný řetězec. V tomto případě první čtyři argumenty vrací prázdnou hodnotu nebo prázdný řetězec, takže vyhodnocování pokračuje pátým argumentem. Pátý argument není prázdná hodnota ani prázdný řetězec, takže hodnocení zde končí. Vrátí se hodnota pátého argumentu a šestý argument se nevyhodnocuje.	3
Coalesce( "" )	Otestuje první argument, což je prázdný řetězec. Protože první argument je prázdný řetězec a neexistují žádné další argumenty, funkce vrací prázdnou hodnotu.	prázdný

IsBlank

1. Vytvořte aplikaci od začátku, přidejte ovládací prvek typu textový vstup a dejte mu název FirstName.

2. Přidejte popisek a do jeho vlastnosti Text nastavte tento vzorec:

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

   Ve výchozím nastavení je ve vlastnosti Text ovládacího prvku typu textový vstup nastavený řetězec "Text input". Vlastnost obsahuje hodnotu, takže není prázdná a popisek nezobrazí žádnou zprávu.

3. Odeberte z ovládacího prvku typu textový vstup všechny znaky včetně všech mezer.

   Protože vlastnost Text již neobsahuje žádné znaky, je to prázdný řetězec a IsBlank( FirstName.Text ) je true. Zobrazí se zpráva, že pole je povinné.

Informace o tom, jak provádět ověřování pomocí jiných nástrojů, najdete v tématech o funkci Validate a o práci se zdroji dat.

Další příklady:

Vzorec	Popis	Výsledek
IsBlank( Blank)	Otestuje návratovou hodnotu z Blank funkce, která vždy vrátí prázdnou hodnotu.	věrný
IsBlank( "" )	Řetězec, který neobsahuje žádné znaky	věrný
IsBlank( "Hello" )	Řetězec, který obsahuje jeden nebo více znaků	falešný
IsBlank( AnyCollection )	Kolekce existuje, a proto pro tuto funkci není prázdná, ani když neobsahuje žádné záznamy. Pokud chcete zkontrolovat prázdnou kolekci, použijte IsEmpty místo toho.	falešný
IsBlank( Mid( "Hello"; 17; 2 ) )	Počáteční znak pro funkci Mid je až za koncem řetězce. Výsledkem je prázdný řetězec.	věrný
IsBlank( If( false; false ) )	Funkce If bez argumentu ElseResult. Podmínka má vždycky hodnotu false, takže tato funkce If vždycky vrátí prázdnou hodnotu.	věrný

IsEmpty

1. Vytvořte aplikaci od začátku a přidejte ovládací prvek Button.

2. Vlastnost OnSelect tlačítka nastavte na tento vzorec:

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

3. Zobrazte náhled aplikace, klikněte nebo klepněte na tlačítko, které jste přidali, a pak zavřete náhled.

   Vytvoří se kolekce s názvem IceCream, která obsahuje tato data:

   

   Tato kolekce má dva záznamy a není prázdná. IsEmpty( IceCream ) vrátí hodnotu false a CountRows( IceCream ) vrátí hodnotu 2.

4. Přidejte druhé tlačítko a nastavte jeho vlastnost OnSelect na tento vzorec:

   Čirá (zmrzlina)

5. Zobrazte náhled aplikace, klikněte nebo klepněte na druhé tlačítko a pak zavřete náhled.

   Kolekce je teď prázdná:

   

   Funkce Clear odebere z kolekce všechny záznamy, takže výsledkem je prázdná kolekce. IsEmpty(IceCream ) vrátí hodnotu true a Vrátí hodnotu 0.

Můžete také použít IsEmpty k otestování, jestli je počítaná tabulka prázdná, jak ukazují tyto příklady:

Vzorec	Popis	Výsledek
IsEmpty( [ 1, 2, 3 ] )	Tabulka s jedním sloupcem obsahuje tři záznamy, takže není prázdná.	falešný
IsEmpty( [ ] )	Tabulka s jedním sloupcem neobsahuje žádné záznamy, takže je prázdná.	věrný
IsEmpty( Filter( [ 1; 2; 3 ], Hodnota > 5 ) )	Tabulka s jedním sloupcem neobsahuje žádné hodnoty větší než 5. Výsledek z funkce Filter neobsahuje žádné záznamy, takže je prázdný.	věrný