รับข้อมูลหน้า

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

หมายเหตุ

นี่คือประเภทของการดำเนินการ Get data หากต้องการทำความเข้าใจวิธีใช้การดำเนินการประเภทนี้กับทริกเกอร์ Scheduled time และลูป For each โปรดดูกำหนดการ รับข้อมูล และเวิร์กโฟลว์แบบลูปใน Shopify Flow

การกำหนดค่า

ฟิลด์

การดำเนินการ Get page data มีฟิลด์ดังต่อไปนี้

ฟิลด์ที่ใช้ในการดำเนินการ Get data

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

สตริงคิวรี

ต่อไปนี้คือตัวอย่างคิวรีสำหรับการรับหน้าเว็บที่เผยแพร่แล้ว

published_status:published

ตัวแปร published_status เป็นตัวกรองที่มีในคิวรีหน้า ซึ่งสามารถใช้ได้หลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ

เมื่อคิวรีข้อมูล ข้อมูลต่อไปนี้อาจมีประโยชน์

• รายการตัวกรองหน้าที่พร้อมใช้งาน

• คิวรีต้องเป็นไปตามไวยากรณ์ที่กำหนด

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

• คุณสามารถรันหรือทดสอบคิวรีในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL

• โปรดระมัดระวังสิ่งที่จะเกิดขึ้นหากคิวรีของคุณล้มเหลว บ่อยครั้งที่ API จะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนเลย)

ข้อมูลที่ส่งคืน

การดำเนินการ Get data ทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ โดยขึ้นอยู่กับกรณีการใช้งานของคุณ คุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบต่างๆ ดังนี้

• หากคุณต้องการจัดการรายการแต่ละรายการแบบแยกกัน เช่น การเพิ่มแท็กให้กับแต่ละรายการ คุณสามารถใช้การดำเนินการ For each ได้
• หากคุณต้องการรวบรวมข้อมูล เช่น การนับจำนวนผลลัพธ์ที่ส่งคืน คุณสามารถใช้การดำเนินการ Count หรือ Sum ได้
• หากคุณต้องการแสดงผลรายการ เช่น ส่งอีเมลพร้อมรายการทั้งหมด คุณสามารถใช้ข้อมูลที่ส่งคืนในการดำเนินการถัดไปได้โดยตรง

หากต้องการเข้าถึงข้อมูลที่ส่งคืนในขั้นตอนที่ตามหลังการดำเนินการนี้ ให้ใช้ตัวแปรที่ชื่อ Get page data ซึ่งเป็นรายการหน้าเว็บ โดยคุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการหน้าในการดำเนินการ Send internal email ที่มีลักษณะดังนี้

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

หมายเหตุ

หากมีการใช้การดำเนินการ Get data หลายครั้งในเวิร์กโฟลว์เดียว ระบบจะเพิ่มตัวเลขลงในชื่อตัวแปร ตัวอย่างเช่น ในเวิร์กโฟลว์ที่ใช้การดำเนินการ Get order data สองครั้ง ตัวแปรแรกสำหรับข้อมูลที่ส่งคืนคือ getOrderData และตัวแปรที่สองคือ getOrderData1 โดยไม่สามารถปรับแต่งชื่อนี้ได้

ทริกเกอร์

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

ข้อมูลอ้างอิง API

หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับ API ที่ใช้ในการดำเนินการนี้ โปรดดูคิวรีหน้า