Virheiden vianmääritys Shopify Flow'ssa

Kun luot uutta työnkulkua, saatat kohdata virheilmoituksen Olet saavuttanut sallitun 1 000 työnkulun enimmäismäärän. Jatkaaksesi poista kaikki käyttämättömät työnkulut ja yritä uudelleen.

Flow rajoittaa kaupan työnkulkujen määrän 1 000:een. Tämä sisältää aktiiviset ja passiiviset työnkulut. Jos saavutat tämän rajan ja haluat luoda uuden työnkulun, poista käyttämättömiä tai passiivisia työnkulkuja.

Jos kaupassasi oli yli 1 000 työnkulkua ennen tämän rajoituksen asettamista, kauppasi voi edelleen toimia yli 1 000 työnkulun kanssa. Uusien työnkulkujen luominen edellyttää kuitenkin, että työnkulkujen määrä on alle rajan.

Saatat kohdata tämän virheen suorittaessasi useita toimintoja Flow-sovelluksessa:

• Uuden työnkulun luominen
• Työnkulun kopioiminen
• Työnkulun tuominen
• Mallin asentaminen

Kun aktivoit työnkulkua, saatat nähdä varoituksen, jonka mukaan kaupassasi on yli 10 aktiivista työnkulkua, jotka käyttävät samaa käynnistintä.

Jos monella työnkululla on sama käynnistin, voi esiintyä tehokkuusongelmia, sillä aina kun käynnistimen tapahtuma toteutuu, Flow'n täytyy käsitellä kaikki siihen liittyvät työnkulut. Tällainen moninkertainen käsittely voi hidastaa suoritusaikoja ja lisätä resurssien käyttöä.

Voit vähentää yhtä käynnistintä käyttävien työnkulkujen määrää seuraavilla tavoilla:

• Yhdistä samaa käynnistintä käyttävät työnkulut yhdeksi työnkuluksi, jossa on useita haaroja ja ehtoja.
• Deaktivoi tai poista työnkulut, joita ei enää tarvita.
• Tarkista, voisivatko jotkin työnkulut käyttää sen sijaan tarkempaa käynnistintä.

Kun lisäät työnkulkuun uutta toimintoa, saatat kohdata virheilmoituksen Tietoja ei löytynyt:

Tämä virhe johtuu siitä, että monet toiminnot, kuten Lisää tuotetunnisteita, edellyttävät Shopify-resurssia, kuten tuotetta. Jos kyseistä resurssia ei ole saatavilla, toimintoa ei voi suorittaa. Yleensä työnkulut saattavat sisältää vaadittuja tietoja muistuttavia tietoja, mutta ne eivät ole juuri sitä, mitä tarvitaan.

Seuraavissa osioissa kuvataan yleisiä tilanteita, jotka voivat aiheuttaa tämän virheen, ja miten ne ratkaistaan.

Ongelma 1: Hae tiedot -toiminto antoi luettelon, kun tarvittiin yksittäinen kohde

Usein työnkulku antaa luettelon Shopify-resursseista, mutta toiminto sallii vain yhden resurssin. Esimerkiksi työnkulku antaa tuoteluettelon Hae tuotetiedot -toiminnon kautta, mutta Lisää tuotetunnisteita -toiminto vaatii yhden tuotteen.

Voit ratkaista tämän virheen lisäämällä Kullekin-toiminnon, joka käy luettelon läpi ja kutsuu toimintoa luettelon jokaiselle kohteelle. Tämä esimerkki havainnollistaa sekä virhettä että ratkaisua Kullekin-toiminnolla:

Ongelma 2: Käynnistin antoi luettelon, kun tarvittiin yksittäinen kohde

Vastaava virhe voi ilmetä, kun toiminto vaatii yhden resurssin, mutta käynnistin antaa luettelon. Esimerkiksi Merkitse täytettävä tilaus täytetyksi vaatii täytettävän tilauksen, mutta käynnistin tulee tilauksesta, joka antaa luettelon täytettävistä tilauksista.

Kuten ongelmassa 1, voit ratkaista tämän virheen lisäämällä Kullekin-toiminnon, joka käy luettelon läpi ja kutsuu toimintoa luettelon jokaiselle kohteelle:

