ค้นหา
ค้นหาวัตถุโมเดลหนึ่งหรือหลายรายการในฐานข้อมูลตามฟิลด์และส่งคืนวัตถุเหล่านั้น
เคล็ดลับ : การค้นหาทั้งหมดไม่คำนึงถึงตัวพิมพ์เล็กและใหญ่ และค้นหาสตริงย่อย ซึ่งสอดคล้องกับคำสั่ง SQL "ILIKE" โดยมี "%" รอบค่าการค้นหา (เช่น หากคุณค้นหา "Max" ใน "first_name" ข้อความค้นหา SQL จะมีลักษณะดังนี้ " first_name" เหมือนกัน "%Max%")
เคล็ดลับ : คุณสามารถใช้ SQL Wildcards ในการค้นหาของคุณได้ ตัวอย่างเช่น หากคุณค้นหา "ma%m" ระบบจะส่งคืน "Maxim" หากคุณส่งสัญลักษณ์แทนเหล่านี้ผ่านพารามิเตอร์การสืบค้น URL ตรวจสอบให้แน่ใจว่าได้เข้ารหัสอักขระเหล่านั้นแล้ว (เช่น "%" กลายเป็น "%25" ในขณะที่ "_" สามารถคงอยู่เช่นเดิม)
เคล็ดลับ : ในการส่งอาร์เรย์ผ่านพารามิเตอร์การค้นหา URL ตรวจสอบให้แน่ใจว่าได้เข้ารหัสในรูปแบบต่อไปนี้ "arrayName[]=element1&arrayName[]=element2" (เช่น "สี[]=red&colors[]=blue")
การเชื่อมต่อการไหล
- [Input] In - เริ่มการดำเนินการของบล็อก
- [Output] Out - เปิดใช้งานเมื่อบล็อกเสร็จสิ้นการดำเนินการ
การเชื่อมต่อข้อมูล
- [Input] _Offset (integer, optional) - แถวแรกในฐานข้อมูลเพื่อเริ่มการค้นหาจาก (ดัชนีเริ่มต้นที่ 0)
- [Input] _Limit (integer, optional) - จำนวนสูงสุดของอ็อบเจกต์โมเดลที่จะส่งคืน
- [Input] _SortOrder (string, optional) - เรียงลำดับวัตถุโมเดลที่ส่งคืน (สามารถเป็น "ASC" สำหรับการเรียงลำดับจากน้อยไปมาก หรือ ""DESC" สำหรับการเรียงลำดับจากมากไปน้อย)
- [Input] _SortBy (string, optional) - ฟิลด์ที่วัตถุโมเดลที่ส่งคืนจะถูกจัดเรียง ชื่อของฟิลด์ควรระบุเป็นตัวพิมพ์เล็ก (เช่น "first_name")
- [Input] _with (enum, optional) - โมเดลข้อมูลที่เชื่อมต่อกับวัตถุโมเดลเป้าหมายเพื่อดึงข้อมูลจากฐานข้อมูล สามารถใช้หลังจากขยายวัตถุโมเดลที่พบ อ่านเพิ่มเติมเกี่ยวกับ _with ในคำถามที่พบบ่อยเกี่ยวกับกระบวนการทางธุรกิจ
- [Input] _Search (string, optional) - ค่าที่จะค้นหาในหลายฟิลด์พร้อมกันโดยใช้ตรรกะ OR (เช่น "first_name" = "Max" OR "last_name" = "Max")
- [Input] _SearchIn (string array, optional) - ฟิลด์ที่จะค้นหาสำหรับค่าที่กำหนดในอินพุตข้อมูล _Search ควรระบุชื่อช่องด้วยตัวพิมพ์เล็ก (เช่น "first_name")
- [Input] Fields (multiple, any) - ค่าฟิลด์ที่จะค้นหา ออบเจกต์ใดๆ ที่มีสตริงย่อยดังกล่าวจะถูกส่งกลับ การค้นหาจะไม่คำนึงถึงตัวพิมพ์เล็กและใหญ่ (เช่น หากตั้งค่าเป็น "MAX" และค่าของออบเจ็กต์ในฐานข้อมูลเป็น "Maxim" จะถูกส่งกลับ) การค้นหาจะเทียบเท่ากับคำสั่ง SQL "ILIKE" และอินพุตที่ไม่ใช่ค่า Null จะรวมกันโดยใช้ตรรกะ AND (เช่น "First Name" ILIKE "%Max%" AND "Last Name" ILIKE "%Parker%")
- [Output] Data (model array) - วัตถุโมเดลที่พบในฐานข้อมูล
- [Output] Count (integer) - จำนวนวัตถุโมเดลที่พบ
ในกรณีที่โมเดลที่คุณกำลังค้นหามีความสัมพันธ์แบบหนึ่งต่อกลุ่มหรือกลุ่มต่อกลุ่ม และคุณได้เลือกโมเดลที่เกี่ยวข้องที่จะส่งคืนโดยใช้การป้อนข้อมูล _with คุณจะสามารถกำหนดได้ว่าวัตถุที่เกี่ยวข้องใดที่จะถูกส่งกลับ (โดยใช้ _Sort, _Search และที่คล้ายกัน) โปรดทราบว่าคุณจะไม่กรองโมเดลที่กำลังค้นหาด้วยพารามิเตอร์เหล่านี้ แต่จะกรองเฉพาะโมเดลที่เกี่ยวข้อง (ดูวิดีโอด้านบนสำหรับรายละเอียดเพิ่มเติม)