Înțelegerea condițiilor în Shopify Flow

O condiție este un pas într-un flux de lucru în care se ia o decizie cu privire la modul de a continua, pe baza faptului dacă un set de criterii a fost îndeplinit. Fiecare pas de condiție are 2 posibilități: Adevărat, când criteriile au fost îndeplinite, și Fals, când criteriile nu au fost îndeplinite. Dacă nu definiți un pas următor pentru oricare dintre posibilități, alegând o altă condiție sau acțiune, atunci execuția fluxului de lucru se oprește.

De exemplu, dacă fluxul dumneavoastră de lucru este declanșat atunci când se creează o comandă, atunci o condiție ar putea verifica dacă un anumit cod de reducere AFFILIATE10 a fost utilizat în comandă. Dacă da, atunci opțiunea Adevărat ar putea duce la o acțiune care trimite un e-mail către afiliat pentru a-l informa că i s-a folosit codul. Dacă nu, atunci opțiunea Fals ar putea fi goală, indicând faptul că nu se mai întâmplă nimic și execuția fluxului de lucru se încheie.

Un flux de lucru poate avea orice număr de condiții, în funcție de complexitatea fluxului dumneavoastră de lucru. De asemenea, condițiile se pot conecta la alte condiții sau acțiuni, în funcție de ceea ce doriți să facă fluxul de lucru. Condițiile pot fi configurate să se conecteze în secvență (de exemplu, dacă condiția A este adevărată, atunci se verifică condiția B; dacă A este falsă, atunci se verifică C) sau le puteți configura să aibă loc simultan ca parte a aceluiași pas (de exemplu, se verifică dacă A, B sau C este adevărată).

Crearea condițiilor pentru fluxul dumneavoastră de lucru

Spre deosebire de un declanșator sau o acțiune, pe care le puteți selecta dintr-o listă prestabilită de opțiuni disponibile în Shopify Flow, condițiile sunt create de la zero prin selectarea de variabile, operatori logici și valori pentru a crea instrucțiunea condițională:

• O variabilă este un substituent care definește datele pe care le utilizează condiția. De exemplu, dacă o condiție trebuie să verifice un anumit cod de reducere pentru o comandă, atunci variabila ar fi order.discountCode. Variabilele utilizează notația cu punct GraphQL Admin API.
• Un operator logic indică modul în care fluxul de lucru ar trebui să determine dacă este îndeplinită condiția. Operatorii logici se pot aplica la nivel de variabilă sau atunci când mai multe variabile sunt incluse ca parte a criteriilor generale ale condiției:
  • Opțiunile la nivel de variabilă includ operatori la nivel de câmp, cum ar fi Mai mare decât sau Începe cu, sau operatori de listă, cum ar fi Cel puțin una din sau Toate din.
  • Opțiunile la nivel de condiție includ ȘI, însemnând că toate variabilele trebuie să fie adevărate pentru ca întreaga condiție să fie considerată adevărată, sau SAU, însemnând că cel puțin 1 variabilă trebuie să fie adevărată pentru ca întreaga condiție să fie considerată adevărată.
• O valoare este informația efectivă pe care o caută variabila. De exemplu, dacă order.discountCode specific pe care doriți ca fluxul de lucru să îl verifice este AFFILIATE10, atunci aceea ar fi valoarea de inclus ca parte a condiției.

Pe măsură ce selectați variabilele și operatorii, pasul condiției din pânza Shopify Flow se actualizează pentru a reflecta instrucțiunea dumneavoastră condițională în limbaj simplu, astfel încât să puteți verifica dacă condiția pe care o construiți este formatată corect. Puteți da clic pe Adăugare descriere pentru a suprascrie instrucțiunea condițională implicită cu propria dumneavoastră descriere scrisă.

Aflați informații mai detaliate despre elementele condițiilor în Shopify Flow.

Înțelegerea variabilelor în condiții

Când creați un pas de condiție într-un flux de lucru, primul pas care vi se solicită este să Adăugați o variabilă. Dar, ce este o variabilă?

În Shopify Flow, o variabilă este un substituent care indică datele utilizate de condiție în fluxul de lucru. Când o condiție are forma „Dacă A este mai mare decât 10...”, partea A este variabila. Alegerea unei variabile pentru o condiție înseamnă, în esență, a-i spune condiției în mod specific ce date să evalueze.

Variabilele sunt formatate folosind notația cu punct GraphQL Admin API. Nu trebuie să cunoașteți în detaliu API-ul pentru a crea fluxuri de lucru cu aplicația Flow, dar o înțelegere de bază a numelor variabilelor și a definițiilor acestora vă poate ajuta să construiți logica specifică a fluxului de lucru pe care o doriți.

Pentru a înțelege ce date reprezintă o variabilă, luați în considerare următoarele informații despre variabile:

