รับข้อมูลคอลเลกชัน
คุณสามารถใช้การดำเนินการ “รับข้อมูลคอลเลกชัน” เพื่อกู้คืนข้อมูลคอลเลกชันจากร้านค้าได้ในขั้นตอนการทำงานที่ต้องใช้ข้อมูลคอลเลกชัน
การกำหนดค่า
ช่อง
การดำเนินการรับข้อมูลคอลเลกชันประกอบด้วยช่องดังต่อไปนี้
ช่อง | คำอธิบาย |
---|---|
จัดเรียงข้อมูลตาม | จำเป็นต้องมี พารามิเตอร์ที่ทำให้ระบบจัดเรียงข้อมูลส่งกลับจากคำค้นหา |
จํานวนผลลัพธ์สูงสุด | ต้องระบุ จํานวนผลลัพธ์สูงสุดที่ระบบสามารถส่งคืนจากคำค้นหาที่คุณเลือกคุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ |
คำค้นหา | ต้องระบุ เลือกจากคำค้นหาทั่วไปหรือเลือก “Advanced” เพื่อสร้างคำค้นหาของคุณเอง |
สตริงคำค้นหา
ต่อไปนี้เป็นตัวอย่างคำค้นหาเกี่ยวกับการรับคอลเลกชันที่อัปเดตในวันที่ผ่านมา:
ตัวแปร updated_at
คือตัวกรองที่มีอยู่ในคำค้นหาเกี่ยวกับคอลเลกชัน และสามารถใช้ได้หลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ ได้ ตัวแปร Liquid scheduledAt
มีอยู่ในขั้นตอนการทำงานที่ใช้ทริกเกอร์ “Scheduled time” แท็ก Liquid date_minus
เป็นแท็ก Flow พิเศษที่ช่วยให้คุณสามารถลบเวลาออกจากวันที่ได้
เมื่อค้นหาข้อมูลจะมีข้อควรทราบดังนี้:
- [รายการตัวกรองคอลเลกชันที่พร้อมใช้งาน - คำค้นหาต้องเป็นไปตามโครงสร้างทางไวยากรณ์บางรูปแบบ
- คุณสามารถดูชื่อช่องคำค้นหาของคำค้นหาทั้งหมดได้ในเอกสารสำหรับผู้พัฒนาของอ็อบเจกต์ QueryRoot
- ระบบไม่ได้บันทึกค่าช่องคำค้นหาเสมอไป ในบางกรณี คุณสามารถดูค่าได้โดยไปที่เอกสาร API หรือคุณจะค้นหาค่าช่องข้อมูลใน URL ต่างๆ ในส่วนผู้ดูแลเมื่อทำการกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าคำค้นหาเกี่ยวกับ “Order” ให้กรองหน้า “คำสั่งซื้อ” ในส่วนผู้ดูแล จากนั้นจึงตรวจสอบ URL
- คุณสามารถเรียกใช้หรือทดสอบคำค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
- โปรดระวังสิ่งที่จะเกิดขึ้นหากดำเนินการค้นหา ไม่สำเร็จ API มักจะส่งคืนผลลัพธ์ทั้งหมด (แทนไม่มี) ](https://shopify.dev/docs/api/admin-graphql/latest/objects/QueryRoot#connection-queryroot-collections)
ข้อมูลที่ส่งคืน
การดำเนินการ “Get data” ทั้งหมดจะส่งคืนรายการแหล่งข้อมูลตั้งแต่ 0 ถึง 100 รายการ คุณสามารถใช้ข้อมูลนี้ในรูปแบบต่างๆ ตามกรณีการใช้งานของคุณดังต่อไปนี้:
- หากคุณต้องจัดการรายการสินค้าแต่ละรายการแยกกัน เช่น เพิ่มแท็กของแต่ละรายการ คุณสามารถใช้การดำเนินการ “For each” ได้
- หากคุณต้องการรวมข้อมูล เช่น จํานวนผลลัพธ์ที่ถูกส่งคืน คุณสามารถใช้การดําเนินการ “Count” หรือ “Sum” ได้
- หากคุณต้องการส่งออกรายการ เช่น ส่งอีเมลพร้อมรายการสิ นค้าทั้งหมด คุณสามารถใช้ “returned data” ได้โดยตรงในการดำเนินการครั้งถัดไป
หากต้องการเข้าถึงข้อมูลที่ส่งคืนแล้วในขั้นตอนที่เป็นไปตามการดำเนินการนี้ ให้ใช้ตัวแปรชื่อ “Get collection data” ซึ่งเป็นรายการคอลเลกชัน คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการคอลเลกชันในการดำเนินการ “Send internal email” ดังต่อไปนี้ได้:
ทริกเกอร์
โดยคุณสามารถใช้การดำเนินการนี้ในขั้นตอนการทำงานใดก็ได้ รวมถึงทริกเกอร์ “เวลาที่กำหนดไว้” ซึ่งขั้นตอนการทำงานที่ใช้ทริกเกอร์ “เวลาที่กำหนดไว้” จะเริ่มต้น ณ เวลาที่คุณระบุไว้ ไม่ใช่เป็นผลลัพธ์ของเหตุการณ์ใดเหตุการณ์หนึ่ง และเนื่องจากไม่มีเหตุการณ์เฉพาะเจาะจงในร้านค้าของคุณหรือจากแอปที่เริ่มขั้นตอนการทำงานดังกล่าว ระบบจึงจะไม่ได้รวมข้อมูลใดๆ ไว้โดยอัตโนมัติ
ตัวอย่างเช่น
ในตัวอย่างขั้นตอนการทำงานนี้ ระบบจะส่งอีเมลสำหรับใช้ภายในหากมีคอลเลกชันใดก็ตามที่มีชื่อว่า "ใหม่"