Blank, Coalesce, IsBlankés IsEmpty függvények

Functions	A következőkre vonatkozik:
Blank	Vászonalapú alkalmazások Copilot Studio Desktop folyamatok Dataverse képletoszlopok Modellalapú alkalmazások Power Platform CLI Dataverse-függvények
Coalesce IsEmpty	Vászonalapú alkalmazások Copilot Studio Desktop folyamatok Modellalapú alkalmazások Power Platform CLI Dataverse függvények Power Pages
IsBlank	Vászonalapú alkalmazások Copilot Studio Desktop folyamatok Dataverse képletoszlopok Modellalapú alkalmazások Power Platform CLI Dataverse-függvények Power Pages

Megvizsgálja, hogy az érték üres-e, vagy hogy a tábla tartalmaz-e rekordokat, és lehetővé teszi üres értékek létrehozását.

Áttekintés

Blank a "nincs érték" vagy az "ismeretlen érték" helyőrzője. A Kombinált lista vezérlőelem Kijelölt tulajdonsága például üres , ha a felhasználó nem adott meg kijelölést. Számos adatforrás támogatja a NULL értékek tárolását és visszaadását. Ezeket a Power Apps üres értékként jelöli.

A Power Apps bármilyen tulajdonsága vagy számított értéke lehet üres. Egy logikai érték például általában az igaz vagy hamis érték egyike. A kettő mellett azonban üres is lehet, ami azt jelzi, hogy az állapot nem ismert. Ez hasonlít a Microsoft Excel megoldására, ahol a munkalapok cellái kezdetben üresek, nincsen bennük tartalom, de többek között IGAZ vagy HAMIS értékűek is lehetnek. Ha a cella tartalmát bármikor törlik, visszaáll az üres állapot.

Az üres karakterlánc olyan karakterláncra utal, amely nem tartalmaz karaktereket. A Len függvény a nulla értéket adja vissza az ilyen sztringekhez, és felvehető olyan képletekbe, amelyekben két idézőjel között nincs semmi: "". Bizonyos vezérlők és adatforrások üres sztringgel jelzik a „nincs érték” feltételt. Az alkalmazás létrehozásának egyszerűsítése érdekében az üres értékek és Coalesce az üres sztringek és a IsBlank függvények tesztelése.

A függvény kontextusában az IsEmptyüresség olyan táblákra vonatkozik, amelyek nem tartalmaznak rekordokat. Lehet, hogy a tábla szerkezete hibátlan, és az összes oszlop neve megfelelő, de a tábla nem tartalmaz adatokat. Egy tábla kezdetben lehet üres, majd a rekordok felvitelét követően nem lesz üres, majd a rekordok eltávolítása után ismét üressé válhat.

Blank

A Blank függvény üres értéket ad vissza. Ezzel tárolhat NULL értéket az ilyen értéket támogató adatforrásokban, és távolíthat el értéket az adott mezőből.

IsBlank

A IsBlank függvény egy üres értéket vagy egy üres sztringet tesztel. A teszt üres sztringeket tartalmaz az alkalmazások létrehozásának megkönnyítése érdekében, mivel egyes adatforrások és vezérlők üres sztringet használnak, ha nincs érték. Ha kifejezetten üres értékre szeretne tesztelni, használja if(Value = Blank(), ... ahelyett, hogy IsBlanka . A IsBlank függvény az üres táblákat nem üresnek tekinti, és IsEmpty egy tábla tesztelésére kell használni.

A meglévő alkalmazások hibakezelésének engedélyezésekor érdemes lehet lecserélni IsBlank az IsBlankOrError-ra a meglévő alkalmazás viselkedésének megőrzése érdekében. A hibakezelés bevezetése előtt az üres érték volt használatos az adatbázisokból származó null értékek és a hibaértékek megjelenítésére. A hibakezelés elválasztja az üres két értelmezést, ami megváltoztathatja a továbbra is használt IsBlankmeglévő alkalmazások viselkedését.

A visszatérési IsBlank érték egy igaz vagy hamis logikai érték.

Coalesce

A Coalesce függvény sorrendben értékeli ki az argumentumait, és visszaadja az első értéket, amely nem üres vagy üres sztring. Ezzel a függvénnyel egy üres értéket üres vagy más értékkel rendelkező üres karakterláncot cserélhet le, de a nem üres értékek és a nem üres karakterláncok értékei változatlanok maradnak. Ha az összes argumentum üres vagy üres sztring, akkor a függvény üres értéket ad vissza, így Coalesce az üres sztringek üres értékekké alakíthatók.

Coalesce( value1, value2 ) a tömörebb megfelelője, If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) és nem igényli az érték1 és az érték2 kétszeri kiértékelését. A Ha függvényüres értéket ad vissza, ha nincs "más" képlet, ahogyan az itt is szerepel.