Vaihtoehtoisesti voit käyttää toista käynnistintä, joka antaa vaaditun resurssin. Esimerkiksi sen sijaan, että käytät Tilaus luotu -käynnistintä, voit käyttää Täytettävä tilaus valmis täytettäväksi -käynnistintä, joka antaa yhden täytettävän tilauksen.

Ongelma 3: Ajastettu aika -käynnistin ei antanut tietoja

Ajastettu aika -käynnistin ei anna Shopifyn resurssitietoja. Jos yrität yhdistää käynnistimen jälkeen toimintoja, jotka vaativat Shopify-resursseja, kohtaat virheen.

Voit ratkaista tämän virheen lisäämällä toiminnon, kuten Hae tuotetiedot, joka antaa vaaditut tiedot. Kuten ongelmassa 1 todettiin, sinun on myös lisättävä Kullekin-toiminto, jotta voit käydä läpi luettelon, jonka tiedot hakeva toiminto palauttaa.

Ongelma 4: Sovelluksen käynnistin ei antanut tietoja

Kuten ongelmassa 3, jotkin sovellusten luomat käynnistimet eivät anna vaadittuja Shopify-resurssitietoja. Esimerkiksi ”Arvostelu luotu” -käynnistin voi antaa sähköpostiosoitteen, mutta ei asiakas-objektia, jota tarvitaan monissa toiminnoissa, kuten Lisää asiakastunnisteita.

Voit ratkaista tämän virheen käyttämällä ”Hae tiedot” -toimintoa tarvitsemasi Shopify-resurssin noutamiseen. Voit esimerkiksi käyttää Hae asiakastiedot -toimintoa saadaksesi asiakasobjektin käynnistimen antamasta sähköpostiosoitteesta. Kuten muissakin ongelmissa, sinun on myös lisättävä Kullekin-toiminto, jotta voit käydä läpi luettelon, jonka tiedot hakeva toiminto palauttaa.

Jos ”Hae tiedot” -toiminto ei ole käytettävissä, sinun on ehkä otettava yhteyttä sovelluskehittäjään ja kysyttävä, voivatko he muokata käynnistintään antamaan tarvittavat tiedot.

Kun lisäät uusia odotusvaiheita työnkulkuusi, saatat kohdata virheilmoituksen: Työnkuluissa saa olla enintään 40 odotusvaihetta.

Flow rajoittaa työnkulun odotusvaiheiden sallitun enimmäismäärän 40:een. Jos kohtaat tämän virheen, olet ylittänyt tämän rajan. Ratkaise ongelma poistamalla odotusvaiheita muualta työnkulustasi.

Jos sinulla oli jo ennen tämän rajoituksen käyttöönottoa työnkulkuja, jotka sisälsivät yli 40 odotusvaihetta, työnkulkusi toimii edelleen odotetusti. Jos kuitenkin haluat lisätä odotusvaiheita, sinun on ensin poistettava olemassa olevia vaiheita, jotta pysyt rajan alapuolella.

Lisäksi kaikkien odotusvaiheiden yhteenlaskettu odotusaika ei saa ylittää 90 päivää.

Kun muokkaat määrityskenttien arvoa työnkulkusi ehdoissa, saatat kohdata virheilmoituksen: Määrityskentän arvon on oltava alle 50 kt.

Flow rajoittaa määrityskentän arvon koon 50 kt:uun. Kun kohtaat tämän virheen, olet saavuttanut tai ylittänyt rajan. Ratkaise ongelma lyhentämällä kenttään lisäämiesi tietojen pituutta.

Jos sinulla on jo määrityskenttiä, joiden arvo on 50 kt tai enemmän, työnkulkusi toimivat edelleen odotetusti. Jos kuitenkin haluat tehdä muutoksia työnkulkuusi, sinun on muokattava virheen aiheuttavaa arvoa.

Vaiheen aikakatkaisu -virheitä ilmenee yleensä silloin, kun työnkulun tehtävä yrittää hakea liikaa dataa yhden osion sisällä. Tämä virhe ilmenee usein työnkuluissa, jotka käyvät läpi listoja, erityisesti sisäkkäisiä listoja, jotka ovat liian suuria nopeasti käsiteltäviksi.

