รับข้อมูลสัญญาการสมัครใช้งาน
ในเวิร์กโฟลว์ที่ใช้ข้อมูลสัญญาการสมัครใช้งาน คุณสามารถใช้การดำเนินการ รับข้อมูลสัญญาการสมัครใช้งาน เพื่อดึงข้อมูลสัญญาการสมัครใช้งานจากร้านค้าของคุณได้
การกำหนดค่า
ช่องข้อมูล
การดำเนินการ รับข้อมูลสัญญาการสมัครใช้งาน ประกอบด้วยช่องข้อมูลต่อไปนี้ ซึ่งใช้เพื่อสร้างคำค้นหา
| ช่องข้อมูล | คำอธิบาย |
|---|---|
| จัดเรียงข้อมูลตาม | จำเป็น พารามิเตอร์ที่ใช้จัดเรียงข้อมูลที่ส่งคืนจากคำค้นหา |
| จำนวนผลลัพธ์สูงสุด | จำเป็น จำนวนผลลัพธ์สูงสุดที่คำค้นหาที่คุณเลือกสามารถส่งคืนได้ คุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ |
| คำค้นหา | จำเป็น เลือกระหว่างคำค้นหาทั่วไปหรือเลือกขั้นสูงเพื่อสร้างคำค้นหาของคุณเอง |
สตริงคำค้นหา
นี่คือตัวอย่างคำค้นหาสำหรับรับสัญญาการสมัครใช้งานที่มีสถานะเป็น ACTIVE ดังนี้
status: ACTIVEตัวแปร status คือตัวกรองที่มีอยู่ในคำค้นหาสัญญาการสมัครใช้งานและสามารถใช้ซ้ำได้
ข้อควรรู้เมื่อทำการค้นหาข้อมูลมีดังนี้
- รายการตัวกรองที่ใช้ได้
- คำค้นหาต้องเป็นไปตามไวยากรณ์ที่กำหนด
- ค่าช่องข้อมูลของคำค้นหาไม่ได้มีระบุไว้ในเอกสารเสมอไป ในบางกรณี สามารถดูค่าเหล่านี้ได้จากเอกสาร API หรืออีกวิธีหนึ่งคือ คุณมักจะพบค่าช่องข้อมูลเหล่านี้ได้ใน URL ของส่วนผู้ดูแลเมื่อคุณใช้ตัวกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าคำค้นหาของคำสั่งซื้อบางรายการ ให้กรองหน้าคำสั่งซื้อในส่วนผู้ดูแล จากนั้นจึงตรวจสอบ URL
- คุณสามารถรันหรือทดสอบคำค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
- โปรดทราบถึงสิ่งที่อาจเกิดขึ้นหากคำค้นหาของคุณล้มเหลว โดย API มักจะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนผลลัพธ์ใดๆ)
ข้อมูลที่ส่งคืน
การดำเนินการรับข้อมูลทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ คุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบต่างๆ กันไปตามกรณีการใช้งานของคุณ ดังนี้
- หากคุณต้องการจัดการแต่ละรายการในลิสต์แยกกัน เช่น การเพิ่มแท็กสำหรับแต่ละรายการ คุณสามารถใช้การดำเนินการสำหรับแต่ละรายการได้
- หากคุณต้องการรวบรวมข้อมูล เช่น การนับจำนวนผลลัพธ์ที่ส่งคืนมา คุณสามารถใช้การดำเนินการนับ หรือผลรวมได้
- หากคุณต้องการแสดงผลลัพธ์ของลิสต์ เช่น ส่งอีเมลพร้อมกับทุกรายการ คุณสามารถใช้ข้อมูลที่ส่งคืนได้โดยตรงในการดำเนินการถัดๆ ไป
หากต้องการเข้าถึงข้อมูลที่ส่งคืนในขั้นตอนที่ตามหลังการดำเนินการนี้ ให้ใช้ตัวแปรชื่อ Get subscription contract data ซึ่งเป็นรายการสัญญาการสมัครใช้งาน คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการสัญญาการสมัครใช้งานในการดำเนินการ ส่งอีเมลภายใน ได้ดังนี้
{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}ทริกเกอร์
คุณสามารถใช้การดำเนินการนี้ในเวิร์กโฟลว์ใดก็ได้ รวมถึงทริกเกอร์เวลาที่กำหนดไว้ สำหรับเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนดไว้ เวิร์กโฟลว์จะเริ่มต้น ณ เวลาที่คุณระบุไว้ แทนที่จะเริ่มจากการเกิดเหตุการณ์ เนื่องจากไม่มีเหตุการณ์เฉพาะเจาะจงในร้านค้าของคุณหรือจากแอปที่เริ่มเวิร์กโฟลว์ จึงไม่มีข้อมูลรวมอยู่โดยอัตโนมัติ