ฟังก์ชัน Update และ UpdateIf
ใช้กับ:
แอป Canvas แอปที่ขับเคลื่อนด้วยโมเดล
อัปเดต เรกคอร์ด ใน แหล่งข้อมูล
Description
ฟังก์ชัน Update
ใช้ฟังก์ชัน Update เพื่อแทนที่ทั้งเรกคอร์ดในแหล่งข้อมูล ในทางกลับกัน ฟังก์ชัน UpdateIf และ Patch จะปรับเปลี่ยนค่าอย่างน้อยหนึ่งรายการในเรกคอร์ด ทิ้งค่าอื่นไว้ลำพัง
สำหรับ คอลเลกชัน ทั้งเรกคอร์ดต้องตรงกัน คอลเลกชันอนุญาตให้ทำเรกคอร์ดซ้ำได้ หลายเรกคอร์ดจึงอาจตรงกัน คุณสามารถใช้อาร์กิวเมนต์ RemoveFlags.All เพื่ออัปเดตสำเนาของเรกคอร์ดทั้งหมด มิฉะนั้น จะอัปเดตสำเนาของเรกคอร์ดเดียวเท่านั้น
ถ้าแหล่งข้อมูลสร้างค่าของคอลัมน์โดยอัตโนมัติ ค่าของ คอลัมน์ นั้นต้องได้รับการยืนยันอีกครั้ง
ฟังก์ชัน UpdateIf
ใช้ฟังก์ชัน UpdateIf เพื่อปรับเปลี่ยนค่าอย่างน้อยหนึ่งรายการในอย่างน้อยหนึ่งเรกคอร์ดที่ตรงกับอย่างน้อยหนึ่งเงื่อนไข เงื่อนไขสามารถเป็นสูตรใดก็ได้ที่ส่งผลให้เกิด จริง หรือ เท็จ และสามารถอ้างอิงคอลัมน์ของแหล่งข้อมูลตามชื่อ ฟังก์ชันจะประเมินเงื่อนไขสำหรับแต่ละเรกคอร์ด และปรับเปลี่ยนเรกคอร์ดใดๆ ที่ผลลัพธ์เป็น จริง
เมื่อต้องการระบุการปรับเปลี่ยน ให้ใช้เรกคอร์ดการเปลี่ยนแปลงที่มีค่าคุณสมบัติใหม่ ถ้าคุณระบุเรกคอร์ดการเปลี่ยนแปลงแบบอินไลน์นี้ภายในวงเล็บปีกกา สูตรของคุณสมบัติสามารถอ้างอิงคุณสมบัติของเรกคอร์ดที่ถูกปรับเปลี่ยน คุณสามารถใช้ลักษณะการทำงานนี้เพื่อปรับเปลี่ยนเรกคอร์ดโดยยึดตามสูตร
คล้ายกับ UpdateIf คุณยังสามารถใช้ฟังก์ชัน Patch เพื่อเปลี่ยนแปลงคอลัมน์ที่ระบุของเรกคอร์ดโดยไม่กระทบกับคอลัมน์อื่นได้
ทั้ง Update และ UpdateIf ส่งกลับแหล่งข้อมูลที่ปรับเปลี่ยนแล้วเป็น ตาราง คุณต้องใช้ฟังก์ชันใดก็ได้ใน สูตรของลักษณะการทำงาน
การมอบหมาย
เมื่อใช้กับแหล่งข้อมูล ฟังก์ชันเหล่านี้ไม่สามารถมอบสิทธิ์ได้ เฉพาะแหล่งข้อมูลส่วนแรกเท่านั้นที่จะมีการเรียกข้อมูลแล้วมีการนำฟังก์ชันไปใช้ สิ่งนี้อาจไม่แสดงข้อมูลการดำเนินการทั้งหมด คำเตือนอาจปรากฏขึ้นในขณะเขียน เพื่อเตือนคุณถึงข้อจำกัดนี้
การสนับสนุนการมอบหมาย (ทดลอง)
การสนับสนุนการมอบหมายสำหรับ UpdateIf และ RemoveIf อยู่ในการแสดงตัวอย่างการทดลอง (ปิดค่าเริ่มต้น) สำหรับแหล่งข้อมูลที่สนับสนุน หากแหล่งข้อมูลไม่รองรับคุณลักษณะนี้ ตอนนี้ Power Apps จะส่งแบบสอบถามไปยังเซิร์ฟเวอร์และดึงข้อมูลทั้งหมดที่ตรงกับนิพจน์ตัวกรองสูงสุด 500, 2000 หรือขนาดหน้าข้อมูล จากนั้นจะอัปเดตบันทึกเหล่านั้นและส่งกลับไปยังเซิร์ฟเวอร์เพื่อทำการอัปเดต
ไวยากรณ์
อัปเดต( แหล่งข้อมูล, OldRecord, NewRecord [, RemoveFlags.All ] )
- DataSource – จำเป็น แหล่งข้อมูลที่มีเรกคอร์ดที่คุณต้องการแทนที่
- OldRecord – จำเป็น เรกคอร์ดที่จะแทนที่
- NewRecord – จำเป็น เรกคอร์ดแทนที่ นี่ไม่ใช่เรกคอร์ดที่มีการเปลี่ยนแปลง ทั้งเรกคอร์ดจะถูกแทนที่ และคุณสมบัติที่หายไปจะ ว่างเปล่า
- RemoveFlags.All – ไม่บังคับ ในคอลเลกชัน เรกคอร์ดเดียวกันอาจปรากฏขึ้นมากกว่าหนึ่งครั้ง ระบุอาร์กิวเมนต์ RemoveFlags.All เพื่ออัปเดตสำเนาของเรกคอร์ดทั้งหมด
อัปเดตถ้า( แหล่งข้อมูล, เงื่อนไข1, บันทึกการเปลี่ยนแปลง1 [, เงื่อนไข2, บันทึกการเปลี่ยนแปลง2, ... ] )
- DataSource – จำเป็น แหล่งข้อมูลที่มีเรกคอร์ดที่คุณต้องการปรับเปลี่ยน
- เงื่อนไข – จำเป็น สูตรที่ประเมินเป็น จริง สำหรับเรกคอร์ดที่คุณต้องการปรับเปลี่ยน คุณสามารถใช้ชื่อคอลัมน์ว่า DataSource ในสูตรได้
- ChangeRecords - จำเป็น สำหรับแต่ละเงื่อนไขที่สอดคล้องกัน เรกคอร์ดที่มีการเปลี่ยนแปลงของค่าคุณสมบัติใหม่ที่จะนำไปใช้กับเรกคอร์ด DataSource ที่ตรงตามเงื่อนไข ถ้าคุณระบุเรกคอร์ดแบบอินไลน์โดยใช้พร้อมกับวงเล็บปีกกา ค่าคุณสมบัติของเรกคอร์ดที่มีอยู่จะสามารถใช้ในสูตรของคุณสมบัติได้
ตัวอย่าง
ในตัวอย่างเหล่านี้ คุณจะแทนที่หรือปรับเปลี่ยนเรกคอร์ดในแหล่งข้อมูลที่มีชื่อว่า IceCream และที่เริ่มต้นด้วยข้อมูลในตารางนี้:
| สูตร | รายละเอียด | ผลลัพธ์ |
|---|---|---|
| อัพเดท( ไอศกรีม, First( Filter( IceCream, Flavor="Chocolate" ) ), { ID: 1, Flavor: "Mint Chocolate", Quantity:150 } ) |
แทนที่เรกคอร์ดจากแหล่งข้อมูล |  แหล่งข้อมูล ไอศครีม ได้ถูกปรับเปลี่ยนแล้ว |
| UpdateIf(ไอศกรีม, จำนวน > 175, { จำนวน: จำนวน + 10 } ) | ปรับเปลี่ยนเรกคอร์ดที่มี ปริมาณ ที่มากกว่า 175 ฟิลด์ ปริมาณ จะถูกเพิ่มค่าครั้งละ 10 และจะไม่ปรับเปลี่ยนฟิลด์อื่น |  แหล่งข้อมูล ไอศครีม ได้ถูกปรับเปลี่ยนแล้ว |
| อัพเดท( ไอศกรีม, First( Filter( IceCream, Flavor="Strawberry" ) ), { ID: 3, Flavor: "Strawberry Swirl"} ) |
แทนที่เรกคอร์ดจากแหล่งข้อมูล คุณสมบัติ Quantity ยังไม่อยู่ในเรกคอร์ดแทนที่ คุณสมบัตินั้นจึงจะ ว่างเปล่า ในผลลัพธ์ |  แหล่งข้อมูล ไอศครีม ได้ถูกปรับเปลี่ยนแล้ว |
| UpdateIf(ไอศกรีม, true, { จำนวน: 0 } ) | ตั้งค่าของคุณสมบัติ Quantity สำหรับเรกคอร์ดทั้งหมดในแหล่งข้อมูลเป็น 0 |  แหล่งข้อมูล ไอศครีม ได้ถูกปรับเปลี่ยนแล้ว |
ทีละขั้นตอน
นำเข้าหรือสร้างคอลเลกชันชื่อว่า Inventory แล้วแสดงในแกลเลอรีตามที่ แสดงข้อมูลในแกลเลอรี อธิบายไว้
ตั้งชื่อแกลเลอรีว่า ProductGallery
เพิ่มแถบเลื่อนชื่อว่า UnitsSold แล้วตั้งค่าคุณสมบัติ Max ลงในนิพจน์นี้:
แกลเลอรี่สินค้า.เลือก.จำนวน.มีในสต๊อกเพิ่มปุ่ม และตั้งค่าคุณสมบัติ OnSelect เป็นสูตรนี้:
UpdateIf(สินค้าคงคลัง, ชื่อผลิตภัณฑ์ = ProductGallery.Selected.ProductName, {UnitsInStock:UnitsInStock-UnitsSold.Value})กด F5 เลือกผลิตภัณฑ์ในแกลเลอรี ระบุค่าด้วยแถบเลื่อน แล้วเลือกปุ่ม
จำนวนของหน่วยในสินค้าคงคลังสำหรับผลิตภัณฑ์ทีคุณระบุลดลงตามจำนวนที่คุณระบุ