Blank, Coalesce, IsBlank, ופונקציות IsEmpty

Functions	חל על
Blank	אפליקציות Canvas Studio Copilot Studio זורמות עמודות נוסחאות Dataverse אפליקציות מונחות דגמים פונקציות Power Platform CLI Dataverse
Coalesce IsEmpty	אפליקציות Canvas Copilot Studio Desktop זורמות אפליקציות מונחות דגמים פונקציות Power Platform CLI Dataverse Power Pages
IsBlank	אפליקציות Canvas Studio Copilot Studio זורמות עמודות נוסחאות Dataverse אפליקציות מונחות דגמים Power Platform CLI Dataverse פונקציות Power Pages

בודקת אם ערך ריק או אם טבלה אינה מכילה רשומות, ומספקת דרך ליצור ערכים ריקים.

מבט כולל

Blankהוא מציין מיקום עבור "אין ערך" או "ערך לא ידוע". לדוגמה, המאפייןנבחר של פקד תיבה משולבת ריק אם המשתמש לא ביצע בחירה. מקורות נתונים רבים יכולים לאחסן ולהחזיר ערכי NULL, המיוצגים ב- Power Apps כריקים.

כל מאפיין או ערך מחושב ב- Power Apps יכול להיות ריק. לדוגמה, לערך בוליאני יש בדרך כלל אחד משני ערכים: true או false. אך בנוסף לשני אלה, הוא יכול להיות גם ריק המציין שהמדינה אינה ידועה. זה דומה ל- Microsoft Excel, שם תא של גליון עבודה מתחיל כריק ללא תוכן, אבל יכול להכיל את הערכים TRUE או FALSE (בין השאר). בכל עת, ניתן שוב לנקות את התוכן של התא, ולהחזיר אותו למצב ריק.

מחרוזת ריקה מתייחסת למחרוזת שאינה מכילה תווים. הפונקציה Len מחזירה אפס עבור מחרוזת כזאת וניתן לכתוב אותה בנוסחאות כשתי מרכאות כפולות עם שום דבר בין לבין "". פקדים ומקורות נתונים מסוימים משתמשים במחרוזת ריקה כדי לציין מצב של "ללא ערך". כדי לפשט את יצירת היישום, הפונקציות IsBlank והפונקציות Coalesce מחפשות הן ערכים ריקים והן מחרוזות ריקות.

בהקשר של הפונקציה IsEmpty , ריק הוא ספציפי לטבלאות ללא רשומות. מבנה הטבלה עשוי להיות שלם, מלא בשמות עמודה, אבל ללא נתונים בטבלה. טבלה עשויה להתחיל כריקה, לקבל רשומות ולא להיות עוד ריקה, ולאחר מכן לחזור להיות ריקה לאחר שהרשומות שלה הוסרו.

Blank

הפונקציה Blank מחזירה ערך ריק. השתמש בו כדי לאחסן ערך NULL במקור נתונים התומך בערכים אלה, תוך הסרה יעילה של ערך כלשהו מהשדה.

IsBlank

הפונקציה IsBlank בודקת אם קיים ערך ריק או מחרוזת ריקה. הבדיקה כוללת מחרוזות ריקות כדי להקל על יצירת היישום מאחר שמקורות נתונים ופקדים מסוימים משתמשים במחרוזת ריקה כאשר אין ערך קיים. כדי לבדוק באופן ספציפי אם יש שימוש בערך ריק if(Value = Blank(), ... במקום ב- IsBlank. הפונקציה IsBlank מחשיבה טבלאות ריקות כטבלאות IsEmpty ריקות ויש להשתמש בהן לבדיקת טבלה.

בעת הפעלת טיפול בשגיאות עבור יישומים קיימים, IsBlank שקול להחליף ב- IsBlankOrError כדי לשמר את אופן הפעולה הקיים של היישום. לפני הוספת הטיפול בשגיאות, נעשה שימוש בערך ריק כדי לייצג ערכי Null ממסדי נתונים וערכי שגיאות. טיפול בשגיאות מפריד בין שתי פרשנות אלה לריק, דבר שעשוי לשנות את אופן הפעולה של יישומים קיימים הממשיכות להשתמש ב- IsBlank.

ערך ההחזרה IsBlank עבור הוא ערך True בוליאני אוFalse.

Coalesce

הפונקציה Coalesce מעריכה את הארגומנטים שלה לפי הסדר ומחזירה את הערך הראשון שאינו ריק או מחרוזת ריקה. השתמש בפונקציה זו כדי להחליף ערך ריק או מחרוזת ריקה בערך שונה, אבל השאר ערכי מחרוזת שאינם ריקים ללא שינוי. אם כל הארגומנטים הם מחרוזות ריקות או ריקות, הפונקציה מחזירה ערך ריק,Coalesce מה שהופך דרך טובה להמרת מחרוזות ריקות לערכים ריקים.

Coalesce( value1, value2 ) הוא המקבילה התמציתית יותר ל If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) ולא דורשת value1 ו value2 ל להעריך פעמיים. הפונקציה If מחזירה ערך ריק אם אין נוסחה "אחרת" כמו במקרה כאן.