• Cum să citiți notația cu punct a variabilelor.
• Înțelegerea cerințelor de date pentru variabile.
• Localizarea variabilei corecte în timpul unei căutări.

Sfat: Obțineți ajutor cu variabilele de la asistentul Dev Docs

Dacă nu știți ce variabilă să selectați atunci când construiți condiția, luați în considerare să cereți sfatul asistentului Shopify Dev Docs. Asistentul Dev Docs are acces la toată documentația privind GraphQL Admin API și poate oferi sugestii despre cum să formatați o condiție în Shopify Flow:

1. Accesați Shopify Dev Docs.
2. Faceți clic pe Ask Assistant pentru a deschide panoul de chat.
3. În câmpul de mesaj, introduceți solicitarea, cum ar fi „Ce variabilă ar trebui să folosesc în Shopify Flow dacă aș dori să accesez datele etichetelor clientului atunci când declanșatorul meu începe cu „Comandă creată”?”.
4. Apăsați pe Enter sau faceți clic pe .

Citirea notației cu puncte a variabilelor

Atunci când selectați variabile, veți observa că acestea sunt formatate ca niște cuvinte cheie separate prin puncte, cum ar fi order.customer.tag. Acest format indică pașii pe care îi parcurge API-ul pentru a ajunge la datele pe care doriți să le utilizați. Fiecare „pas” al unei variabile este separat printr-un punct, iar calea către date este citită de la stânga la dreapta. Variabilele pot avea lungimi diferite în funcție de locul în care sunt stocate datele în API și de calea pe care o parcurge fluxul de lucru pentru a ajunge acolo.

De exemplu:

• order.email: Verifică adresa de e-mail asociată clientului pentru comandă. Este similar cu modul în care ați face clic pe o comandă și apoi ați verifica adresa de e-mail în detaliile comenzii.
• refunds_item.staffMember.name: Verifică în comandă dacă există o restituire pentru un articol, accesează informațiile despre membrul personalului asociat cu acea restituire și verifică numele complet al membrului personalului respectiv.

Atunci când alegeți o variabilă, luați în considerare modul în care ați naviga în panoul de administrare Shopify pentru a găsi informațiile dorite. Este probabil ca API-ul să trebuiască să parcurgă o cale similară, ceea ce vă poate ajuta să stabiliți cum ar putea fi formatată variabila dumneavoastră.

De exemplu, dacă examinați o comandă nouă și doriți să aflați în ce grup RFM se află clientul asociat comenzii, atunci v-ați putea gândi să faceți clic pe numele clientului din comandă pentru a fi redirecționat către pagina de detalii a clientului din panoul de administrare Shopify, iar apoi ați putea verifica sumarul datelor analitice ale clientului pentru a citi ce valoare este afișată în coloana grup RFM.

Variabila pe care ați folosi-o pentru a returna aceleași date în Shopify Flow ar utiliza o cale similară: order.customer.statistics.rfmGroup.

Cerințe de date pentru variabile

Variabilele necesită date. Dacă datele potrivite nu sunt disponibile pentru variabilă, atunci condiția nu va funcționa și fluxul de lucru eșuează. În funcție de declanșatorul pe care l-ați selectat ca punct de pornire al fluxului de lucru, opțiunile pentru variabilele pe care le puteți adăuga la condiții se modifică pentru a reflecta opțiunile posibile pe baza datelor disponibile.

De exemplu, dacă fluxul de lucru începe cu declanșatorul Produs creat, atunci condițiile pe care le creați din acel declanșator sunt limitate la variabilele disponibile din setul de date produs. Prin urmare, variabile precum product.category.name, product.vendor și variants_item.displayName pot fi utilizate ca parte a condiției. În schimb, variabile precum customer.verifiedEmail sau subscriptionContracts_item.status nu ar fi afișate ca opțiuni, deoarece nu sunt asociate cu setul de date al produsului.

Cu toate acestea, acest lucru nu înseamnă neapărat că datele conținute în alte seturi de date sunt complet inaccesibile. Unele date pot fi accesate prin mai multe căi în API, în același mod în care ați putea face clic pe diferite link-uri pentru a ajunge la aceeași pagină în panoul de administrare Shopify. În practică, acest lucru înseamnă că declanșatoare diferite necesită notații diferite pentru variabile pentru a returna aceleași informații.

De exemplu, doriți ca fluxul de lucru să verifice etichetele de pe profilul unui client. Dacă fluxul de lucru începe cu declanșatorul Comandă creată, atunci variabila ar fi order.customer.tags, deoarece fluxul de lucru pornește cu datele comenzii, apoi verifică informațiile despre client din comandă, apoi verifică etichetele acelui client. Dacă fluxul de lucru începe cu declanșatorul Client creat, atunci variabila ar fi pur și simplu customer.tags, deoarece fluxul de lucru pornește cu datele clientului, deci poate trece direct la verificarea etichetelor de pe profilul clientului.

Verificarea căii unei variabile la căutarea pe bază de cuvinte cheie

