Blank, Coalesce, IsBlank, и IsEmpty функции

Функции Приложимо за
Blank Приложенията за платно Copilot Studio Desktop flows Dataverse formula columns Model-driven apps Power Platform CLI Dataverse functions
Coalesce
IsEmpty
Приложения за платно Copilot Studio Работен плот потоци Модел-управлявани приложения Power Platform CLI Dataverse функции Power Pages
IsBlank Приложения за платно Copilot Studio Работен плот потоци Dataverse формули колони Модел-задвижвани приложения Power Platform CLI Dataverse функции Power Pages

Тества дали стойността е празна или таблица не съдържа записи и предоставя начин за създаване празни стойности.

Преглед

Blankе контейнер за "няма стойност" или "неизвестна стойност". Например свойството Selected на контрола на разгъващ се списък е празно, ако потребителят не е направил избор. Много източници на данни могат да съхраняват и връщат NULL стойности, които са представени в Power Apps като празно.

Всяка собственост или изчислена стойност в Power Apps може да бъде празно. Например, булева стойност обикновено има една от две стойности: вярно или невярно. Но в допълнение към тези две може да бъде и празно , което показва, че състоянието не е известно. Това е подобно на Microsoft Excel, където клетката на работен лист започва като празна без съдържание, но може да побере стойностите ВЯРНО или НЕВЯРНО (между другото). По всяко време съдържанието на клетката може отново да бъде изчистено, връщайки я в празно състояние.

Празен низ се отнася до низ, който не съдържа знаци. Функцията Len връща нула за такъв низ и той може да бъде записан във формули като две двойни кавички без нищо между тях "". Някои контроли и източници на данни използват празен низ, за да покажат състояние "без стойност". За да опростят създаването на приложения, функциите и Coalesce функциите IsBlank се тестват както за празни стойности, така и за празни низове.

В контекста на IsEmpty функцията празно се отнася за таблици, които не съдържат записи. Структурата на таблицата може да е непокътната, допълнена с колона имена, но в таблицата няма данни. Таблицата може да започне като празна, да поеме записи и вече да не е празна, а след това премахнете записите и отново да бъде празна.

Blank

Функцията Blank връща празна стойност. Използвайте това, за да запазите NULL стойност в източник на данни, която поддържа тези стойности, ефективно премахвайки всяка стойност от полето.

IsBlank

Функцията IsBlank проверява за празна стойност или празен низ. Тестът включва празни низове, за да улесни създаването на приложения, тъй като някои източници на данни и контроли използват празен низ, когато няма налична стойност. За да тествате специално за използване if(Value = Blank(), ... на празна стойност вместо IsBlank. Функцията IsBlank счита празните таблици за празни и IsEmpty трябва да се използва за тестване на таблица.

Когато разрешавате обработването на грешки за съществуващи приложения, обмислете заместване IsBlank с IsBlankOrError , за да запазите поведението на съществуващото приложение. Преди добавянето на обработка на грешки, празна стойност беше използвана за представяне както на нулеви стойности от бази данни, така и на стойности на грешки. Обработката на грешки разделя тези две интерпретации на празни, което може да промени поведението на съществуващите приложения, които продължават да използват IsBlank.

Върнатата стойност за IsBlank е булева стойност "истина " или "неистина".

Coalesce

Функцията Coalesce оценява аргументите си поред и връща първата стойност, която не е празна , или празен низ. Използвайте тази функция, за да замените празна стойност или празен низ с различна стойност, но оставете не-празна и стойности на празни низове непроменени. Ако всички аргументи са празни или празни низове, функцията връща празна стойност, което прави Coalesce добър начин за преобразуване на празни низове в празни стойности.

Coalesce( value1, value2 ) е по-краткият еквивалент на If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) и не изисква value1 и value2 да бъдат изчислени два пъти. Функцията If връща празна стойност, ако няма формула "else", както е в случая тук.

Всички аргументи трябва да Coalesce бъдат от един и същ тип; например не можете да смесвате числа с текстови низове. Върнатата стойност от е от Coalesce този често срещан тип.

IsEmpty

Функцията IsEmpty проверява дали дадена таблица съдържа записи. Това е еквивалентно на използването на CountRows функция и проверка за нула. Можете да проверите за грешки в източника на данни, като комбинирате IsEmpty с функцията "Грешки" .

Върнатата стойност за IsEmpty е булева стойност "истина " или "неистина".

Синтаксис

Blank()

Coalesce( Стойност1 [, Стойност2, ... ] )

  • Ценности – Задължително. Стойности за тестване. Всяка стойност се изчислява поред, докато не бъде намерена стойност, която не е празна , а не празен низ. Стойностите след тази точка не се оценяват.

IsBlank( Стойност )

  • Стойност – Задължително. Стойност за тестване за празно стойност или празен низ.

IsEmpty( Таблица )

  • Таблица - Задължително. Таблица за тестване за записи.

Примери