כל הארגומנטים Coalesce חייבים להיות מאותו סוג; לדוגמה, לא ניתן לערבב מספרים עם מחרוזות טקסט. ערך ההחזרה Coalesce מסוג נפוץ זה.

IsEmpty

הפונקציה IsEmpty בודקת אם טבלה מכילה רשומות כלשהן. היא שוות ערך לשימוש בפונקציה CountRows ובדיקה אם קיים אפס. באפשרותך לבדוק אם קיימים שגיאות במקור נתונים על-ידי שילוב IsEmpty עם הפונקציה Errors .

ערך ההחזרה IsEmpty עבור הוא ערך True בוליאני אוFalse.

תחביר

Blank()

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

• ערכים – חובה. ערכים לבדיקה. כל ערך מוערך לפי סדר עד שערך שאינו ריק ולא נמצא מחרוזת ריקה. ערכים לאחר נקודה זו אינם מוערכים.

IsBlank( ערך )

• ערך – חובה. ערך לבדיקה אם קיימים ערך ריק או מחרוזת ריקה.

IsEmpty( טבלה )

• טבלה - חובה. טבלה לבדיקת הרשומות.

דוגמאות

Blank

1. צור יישום מאפס, והוסף פקד Button‎.

2. הגדר את המאפיין OnSelect של הלחצן לנוסחה הבאה:

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

3. הצג את היישום שלך בתצוגה מקדימה, לחץ או הקש על הלחצן שהוספת וסגור את התצוגה המקדימה.

4. בתפריט קובץ, לחץ או הקש על אוספים.

   האוסף ערים מופיע, ומציג רשומה אחת עם "הרצליה" ו"גשום":

   

5. לחץ או הקש על החץ אחורה כדי לחזור לסביבת העבודה של ברירת המחדל.

6. הוסף פקד Label‎ והגדר את מאפיין Text‎ שלו לנוסחה זו:

   IsBlank( First( Cities ).Weather )
   

   התווית מציגה false משום שהשדה מזג אוויר מכיל ערך ("גשום").

7. הוסף לחצן שני, והגדר את מאפיין OnSelect שלו לנוסחה זו:

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

8. הצג את היישום שלך בתצוגה מקדימה, לחץ או הקש על הלחצן שהוספת וסגור את התצוגה המקדימה.

   השדה מזג אוויר של הרשומה הראשונה תחת ערים הוחלף בערך ריק, שמסיר את "גשום" שהיה שם קודם לכן.

   

   התווית מציגה true משום שהשדה מזג אוויר אינו מכיל עוד ערך.

Coalesce

נוסחה	תיאור	תוצאה
Coalesce( Blank(), 1 )	בדיקת הערך המוחזר מהפונקציה Blank , המחזירה תמיד ערך ריק. משום שהארגומנט הראשון הוא ריק, ההערכה ממשיכה עם הארגומנט הבא עד שערך שאינו ריק ומחרוזת שאינה ריקה נמצאים.	1
Coalesce( "", "2" )	בדיקת הארגומנט הראשון, שהוא מחרוזת ריקה. משום שהארגומנט הראשון הוא מחרוזת ריקה, ההערכה ממשיכה עם הארגומנט הבא עד שערך שאינו ריק ומחרוזת שאינה ריקה נמצאים.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesceמתחילה בתחילת רשימת הארגומנטים ומעריכה כל ארגומנט בהתחלה עד שנמצא ערך שאינו ריק ומחרוזת שאינה ריקה. במקרה זה, ארבעת הארגומנטים הראשונים מחזירים ריק או מחרוזת ריקה, ולכן ההערכה ממשיכה לארגומנט החמישי. הארגומנט החמישי הוא אינו ריק ומחרוזת שאינה ריקה, ולכן ההערכה מפסיקה כאן. הערך של הארגומנט החמישי מוחזר, והארגומנט השישי אינו מוערך.	3
Coalesce( "" )	בדיקת הארגומנט הראשון, שהוא מחרוזת ריקה. משום שהארגומנט הראשון הוא מחרוזת ריקה, ואין ארגומנטים נוספים, הפונקציה מחזירה ריק.	רֵיק

