รับข้อมูลตำแหน่งที่ตั้งของบริษัท

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

การกำหนดค่า

ฟิลด์

การดำเนินการ รับข้อมูลตำแหน่งที่ตั้งของบริษัท มีฟิลด์ต่อไปนี้ ซึ่งใช้เพื่อสร้างคำค้นหา

ฟิลด์ที่ใช้ในการดำเนินการรับข้อมูล
ฟิลด์คำอธิบาย
จัดเรียงข้อมูลตามจำเป็น พารามิเตอร์ที่ใช้จัดเรียงข้อมูลที่ส่งคืนโดยคำค้นหา
จำนวนผลลัพธ์สูงสุดจำเป็น จำนวนผลลัพธ์สูงสุดที่สามารถส่งคืนโดยคำค้นหาที่คุณเลือก คุณสามารถส่งคืนได้สูงสุดครั้งละ 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 รายการ คุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบต่างๆ กันไป ทั้งนี้ขึ้นอยู่กับกรณีการใช้งานของคุณ

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

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

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}

ทริกเกอร์

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

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