Używanie pól API z argumentami w Shopify Flow do tworzenia zmiennych

Niektóre zmienne wymagają dodatkowych parametrów, aby działać poprawnie w przepływie pracy Shopify Flow. Te parametry to argumenty, dla których musisz zadeklarować wartości, zanim zmienna zostanie uznana za kompletną i użyteczną w przepływie pracy.

Na przykład pole product.inCollection określa, czy produkt znajduje się w określonej kolekcji, i zwraca wartość logiczną true lub false. Jednakże w przypadku tego pola należy podać argument id kolekcji, ponieważ w przeciwnym razie zmienna nie będzie wiedziała, którą konkretnie kolekcję sprawdzić. Aby prawidłowo użyć pola, musisz uwzględnić argument jako jego część. Na przykład po wysłaniu zapytania product.inCollection(id: "gid://shopify/Collection/123456") Flow może określić, czy produkt znajduje się w kolekcji o ID 123456, a następnie zwrócić true lub false, zgodnie z oczekiwaniami. Tworząc zmienne w Shopify Flow, nie musisz szukać wartości takich jak ID produktu czy kolekcji. Flow udostępnia selektor zasobów umożliwiający wybór żądanej wartości, a ID jest wypełniane automatycznie.

Aby ułatwić wysyłanie zapytań o pola z argumentami, możesz przypisać nową nazwę do zmiennej utworzonej na podstawie pola i argumentu w Shopify Flow. Na przykład, jeśli nazwa kolekcji o ID 123456 to Summer Bestsellers, możesz przypisać zmiennej inCollection(id: "gid://shopify/Collection/123456") prostszą nazwę inSummerBestsellers. Wtedy we wszystkich kolejnych krokach przepływu pracy możesz po prostu używać zmiennej product.inSummerBestsellers.

Ponieważ argumenty różnią się w zależności od przypisanych im wartości, z jednego pola wymagającego argumentów możesz utworzyć wiele nowych zmiennych. Przykładowo, z samego pola product.inCollection możesz utworzyć 3 unikalne zmienne:

• Zmienna product.inCollection(id: "gid://shopify/Collection/123456") może otrzymać nazwę product.inSummerBestsellers.
• Zmienna product.inCollection(id: "gid://shopify/Collection/654321") może otrzymać nazwę product.inSwimwear.
• Zmienna product.inCollection(id: "gid://shopify/Collection/112233") może otrzymać nazwę product.inBeachAccessories.

Obsługiwane pola GraphQL Admin API w Shopify Flow

Shopify Flow obsługuje następujące pola w GraphQL Admin API, które wymagają argumentów:

• 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 pól typu translations, takich jak collection.translations oraz product.translations

Nieobsługiwane pola GraphQL Admin API w Shopify Flow

Shopify Flow nie obsługuje następujących pól:

• deliveryCarrierService.availableServicesForCountries
• inventoryLevel.quantities
• return.suggestedFinancialOutcome
• return.suggestedRefund
• shop.search

Aby użyć danych z tych nieobsługiwanych pól w przepływie pracy, musisz skorzystać z akcji Wyślij żądanie HTTP.

Tworzenie zmiennej z pola z argumentem

W Shopify Flow możesz utworzyć zmienną dla dowolnego obsługiwanego pola, które wymaga argumentu. Zmienną wystarczy utworzyć tylko raz w pojedynczym przepływie pracy, ponieważ pozostaje ona dostępna jako opcja we wszystkich jego kolejnych krokach.

Zmienna, którą utworzysz, nie jest współdzielona z innymi przepływami pracy, więc aby użyć jej w innym przepływie, musisz dodać ją do niego ponownie.

Kroki:

1. W przepływie pracy aplikacji Shopify Flow kliknij opcję Dodaj zmienną w akcji lub warunku.
2. Wybierz pole wymagające argumentu. Przy tych polach wyświetlany jest przycisk +. Następnie kliknij + Utwórz zmienną.
3. W oknie dialogowym „ Utwórz zmienną ” wykonaj następujące kroki:
   1. Na podstawie wybranego pola ustaw wartość wymaganego argumentu.
   2. Opcjonalnie: W polu Nowa nazwa zmiennej dostosuj pożądaną nazwę nowej zmiennej. Ta nazwa dotyczy tylko bieżącego przepływu pracy.
   3. Kliknij Dodaj, aby odświeżyć panel wyboru zmiennych.

Po dodaniu nowej zmiennej do przepływu pracy pozostaje ona dostępna jako opcja pola i można szybko odwoływać się do niej w kolejnych krokach. Podczas wybierania opcji Dodaj zmienną jest ona wyświetlana na liście pól pod oryginalną opcją pola.

Tworzenie zmiennej z metapola w aplikacji Shopify Flow

Metapola to rodzaj zmiennej z polami wymagającymi argumentów. Pobieranie danych metapola w przepływie pracy aplikacji Shopify Flow różni się nieco od pobierania danych standardowych pól w innych zmiennych, ponieważ to Ty tworzysz i definiujesz wartości pól namespace i key metapola, więc są one zawsze unikalne dla Twojego sklepu.

Na przykład pole product.inCollection zawsze wymaga argumentu id niezależnie od tego, w którym sklepie pracujesz. Ponieważ jednak to Ty ustalasz przestrzeń nazw i klucz dla każdego metapola tworzonego w sklepie, wymagane argumenty są niestandardowe. Zatem zmienną metapola produktu, która przechwytuje instrukcje pielęgnacji odzieży letniej, może być product.careGuideSummer.value, a zmienną metapola produktu, która rejestruje ID grupy wiekowej, dla której przeznaczony jest produkt, może być product.ageGroup.value_item.taxonomyReference.id. O nazwach pól i argumentach decydujesz wyłącznie Ty.

Dowiedz się więcej o metapolach w aplikacji Shopify Flow.