รับข้อมูลบริษัท
ในเวิร์กโฟลว์ที่ใช้ข้อมูลบริษัท คุณสามารถใช้การดำเนินการ รับข้อมูลบริษัท เพื่อดึงข้อมูลบริษัทจากร้านค้าของคุณได้
การกำหนดค่า
ช่อง
การดำเนินการ รับข้อมูลบริษัท ประกอบด้วยช่องต่อไปนี้ซึ่งใช้ในการสร้างคิวรี
| ช่อง | คำอธิบาย |
|---|---|
| จัดเรียงข้อมูลตาม | จำเป็นต้องระบุ พารามิเตอร์ที่ใช้จัดเรียงข้อมูลที่ส่งคืนโดยคำค้นหา |
| จำนวนผลลัพธ์สูงสุด | จำเป็นต้องระบุ จำนวนผลลัพธ์สูงสุดที่สามารถส่งคืนได้โดยคำค้นหาที่คุณเลือก คุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ |
| คิวรี | จำเป็นต้องระบุ เลือกจากคิวรีทั่วไปหรือเลือกขั้นสูงเพื่อสร้างคิวรีของคุณเอง |
สตริงคิวรี
นี่คือตัวอย่างคิวรีสำหรับรับข้อมูลบริษัทที่อัปเดตในวันล่าสุด
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'ตัวแปร updated_at คือตัวกรองที่ใช้ได้ในคิวรีบริษัท และสามารถใช้ซ้ำหลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ ได้ ส่วนตัวแปร Liquid scheduledAt จะมีให้ใช้งานในเวิร์กโฟลว์ที่ใช้ทริกเกอร์ตามเวลาที่กำหนด ทั้งนี้ แท็ก Liquid date_minus คือแท็ก Flow พิเศษที่ให้คุณลบเวลาออกจากวันที่ได้
สิ่งควรรู้เมื่อทำการค้นหาข้อมูล
- รายการตัวกรองบริษัทที่ใช้ได้
- คิวรีต้องเป็นไปตามไวยากรณ์ที่กำหนด
- ค่าของช่องคิวรีอาจไม่ได้ระบุไว้ในเอกสารเสมอไป ในบางกรณี คุณสามารถดูค่าเหล่านี้ได้โดยดูที่เอกสาร API หรือคุณมักจะพบค่าของช่องเหล่านี้ได้ใน URL ของส่วนผู้ดูแลเมื่อคุณทำการกรอง ตัวอย่างเช่น หากต้องการหาค่าคิวรีคำสั่งซื้อบางค่า ให้กรองข้อมูลที่หน้าคำสั่งซื้อในส่วนผู้ดูแล แล้วตรวจสอบ URL
- คุณสามารถรันหรือทดสอบคิวรีในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
- โปรดทราบว่าจะเกิดอะไรขึ้นหากคิวรีของคุณล้มเหลว บ่อยครั้งที่ API จะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนเลย)
ข้อมูลที่ส่งคืน
การดำเนินการ รับข้อมูล ทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ คุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบต่างๆ กันได้โดยขึ้นอยู่กับกรณีการใช้งานของคุณ ดังนี้
- หากคุณต้องการจัดการแต่ละรายการในลิสต์แยกกัน เช่น เพื่อเพิ่มแท็กให้แต่ละรายการ คุณสามารถใช้การดำเนินการ สำหรับแต่ละรายการ ได้
- หากคุณต้องการรวบรวมข้อมูล เช่น การนับจำนวนผลลัพธ์ที่ส่งคืนมา คุณสามารถใช้การดำเนินการ นับจำนวน หรือ หาผลรวม ได้
- หากคุณต้องการแสดงผลลัพธ์เป็นรายการ เช่น การส่งอีเมลที่มีรายการทั้งหมด คุณก็สามารถใช้ข้อมูลที่ส่งคืนมาโดยตรงในการดำเนินการถัดไปได้
หากต้องการเข้าถึงข้อมูลที่ส่งคืนมาในขั้นตอนต่างๆ ที่ตามหลังการดำเนินการนี้ ให้ใช้ตัวแปรชื่อ Get company data ซึ่งเป็นรายการของบริษัทต่างๆ คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการบริษัทในการดำเนินการ ส่งอีเมลภายใน ได้ดังนี้
{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}ทริกเกอร์
คุณสามารถใช้การดำเนินการนี้ในเวิร์กโฟลว์ใดก็ได้ รวมถึงทริกเกอร์เวลาที่กำหนดไว้ ในเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนดไว้ เวิร์กโฟลว์จะเริ่มทำงานตามเวลาที่คุณระบุไว้ แทนที่จะเป็นผลมาจากเหตุการณ์ใดเหตุการณ์หนึ่ง เนื่องจากไม่มีเหตุการณ์ที่เฉพาะเจาะจงในร้านค้าของคุณหรือจากแอปที่มาเริ่มต้นเวิร์กโฟลว์ จึงไม่มีข้อมูลใดรวมอยู่โดยอัตโนมัติ