კოლექციის მონაცემების მიღება
სამუშაო პროცესებში, რომლებიც კოლექციის მონაცემებს მოითხოვს, შეგიძლია გამოიყენო ქმედება კოლექციის მონაცემების მიღება (Get collection data) შენი მაღაზიიდან კოლექციის ინფორმაციის მისაღებად.
კონფიგურაცია
ველები
ქმედება კოლექციის მონაცემების მიღება შეიცავს შემდეგ ველებს.
| ველი | აღწერა |
|---|---|
| მონაცემების დახარისხება | სავალდებულოა. პარამეტრები, რომელთა მიხედვითაც ხარისხდება საძიებო მოთხოვნის მიერ დაბრუნებული მონაცემები. |
| შედეგების მაქსიმალური რაოდენობა | სავალდებულოა. შედეგების მაქსიმალური რაოდენობა, რომლის დაბრუნებაც შეუძლია შენ მიერ არჩეულ საძიებო მოთხოვნას. ერთდროულად შეგიძლია დააბრუნო 100-მდე შედეგი. |
| მოთხოვნა | სავალდებულოა. აირჩიე სტანდარტული მოთხოვნებიდან ან მონიშნე გაფართოებული (Advanced), რათა შექმნა შენი საკუთარი. |
მოთხოვნის სტრიქონი
ეს არის მოთხოვნის მაგალითი ბოლო დღეში განახლებული კოლექციების მისაღებად:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'ცვლადი updated_at წარმოადგენს ფილტრს, რომელიც ხელმისაწვდომია კოლექციების მოთხოვნაში და მისი გამოყენება შესაძლებელია რამდენჯერმე, ან სხვა ცვლადებთან ერთად. Liquid ცვლადი scheduledAt ხელმისაწვდომია იმ სამუშაო პროცესებში, რომლებმაც გამოიყენეს დაგეგმილი დროის ტრიგერი. Liquid თეგი date_minus არის Flow-ს სპეციალური თეგი, რომელიც თარიღისთვის დროის გამოკლების საშუალებას გაძლევს.
მონაცემების გამოთხოვისას სასარგებლოა იცოდე:
- კოლექციის ხელმისაწვდომი ფილტრების სია
- მოთხოვნები უნდა მიჰყვებოდეს კონკრეტულ სინტაქსს
- მოთხოვნის ველის მნიშვნელობები ყოველთვის არ არის დოკუმენტირებული. ზოგ შემთხვევაში მნიშვნელობების მოძიება API-ის დოკუმენტაციაში შეგიძლია. გარდა ამისა, ველის მნიშვნელობების პოვნა გაფილტვრისას ხშირად შეგიძლია ადმინ პანელში არსებულ URL-ებში. მაგალითად, შეკვეთის (Order) მოთხოვნის ზოგიერთი მნიშვნელობის მოსაძებნად, გაფილტრე შეკვეთების გვერდი ადმინ პანელში და შემდეგ შეამოწმე URL.
- შენს მაღაზიაში მოთხოვნის გასაშვებად ან შესამოწმებლად შეგიძლია გამოიყენო Shopify GraphiQL აპი.
- გაითვალისწინე, რა ხდება მოთხოვნის წარუმატებლობის შემთხვევაში. ხშირად API აბრუნებს ყველა შედეგს (და არა არცერთს).
დაბრუნებული მონაცემები
მონაცემების მიღების (Get data) ყველა ქმედება აბრუნებს 0-დან 100-მდე რესურსისგან შემდგარ სიას. შენი გამოყენების შემთხვევის მიხედვით, შესაძლოა ამ მონაცემების გამოყენება სხვადასხვა გზით დაგჭირდეს:
- თუ სიის თითოეული ერთეულის ინდივიდუალურად დამუშავება გჭირდება (მაგალითად, თითოეულისთვის თეგის დასამატებლად), შეგიძლია გამოიყენო ქმედება For each.
- თუ მონაცემების შეგროვება გჭირდება (მაგალითად, დაბრუნებული შედეგების რაოდენობის დათვლა), შეგიძლია გამოიყენო ქმედებები Count ან Sum.
- თუ სიის გამოტანა გჭირდება (მაგალითად, ყველა ერთეულის ელფოსტით გაგზავნა), დაბრუნებული მონაცემების გამოყენება პირდაპირ შეგიძლია შემდგომ ქმედებებში.
ამ ქმედების შემდგომ ნაბიჯებში დაბრუნებულ მონაცემებზე წვდომისთვის გამოიყენე ცვლადი სახელწოდებით Get collection data, რომელიც კოლექციების სიას წარმოადგენს. ამ ცვლადის გამოყენება შეგიძლია როგორც პირობებში, ისე ქმედებებში. მაგალითად, კოლექციების სიის გაგზავნა შეგიძლია შიდა ელფოსტის გაგზავნის (Send internal email) ქმედებაში ასე:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}ტრიგერები
ამ ქმედების გამოყენება შეგიძლია ნებისმიერ სამუშაო პროცესში, მათ შორის Scheduled time ტრიგერში. სამუშაო პროცესში, რომელიც იყენებს Scheduled time ტრიგერს, სამუშაო პროცესი იწყება შენ მიერ მითითებულ დროს და არა რაიმე მოვლენის შედეგად. რადგან შენს მაღაზიაში ან აპში არ არსებობს კონკრეტული მოვლენა, რომელიც იწყებს სამუშაო პროცესს, მონაცემები ავტომატურად არ დაერთვის.