#กฎการเชื่อมโยง

#บทนำ

ใน NocoBase กฎการเชื่อมโยงคือกลไกที่ใช้ควบคุมการทำงานร่วมกันขององค์ประกอบต่างๆ บนหน้าจอส่วนหน้า (frontend) ช่วยให้ผู้ใช้สามารถปรับการแสดงผลและตรรกะการทำงานของบล็อก (block), ฟิลด์ (field) และการดำเนินการ (action) บนหน้าจอได้ตามเงื่อนไขที่แตกต่างกัน เพื่อสร้างประสบการณ์การโต้ตอบที่ยืดหยุ่นและใช้โค้ดน้อย (low-code) ฟีเจอร์นี้กำลังได้รับการพัฒนาและปรับปรุงอย่างต่อเนื่องครับ/ค่ะ

การตั้งค่ากฎการเชื่อมโยงช่วยให้คุณสามารถทำสิ่งต่างๆ ได้ เช่น:

• ซ่อน/แสดงบล็อกบางส่วนตามบทบาทของผู้ใช้ปัจจุบัน โดยบทบาทที่ต่างกันจะเห็นบล็อกที่มีขอบเขตข้อมูลต่างกัน เช่น ผู้ดูแลระบบจะเห็นบล็อกที่มีข้อมูลครบถ้วน ในขณะที่ผู้ใช้ทั่วไปจะเห็นเฉพาะบล็อกข้อมูลพื้นฐานเท่านั้น
• เมื่อเลือกตัวเลือกใดตัวเลือกหนึ่งในฟอร์ม ให้กรอกหรือรีเซ็ตค่าฟิลด์อื่นโดยอัตโนมัติ
• เมื่อเลือกตัวเลือกใดตัวเลือกหนึ่งในฟอร์ม ให้ปิดใช้งานช่องกรอกข้อมูลบางรายการ
• เมื่อเลือกตัวเลือกใดตัวเลือกหนึ่งในฟอร์ม ให้กำหนดให้ช่องกรอกข้อมูลบางรายการเป็นช่องที่ต้องกรอก
• ควบคุมว่าปุ่มดำเนินการจะมองเห็นได้หรือคลิกได้ภายใต้เงื่อนไขบางอย่างหรือไม่

#การตั้งค่าเงื่อนไข

#ตัวแปรฝั่งซ้าย

ตัวแปรฝั่งซ้ายในเงื่อนไขใช้สำหรับกำหนด "วัตถุที่ใช้ในการตัดสิน" ในกฎการเชื่อมโยง นั่นคือ การตัดสินเงื่อนไขจะอิงตามค่าของตัวแปรนี้ เพื่อพิจารณาว่าจะเรียกใช้การเชื่อมโยงหรือไม่ครับ/ค่ะ

ตัวแปรที่สามารถเลือกได้ ได้แก่:

• ฟิลด์ที่อยู่ในบริบท (context) เช่น 「ฟอร์มปัจจุบัน/xxx」 (Current Form/xxx), 「บันทึกปัจจุบัน/xxx」 (Current Record/xxx), 「บันทึกป๊อปอัปปัจจุบัน/xxx」 (Current Popup Record/xxx) เป็นต้น
• ตัวแปรระบบส่วนกลาง (system global variables) เช่น ผู้ใช้ปัจจุบัน (Current User), บทบาทปัจจุบัน (Current Role) เป็นต้น ซึ่งเหมาะสำหรับการควบคุมแบบไดนามิกตามข้อมูลประจำตัวผู้ใช้ สิทธิ์ และข้อมูลอื่นๆ

  ✅ ตัวเลือกสำหรับตัวแปรฝั่งซ้ายจะถูกกำหนดโดยบริบทของบล็อกนั้นๆ โปรดใช้ตัวแปรฝั่งซ้ายให้เหมาะสมกับความต้องการทางธุรกิจครับ/ค่ะ:

  • 「ผู้ใช้ปัจจุบัน」 (Current User) หมายถึงข้อมูลของผู้ใช้ที่เข้าสู่ระบบอยู่ในขณะนั้น
  • 「ฟอร์มปัจจุบัน」 (Current Form) หมายถึงค่าที่ป้อนแบบเรียลไทม์ในฟอร์ม
  • 「บันทึกปัจจุบัน」 (Current Record) หมายถึงค่าบันทึกที่ถูกบันทึกไว้ เช่น บันทึกแถวในตาราง

#ตัวดำเนินการ

