Riešenie chýb v aplikácii Shopify Flow

Aplikácia Shopify Flow pomáha pri automatizácii úloh a procesov vo vašom obchode, no pri vytváraní alebo úprave pracovných postupov môžete naraziť na chyby alebo dosiahnuť určité limity. Táto stránka vysvetľuje bežné problémy, s ktorými sa môžete stretnúť, ako sú limity pracovných postupov či chyby údajov, a poskytuje návod na ich riešenie. Pochopenie týchto chýb vám pomôže pri riešení problémov a udržiavaní plynulého chodu vašich pracovných postupov.

Chyby pri vytváraní pracovných postupov

Pri vytváraní pracovného postupu sa môžu vyskytnúť chyby, ktoré vám zabránia v pridaní nového pracovného postupu. Môžete sa stretnúť napríklad s týmito chybami:

Prekročil sa počet pracovných postupov

Pri vytváraní nového pracovného postupu sa môže zobraziť chyba Dosiahli ste maximálny povolený limit 1 000 pracovných postupov. Ak chcete pokračovať, odstráňte nepoužívané pracovné postupy a skúste to znova.

Aplikácia Flow obmedzuje počet pracovných postupov v obchode na 1 000. Patria sem aktívne aj neaktívne pracovné postupy. Ak tento limit dosiahnete a chcete vytvoriť nový pracovný postup, odstráňte nepoužívané alebo neaktívne pracovné postupy.

Ak mal váš obchod pred zavedením tohto limitu viac ako 1 000 pracovných postupov, môže s nimi fungovať aj naďalej. Na vytváranie nových pracovných postupov sa však musíte dostať pod tento limit.

Táto chyba sa môže vyskytnúť pri vykonávaní viacerých akcií v aplikácii Flow:

  • Vytváranie nového pracovného postupu
  • Duplikovanie pracovného postupu
  • Importovanie pracovného postupu
  • Inštalácia šablóny
Too many workflows on the same trigger

When activating a workflow, you might see a warning that your store has more than 10 active workflows using the same trigger.

Having many workflows that share the same trigger can cause performance issues, because each time the trigger event occurs, Flow must process all of the associated workflows. This fan-out can lead to slower execution times and increased resource usage.

To reduce the number of workflows on a single trigger, consider the following approaches:

  • Combine workflows that use the same trigger into a single workflow with multiple branches and conditions.
  • Deactivate or delete workflows that are no longer needed.
  • Review whether some workflows could use a more specific trigger instead.

Chyby pri úprave pracovných postupov

Pri úprave pracovného postupu sa môžu vyskytnúť chyby, ktoré vám zabránia v jeho uložení. Tu sú bežné chyby, s ktorými sa môžete stretnúť pri úprave pracovného postupu:

Údaje sa nenašli

Pri pridávaní novej akcie do pracovného postupu sa môže zobraziť chyba Údaje sa nenašli:

Chyba Údaje sa nenašli

Táto chyba sa vyskytuje, pretože mnohé akcie vrátane akcie Pridať značky produktu vyžadujú zdroj v službe Shopify, napríklad produkt. Ak tento zdroj nie je k dispozícii, akciu nie je možné spustiť. Pracovné postupy môžu bežne obsahovať údaje podobné požadovaným údajom, ale v skutočnosti neposkytujú to, čo je potrebné.

V nasledujúcich častiach sú opísané bežné situácie, ktoré môžu spôsobiť túto chybu, a spôsoby ich riešenia.

Problém č. 1: Akcia Získať údaje poskytla zoznam, hoci bola potrebná jedna položka

Pracovný postup často poskytuje zoznam zdrojov služby Shopify, no akcia umožňuje použiť len jeden zdroj. Pracovný postup napríklad poskytne zoznam produktov prostredníctvom akcie Získať údaje o produkte, ale akcia Pridať značky produktu vyžaduje len jeden produkt.

Ak chcete túto chybu vyriešiť, môžete pridať akciu Pre každý, ktorá prejde zoznam a zavolá akciu pre každú položku v zozname. Tento príklad znázorňuje chybu aj riešenie pomocou akcie Pre každý:

Chyba Údaje sa nenašli

Problém č. 2: Spúšťač poskytol zoznam, hoci bola potrebná jedna položka

Podobná chyba môže nastať, keď akcia vyžaduje jeden zdroj, ale spúšťač poskytne zoznam. Akcia Označiť objednávku na vybavenie ako vybavenú napríklad vyžaduje Objednávku na vybavenie, ale spúšťač pochádza z Objednávky, ktorá poskytuje zoznam objednávok na vybavenie.