Blank

  1. Създайте приложение от нулата и добавете контрола бутон.

  2. Задайте свойството OnSelect на бутона на тази формула:

    ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
    
  3. Визуализирайте приложението си, щракнете или докоснете бутона, който сте добавили, и след това затворете Преглед.

  4. В менюто файл щракнете върху или докоснете Колекции.

    Колекцията градове се появява колекция, показваща един запис със "Сиатъл" и "Дъждовно":

    Колекция, показваща Сиатъл с дъждовно време.

  5. Кликнете или докоснете стрелката назад, за да се върнете към работното пространство по подразбиране.

  6. Добавете контрола Етикет с име Текст и задайте свойството й на тази формула:

    IsBlank( First( Cities ).Weather )
    

    Етикетът показва невярно, защото Метеорологично време поле съдържа стойност ("Дъждовно").

  7. Добавете втори бутон и задайте свойството му OnSelect на тази формула:

    Patch( Cities, First( Cities ), { Weather: Blank() } )
    
  8. Визуализирайте приложението си, щракнете или докоснете бутона, който сте добавили, и след това затворете Преглед.

    Полето Метеорологично време на първия запис в градове се заменя с празно, премахвайки „Дъждовно“, което беше там преди.

    Колекция, показваща Сиатъл с празно поле за метеорологично време.

    Етикетът показва вярно, защото Метеорологично време поле вече не съдържа стойност.

Coalesce

Формула Описание Резултат
Coalesce( Blank); 1 ) Проверява върнатата стойност от Blank функцията, която винаги връща празна стойност. Защото първият аргумент е празно, оценката продължава със следващия аргумент, докато не-празно стойност и непразен низ е намерен. 1
Coalesce( "", "2" ) Проверява първия аргумент, който е празен низ. Защото първият аргумент е празен низ, оценката продължава със следващия аргумент, докато не-празно стойност и непразен низ е намерен. 2
Coalesce( Blank), "", Blank(), "", "3", "4" ) Coalesce започва в началото на списъка с аргументи и оценява всеки аргумент поред, докато не бъде намерена непразна стойност и непразен низ. В този случай първите четири аргумента се връщат празно или празен низ, така че оценката продължава до петия аргумент. Петият аргумент е не-празно и не-празен низ, така че оценката спира тук. Стойността на петия аргумент се връща, а шестият аргумент не се оценява. 3
Coalesce( "" ) Проверява първия аргумент, който е празен низ. Тъй като първият аргумент е празен низ и няма повече аргументи, функцията се връща празно. интервал

IsBlank

  1. Създайте приложение от нулата, добавете контрола за въвеждане на текст и го назовете FirstName.

  2. Добавете етикет и задайте свойството му Текст на тази формула:

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

    По подразбиране, Текст свойството на контрола за въвеждане на текст е зададено на „Въвеждане на текст“. Тъй като свойството съдържа стойност, тя не е празна и етикетът не показва никакво съобщение.

  3. Премахнете всички символи от контрола за въвеждане на текст, включително всички интервали.

    Тъй като свойството "Текст " вече не съдържа никакви знаци, то е празен низ и IsBlank( СобственоИме.Текст ) е true. Съобщението за задължително поле се показва.

За информация как да извършите валидирането с помощта на други инструменти, вижте функцията Validate и работа с източници на данни.

Други примери:

Формула Описание Резултат
IsBlank1000000000000 Blank Проверява върнатата стойност от Blank функцията, която винаги връща празна стойност. верен
IsBlank( "" ) Низ, който не съдържа символи. верен
IsBlank( "Здравей" ) Низ, който съдържа един или повече символи. невярно
IsBlank( AnyCollection ) Тъй като колекция съществува, той не е празен, дори ако не съдържа никакви записи. За да проверите за празна колекция, използвайте IsEmpty вместо това. невярно
IsBlank( Mid( "Hello", 17, 2 ) Началният символ за Mid е отвъд края на низа. Резултатът е празен низ. верен
IsBlank( If( false, false ) ) Функция If без ElseResult. Защото състоянието е винаги невярно, това If винаги връща празно. верен

IsEmpty

  1. Създайте приложение от нулата и добавете контрола бутон.

  2. Задайте свойството OnSelect на бутона на тази формула:

    Collect( IceCream, {Flavor: "Ягода", количество: 300}, {Аромат: "Шоколад", Количество: 100} )

  3. Визуализирайте приложението си, щракнете или докоснете бутона, който сте добавили, и след това затворете Преглед.

    Колекция с име Сладолед е създаден и съдържа тези данни:

    Таблица с аромати на ягоди и шоколад с количества 300 и 100.

    Тази колекция има два записа и не е празна. IsEmpty( IceCream ) връща false, а CountRows( IceCream ) връща 2.

  4. Добавете втори бутон и задайте свойството му OnSelect на тази формула:

    Прозрачен ( сладолед)

  5. Визуализирайте приложението си, щракнете или докоснете втория бутон след това затворете Преглед.

    Сега колекцията е празна:

    Колекция с аромат и количество като празна колекция.

    Функцията Clear премахва всички записи от колекция, което води до празна колекция. IsEmpty( IceCream ) връща "истина", а CountRows( IceCream ) връща 0.

Можете също да използвате IsEmpty , за да проверите дали изчисляемата таблица е празна, както е посочено в тези примери:

Формула Описание Резултат
IsEmpty( [ 1, 2, 3 ] ) Таблицата с една колона съдържа три записа и следователно не е празна. невярно
IsEmpty( [ ] ) Таблицата с една колона не съдържа записи и е празна. верен
IsEmpty( Филтър( [ 1; 2; 3 ], Стойност > 5 ) ) Таблицата с една колона не съдържа стойности, по-големи от 5. Резултатът от филтъра не съдържа записи и е празен. верен