Blankฟังก์ชัน , Coalesce, IsBlankและIsEmpty

ฟังก์ชัน	นำไปใช้กับ
Blank	แอป พื้นที่ทํางาน Copilot Studio Desktop โฟลว์ คอลัมน์ สูตร Dataverse แอป แบบจําลองฟังก์ชัน Power Platform CLI Dataverse
Coalesce IsEmpty	แอป พื้นที่ทํางาน Copilot Studio Desktop โฟลว์ แอป แบบจําลอง Power Platform CLI ฟังก์ชัน Dataverse Power Pages
IsBlank	แอป พื้นที่ทํางาน Copilot Studio Desktop โฟลว์ คอลัมน์ สูตร Dataverse แอป แบบจําลอง Power Platform CLI Dataverse ฟังก์ชัน Power Pages

ทดสอบว่าค่านั้นเป็นค่าว่าง หรือ ตาราง ไม่มี เรกคอร์ด และแสดงวิธีการสร้างค่า ว่าง

ภาพรวม

Blankเป็นพื้นที่ที่สํารองไว้สําหรับ "ไม่มีค่า" หรือ "ค่าที่ไม่รู้จัก" ตัวอย่างเช่น คุณสมบัติ Selected ของตัวควบคุม กล่องคําสั่งผสม เป็น ค่าว่าง ถ้าผู้ใช้ไม่ได้ทําการเลือก แหล่งข้อมูลหลายรายการ สามารถจัดเก็บและส่งกลับค่า NULL ซึ่งแสดงอยู่ใน Power Apps เป็น ว่าง

คุณสมบัติหรือค่าจากการคำนวณใดๆ ใน Power Apps สามารถเป็น ว่าง ได้ ตัวอย่างเช่น ค่าบูลีนโดยปกติมีได้หนึ่งในสองค่า: จริง หรือ เท็จ แต่นอกเหนือจากสองค่านี้ อาจเป็น ค่าว่าง ที่ระบุว่ารัฐไม่เป็นที่รู้จัก ซึ่งคล้ายกับ Microsoft Excel ที่เซลล์เวิร์กชีตเริ่มต้นเป็นว่างเปล่าไม่มีเนื้อหา แต่สามารถเก็บค่า TRUE หรือ FALSE ได้ (ในรายการอื่นๆ) เนื้อหาของเซลล์สามารถถูกล้างอีกครั้งได้ตลอดเวลา ทำให้กลับไปเป็นสถานะ ว่างเปล่า

สตริงว่าง หมายถึงสตริงที่ไม่มีอักขระใดๆ ฟังก์ชันLen ส่งกลับค่าศูนย์สำหรับสตริงดังกล่าว และสามารถเขียนในสูตรเป็นสองอัญประกาศคู่ โดยไม่มีอะไรคั่น "" ตัวควบคุมและแหล่งข้อมูลบางตัวใช้สตริงที่ว่างเพื่อระบุเงื่อนไข "ไม่มีค่า" เพื่อลดความซับซ้อนของการสร้างแอป ฟังก์ชัน และ Coalesce จะIsBlankทดสอบสําหรับทั้งค่าว่างหรือสตริงที่ว่างเปล่า

ในบริบทของ 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 ) และไม่จำเป็นต้องประเมิน ค่า1 และ ค่า2 สองครั้ง ฟังก์ชัน If จะส่งกลับค่าว่าง ถ้าไม่มีสูตร "else" เหมือนกับกรณีนี้

อาร์กิวเมนต์ 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. บนเมนู ไฟล์ คลิกหรือแตะ คอลเลกชัน

   คอลเลกชัน Cities จะปรากฏ โดยแสดงหนึ่งเรกคอร์ดที่มี "Seattle" และ "Rainy"

   

5. คลิกหรือแตะลูกศรย้อนกลับ เพื่อกลับไปยังพื้นที่ทำงานเริ่มต้น