Ak chcete túto chybu vyriešiť, rovnako ako pri probléme č. 1 môžete pridať akciu Pre každý, ktorá prejde zoznam a zavolá akciu pre každú položku v zozname:

Riešenie pre objednávky na vybavenie

Prípadne môžete použiť iný spúšťač, ktorý poskytuje požadovaný zdroj. Namiesto spúšťača Vytvorená objednávka môžete napríklad použiť spúšťač Objednávka na vybavenie je pripravená na vybavenie, ktorý poskytuje jednu objednávku na vybavenie.

Príklad spúšťača Objednávka na vybavenie je pripravená na vybavenie

Problém č. 3: Spúšťač Naplánovaný čas neposkytol žiadne údaje

Spúšťač Naplánovaný čas neposkytuje údaje o zdrojoch služby Shopify. Ak sa po spúšťači pokúsite pripojiť akcie, ktoré vyžadujú zdroje služby Shopify, vyskytne sa táto chyba.

Ak chcete túto chybu vyriešiť, pridajte akciu, ktorá poskytuje požadované údaje, napríklad Získať údaje o produkte. Ako sme uviedli pri probléme č. 1, musíte pridať aj akciu Pre každý, aby ste prešli akýkoľvek zoznam vrátený akciou na získanie údajov.

Príklad chýbajúceho požadovaného produktu

Problém č. 4: Spúšťač aplikácie neposkytol žiadne údaje

Podobne ako pri probléme č. 3, niektoré spúšťače vytvorené aplikáciami neposkytujú požadované údaje o zdrojoch služby Shopify. Spúšťač „Vytvorená recenzia“ môže napríklad poskytnúť e‑mailovú adresu, no nie objekt Zákazník, ktorý vyžaduje množstvo akcií, napríklad Pridať značky zákazníka.

Túto chybu je možné vyriešiť použitím akcie „Získať údaje“ na načítanie potrebného zdroja služby Shopify. Pomocou akcie Získať údaje o zákazníkoch môžete napríklad získať objekt zákazníka z e‑mailovej adresy, ktorú poskytol spúšťač. Rovnako ako v prípade ostatných problémov, aj tu musíte pridať akciu Pre každý, aby ste prešli akýkoľvek zoznam vrátený akciou na získanie údajov.

Ak možnosť „Získať údaje“ nie je k dispozícii, možno budete musieť kontaktovať vývojára danej aplikácie a zistiť, či dokáže upraviť svoj spúšťač tak, aby poskytoval požadované údaje.

Prekročil sa počet krokov čakania

Pri pridávaní nových krokov čakania do pracovného postupu sa môže zobraziť chyba Pracovné postupy môžu mať maximálne 40 krokov čakania.

Aplikácia Flow obmedzuje povolený počet krokov čakania v pracovnom postupe na 40. Ak sa vyskytne táto chyba, limit ste prekročili. Ak chcete problém vyriešiť, odstráňte kroky čakania v inej časti pracovného postupu.

Ak vaše pracovné postupy obsahovali viac ako 40 krokov čakania už pred zavedením tohto limitu, budú fungovať normálne aj naďalej. Ak však chcete pridať ďalšie kroky čakania, musíte najskôr odstrániť existujúce kroky, aby ste sa zmestili do limitu.

Celkový čas čakania vo všetkých krokoch čakania zároveň nesmie prekročiť 90 dní.

Prekročil sa limit veľkosti hodnoty konfiguračného poľa

Pri úprave hodnôt konfiguračných polí v rámci podmienok v pracovnom postupe sa môže zobraziť chyba Hodnota konfiguračného poľa musí byť menšia ako 50 kB.

Aplikácia Flow obmedzuje veľkosť hodnoty konfiguračného poľa na 50 kB údajov. Ak sa vyskytne táto chyba, limit ste dosiahli alebo prekročili. Ak chcete problém vyriešiť, skráťte údaje, ktoré do daného poľa pridávate.

Ak už máte konfiguračné polia s hodnotou 50 kB alebo viac, vaše pracovné postupy sa budú aj naďalej normálne spúšťať. Ak však v pracovnom postupe chcete vykonať zmeny, musíte upraviť hodnotu spôsobujúcu chybu.

Chyby pri spustení pracovného postupu