Kun tämä virhe ilmenee, käynnistimen tai odotusvaiheen tilana näytetään yritetään uudelleen.

Voit ratkaista tämän ongelman tarkistamalla ehdot, jotka käyttävät listoja ja sisäkkäisiä listoja, ja varmistamalla, että ne on määritetty oikein. Yleinen ongelma on ehto, joka tarkistaa kaikki kaupan tuotteet tilauksen tuotteiden sijaan.

Useimmat Flow-toiminnot sisältävät HTTP-kutsuja. Toisinaan verkko- tai muut palvelinongelmat voivat aiheuttaa HTTP-kutsujen epäonnistumisen ja palauttaa virhekoodin väliltä 500–599. Tämän virheen yksittäinen esiintyminen ei ole ongelma, mutta toistuvat tapaukset saattavat viitata ongelmaan tehtävää käsittelevässä palvelimessa vaiheen määritystavan sijaan.

Tämän tyyppinen virhe näkyy yleisimmin Lähetä HTTP-pyyntö -toiminnossa, mutta se voi ilmetä useimmissa tehtävissä.

Työnkulun tekemän työn kokonaismäärää rajoittavat API-pyyntörajat, jotka määräytyvät osittain sopimuksesi mukaan. Yleensä näitä rajoja ei saavuteta, ellei työnkulku ole erittäin monimutkainen tai sisällä tahatonta suunnitteluvirhettä.

Tämä virhe voi johtua esimerkiksi seuraavista tilanteista:

• Työnkulun Liquid-koodi tai ehdot käyvät läpi listaa, jossa on suuri määrä dataa, kuten tarkistavat HTML-koodia sisältävien metakenttien arvoja.
• Työnkulun Liquid-koodi tai ehdot käyvät läpi suurta listaa, kuten shop.orders-listaa suuressa kaupassa.
• Työnkulku johtaa äärettömään silmukkaan, jossa se luo jatkuvasti uusia työnkulun suorituksia. Näin voi käydä esimerkiksi, jos työnkulku käyttää Asiakkaan tunnisteet lisätty -käynnistintä ja sisältää Lisää asiakastunnisteita -toiminnon.

Jos raja saavutetaan, saat GraphQL-rajoitus-virheilmoituksen. Tämä virhe voi vaikuttaa muihin työnkulkuihin niiden yrittäessä suoritusta, joten korjaa virhe välittömästi sen ilmetessä.

Shopify-toiminnot edellyttävät suorittamista varten yhtä tai useampaa resurssia, kuten tuotetta, asiakasta tai tilausta. Jos tarvittava resurssi ei ole käytettävissä, toimintoa ei voi suorittaa tarkoitetulla tavalla. Tilaus voidaan esimerkiksi luoda Shopifyn ohjausnäkymässä ilman asiakasta. Jos suoritat toiminnon, kuten Lisää asiakastunnisteita, toiminto epäonnistuu ja aiheuttaa tämän virheen.

Voit estää tämän virheen lisäämällä toimintoa edeltävän ehdon, joka tarkistaa, onko resurssi olemassa. Jos edellisessä esimerkissä haluat lähettää sisäisen sähköpostin samassa työnkulussa kuin Lisää asiakastunnisteita, voit joko sijoittaa sähköpostitoiminnon ennen vaihetta, joka saattaa epäonnistua, tai käyttää jotakin seuraavista tavoista:

Sijoita toiminnot rinnakkaisiin haaroihin (jolloin vaiheesta lähtee vähintään kaksi haaraa):

Lisää toiminnon eteen ehto, joka tarkistaa asiakkaan olemassaolon. Voit esimerkiksi tarkistaa ehdon order / customer / id is not empty and exists.

Google Sheets -yhdistin edellyttää, että yhdistät Google-tilisi Flow'hun saadaksesi kirjoitusoikeuden taulukkoon. Tämä virhe voi ilmetä, kun Flow'lla ei ole oikeutta kirjoittaa taulukkoon joko siksi, että tilin yhteys Flow'hun on katkaistu tai koska kyseisellä tilillä ei ole pääsyä kyseiseen taulukkoon.

