კატალოგის მონაცემების მიღება

სამუშაო პროცესებში, რომლებიც კატალოგის მონაცემებს მოითხოვს, შეგიძლია გამოიყენო ქმედება კატალოგის მონაცემების მიღება (Get catalog data), რათა მიიღო B2B კატალოგის ინფორმაცია შენი მაღაზიიდან. კატალოგები არის პროდუქტების ჯგუფები მორგებული ფასებით კონკრეტული B2B მომხმარებლებისთვის ან კომპანიის ლოკაციებისთვის.

ამ გვერდზე

კონფიგურაცია

ველები

ქმედება კატალოგის მონაცემების მიღება შეიცავს შემდეგ ველებს:

მონაცემების მიღების (Get data) ქმედებებში გამოყენებული ველები.
ველი	აღწერა
მონაცემების დახარისხება	სავალდებულოა. პარამეტრები, რომელთა მიხედვითაც ხარისხდება საძიებო მოთხოვნის მიერ დაბრუნებული მონაცემები.
შედეგების მაქსიმალური რაოდენობა	სავალდებულოა. შენ მიერ არჩეული საძიებო მოთხოვნის შედეგად დაბრუნებული შედეგების მაქსიმალური რაოდენობა. ერთ ჯერზე შეგიძლია, დააბრუნო მაქსიმუმ 100.
მოთხოვნა	სავალდებულოა. აირჩიე სტანდარტული მოთხოვნებიდან ან მონიშნე Advanced შენი საკუთარის შესაქმნელად.

მოთხოვნის სტრიქონი

ეს არის მოთხოვნის მაგალითი ყველა აქტიური კატალოგის მისაღებად:

status:ACTIVE

ცვლადი status არის ფილტრი, რომელიც ხელმისაწვდომია Catalogs მოთხოვნაში და მისი გამოყენება შესაძლებელია რამდენჯერმე, ან სხვა ცვლადებთან კომბინაციაში.

მონაცემების გამოთხოვისას სასარგებლოა იცოდე:

ხელმისაწვდომი კატალოგის ფილტრების სია
მოთხოვნები უნდა მიჰყვებოდეს კონკრეტულ სინტაქსს
მოთხოვნის ველის მნიშვნელობები ყოველთვის არ არის დოკუმენტირებული. ზოგ შემთხვევაში მნიშვნელობების მოძიება API-ის დოკუმენტაციაში შეგიძლია. გარდა ამისა, ველის მნიშვნელობების პოვნა გაფილტვრისას ხშირად შეგიძლია ადმინ პანელში არსებულ URL-ებში. მაგალითად, შეკვეთის (Order) მოთხოვნის ზოგიერთი მნიშვნელობის მოსაძებნად, გაფილტრე შეკვეთების გვერდი ადმინ პანელში და შემდეგ შეამოწმე URL.
შენს მაღაზიაში მოთხოვნის გასაშვებად ან შესამოწმებლად შეგიძლია გამოიყენო Shopify GraphiQL აპი.
გაითვალისწინე, რა ხდება მოთხოვნის წარუმატებლობის შემთხვევაში. ხშირად API აბრუნებს ყველა შედეგს (და არა არცერთს).

დაბრუნებული მონაცემები

მონაცემების მიღების (Get data) ყველა ქმედება აბრუნებს 0-დან 100-მდე რესურსისგან შემდგარ სიას. შენი გამოყენების შემთხვევის მიხედვით, შესაძლოა ამ მონაცემების გამოყენება სხვადასხვა გზით დაგჭირდეს:

თუ სიის თითოეული ერთეულის ინდივიდუალურად დამუშავება გჭირდება (მაგალითად, თითოეულისთვის თეგის დასამატებლად), შეგიძლია გამოიყენო ქმედება For each.
თუ მონაცემების შეგროვება გჭირდება (მაგალითად, დაბრუნებული შედეგების რაოდენობის დათვლა), შეგიძლია გამოიყენო ქმედებები Count ან Sum.
თუ სიის გამოტანა გჭირდება (მაგალითად, ყველა ერთეულის ელფოსტით გაგზავნა), დაბრუნებული მონაცემების გამოყენება პირდაპირ შეგიძლია შემდგომ ქმედებებში.

ამ ქმედების შემდგომ ნაბიჯებში დაბრუნებულ მონაცემებზე წვდომისთვის გამოიყენე ცვლადი სახელწოდებით Get catalog data, რომელიც კატალოგების სიას წარმოადგენს. ამ ცვლადის გამოყენება შეგიძლია როგორც პირობებში, ისე ქმედებებში. მაგალითად, კატალოგების სიის გაგზავნა შეგიძლია შიდა ელფოსტის გაგზავნის (Send internal email) ქმედებაში ასე:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

შენიშვნა

თუ მონაცემების მიღების (Get data) ქმედება ერთ სამუშაო პროცესში რამდენჯერმეა გამოყენებული, ცვლადის სახელს ემატება რიცხვი. მაგალითად, სამუშაო პროცესში, რომელიც შეკვეთის მონაცემების მიღების (Get order data) ქმედებას ორჯერ იყენებს, პირველი ცვლადი დაბრუნებული მონაცემებისთვის არის getOrderData, ხოლო მეორე ცვლადი არის getOrderData1. ამ სახელის მორგება შეუძლებელია.

ტრიგერები

ამ ქმედების გამოყენება შეგიძლია ნებისმიერ სამუშაო პროცესში, მათ შორის, დაგეგმილი დროის (Scheduled time) ტრიგერში. სამუშაო პროცესი, რომელიც დაგეგმილი დროის ტრიგერს იყენებს, მოვლენის შედეგის ნაცვლად შენ მიერ მითითებულ დროს იწყება. ვინაიდან შენს მაღაზიაში ან აპში არ არსებობს კონკრეტული მოვლენა, რომელიც სამუშაო პროცესს იწყებს, მონაცემები ავტომატურად არ დაერთვის.

API ცნობარი

ამ ქმედებაში გამოყენებული API-ის შესახებ დამატებითი ინფორმაციისთვის იხილე კატალოგების მოთხოვნა (Catalogs query).