Keď pri spustení pracovného postupu dôjde k chybe, spustenie sa označí ako zlyhané. Chybové hlásenie sa zobrazí v detailoch spustenia. Nižšie sú uvedené bežné chyby, s ktorými sa môžete stretnúť pri zlyhaní spustenia pracovného postupu:

  • Prechodné chyby sú dočasné chyby, ktoré sa vyskytnú, keď aplikácia Flow nedokáže dokončiť úlohu. Tieto úlohy sa opakujú, kým sa nedokončia úspešne, alebo kým sa nedosiahne časový limit.
  • Trvalé chyby sú chyby, ktoré sa vyskytnú, keď aplikácia Flow nedokáže dokončiť úlohu a túto úlohu nie je možné zopakovať.

Prechodné chyby

Prechodné chyby sú dočasné chyby, ku ktorým dochádza, keď aplikácia Flow nedokáže dokončiť úlohu. Tieto úlohy sa opakujú, kým sa nedokončia úspešne, alebo kým sa nedosiahne časový limit. Ak napríklad aplikácia Flow nedokáže pri vykonávaní akcie konektora kontaktovať partnera, úlohu pred jej zrušením niekoľkokrát zopakuje.

Opakovania sú rozložené v čase, pričom oneskorenie medzi jednotlivými pokusmi sa predlžuje. Keď sa v pracovnom postupe vyskytnú prechodné chyby, zvyčajne zostáva dlho v stave prebieha (running), kým opakuje úlohy.

Keď sa zopakovaná úloha podarí, pracovný postup pokračuje. Ak sa pri opakovanej úlohe vyskytne trvalá chyba, pracovný postup zlyhá. Každá časť pracovného postupu má kombinovaný horný limit na vykonanie 36 hodín. Ak krok s prechodnými chybami neuspeje pred dosiahnutím tohto limitu, pracovný postup zlyhá.

Pracovné postupy s krokmi čakania sa delia na sekcie, čo ovplyvňuje spôsob výpočtu časových limitov v pracovnom postupe. Každá sekcia predstavuje skupinu úloh, ktoré sa spúšťajú spoločne, a každá má vlastný 36-hodinový časový limit. Ak má napríklad pracovný postup krok čakania v dĺžke jednej hodiny, úlohy pred krokom čakania sa spustia spolu v jednej sekcii a úlohy po kroku čakania sa spustia spolu v druhej sekcii. Ak má pracovný postup viacero krokov čakania, úlohy medzi jednotlivými krokmi čakania sa spustia spolu v jednej sekcii. Pracovné postupy bez krokov čakania sa považujú za jednu sekciu.

Občasné prechodné chyby sú bežné. Ak však máte pracovný postup, pri ktorom neustále dochádza k rovnakej prechodnej chybe vo viacerých spusteniach, možno ho bude potrebné prekonfigurovať.

Časový limit kroku vypršal

K chybám Step timed out dochádza zvyčajne vtedy, keď sa úloha v pracovnom postupe pokúša vyžiadať príliš veľa údajov v rámci jednej sekcie. Táto chyba sa často vyskytuje v pracovných postupoch, ktoré prechádzajú cez zoznamy, najmä vnorené zoznamy, ktoré sú príliš veľké na rýchle spracovanie.

Keď sa vyskytne táto chyba, spúšťač alebo krok čakania sa zobrazí so stavom retrying.

Ak chcete tento problém vyriešiť, skontrolujte podmienky, ktoré pristupujú k zoznamom a vnoreným zoznamom, a overte, či sú nastavené správne. Častým problémom je podmienka, ktorá kontroluje všetky produkty v obchode namiesto toho, aby kontrolovala len produkty v objednávke.

Stav 5XX

Väčšina akcií aplikácie Flow zahŕňa volania HTTP. Sieťové alebo iné serverové problémy môžu občas spôsobiť zlyhanie volaní HTTP a vrátenie kódu chyby v rozsahu 500 až 599. Jediný výskyt tejto chyby nepredstavuje problém, no jej opakovaný výskyt môže znamenať problém so serverom, ktorý spracúva úlohu, a nie so spôsobom konfigurácie kroku.

Tento typ chyby sa najčastejšie zobrazuje pri akcii Odoslať požiadavku HTTP, no môže sa vyskytnúť pri väčšine úloh.

GraphQL obmedzené

Celkový objem práce, ktorú pracovný postup dokončí, je limitovaný limitmi požiadaviek API, ktoré čiastočne závisia od vášho plánu. Tieto limity sa zvyčajne nedosiahnu, pokiaľ pracovný postup nie je veľmi zložitý alebo neobsahuje neúmyselnú chybu v návrhu.

