กำหนดค่าตัวจัดการเหตุการณ์สำหรับฟอร์ม
หัวข้อนี้นำไปใช้ได้กับ Dynamics 365 Customer Engagement (on-premises) สำหรับรุ่น Power Apps ของหัวข้อนี้ ดู: ตั้งค่าคอนฟิกตัวจัดการเหตุการณ์ของฟอร์มแอปแบบจำลอง
สามารถตั้งค่าคอนฟิกตัวจัดการเหตุการณ์ของฟอร์มสำหรับ Dynamics 365 Customer Engagement (on-premises) สำหรับบริเวณต่างๆ ดังต่อไปนี้ในฟอร์มได้:
องค์ประกอบ | กิจกรรมพิเศษ | คำอธิบาย |
---|---|---|
ฟอร์ม | OnLoad |
เกิดขึ้นเมื่อโหลดฟอร์ม |
OnSave |
เกิดขึ้นเมื่อมีการบันทึกข้อมูล | |
แท็บ | TabStateChange |
เกิดขึ้นเมื่อมีการขยายหรือยุบแท็บ |
ฟิลด์ | OnChange |
เกิดขึ้นเมื่อข้อมูลในฟิลด์นั้นเปลี่ยนแปลงและตัวควบคุมนั้นเสียโฟกัส |
IFRAME | OnReadyStateComplete |
เกิดขึ้นเมื่อโหลดเนื้อหาของ IFRAME |
ตัวจัดการเหตุการณ์ประกอบด้วยการอ้างอิงไปยังทรัพยากรบนเว็บ JavaScript และฟังก์ชันที่กำหนดไว้ภายในทรัพยากรบนเว็บนั้น ที่จะดำเนินการเมื่อเกิดเหตุการณ์ขึ้น แต่ละองค์ประกอบนั้นสามารถมีตัวจัดการเหตุการณ์ที่แยกจากกันได้มากสุดถึง 50 ตัว
สำคัญ
การกำหนดค่าตัวจัดการเหตุการณ์ไม่ถูกต้องอาจก่อให้เกิดข้อผิดพลาดของสคริปต์ที่อาจทำให้ฟอร์มไม่สามารถโหลดหรือทำงานได้อย่างถูกต้อง ถ้าคุณไม่ใช่ผู้พัฒนาสคริปต์ ตรวจสอบให้แน่ใจว่าคุณเข้าใจอย่างชัดเจนแล้วว่าสคริปต์นั้นต้องการใช้ตัวเลือกการกำหนดค่าตัวใด
อย่ากำหนดค่าตัวจัดการเหตุการณ์ของสคริปต์ด้วยการใช้ไลบรารีที่ไม่ได้มาจากแหล่งที่คุณเชื่อถือ สามารถใช้สคริปต์เพื่อดำเนินการใดๆ ที่ผู้ใช้อาจดำเนินการได้ และสคริปต์ที่เขียนขึ้นแบบชุ่ยๆ นั้นอาจส่งผลเสียหายต่อประสิทธิภาพการทำงานของฟอร์มได้อย่างมาก
หลังจากที่คุณกำหนดค่าตัวจัดการเหตุการณ์แล้ว ขอให้ทดสอบเสมอเพื่อตรวจสอบว่าทำงานได้อย่างถูกต้องหรือไม่
ถ้าต้องการกำหนดค่าตัวจัดการเหตุการณ์
ในตัวแก้ไขฟอร์ม เลือกองค์ประกอบที่มีเหตุการณ์ที่คุณต้องการกำหนดค่าตัวจัดการให้
บน แท็บหน้าหลัก ในกลุ่ม แก้ไข เลือก เปลี่ยนคุณสมบัติ หรือเพียงแค่คลิกสองครั้งที่องค์ประกอบ
ในกล่องโต้ตอบคุณสมบัติขององค์ประกอบ เลือกแท็บ เหตุการณ์
ขยายพื้นที่ ไลบรารีฟอร์ม ออก ถ้าไลบรารีที่มีฟังก์ชันที่คุณต้องการตั้งค่าเป็นตัวจัดการเหตุการณ์นั้นยังไม่อยู่ในรายการ ให้ทำการเพิ่มไลบรารี
เมื่อต้องการเพิ่มไลบรารีให้กับตัวจัดการเหตุการณ์:
ในส่วน ไลบรารีฟอร์ม ของ รายการเหตุการณ์ เลือก เพิ่ม
หาตำแหน่งที่ตั้งทรัพยากรบนเว็บ JavaScript ในรายการของทรัพยากรบนเว็บที่มีให้ใช้งาน เลือกรายการ และจากนั้นเลือก เพิ่ม
ถ้าทรัพยากรบนเว็บ JavaScript ที่คุณจำเป็นต้องใช้นั้นไม่มีอยู่ ให้เลือก สร้าง เพื่อเปิดฟอร์มทรัพยากรบนเว็บใหม่ และสร้างรายการใหม่
ถ้าต้องการสร้างทรัพยากรบนเว็บแบบ JavaScript:
ในฟอร์มทรัพยากรบนเว็บ ให้ตั้งค่าคุณสมบัติดังต่อไปนี้:
คุณสมบัติ ค่า ชื่อ จำเป็นต้องใช้ พิมพ์ชื่อของทรัพยากรบนเว็บ ชื่อที่แสดง จำเป็นต้องใช้ พิมพ์ชื่อที่จะแสดงในรายการของทรัพยากรบนเว็บ คำอธิบาย เลือกได้ พิมพ์คำอธิบายของทรัพยากรบนเว็บ ชนิด จำเป็นต้องใช้ เลือก สคริปต์ (JScript) ภาษา เลือกได้ เลือกภาษาที่มีให้ใช้งานภาษาใดภาษาหนึ่งสำหรับองค์กรของคุณ ถ้าคุณได้รับสคริปต์มา เราขอแนะนำให้คุณใช้ปุ่ม เรียกดู เพื่อค้นหาแฟ้มและอัปโหลดแฟ้มดังกล่าว
อีกทางหนึ่งคือ คุณสามารถเลือกปุ่ม ตัวแก้ไขข้อความ และวาง หรือพิมพ์เนื้อหาของสคริปต์ในกล่องโต้ตอบ แก้ไขเนื้อหา
หมายเหตุ
เนื่องจากตัวแก้ไขข้อความอย่างง่ายนี้นั้นไม่มีคุณลักษณะที่ใช้สำหรับตรวจสอบความถูกต้องของสคริปต์ โดยทั่วไปแล้วคุณควรพยายามใช้แอพลิเคชันที่แยกออกไปต่างหากเช่น Visual Studio เสมอในการแก้ไขสคริปต์ และจึงอัปโหลดสคริปต์ดังกล่าวนั้น
เลือก บันทึก และปิดกล่องโต้ตอบของทรัพยากรบนเว็บ
ทรัพยากรบนเว็บที่คุณสร้างขึ้นนั้นจะถูกเลือกใช้ในกล่องโต้ตอบ ค้นหาเรกคอร์ด เลือก เพิ่ม เพื่อปิดกล่องโต้ตอบ
ในส่วน ตัวจัดการเหตุการณ์ ให้เลือกเหตุการณ์ที่คุณต้องการตั้งค่าตัวจัดการเหตุการณ์ให้
เลือก เพิ่ม เพื่อเปิดกล่องโต้ตอบ คุณสมบัติตัวจัดการ
ในแท็บ รายละเอียด ให้เลือกไลบรารีที่เหมาะสม และพิมพ์ชื่อของฟังก์ชันที่ควรดำเนินการให้กับเหตุการณ์
โดยค่าเริ่มต้น ตัวจัดการเหตุการณ์นั้นจะถูกเปิดใช้งานเอาไว้ ล้างกล่องกาเครื่องหมาย เปิดใช้งาน ถ้าคุณไม่ต้องการเปิดใช้งานเหตุการณ์นี้
บางฟังก์ชันนั้นจำเป็นต้องมีการส่งผ่านบริบทการดำเนินการไปยังฟังก์ชัน เลือก ส่งผ่านบริบทการดำเนินการเป็นพารามิเตอร์แรก ถ้าจำเป็น
บางฟังก์ชันสามารถยอมรับชุดของพารามิเตอร์เพื่อใช้ควบคุมพฤติกรรมของฟังก์ชันนั้น ถ้าสิ่งเหล่านี้เป็นสิ่งจำเป็น ให้ป้อนลงใน รายการที่คั่นด้วยจุลภาคของพารามิเตอร์ที่จะส่งผ่านไปยังฟังก์ชัน
บนแท็บ การขึ้นต่อกัน ให้เพิ่มฟิลด์ที่สคริปต์นั้นขึ้นต่อลงไปในพื้นที่ ฟิลด์ที่สัมพันธ์กัน
เลือก ตกลง เพื่อปิดกล่องโต้ตอบ คุณสมบัติตัวจัดการ
เมื่อมีการใส่ตัวจัดการเหตุการณ์ คุณสามารถปรับลำดับที่ฟังก์ชันจะดำเนินการให้สัมพันธ์กับฟังก์ชันอื่นๆได้ด้วยการใช้ลูกศรสีเขียวเพื่อย้ายขึ้นหรือลง
เลือก ตกลง เพื่อปิดกล่องโต้ตอบคุณสมบัติขององค์ประกอบ
เลือก บันทึก เพื่อบันทึกการเปลี่ยนแปลงของคุณ เลือก เผยแพร่ เพื่อเผยแพร่ฟอร์ม
หมายเหตุ
ในขณะที่อินเทอร์เฟซผู้ใช้ (UI) ช่วยให้คุณสามารถปรับปรุงใบสั่งซึ่งสคริปต์จะถูกโหลด โดยใช้ขึ้น และ ลงลูกศรสีเขียว สคริปต์ได้โหลดไม่จริงตามลำดับ