Minden argumentumnak Coalesce azonos típusúnak kell lennie, például nem keverhet számokat szöveges sztringekkel. A visszatérési érték ebből a gyakori típusból származik Coalesce .

IsEmpty

A IsEmpty függvény ellenőrzi, hogy egy tábla tartalmaz-e rekordokat. Egyenértékű a CountRows függvény használatával, majd a nullás érték ellenőrzésével. Az adatforrás hibáit a Hibák függvénnyel kombinálva IsEmpty ellenőrizheti.

A visszatérési IsEmpty érték logikai igaz vagy hamis.

Szintaxis

Blank()

Coalesce( Érték1 [, Érték2, ... ] )

• Értékek – Kötelező. A vizsgálni kívánt értékek. A rendszer mindaddig sorrendben értékeli ki az értékeket, amíg nem talál üres sztringet, és nem üres karakterláncot. A pont utáni értékek kiértékelése nem történik meg.

IsBlank( Érték )

• Érték – Kötelező. Az érték, amelyben üres értéket vagy üres sztringet kell keresni.

IsEmpty( Táblázat )

• Tábla - Kötelező. A tábla, amelyben a rekordok meglétét szeretné vizsgálni.

Példák

Blank

1. Hozzon létre egy előzmény nélküli új alkalmazást, és vegyen fel egy Gomb vezérlőelemet.

2. A gomb OnSelect (Kiválasztáskor) tulajdonságát állítsa a következő képletre:

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

3. Az előnézettel ellenőrizze az alkalmazást, kattintson vagy koppintson a hozzáadott gombra, majd zárja be az előnézetet.

4. A Fájl menüben kattintson vagy koppintson a Gyűjtemények lehetőségre.

   Megjelenik a Cities gyűjtemény, amelyben egyetlen rekord található „Seattle” és „Rainy” (Esős) értékekkel:

   

5. Kattintson vagy koppintson a vissza nyílra, hogy visszatérjen az alapértelmezett munkaterületre.

6. Adjon hozzá egy Címke vezérlőelemet, és a Szöveg tulajdonságát állítsa a következő képletre:

   IsBlank( First( Cities ).Weather )
   

   A felirat hamis értéket mutat, mert a Weather mező már tartalmaz értéket („Rainy”).

7. Vegyen fel egy második gombot, és az OnSelect (Kiválasztáskor) tulajdonság értékeként adja meg ezt a képletet:

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

8. Az előnézettel ellenőrizze az alkalmazást, kattintson vagy koppintson a hozzáadott gombra, majd zárja be az előnézetet.

   A Cities tábla első rekordjának Weather mezője ki lett cserélve egy üres elemre, ezzel eltávolítva a korábbi „Rainy” értéket.

   

   A címke igaz értéket mutat, mert a Weather mező már nem tartalmaz értéket.

Coalesce

Képlet	Ismertetés	Eredmény
Coalesce( Blank(), 1 )	Teszteli a függvény visszatérési Blank értékét, amely mindig üres értéket ad vissza. Mivel az első argumentum üres, a kiértékelés a következő argumentumot vizsgálja, egész addig, amíg egy nem üres értéket és egy nem üres sztringet talál.	1
Coalesce( "", "2" )	Az első argumentumot teszteli, amely egy üres sztring. Mivel az első argumentum üres sztring, a kiértékelés a következő argumentumot vizsgálja, egész addig, amíg egy nem üres értéket és egy nem üres sztringet talál.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesce az argumentumlista elején kezdődik, és egymás után értékeli ki az egyes argumentumokat, amíg nem üres érték és nem üres sztring nem található. Jelen esetben az első négy argumentum mind üres értéket vagy üres sztringet ad vissza, ezért a kiértékelés az ötödik argumentumig folytatódik. Az ötödik argumentum nem üres és nem üres sztring, ezért a kiértékelés megszakad. Az ötödik argumentum lesz a visszaadott érték, és a hatodik argumentum kiértékelésére már nem kerül sor.	3
Coalesce( "" )	Az első argumentumot teszteli, amely egy üres sztring. Mivel az első argumentum üres sztring, és nincs több argumentum, a függvény üres értéket ad vissza.	üres