Nasledujúce príklady opisujú situácie, ktoré môžu viesť k tejto chybe:

  • Kód Liquid alebo podmienky v pracovnom postupe prechádzajú zoznamom s veľkým množstvom údajov, napríklad pri kontrole hodnôt metapolí obsahujúcich HTML.
  • Kód Liquid alebo podmienky v pracovnom postupe prechádzajú rozsiahlym zoznamom, napríklad pri prechádzaní zoznamu shop.orders vo veľkom obchode.
  • Pracovný postup vyústi do nekonečnej slučky, v ktorej neustále vytvára nové spustenia pracovného postupu. Môže sa to stať napríklad vtedy, ak pracovný postup používa spúšťač Pridané štítky zákazníkov a obsahuje akciu Pridať štítky zákazníkov.

Ak sa dosiahne limit, zobrazí sa chyba GraphQL throttled. Táto chyba môže ovplyvniť ďalšie pracovné postupy pri pokuse o ich spustenie, preto ju v prípade výskytu okamžite vyriešte.

Trvalé chyby

Trvalé chyby sa vyskytnú, keď aplikácia Flow nedokáže dokončiť úlohu a túto úlohu nie je možné zopakovať. Ak napríklad aplikácia Flow nedokáže odoslať e-mail z dôvodu neplatnej e-mailovej adresy, úlohu nezopakuje. Namiesto toho pracovný postup zlyhá.

Polia: id sú povinné, ale sú prázdne

Akcie Shopify vyžadujú na spustenie jeden alebo viacero prostriedkov, napríklad produkt, zákazníka alebo objednávku. Ak potrebný prostriedok nie je k dispozícii, akciu nie je možné spustiť podľa očakávania. Objednávka môže byť napríklad vytvorená v administrátorovi Shopify bez zákazníka. Ak spustíte akciu, napríklad Pridať štítky zákazníkov, akcia s touto chybou zlyhá.

Aby ste predišli tejto chybe, pridajte pred akciu podmienku, ktorá skontroluje existenciu prostriedku. Ak v predchádzajúcom príklade chcete odoslať interný e-mail v rovnakom pracovnom postupe ako Pridať štítky zákazníkov, môžete akciu odoslania e-mailu umiestniť buď pred krok, ktorý by mohol zlyhať, alebo použiť jeden z nasledujúcich postupov:

Vložte akcie do paralelných vetiev (kde z jedného kroku vychádzajú 2 alebo viaceré vetvy):

Príklad zobrazujúci dve paralelné akcie po spúšťači.

Pridajte pred akciu podmienku, ktorá skontroluje, či je prítomný zákazník. Môžete napríklad skontrolovať, či platí, že order / customer / id is not empty and exists.

Príklad zobrazujúci podmienku, ktorá hľadá ID.

Aplikácia Flow nemá povolenie na prístup k vášmu účtu Google Sheets. Znova pripojte svoj účet.

Konektor Google Sheets vyžaduje prepojenie vášho účtu Google s aplikáciou Flow na získanie povolenia na zápis do tabuľky. Táto chyba sa môže vyskytnúť, keď aplikácia Flow nemá povolenie na zápis do tabuľky – buď preto, že sa účet odpojil od aplikácie Flow, alebo preto, že daný účet k tejto tabuľke nemá prístup.

Ak to chcete vyriešiť, uistite sa, že účet používaný pre konektor dokáže tabuľku otvoriť a má prístup na úpravy. Ak je pripojený nesprávny účet, môžete ho odpojiť a pripojiť nový.

Kroky:

  1. Otvorte existujúci pracovný postup alebo vytvorte nový.
  2. Pridajte akciu do pracovného postupu.
  3. Vyberte konektor Google Sheets.
  4. Kliknite na Odpojiť a potom kliknutím na Pripojiť znova pripojte správny účet Google.
Akcia aplikácie Flow bola prijatá s neplatnými vlastnosťami. Zákazník nesúhlasí s marketingom.

Akcia Odoslať marketingový e-mail neodosiela e-maily zákazníkom, ktorí nesúhlasili s ich prijímaním, a natrvalo zlyhá, ak sa o to pracovný postup pokúsi.

Ak to chcete vyriešiť, pridajte do pracovného postupu podmienku, ktorá skontroluje stav odberu zákazníkov. Pred odoslaním sa tak môžete uistiť, že zákazníci súhlasili s prijímaním marketingových e-mailov. Postupujte podľa krokov v časti Správa zoznamu odberateľov e-mailov.

