Blank, Coalesce, IsBlank және IsEmpty функциялары

Қолданылады: Canvas қолданбалары Жұмыс үстелі ағындары Dataverse формула бағандары Үлгіге негізделген қолданбалар Power Pages Power Platform CLI

Мәннің бос екенін немесе кестенің ешбір жазбаларды қамтымайтынын тексереді және бос мәндерді жасау жолын береді.

Шолу

Бос "мән жоқ" немесе "белгісіз мән" дегеннің толтырғышы болып табылады. Мысалы, Аралас тізім басқару элементінің Таңдалған сипаты пайдаланушы таңдау жасамаса бос болады. Көп деректер көздері NULL мәндерін сақтай және қайтара алады, олар Power Apps ішінде бос түрінде көрсетіледі.

Power Apps ішіндегі кез келген сипат немесе есептелетін мән бос болуы мүмкін. Мысалы, әдетте логикалық мәнде екі мәннің біреуі болады: true немесе false. Бірақ осы екеуіне қоса, ол сонымен бірге бос бола алады, бұл күй белгісіз екенін көрсетеді. Бұл Microsoft Excel бағдарламасына ұқсайды, онда жұмыс парағының ұяшығы мазмұны жоқ бос күйде басталады, бірақ TRUE немесе FALSE (басқаларының арасында) сақтай алады. Кез келген уақытта, ұяшықтың мазмұнын қайта тазалауға болады, бұл оны бос күйге қайтарады.

Бос жол таңбаларды қамтымайтын жолды білдіреді. Len функциясы мұндай жол үшін нөлді қайтарады және оны формулаларда "" арасында ештеңе жоқ екі қос тырнақша түрінде жазуға болады. Кейбір басқару элементтері және деректер көздері "мән жоқ" күйді көрсету үшін бос жолды пайдаланады. Бағдарламаны жасауды жеңілдету үшін IsBlank және Coalesce функциялары бос мәндердің немесе бос жолдардың екеуінің де бар-жоғын тексереді.

IsEmpty функциясының контекстінде бос сөзі жазбаларды қамтымайтын кестелерге қатысты болады. Кесте құрылымы тиілмеуі, барлық баған атаулары болуы мүмкін, бірақ кестеде деректер болмауы мүмкін. Кесте бос түрде басталуы, жазбаларды қабылдауы және енді бос болмауы мүмкін, содан кейін жазбалары жойылуы және қайтадан бос болуы мүмкін.

Ескертпе

Біз өту кезеңіндеміз. Қазірге дейін blank мәні де қателер туралы хабарлау үшін пайдаланылып келген, бұл жарамды "мән жоқ" мәнін қатеден айыруды мүмкін емес еткен. Осы себепті, қазіргі уақытта, blank мәндерді сақтауға тек жергілікті жинақтарда қолдау көрсетіледі. Егер сіз Формула деңгейіндегі қатені басқару эксперименттік мүмкіндігін Параметрлер>Алдағы мүмкіндіктер>Эксперименттік тармағынан қоссаңыз, бос мәндерді басқа деректер көздерінде сақтауға болады. Біз бұл мүмкіндікті аяқтау және blank мәндерін қателерден тиісті ажыратуды аяқтау үшін белсенді түрде жұмыс істеудеміз.

Бос

Қолданылады: Canvas қолданбалары Үлгіге негізделген қолданбалар Dataverse формула бағандары

Blank функциясы blank мәнін қайтарады. Мұны осы мәндерді қолдайтын деректер көзінде NULL мәнін сақтау үшін пайдаланыңыз, бұл өрістен кез келген мәнді тиімді жояды.

IsBlank

Қолданылады: Canvas қолданбалары Үлгіге негізделген қолданбалар

IsBlank функциясы blank мәні немесе бос жол бар-жоғын тексереді. Бұл тексеру бағдарламаны жасауды жеңілдету үшін бос жолдарды қамтиды, өйткені кейбір деректер өкздері және басқару элементтері мән жоқ кезде бос жолды пайдаланады. blank мәні бар-жоғын арнайы тексеру үшін IsBlank орнына if( Value = Blank(), ... пайдаланыңыз. IsBlank функциясы бос кестелерді бос емес деп санайды және IsEmpty кестені тексеру үшін пайдаланылуы керек.

Бұрыннан бар бағдарламалар үшін қате өңдеуді қосқанда, бағдарламаның бұрыннан бар әрекетін сақтау үшін IsBlank функциясын IsBlankOrError функциясымен ауыстыруды қарастырыңыз. Қатені өңдеуді қоспас бұрын, дерекқордың нөлдік мәндерін және қате мәндерін көрсету үшін бос мән пайдаланылды. Қатені өңдеу IsBlank функциясын пайдалануды жалғастыратын бұрыннан бар бағдарламалар әрекетін өзгертуі мүмкін бос мәннің осы екі түсіндірмесін бөледі.

IsBlank үшін қайтарылатын мән — логикалық шын немесе жалған.

Coalesce

Қолданылады: Canvas қолданбалары Үлгіге негізделген қолданбалар

Coalesce функциясы аргументтерін ретпен есептейді және blank немесе бос жол емес бірінші мәнді қайтарады. Бұл функцияны blank мәнін немесе бос жолды басқа мәнмен ауыстыру, бірақ blank емес және бос жол емес мәндерді өзгеріссіз қалдыру үшін пайдаланыңыз. Егер барлық аргументтер бос немесе бос жолдар болса, онда функция Coalesce тәсілін бос жолдарды бос мәндерге түрлендірудің жақсы жолы етіп, бос мәнді қайтарады.

Coalesce( value1, value2 ) —If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) формулаларының дәлірек баламасы және value1 және value2 мәндерінің екі рет есептелуін қажет етпейді. If функциясы осы жердегідей "else" формуласы жоқ болса, blank мәнін қайтарады.