ตัวดำเนินการใช้สำหรับกำหนดตรรกะในการตัดสินเงื่อนไข นั่นคือ วิธีการเปรียบเทียบตัวแปรฝั่งซ้ายกับค่าฝั่งขวา ตัวแปรฝั่งซ้ายประเภทต่างๆ จะรองรับตัวดำเนินการที่แตกต่างกัน โดยตัวดำเนินการประเภทที่พบบ่อยมีดังนี้ครับ/ค่ะ:

• ประเภทข้อความ: $includes, $eq, $ne, $empty, $notEmpty เป็นต้น
• ประเภทตัวเลข: $eq, $gt, $lt, $gte, $lte เป็นต้น
• ประเภทบูลีน: $isTruly, $isFalsy
• ประเภทอาร์เรย์: $match, $anyOf, $empty, $notEmpty เป็นต้น

✅ ระบบจะแนะนำรายการตัวดำเนินการที่ใช้งานได้โดยอัตโนมัติตามประเภทของตัวแปรฝั่งซ้าย เพื่อให้แน่ใจว่าตรรกะการตั้งค่านั้นสมเหตุสมผลครับ/ค่ะ

#ค่าฝั่งขวา

ใช้สำหรับเปรียบเทียบกับตัวแปรฝั่งซ้าย เป็นค่าอ้างอิงในการพิจารณาว่าเงื่อนไขเป็นจริงหรือไม่ครับ/ค่ะ

เนื้อหาที่รองรับ ได้แก่:

• ค่าคงที่ (Constant values): ป้อนค่าตัวเลข ข้อความ วันที่ หรืออื่นๆ ที่กำหนดไว้
• ตัวแปรบริบท (Context variables): เช่น ฟิลด์อื่นๆ ในฟอร์มปัจจุบัน, บันทึกปัจจุบัน เป็นต้น
• ตัวแปรระบบ (System variables): เช่น ผู้ใช้ปัจจุบัน, เวลาปัจจุบัน, บทบาทปัจจุบัน เป็นต้น

✅ ระบบจะปรับวิธีการป้อนข้อมูลสำหรับค่าฝั่งขวาโดยอัตโนมัติตามประเภทของตัวแปรฝั่งซ้าย เช่น:

• เมื่อฝั่งซ้ายเป็น "ฟิลด์ตัวเลือก" (Select field) จะแสดงตัวเลือกที่เกี่ยวข้อง
• เมื่อฝั่งซ้ายเป็น "ฟิลด์วันที่" (Date field) จะแสดงตัวเลือกวันที่
• เมื่อฝั่งซ้ายเป็น "ฟิลด์ข้อความ" (Text field) จะแสดงช่องกรอกข้อความ

💡 การใช้ค่าฝั่งขวาอย่างยืดหยุ่น (โดยเฉพาะตัวแปรแบบไดนามิก) ช่วยให้คุณสามารถสร้างตรรกะการเชื่อมโยงที่อิงตามผู้ใช้ปัจจุบัน สถานะข้อมูลปัจจุบัน และสภาพแวดล้อมของบริบท ซึ่งจะนำไปสู่ประสบการณ์การโต้ตอบที่ทรงพลังยิ่งขึ้นครับ/ค่ะ

#ตรรกะการทำงานของกฎ

#การเรียกใช้เงื่อนไข

เมื่อเงื่อนไขในกฎเป็นจริง (ไม่บังคับ) การดำเนินการแก้ไขคุณสมบัติที่อยู่ด้านล่างจะถูกเรียกใช้โดยอัตโนมัติ หากไม่ได้ตั้งค่าเงื่อนไข ระบบจะถือว่ากฎเป็นจริงเสมอ และจะดำเนินการแก้ไขคุณสมบัติโดยอัตโนมัติครับ/ค่ะ

#กฎหลายรายการ

คุณสามารถตั้งค่ากฎการเชื่อมโยงหลายรายการสำหรับฟอร์มเดียวได้ เมื่อเงื่อนไขของกฎหลายรายการเป็นจริงพร้อมกัน ระบบจะดำเนินการตามลำดับจากรายการแรกไปรายการสุดท้าย นั่นหมายความว่าผลลัพธ์สุดท้ายจะเป็นมาตรฐานในการดำเนินการครับ/ค่ะ ตัวอย่าง: กฎที่ 1 ตั้งค่าฟิลด์เป็น "ปิดใช้งาน" (Disabled) และกฎที่ 2 ตั้งค่าฟิลด์เป็น "แก้ไขได้" (Editable) หากเงื่อนไขของทั้งสองกฎเป็นจริง ฟิลด์นั้นจะอยู่ในสถานะ "แก้ไขได้" ครับ/ค่ะ