Datorită stilului de notație cu puncte din Shopify Flow, căutarea variabilelor de utilizat într-o condiție pe bază de cuvinte cheie poate returna mai multe rezultate. Înțelegerea a ceea ce indică calea variabilei este importantă atunci când stabiliți ce variabilă să alegeți la construirea condiției.

De exemplu, fluxul de lucru utilizează declanșatorul Comandă creată și căutați o variabilă folosind cuvântul cheie tags. Căutarea ar putea returna următoarele rezultate, care verifică informații diferite din comandă:

• order.tags: Etichetele aplicate comenzii în sine. De exemplu, #comandă urgentă sau #cadou.
• order.customer.tags: Etichetele aplicate clientului care a plasat comanda. De exemplu, #VIP sau #afiliat.
• order.lineItems.product.tags: Etichetele aplicate produselor achiziționate în comandă. De exemplu, #fragil sau #necesităID.

În funcție de tipul de etichete pe care doriți ca fluxul de lucru să le verifice, trebuie să selectați variabila corectă, astfel încât condiția să funcționeze conform așteptărilor.

Înțelegerea operatorilor logici în condiții

Operatorii logici definesc modul în care este aplicată condiția dumneavoastră și fac ca o declarație să fie fie adevărată, fie falsă. Atunci când o condiție se citește „Dacă A este mai mare decât 10...”, partea este mai mare decât este operatorul logic. Alegerea unui operator logic pentru o condiție înseamnă, în esență, a-i spune condiției cum să evalueze variabila.

În fluxurile de lucru Shopify Flow, există 3 tipuri de operatori logici:

• Operatori la nivel de câmp, cum ar fi Mai mare decât sau Începe cu.
• Operatori de listă, cum ar fi Cel puțin unul dintre sau Toți din.
• Operatori la nivel de condiție, cum ar fi ȘI sau SAU.

Operatorii la nivel de câmp și operatorii de listă se aplică la nivel de variabilă, iar operatorii la nivel de condiție se aplică la condiția generală și pot fi utilizați pentru a combina mai multe variabile într-o singură condiție.

Operatorii la nivel de câmp sunt cele mai comune tipuri de operatori, utilizați în fiecare tip de declarație de variabilă. Cu operatorii la nivel de câmp, puteți crea declarații condiționale precum „Dacă A este mai mare decât 10, atunci fă X” sau „Dacă B conține „VIP”, atunci fă X” pentru a avea un grad mai mare de control asupra valorilor unei variabile care returnează un rezultat adevărat. Egal cu este operatorul logic implicit.

Operatorii de listă se pot aplica numai variabilelor care pot returna o listă de rezultate. De exemplu, variabila lineItems_item.variant.price returnează prețul pentru o variantă de produs din comandă, care poate returna o listă de rezultate atunci când clientul a cumpărat mai multe produse în aceeași comandă. Acest lucru înseamnă că ați putea aplica un operator de listă, cum ar fi Cel puțin unul dintre, atunci când doriți ca o declarație condițională, precum „lineItems_item.variant.price este mai mare de 10 $” să fie adevărată atunci când există cel puțin 1 variantă de produs în comandă care depășește 10 $. În schimb, operatorii de listă nu sunt afișați pentru variabilele care pot returna un singur rezultat la un moment dat. De exemplu, există o singură valoare posibilă pentru o variabilă precum order.createdAt, deoarece o comandă poate fi creată o singură dată, astfel că operatorii de listă nu sunt afișați ca opțiuni pentru a modifica declarația care conține acea variabilă.

Operatorii la nivel de condiție, cum ar fi AND și OR, vă permit să includeți mai multe variabile în aceeași condiție. De exemplu, în loc de o instrucțiune condițională simplă, cum ar fi „Dacă A este egal cu 5, atunci executați X”, puteți construi condiții mai complexe, cum ar fi „Dacă A este egal cu 5 și B este mai mare decât 10, atunci executați X”, ceea ce necesită ca ambele variabile, A și B, să fie adevărate, sau „Dacă A este egal cu 5 sau B este mai mare decât 10 sau C este mai mic decât 1, atunci executați X”, ceea ce necesită ca doar una dintre variabilele A, B sau C să fie adevărată. Utilizați AND atunci când totul dintr-un flux de lucru trebuie să fie adevărat; utilizați OR atunci când este suficient ca un singur criteriu să fie îndeplinit pentru ca condiția să fie adevărată.

De ce este important acest lucru: Înțelegerea modului în care funcționează operatorii logici în condiții vă permite să construiți fluxuri de lucru care verifică exact criteriile pe care le doriți. Cu cele 3 tipuri de operatori logici, puteți elabora instrucțiuni condiționale detaliate și complexe pentru a crea fluxuri de lucru care verifică condiții foarte specifice.

Aflați informații mai detaliate despre operatorii logici în condiții.