IsBlank

1. צור יישום מאפס, הוסף פקד קלט טקסט וקרא לו FirstName.

2. הוסף תווית והגדר את מאפיין Text‎ שלה לנוסחה זו:

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

   כברירת מחדל, המאפיין Text‎ של פקד קלט טקסט מוגדר ל"Text input". מכיוון שהמאפיין מכיל ערך, הוא אינו ריק והתווית אינה מציגה הודעה.

3. הסר את כל התווים מפקד קלט הטקסט, כולל רווחים כלשהם.

   מאחר שהמאפיין Text אינו מכיל עוד תווים כלשהם, היא מחרוזת ריקה, ו-IsBlank ( FirstName.Text )הוא true. הודעת השדה הנדרשת מוצגת.

לקבלת מידע אודות אופן ביצוע האימות באמצעות כלים אחרים, עיין בפונקציה Validate ובנושא עבודה עם מקורות נתונים.

דוגמאות אחרות:

נוסחה	תיאור	תוצאה
IsBlankתותים, תותים Blank, תותים	בדיקת הערך המוחזר מהפונקציה Blank , המחזירה תמיד ערך ריק.	נָכוֹן
IsBlank( "" )	מחרוזת שלא מכילה תווים.	נָכוֹן
IsBlank("שלום")	מחרוזת שמכילה תו אחד או יותר.	שֶׁקֶר
IsBlank( AnyCollection )	משום שהאוסף קיים, הוא אינו ריק, גם אם אינו מכיל רשומות. כדי לבדוק אם קיים אוסף ריק, השתמש במקום IsEmpty זאת.	שֶׁקֶר
IsBlank( Mid( "Hello", 17, 2 )	התו הפותח עבור Mid הוא מעבר לסוף המחרוזת. התוצאה היא מחרוזת ריקה.	נָכוֹן
IsBlank( If( false, false ) )	פונקציית If ללא ElseResult. משום שהתנאי הוא תמיד false, פונקציית If זו מחזירה תמיד ריק.	נָכוֹן

IsEmpty

1. צור יישום מאפס, והוסף פקד Button‎.

2. הגדר את המאפיין OnSelect של הלחצן לנוסחה הבאה:

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

3. הצג את היישום שלך בתצוגה מקדימה, לחץ או הקש על הלחצן שהוספת וסגור את התצוגה המקדימה.

   אוסף בשם גלידה נוצר ומכיל נתונים אלה:

   

   אוסף זה כולל שתי רשומות ואינו ריק. IsEmpty( IceCream ) מחזיר False, ו- CountRows ( IceCream ) מחזיר 2.

4. הוסף לחצן שני, והגדר את מאפיין OnSelect שלו לנוסחה זו:

   נקה ( IceCream )

5. הצג את היישום שלך בתצוגה מקדימה, לחץ או הקש על הלחצן השני וסגור את התצוגה המקדימה.

   האוסף ריק כעת:

   

   הפונקציה Clear מסירה את כל הרשומות מאוסף, והתוצאה היא אוסף ריק. IsEmpty( IceCream ) מחזיר True, ו - CountRows ( IceCream ) מחזיר 0.

באפשרותך גם להשתמש כדי IsEmpty לבדוק אם טבלה מחושבת ריקה, כפי שדוגמאות אלה מציגות:

נוסחה	תיאור	תוצאה
IsEmpty( [ 1, 2, 3 ] )	הטבלה בת העמודה היחידה מכילה שלוש רשומות ולכן אינה ריקה.	שֶׁקֶר
IsEmpty( [ ] )	הטבלה בת העמודה היחידה אינה מכילה רשומות והיא ריקה.	נָכוֹן
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 )	הטבלה בת העמודה היחידה אינה מכילה ערכים הגדולים מ- 5. התוצאה מהמסנן אינה מכילה רשומות והיא ריקה.	נָכוֹן