Voit ratkaista tämän varmistamalla, että yhdistimessä käytetyllä tilillä voi avata taulukon ja että sillä on muokkausoikeudet. Jos väärä tili on yhdistetty, voit katkaista sen yhteyden ja yhdistää uuden.

Vaiheet:

1. Avaa olemassa oleva työnkulku tai luo uusi.
2. Lisää toiminto työnkulkuun.
3. Valitse Google Sheets -yhdistin.
4. Klikkaa Katkaise yhteys ja sitten Yhdistä yhdistääksesi oikean Google-tilin uudelleen.

Lähetä markkinointisähköpostia -toiminto ei lähetä sähköposteja asiakkaille, jotka eivät ole suostuneet vastaanottamaan niitä, ja toiminto epäonnistuu pysyvästi, jos työnkulku yrittää tehdä niin.

Voit ratkaista tämän lisäämällä työnkulkuun ehdon, joka tarkistaa asiakkaan tilauksen tilan. Voit varmistaa, että asiakkaat ovat suostuneet vastaanottamaan markkinointisähköposteja, ennen kuin lähetät niitä. Noudata ohjeita kohdassa Sähköpostitilaajaluettelon hallinta.

Tämä virhe osoittaa, että resurssi, kuten asiakas tai tilaus, poistettiin ennen kuin työnkulku ehti noutaa sen tietoja. Useimmiten tämä tapahtuu odotusvaiheen jälkeen, mutta se on mahdollista myös käynnistimen kohdalla, jos resurssi poistetaan hyvin nopeasti käynnistintapahtuman jälkeen.

Tämä viesti osoittaa, että työnkulun suoritusten toteuttaminen kestää hyvin kauan. Tämä johtuu yleensä siitä, että työnkulussa käytetään suurta tietomäärää, jonka noutaminen vie Flow'lta paljon aikaa.

Nämä tapaukset johtuvat yleensä syvistä pyyntöpoluista, jotka käyvät läpi useita nimikelistoja (kuten pyydettäessä kaikkia metakenttiä kaikilta tuotteilta kaikissa niissä kokoelmissa, joihin tuote kuuluu):

Tämä liittyy usein myös työnkulun käynnistinvaiheen aikakatkaisuun.

Työnkulkuja, jotka käyvät läpi kaikki metakentät, voidaan usein parantaa käyttämällä vain tiettyä metakenttää. Useiden sisäkkäisten luetteloiden (kuten kaikkien tuotteiden käyttäminen tuotteen kaikissa kokoelmissa) tai erityisen suurten luetteloiden (kuten kaikkien objektien kaikki metakentät sisältävien metakenttämääritelmien) käyttö saattaa olla tahatonta, ja oikean kentän (yksittäisen tuotteen tai objektin yksittäisen metakentän) valitseminen voi parantaa tehokkuutta merkittävästi. Muissa tapauksissa ”Hae tuote-/tilaus-/asiakastietoja” -toiminnon käyttäminen kyselysuodattimen kanssa voi vähentää merkittävästi käytettyjen objektien määrää, mutta silti sallia pääsyn olennaisiin tietoihin.

Tämä viesti osoittaa, että työnkulun suoritukset tuottavat suuren määrän dataa. Tämä johtuu yleensä monimutkaisista ehdoista, jotka tarkistavat useita kenttiä useilla luettelotasoilla.

Esimerkiksi ehto, kuten ”Vähintään yhdelle tämän asiakkaan tunnisteista, vähintään yhdelle tilauksen rivikohdista, vähintään yhdelle rivikohdan tunnisteista”, voi johtaa siihen, että suoritetaan useita tarkistuksia ja että syntyy paljon dataa näiden tarkistusten tulosten näyttämiseksi:

Tämä viesti osoittaa, että työnkulun suoritukset epäonnistuvat toistuvasti jonkin väliaikaisen ongelman vuoksi, mutta ne eivät onnistu usein seuraavilla uudelleenyrityksillä. Tämä tapahtuu usein, kun joko Shopifyn Admin API tai kumppanin sovellus kohtaa suuren määrän pyyntöjä.