Coalesce функциясының барлық аргументтері бір түрге жатуы керек; мысалы, сандарды мәтін жолдарымен араластыру мүмкін болмаса. Coalesce тәсілінен қайтарылатын мән осы жалпы түрге жатады.

IsEmpty

Қолданылады: Canvas қолданбалары Үлгіге негізделген қолданбалар

IsEmpty функциясы кесте кез келген жазбаларды қамтитын-қамтымайтынын тексереді. Ол CountRows функциясын пайдаланумен және нөл мәні бар-жоғын тексерумен тең. Деректер көзіндегі қателерді IsEmpty функциясын Errors функциясымен біріктіру арқылы тексеруге болады.

IsEmpty үшін қайтарылатын мән — логикалық шын немесе жалған.

Синтаксис

Blank()

Coalesce( Value1 [, Value2, ... ] )

• Value(s) – Міндетті. Тексеретін мәндер. blank емес және бос жол емес мән табылғанша, әр мән ретпен есептеледі. Бұл тұстан кейінгі мәндер есептелмейді.

IsBlank( Value )

• Value – Міндетті. blank мәні немесе бос жол бар-жоғын тексеретін мән.

IsEmpty( Table )

• Кесте - Міндетті. Жазбалар бар-жоғын тексеретін кесте.

Мысалдар

Бос

Ескертпе

Қазіргі уақытта келесі мысалдар тек жергілікті жинақтар үшін жұмыс істейді. Егер сіз Формула деңгейіндегі қатені басқару эксперименттік мүмкіндігін Параметрлер>Алдағы мүмкіндіктер>Эксперименттік тармағынан қоссаңыз, бос мәндерді басқа деректер көздерінде сақтауға болады. Біз бұл мүмкіндікті аяқтау және blank мәндерін қателерден ажыратуды аяқтау үшін белсенді түрде жұмыс істеудеміз.

1. Бағдарламаны басынан жасаңыз және Түймешік басқару элементін қосыңыз.

2. Осы түймешіктің OnSelect сипатын мына формулаға орнатыңыз:

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

3. Бағдарламаны алдын ала қарап, қосқан түймені басыңыз немесе түртіңіз, содан кейін Алдын ала қарауды жабыңыз.

4. Файл мәзірніде Жинақтар тармағын басыңыз немесе түртіңіз.

   Қалалар жинағы пайда болып, "Сиэтл" және "Жаңбырлы" жазулары бар бір жазбаны көрсетеді:

   

5. Әдепкі жұмыс кеңістігіне оралу үшін кері көрсеткісін басыңыз немесе түртіңіз.

6. Белгі басқару элементін қосыңыз және оның Мәтін сипатын мына формулаға орнатыңыз:

   IsBlank( First( Cities ).Weather )
   

   Белгіде false мәні көрсетіледі, өйткені Ауа райы өрісі мәнді ("Жаңбырлы") қамтиды.

7. Екінші түймешікті қосыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:

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

8. Бағдарламаны алдын ала қарап, қосқан түймені басыңыз немесе түртіңіз, содан кейін Алдын ала қарауды жабыңыз.

   Қалалар ішіндегі бірінші жазбаның Ауа өрісі blank мәнмен ауыстырылып, бұрын сонда болған "Жаңбырлы" жазуын жояды.

   

   Белгіде true мәні көрсетіледі, өйткені Ауа райы өрісі енді мәнді қамтымайды.

Coalesce