6. เพิ่มตัวควบคุม ป้ายชื่อ แล้วตั้งค่าคุณสมับติ Text เป็นสูตรนี้:

   IsBlank( First( Cities ).Weather )
   

   ป้ายกำกับแสดง เท็จ เนื่องจากฟิลด์ สภาพอากาศ มีค่า ("Rainy")

7. เพิ่มปุ่มที่สอง แล้วตั้งคุณสมบัติ OnSelect เป็นสูตรดังนี้:

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

8. แสดงตัวอย่างแอปของคุณ คลิกหรือแตะปุ่มที่คุณเพิ่ม จากนั้นปิดการแสดงตัวอย่าง

   ฟิลด์ สภาพอากาศ ของเรกคอร์ดแรก ใน Cities ถูกแทนที่ด้วย ว่าง โดยเอา "Rainy" ที่เคยอยู่ในนั้นออกไป

   

   ป้ายกำกับแสดง จริง เนื่องจากฟิลด์ สภาพอากาศ ไม่มีค่าอีกต่อไป

Coalesce

IsBlank

1. สร้างแอปตั้งแต่เริ่มต้น เพิ่มตัวควบคุมการป้อนข้อความ และตั้งชื่อว่า FirstName

2. เพิ่มป้ายชื่อ และตั้งค่าคุณสมบัติ Text เป็นสูตรนี้:

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

   ตามค่าเริ่มต้น คุณสมบัติ Text ของตัวควบคุมข้อความถูกตั้งเป็น "การป้อนข้อความ" เนื่องจากคุณสมบัติมีค่า จึงไม่ใช่ค่าว่าง และป้ายกำกับจะไม่แสดงข้อความใดๆ

3. เอาอักขระทั้งหมดออกจากตัวควบคุมการป้อนข้อความ รวมถึงช่องว่าง

   เนื่องจากคุณสมบัติ ข้อความ ไม่มีอักขระใด อีกต่อไป จึงเป็นสตริงว่าง และ IsBlank( FirstName.Text ) เป็น true ข้อความฟิลด์ที่จำเป็นจะถูกแสดง

สำหรับข้อมูลเกี่ยวกับวิธีดำเนินการตรวจสอบความถูกต้องโดยใช้เครื่องมืออื่น ให้ดูฟังก์ชัน Validate และ การทำงานกับแหล่งข้อมูล

ตัวอย่างอื่น:

IsEmpty

1. สร้างแอปตั้งแต่เริ่ม และเพิ่มตัวควบคม Button

2. ตั้งค่าคุณสมบัติ OnSelect ของปุ่มเป็นสูตรดังนี้:

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

3. แสดงตัวอย่างแอปของคุณ คลิกหรือแตะปุ่มที่คุณเพิ่ม จากนั้นปิดการแสดงตัวอย่าง

   คอลเลกชันที่มีชื่อว่า IceCream ถูกสร้างขึ้นและประกอบด้วยข้อมูลนี้:

   

   คอลเลกชันนี้มีสองเรกคอร์ดและไม่ว่างเปล่า IsEmpty( ไอศกรีม ) ส่งกลับ false และ CountRows( IceCream ) ส่งกลับ 2

4. เพิ่มปุ่มที่สอง แล้วตั้งคุณสมบัติ OnSelect เป็นสูตรดังนี้:

   เคลียร์(ไอศกรีม)

5. แสดงตัวอย่างแอปของคุณ คลิกหรือแตะปุ่มที่สอง จากนั้นปิดตัวอย่าง

   ขณะนี้คอลเลกชันว่างเปล่าแล้ว

   

   ฟังก์ชัน Clear เอาเรกคอร์ดทั้งหมดออกจากคอลเลกชัน ทำให้คอลเลกชันว่างเปล่า IsEmpty( ไอศกรีม ) ส่งกลับ true และ CountRows( IceCream ) ส่งกลับ 0

คุณยังสามารถใช้ IsEmpty เพื่อทดสอบว่าตารางจากการคํานวณว่างเปล่าหรือไม่ ดังที่ตัวอย่างเหล่านี้แสดง: