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