Формула	Сипаттама	Нәтиже
Coalesce( Blank(), 1 )	Әрқашан blank мәнін қайтаратын Blank функциясының қайтарылатын мәнін тексереді. Бірінші аргумент blank болғандықтан, blank емес мән және бос жол емес мән табылғанда есептеу жалғасады.	1
Coalesce( "", "2" )	Бос жол болып табылатын бірінші аргументті тексереді. Бірінші аргумент бос жол болғандықтан, blank емес мән және бос жол емес мән табылғанда есептеу жалғасады.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesce аргументтер тізімінің басында басталады және blank емес мән және бос жол емес мән табылғанда әр аргументті кезекпен есептейді. Бұл жағдайда бірінші төрт аргументтің барлығы blank мәнін немесе бос жолды қайтарады, осылайша есептеу бесінші аргументке дейін жалғасады. Бесінші аргумент — blank емес және бос жол емес, сондықтан есептеу осы жерде тоқтайды. Бесінші аргументтің мәні қайтарылады және алтыншы аргумент есептелмейді.	3
Coalesce( "" )	Бос жол болып табылатын бірінші аргументті тексереді. Бірінші аргумент бос жол болғандықтан және енді басқа аргументтер болмағандықтан, функция blank мәнін қайтарады.	бос

IsBlank

1. Бағдарламаны басынан жасаңыз, мәтінді енгізу басқару элементін қосыңыз және оны FirstName деп атаңыз.

2. Белгі қосыңыз және оның Мәтін сипатын мына формулаға орнатыңыз:

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

   Әдепкі бойынша, мәтінді енгізу басқару элементінің Мәтін сипаты "Мәтінді енгізу" мәніне орнатылады. Бұл сипат мәнді қамтығандықтан, ол бос емес және белгі ешбір хабарды көрсетпейді.

3. Мәтінді енгізу басқару элементінен барлық таңбаларды, соның ішінде барлық бос орындарды жойыңыз.

   Сипаты property енді ешбір таңбаларды қамтымағандықтан, ол бос жол болып табылады және IsBlank( FirstName.Text ) мәні true болады. Міндетті өріс хабары көрсетіледі.

Басқа құраларды пайдалана отырып тексеруді орындау жолы туралы ақпаратты Validate функциясынан және деректер көздерімен жұмыс істеу бөлімінен қараңыз.

Басқа мысалдар:

Формула	Сипаттама	Нәтиже
IsBlank( Blank() )	Әрқашан blank мәнін қайтаратын Blank функциясының қайтарылатын мәнін тексереді.	true
IsBlank( "" )	Таңбаларды қамтымайтын жол.	true
IsBlank( "Hello" )	Бір немесе бірнеше таңбаны қамтитын жол.	false
IsBlank( AnyCollection )	Жинақ бар болғандықтан, ол бос емес, тіпті ешбір жазбаларды қамтымаса да. Бос жинақ бар-жоғын тексеру үшін оның орнына IsEmpty функциясын пайдаланыңыз.	false
IsBlank( Mid( "Hello", 17, 2 ) )	Mid функциясының бастапқы таңбасы жол соңынан тыс. Нәтижесі — бос жол.	true
IsBlank( If( false, false ) )	ElseResult мәні жоқ If функциясы. Шарт әрқашан false болғандықтан, бұл If функциясы әрқашан blank мәнін қайтарады.	true

IsEmpty

1. Бағдарламаны басынан жасаңыз және Түймешік басқару элементін қосыңыз.

2. Осы түймешіктің OnSelect сипатын мына формулаға орнатыңыз:

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

3. Бағдарламаны алдын ала қарап, қосқан түймені басыңыз немесе түртіңіз, содан кейін Алдын ала қарауды жабыңыз.

   IceCream атты жинақ жасалады және мына деректерді қамтиды:

   

   Бұл жинақта екі жазба бар, сондықтан бос емес. IsEmpty( IceCream ) функциясы false мәнін, ал CountRows( IceCream ) функциясы 2 мәнін қайтарады.

4. Екінші түймешікті қосыңыз және оның OnSelect сипатын мына формулаға орнатыңыз:

   Clear( IceCream )

5. Бағдарламаны алдын ала қарап, екінші түймешікті басыңыз немесе түртіңіз, содан кейін Алдын ала қарауды жабыңыз.

   Жинақ енді бос:

   

   Clear функциясы жинақтан барлық жазбаларды жояды, бұл бсо жинаққа әкеледі. IsEmpty( IceCream ) функциясы true мәнін, ал CountRows( IceCream ) функциясы 0 мәнін қайтарады.

Сондай-ақ IsEmpty функциясын мына мысалдар көрсететіндей кестенің бос екенін тексеру үшін пайдалануға болады:

Формула	Сипаттама	Нәтиже
IsEmpty( [ 1, 2, 3 ] )	Бір бағандық кесте үш жазбаны қамтиды, сондықтан бос емес.	false
IsEmpty( [ ] )	Бір бағандық кесте ешбір жазбаны қамтымайды, сондықтан бос.	true
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) )	Бір бағандық кесте 5-тен үлкенірек ешбір мәндерді қамтымайды. Сүзгіден алынған нәтиже ешбір жазбаларды қамтымайды, сондықтан бос.	true