Chýba prostriedok pre [resource type]

Táto chyba naznačuje, že prostriedok, napríklad customer alebo order, sa odstránil predtým, ako mohol pracovný postup načítať jeho údaje. Najčastejšie k tomu dochádza po kroku čakania, no môže sa to stať aj pri spúšťači, ak sa prostriedok odstráni veľmi rýchlo po tom, ako dôjde k udalosti spúšťača.

Získanie upozornenia pri výskyte chyby

Ak budú mať chyby vplyv na prevádzku vášho obchodu, môžete si nastaviť upozornenia na výskyt chyby. Upozornenia na chyby je možné vytvoriť ako pracovný postup pomocou spúšťača Vyskytla sa chyba pracovného postupu. Upozornenia na chyby sú navrhnuté tak, aby obmedzili rušenie, takže dostanete iba jedno upozornenie na verziu pracovného postupu.

Na začiatok môžete použiť jednu z nasledujúcich šablón:

Opakované spustenia

V niektorých prípadoch môže pri spustení pracovného postupu nastať chyba alebo sa nespustí podľa plánu. Po vyriešení problémov a opravení chýb v príslušnom pracovnom postupe môžete minulé spustenia zopakovať manuálne, aby ste ich výsledok spätne opravili. Ďalšie informácie o opakovaní spustení pracovného postupu.

Prebieha (obmedzená rýchlosť)

V niektorých prípadoch môže pracovný postup alebo postupy spotrebovať príliš veľa prostriedkov a aby sa predišlo problémom, aplikácia Flow úmyselne obmedzí vykonávanie spustení vo vašom obchode, čo môže spôsobiť oneskorenia a chyby časového limitu. Tento problém je možné vyriešiť prepísaním neefektívnych pracovných postupov, zvyčajne s cieľom opraviť chybu, v dôsledku ktorej nefungovali podľa plánu.

Prebieha príliš dlho

Táto správa naznačuje, že vykonávanie spustení pracovného postupu trvá veľmi dlho. Bežne je to spôsobené použitím veľkého množstva údajov v rámci pracovného postupu, ktorých načítanie trvá aplikácii Flow dlho.

Tieto prípady sú zvyčajne spôsobené hlbokými cestami požiadaviek, ktoré prechádzajú cez viaceré zoznamy položiek (ako napríklad vyžiadanie všetkých metapolí pre všetky produkty vo všetkých kolekciách, ktorých je produkt súčasťou):

Príklad dlho prebiehajúceho pracovného postupu.

Toto často súvisí aj s vypršaním časového limitu kroku spúšťača pracovného postupu.

Pracovné postupy, ktoré prechádzajú cez všetky metapolia, je často možné vylepšiť použitím iba konkrétneho metapoľa. Prístup k viacerým vnoreným zoznamom (napríklad ku všetkým produktom vo všetkých kolekciách pre produkt) alebo obzvlášť veľkým zoznamom (napríklad k definíciám metapolí, ktoré obsahujú všetky metapolia pre všetky objekty) sa mohol uskutočniť neúmyselne a výberom správneho poľa (jedného produktu alebo jedného metapoľa na objekte) sa dá výrazne zvýšiť efektivita. V iných prípadoch môže použitie akcie „Get Product/Order/Customer Data“ s filtrom dopytu výrazne znížiť počet použitých objektov, pričom prístup k tým relevantným zostane zachovaný.

Spracúva sa príliš veľa údajov

Táto správa označuje, že spustenia pracovného postupu generujú veľké množstvo údajov. Je to bežne spôsobené zložitými podmienkami, ktoré kontrolujú mnoho polí, zvyčajne v dôsledku kontroly polí vo viacerých vrstvách zoznamov.

Napríklad podmienka, ako je „Pre aspoň jeden štítok tohto zákazníka, pre aspoň jednu samostatnú položku objednávky, pre aspoň jeden štítok na samostatnej položke“, môže viesť k vykonaniu mnohých kontrol a k vygenerovaniu množstva údajov na zobrazenie výsledkov týchto kontrol:

Príklad pracovného postupu, ktorý sa pokúša spracovať príliš veľa údajov.

Zlyhanie automatických opakovaní

Táto správa naznačuje, že spustenia pracovného postupu opakovane zlyhávajú v dôsledku nejakého dočasného problému a že ani po následných opakovaniach väčšinou neprebehnú úspešne. Často k tomu dochádza, keď rozhranie Admin API služby Shopify alebo aplikácia partnera zaznamenáva veľký objem požiadaviek.