IsBlank

1. Hozzon létre egy előzmény nélküli új alkalmazást, és vegyen fel egy szövegbeviteli vezérlő; nevezze úgy, hogy Keresztnév.

2. Adjon hozzá egy címkét, majd állítsa be a Szöveg tulajdonságát a következő képletnek megfelelően:

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

   Alapértelmezés szerint a szövegbeviteli vezérlő Szöveg tulajdonsága az, hogy „Text input” („Szöveges bevitel”). Mivel a tulajdonság értéket tartalmaz, nem számít üresnek, így a címke nem mutatja a megadott üzenetet.

3. Távolítsa el az összes karaktert a szövegbeviteli vezérlőből, beleértve a szóközöket is.

   Mivel a Text tulajdonság már nem tartalmaz karaktereket, ez egy üres sztring, és IsBlanka ( FirstName.Text )igaz. Megjelenik a mező kitöltésére felszólító üzenet.

A különféle eszközökkel történő további ellenőrzésről a Validate függvény használatát és az adatforrások kezelését ismertető cikkben olvashat bővebben.

Más példák:

Képlet	Ismertetés	Eredmény
IsBlank( Blank() )	Teszteli a függvény visszatérési Blank értékét, amely mindig üres értéket ad vissza.	igaz
IsBlank( "" )	Karaktereket nem tartalmazó sztring.	igaz
IsBlank( "Hello" )	Egy vagy több karaktert tartalmazó sztring.	téves
IsBlank( AnyCollection )	Mivel a gyűjtemény létezik, ezért nem üres, még akkor sem, ha nem tartalmaz rekordokat. Ha üres gyűjteményt szeretne keresni, használja IsEmpty helyette.	téves
IsBlank( Mid( "Hello", 17, 2 ) )	A Mid függvény kezdő karaktere a sztring vége után van. Az eredmény üres sztring lesz.	igaz
IsBlank( Ha( hamis, hamis ) )	If függvény, amelyben nincs ElseResult. Mivel a feltétel mindig hamis, ez az If függvény mindig üres eredménnyel fog visszatérni.	igaz

IsEmpty

1. Hozzon létre egy előzmény nélküli új alkalmazást, és vegyen fel egy Gomb vezérlőelemet.

2. A gomb OnSelect (Kiválasztáskor) tulajdonságát állítsa a következő képletre:

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

3. Az előnézettel ellenőrizze az alkalmazást, kattintson vagy koppintson a hozzáadott gombra, majd zárja be az előnézetet.

   Létrejön egy Jégkrém nevű gyűjtemény a következő adatokkal:

   

   A gyűjtemény két rekordot tartalmaz, így nem számít üresnek. IsEmpty( IceCream )eredménye hamis, a CountRows ( IceCream ) pedig 2.

4. Vegyen fel egy második gombot, és az OnSelect (Kiválasztáskor) tulajdonság értékeként adja meg ezt a képletet:

   Clear( IceCream )

5. Az előnézettel ellenőrizze az alkalmazást, kattintson vagy koppintson a második gombra, majd zárja be az előnézetet.

   A gyűjtemény most már üres:

   

   A Clear függvény eltávolítja az összes rekordot a gyűjteményből, így az eredmény egy üres gyűjtemény lesz. IsEmpty( IceCream )igaz értéket ad vissza, a CountRows ( IceCream ) pedig 0 értéket ad vissza.

Azt is IsEmpty tesztelheti, hogy egy számított tábla üres-e, ahogy az alábbi példák is mutatják:

Képlet	Ismertetés	Eredmény
IsEmpty( [ 1, 2, 3 ] )	Az egyoszlopos tábla három rekordot tartalmaz, ezért nem számít üresnek.	téves
IsEmpty( [ ] )	Az egyoszlopos tábla nem tartalmaz rekordokat, ezért üresnek számít.	igaz
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) )	Az egyoszlopos tábla nem tartalmaz olyan értéket, amely nagyobb, mint 5. A szűrés eredménye nem tartalmaz rekordokat, ezért üresnek számít.	igaz