ลำดับการทำงานของกฎหลายรายการมีความสำคัญอย่างยิ่งครับ/ค่ะ เมื่อออกแบบกฎ โปรดตรวจสอบให้แน่ใจว่าได้ทำความเข้าใจลำดับความสำคัญและความสัมพันธ์ระหว่างกัน เพื่อหลีกเลี่ยงความขัดแย้งของกฎ

#การจัดการกฎ

คุณสามารถดำเนินการกับแต่ละกฎได้ดังนี้ครับ/ค่ะ:

• กำหนดชื่อเอง (Custom Naming): ตั้งชื่อกฎที่เข้าใจง่าย เพื่อการจัดการและการระบุตัวตน
• จัดเรียง (Sorting): ปรับลำดับตามลำดับความสำคัญในการทำงานของกฎ เพื่อให้แน่ใจว่าระบบจะประมวลผลกฎตามลำดับที่ถูกต้อง
• ลบ (Delete): ลบกฎที่ไม่จำเป็นอีกต่อไป
• เปิดใช้งาน/ปิดใช้งาน (Enable/Disable): ปิดใช้งานกฎชั่วคราวโดยไม่ต้องลบ เหมาะสำหรับสถานการณ์ที่ต้องการหยุดการทำงานของกฎชั่วคราว
• คัดลอกกฎ (Duplicate Rule): สร้างกฎใหม่โดยการคัดลอกกฎที่มีอยู่ เพื่อหลีกเลี่ยงการตั้งค่าซ้ำซ้อน

#เกี่ยวกับตัวแปร

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

#กฎการเชื่อมโยงบล็อก

กฎการเชื่อมโยงบล็อกช่วยให้สามารถควบคุมการแสดงผลของบล็อกแบบไดนามิกได้ โดยอิงตามตัวแปรระบบ (เช่น ผู้ใช้ปัจจุบัน, บทบาท) หรือตัวแปรบริบท (เช่น บันทึกป๊อปอัปปัจจุบัน) ตัวอย่างเช่น ผู้ดูแลระบบสามารถดูข้อมูลคำสั่งซื้อทั้งหมดได้ ในขณะที่บทบาทฝ่ายบริการลูกค้าจะสามารถดูข้อมูลคำสั่งซื้อที่เฉพาะเจาะจงเท่านั้น ด้วยกฎการเชื่อมโยงบล็อก คุณสามารถตั้งค่าบล็อกที่เกี่ยวข้องตามบทบาท และกำหนดฟิลด์ ปุ่มดำเนินการ และขอบเขตข้อมูลที่แตกต่างกันภายในบล็อกเหล่านั้น เมื่อบทบาทที่เข้าสู่ระบบเป็นบทบาทเป้าหมาย ระบบจะแสดงบล็อกที่เกี่ยวข้อง สิ่งสำคัญคือต้องทราบว่าบล็อกจะแสดงผลตามค่าเริ่มต้น ดังนั้นโดยปกติแล้วคุณจะต้องกำหนดตรรกะสำหรับการซ่อนบล็อกครับ/ค่ะ

👉 ดูรายละเอียดเพิ่มเติมได้ที่: บล็อก/กฎการเชื่อมโยงบล็อก

#กฎการเชื่อมโยงฟิลด์

กฎการเชื่อมโยงฟิลด์ใช้สำหรับปรับสถานะของฟิลด์ในฟอร์มหรือบล็อกรายละเอียดแบบไดนามิกตามการกระทำของผู้ใช้ ซึ่งส่วนใหญ่ประกอบด้วย:

• ควบคุมสถานะ แสดง/ซ่อน ของฟิลด์
• กำหนดว่าฟิลด์นั้น ต้องกรอก หรือไม่
• การกำหนดค่า
• เรียกใช้ JavaScript เพื่อจัดการตรรกะทางธุรกิจที่กำหนดเอง

👉 ดูรายละเอียดเพิ่มเติมได้ที่: บล็อก/กฎการเชื่อมโยงฟิลด์

#กฎการเชื่อมโยงการดำเนินการ

กฎการเชื่อมโยงการดำเนินการในปัจจุบันรองรับการควบคุมพฤติกรรมการดำเนินการ เช่น การซ่อน/การปิดใช้งาน โดยอิงตามตัวแปรบริบท เช่น ค่าบันทึกปัจจุบันและฟอร์มปัจจุบัน รวมถึงตัวแปรส่วนกลางครับ/ค่ะ

👉 ดูรายละเอียดเพิ่มเติมได้ที่: การดำเนินการ/กฎการเชื่อมโยง