หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เหตุการณ์ในฟอร์มและตารางเริ่มต้นรหัสฝั่งไคลเอ็นต์ทั้งหมดในแอปแบบจําลองข้อมูล คุณเชื่อมโยงฟังก์ชันเฉพาะในไลบรารี JavaScript (ทรัพยากรบนเว็บสคริปต์) ที่จะดําเนินการเมื่อมีเหตุการณ์เกิดขึ้น ฟังก์ชันนี้เรียกว่าตัวจัดการเหตุการณ์ แต่ละตัวจัดการเหตุการณ์ระบุฟังก์ชันเดียวภายในไลบรารี JavaScript และพารามิเตอร์ใด ๆ ที่สามารถส่งผ่านไปยังฟังก์ชัน
คุณสามารถเชื่อมโยงตัวจัดการเหตุการณ์กับบางเหตุการณ์เท่านั้นโดยใช้ UI สําหรับเหตุการณ์ที่คุณไม่สามารถเชื่อมโยงผ่าน UI, Client API มีวิธีที่คุณสามารถใช้เพื่อแนบตัวจัดการเหตุการณ์
เพิ่มหรือลบฟังก์ชันตัวจัดการเหตุการณ์ในแบบฟอร์มโดยใช้ UI
เมื่อต้องเพิ่ม หรือลบฟังก์ชันตัวจัดการเหตุการณ์สําหรับเหตุการณ์ในอินเทอร์เฟซแบบรวมใหม่:
ไปที่ Power Apps
ในบานหน้าต่างนําทางด้านซ้าย ให้เลือก ข้อมูล แล้วเลือก ตาราง
จากรายการตาราง ให้เลือกตารางที่คุณต้องการเพิ่มตัวจัดการเหตุการณ์
เลือกแท็บ ฟอร์ม จากแถบคําสั่ง จากนั้นเลือกฟอร์มที่คุณต้องการเพิ่มตัวจัดการเหตุการณ์
เลือกแท็บ เหตุการณ์ คุณเห็นทั้งตัวจัดการเหตุการณ์ เปิด บันทึก และ เมื่อโหลด
หากต้องการเพิ่มตัวจัดการเหตุการณ์สําหรับเหตุการณ์การเปลี่ยนแปลง ให้เลือกคอลัมน์จากนั้นเลือกแท็บเหตุการณ์
ฟอร์มการแก้ไขจํานวนมาก
ตามค่าเริ่มต้น ตัวจัดการเหตุการณ์จะไม่ทํางานเมื่อฟอร์มอยู่ในโหมดแก้ไขจํานวนมาก
เมื่อต้องการเปิดใช้งานตัวจัดการเหตุการณ์ในโหมดแก้ไขจํานวนมาก ให้ปรับเปลี่ยน XML แบบฟอร์ม โดยการค้นหาองค์ประกอบที่เกี่ยวข้อง event และสร้างหรือตั้งค่าBehaviorInBulkEditFormแอตทริบิวต์เป็นEnabled ในปัจจุบัน ลักษณะการทํางานนี้ได้รับการสนับสนุนสําหรับ เหตุการณ์ OnLoad เท่านั้น
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการกําหนดค่า XML ของฟอร์ม ดูเมื่อต้องแก้ไขไฟล์กําหนดเองกําหนดฟอร์ม และเค้าร่าง XML ของฟอร์ม
เมื่อต้องการกําหนดว่าเมื่อใดที่ตัวจัดการเหตุการณ์ทํางานบนฟอร์มในโหมดแก้ไขจํานวนมาก ให้ใช้ getFormType เมธอด
เพิ่มหรือลบฟังก์ชันตัวจัดการเหตุการณ์โดยใช้รหัส Client API
ใช้วิธีการต่อไปนี้เพื่อเพิ่มและเอาตัวจัดการเหตุการณ์สําหรับเหตุการณ์ที่คุณไม่สามารถเชื่อมโยงผ่าน UI:
| กิจกรรม | ตัวจัดการเหตุการณ์ |
|---|---|
| แอตทริบิวต์ OnChange | addOnChange และลบวิธีการ OnChange |
| OnLoad บนฟอร์ม | formContext.ui addOnLoad และเอาวิธีการถ่ายข้อมูลออก |
| โหลดฟอร์ม แล้ว | formContext.ui addLoaded และเอาวิธีการที่โหลดออก |
| OnLoad ข้อมูลฟอร์ม | formContext.data addOnLoad และวิธีการ removeOnLoad |
| ฟอร์ม OnSave | addOnSave และลบวิธีการ OnSave |
| ค้นหาตัวควบคุม การค้นหา PreSearch | addPreSearch และลบวิธีการ PreSearch |
| ตัวควบคุม kbsearch OnResultOpened | addOnResultOpened และ removeOnResultOpened วิธีการ |
| ตัวควบคุม kbsearch OnSelection | addOnSelection และวิธี removeOnSelection |
| การควบคุม kbsearch PostSearch | addOnPostSearch และลบวิธีการ OnPostSearch |
สําคัญ
บริบทการดําเนินการจะถูกส่งผ่านเป็นพารามิเตอร์แรกไปยังฟังก์ชันที่คุณตั้งค่าโดยใช้รหัสโดยอัตโนมัติ สําหรับข้อมูลเพิ่มเติม ดูบริบทการดําเนินการของ Client API
ไปป์ไลน์เหตุการณ์ฟอร์ม
คุณสามารถกําหนดตัวจัดการเหตุการณ์สูงสุด 50 ตัวจัดการสําหรับแต่ละเหตุการณ์ ส่วน ตัวจัดการเหตุการณ์ ในแท็บ เหตุการณ์ ของกล่องโต้ตอบ คุณสมบัติฟอร์ม แสดงลําดับของตัวจัดการเหตุการณ์ และแต่ละตัวจัดการเหตุการณ์ทํางานในลําดับนั้น
ใช้วิธีการ setSharedVariable และ getSharedVariable เพื่อส่งผ่านตัวแปรทั่วไประหว่างตัวจัดการเหตุการณ์ (ฟังก์ชัน) ใช้บริบทการดําเนินการเมธอด getDepth เพื่อทําความเข้าใจลําดับของการดําเนินการตัวจัดการเหตุการณ์ที่สัมพันธ์กับตัวจัดการเหตุการณ์อื่น ๆ
บทความที่เกี่ยวข้อง
ทําความเข้าใจเกี่ยวกับแบบจําลองวัตถุ Client API
บริบทการดําเนินการของ Client API
เหตุการณ์ (การอ้างอิง Client API)