API-ის ველების გამოყენება არგუმენტებთან ერთად Shopify Flow-ში ცვლადების შესაქმნელად
ზოგიერთი ცვლადი საჭიროებს დამატებით პარამეტრებს Shopify Flow სამუშაო პროცესში სწორად ფუნქციონირებისთვის. ეს პარამეტრები წარმოადგენს არგუმენტებს, რომლებსაც უნდა ჰქონდეთ შენ მიერ გამოცხადებული მნიშვნელობები, სანამ ცვლადი სრულყოფილად და სამუშაო პროცესისთვის გამოსაყენებლად ჩაითვლება.
მაგალითად, ველი product.inCollection განსაზღვრავს, არის თუ არა პროდუქტი მითითებულ კოლექციაში და აბრუნებს ბულევურ შედეგს — true ან false. თუმცა, ამ ველისთვის მითითებული უნდა იყოს კოლექციის id არგუმენტი, რადგან სხვაგვარად ცვლადს არ ეცოდინება, თუ რომელი კონკრეტული კოლექცია უნდა შეამოწმოს. ველის სწორად გამოსაყენებლად, არგუმენტი უნდა მიუთითო ველის ნაწილის სახით. მაგალითად, product.inCollection(id: "gid://shopify/Collection/123456") მოთხოვნის გაგზავნით Flow შეძლებს განსაზღვროს, არის თუ არა პროდუქტი იმ კოლექციაში, რომლის ID არის 123456, და შემდეგ დააბრუნოს true ან false. Shopify Flow-ში ცვლადების შექმნისას არ დაგჭირდება ისეთი მნიშვნელობების ძიება, როგორიცაა პროდუქტის ან კოლექციის ID-ები. Flow გთავაზობს რესურსების ამომრჩევს სასურველი მნიშვნელობის ასარჩევად და ID ავტომატურად ივსება.
არგუმენტების მქონე ველების მოთხოვნის პროცესის გასამარტივებლად, შეგიძლია ახალი ცვლადის სახელი მიანიჭო იმ ცვლადს, რომელსაც ქმნი ველიდან და არგუმენტიდან Shopify Flow-ში. მაგალითად, თუ კოლექციის სახელი 123456 ID-ით არის Summer Bestsellers, მაშინ inCollection(id: "gid://shopify/Collection/123456") ცვლადს შეგიძლია მიანიჭო უფრო მარტივი სახელი — inSummerBestsellers. ამის შემდეგ, სამუშაო პროცესის ყველა მომდევნო ეტაპზე შეგიძლია მარტივად გამოიყენო ცვლადი product.inSummerBestsellers.
რადგან არგუმენტები განსხვავდება მათზე მინიჭებული მნიშვნელობების მიხედვით, ერთი ველიდან, რომელიც არგუმენტებს მოითხოვს, შეგიძლია შექმნა რამდენიმე ახალი ცვლადი. მაგალითად, მხოლოდ product.inCollection ველიდან შეგიძლია 3 უნიკალური ცვლადის შექმნა:
product.inCollection(id: "gid://shopify/Collection/123456")შეიძლება იყოსproduct.inSummerBestsellers.product.inCollection(id: "gid://shopify/Collection/654321")შეიძლება იყოსproduct.inSwimwear.product.inCollection(id: "gid://shopify/Collection/112233")შეიძლება იყოსproduct.inBeachAccessories.
ამ გვერდზე
მხარდაჭერილი GraphQL Admin API-ის ველები Shopify Flow-ში
Shopify Flow მხარს უჭერს GraphQL Admin API-ის შემდეგ ველებს, რომლებისთვისაც სავალდებულოა არგუმენტები:
- channel.hasCollection
- collection.hasProduct
- collection.publishedOnChannel
- collection.publishedOnPublication
- companyLocation.inCatalog
- inventoryItem.inventoryLevel
- location.inventoryLevel
- metaobject.field
- market.assignedCustomization
- marketLocalizableResource.marketLocalizations
- product.inCollection
- product.publishedOnChannel
- product.publishedOnPublication
- product.restrictedForResource
- publication.hasCollection
- publishable.publishedOnChannel
- publishable.publishedOnPublication
- sellingPlanGroup.appliesToProduct
- sellingPlanGroup.appliesToProductVariant
- sellingPlanGroup.appliesToProductVariants
- 20
translationsტიპის ველი, როგორიცაა collection.translations და product.translations
მხარდაუჭერელი GraphQL Admin API-ის ველები Shopify Flow-ში
Shopify Flow მხარს არ უჭერს შემდეგ ველებს:
- deliveryCarrierService.availableServicesForCountries
- inventoryLevel.quantities
- return.suggestedFinancialOutcome
- return.suggestedRefund
- shop.search
ამ მხარდაუჭერელი ველებიდან მონაცემების შენს სამუშაო პროცესში გამოსაყენებლად, უნდა გამოიყენო მოქმედება HTTP მოთხოვნის გაგზავნა.
ცვლადის შექმნა არგუმენტის მქონე ველიდან
შენ შეგიძლია შექმნა ცვლადი Shopify Flow-ში ნებისმიერი მხარდაჭერილი ველისთვის, რომელიც მოითხოვს არგუმენტს. ცვლადის შექმნა ერთ სამუშაო პროცესში მხოლოდ ერთხელ დაგჭირდება, რადგან იგი ხელმისაწვდომი რჩება ვარიანტის სახით სამუშაო პროცესის ყველა მომდევნო ეტაპზე.
შენ მიერ შექმნილი ცვლადი არ ზიარდება სხვა სამუშაო პროცესებთან, ამიტომ მისი სხვა სამუშაო პროცესში გამოსაყენებლად, ის ხელახლა უნდა დაამატო იმ სხვა სამუშაო პროცესში.
ნაბიჯები:
- Shopify Flow-ს სამუშაო პროცესში დააწკაპუნე ღილაკს ცვლადის დამატება მოქმედებაში ან პირობაში.
- აირჩიე ველი, რომელიც მოითხოვს არგუმენტს. ასეთი ველების გასწვრივ ნაჩვენებია
+ღილაკი. შემდეგ, დააწკაპუნე + ცვლადის შექმნა. - „ ცვლადის შექმნა “ ფანჯარაში შეასრულე შემდეგი ნაბიჯები:
- შენ მიერ არჩეული ველის მიხედვით, დააყენე მნიშვნელობა სავალდებულო არგუმენტისთვის.
- არასავალდებულო: ველში ახალი ცვლადის სახელი მოირგე ახალი ცვლადის სასურველი სახელი. ეს სახელი ვრცელდება მხოლოდ მიმდინარე სამუშაო პროცესზე.
- დააწკაპუნე ღილაკს დამატება ცვლადების არჩევის პანელის განსაახლებლად.
ახალი ცვლადის სამუშაო პროცესში დამატების შემდეგ, ის ხელმისაწვდომი რჩება როგორც ველის ვარიანტი და მომდევნო ეტაპებზე შეგიძლია სწრაფად გამოიყენო იგი. როდესაც ირჩევ ცვლადის დამატებას, ის ველების სიაში საწყისი ველის ვარიანტის ქვეშ ჩაშენებული (nested) სახით გამოჩნდება.
ცვლადის შექმნა მეტაველიდან Shopify Flow-ში
მეტაველები წარმოადგენს ცვლადის ტიპს ველებით, რომლებიც არგუმენტებს მოითხოვს. მეტაველის მონაცემების მიღება Shopify Flow-ს სამუშაო პროცესში ოდნავ განსხვავდება სხვა ცვლადებში არსებული სტანდარტული ველის მონაცემების მიღებისგან, რადგან შენ ქმნი და განსაზღვრავ მეტაველის namespace და key ველების მნიშვნელობებს, რის გამოც ისინი ყოველთვის უნიკალურია შენი მაღაზიისთვის.
მაგალითად, product.inCollection ველი ყოველთვის მოითხოვს id არგუმენტს, მიუხედავად იმისა, რომელ მაღაზიაში მუშაობ. თუმცა, რადგან შენს მაღაზიაში შექმნილი ყოველი მეტაველისთვის სახელთა სივრცეს (namespace) და გასაღებს (key) თავად აყენებ, სავალდებულო არგუმენტები მორგებადია (custom). ასე რომ, პროდუქტის მეტაველისთვის ცვლადი, რომელიც მოიცავს ზაფხულის ტანსაცმლის მოვლის ინსტრუქციებს, შეიძლება იყოს product.careGuideSummer.value, ან პროდუქტის მეტაველის ცვლადი, რომელიც იწერს იმ ასაკობრივი ჯგუფის ID-ს, ვისთვისაც პროდუქტია განკუთვნილი, შეიძლება იყოს product.ageGroup.value_item.taxonomyReference.id. ველის სახელები და არგუმენტები სრულად შენ მიერ განისაზღვრება.
შეიტყვე მეტი Shopify Flow-ში მეტაველების შესახებ.