หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เหตุการณ์เริ่มต้นรหัสฝั่งไคลเอ็นต์ทั้งหมด ในแอปแบบจําลองข้อมูล คุณสามารถเชื่อมโยงฟังก์ชันเฉพาะในไลบรารี JavaScript (ทรัพยากรบนเว็บสคริปต์) ให้ทํางานเมื่อมีเหตุการณ์เกิดขึ้น ฟังก์ชันนี้เรียกว่าตัวจัดการเหตุการณ์ แต่ละตัวจัดการเหตุการณ์ระบุฟังก์ชันเดียวภายในไลบรารี JavaScript และพารามิเตอร์ใด ๆ ที่สามารถส่งผ่านไปยังฟังก์ชัน
คุณสามารถเชื่อมโยงตัวจัดการเหตุการณ์กับบางเหตุการณ์เท่านั้นโดยใช้ UI สําหรับเหตุการณ์ที่ไม่พร้อมใช้งานเพื่อเชื่อมโยงผ่าน UI, Client API มีวิธีการที่สามารถใช้เพื่อแนบตัวจัดการเหตุการณ์กับเหตุการณ์ดังกล่าว
เพิ่มหรือลบฟังก์ชันตัวจัดการเหตุการณ์ไปยังเหตุการณ์โดยใช้ UI
ใช้ส่วน ตัวจัดการเหตุการณ์ ของกล่องโต้ตอบ คุณสมบัติฟอร์ม เพื่อเชื่อมโยงสคริปต์ของคุณกับเหตุการณ์สําหรับฟอร์มและคอลัมน์
ฟอร์มการแก้ไขจํานวนมาก
ตามค่าเริ่มต้น ตัวจัดการเหตุการณ์จะไม่ถูกเรียกเมื่อฟอร์มอยู่ในโหมดแก้ไขจํานวนมาก
เมื่อต้องการเปิดใช้งานตัวจัดการเหตุการณ์ในโหมดแก้ไขจํานวนมาก ให้ปรับเปลี่ยน XML แบบฟอร์ม โดยการค้นหาองค์ประกอบที่เกี่ยวข้อง event และสร้าง/ตั้งค่าBehaviorInBulkEditFormแอตทริบิวต์เป็นEnabled ปัจจุบัน สิ่งนี้ได้รับการสนับสนุนสําหรับ เหตุการณ์ OnLoad เท่านั้น
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการกําหนดค่า XML ของฟอร์ม ดูเมื่อต้องแก้ไขไฟล์การกําหนดค่ากําหนดฟอร์ม และเค้าร่าง XML ของฟอร์ม
เมื่อต้องการกําหนดว่าเมื่อใดที่ตัวจัดการเหตุการณ์ถูกเรียกบนฟอร์มในโหมดแก้ไขจํานวนมากใช้ getFormType เมธอด
เพิ่มหรือลบฟังก์ชันตัวจัดการเหตุการณ์ไปยังเหตุการณ์โดยใช้โค้ด
ใช้วิธีการต่อไปนี้เพื่อเพิ่มและเอาตัวจัดการเหตุการณ์สําหรับเหตุการณ์ที่ไม่สามารถเชื่อมโยงผ่าน 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)