Obținere date locație

În fluxurile de lucru care necesită date despre locații, puteți utiliza acțiunea Obținere date locație pentru a recupera informații despre locații din magazinul dvs. Shopify. Locațiile reprezintă orice loc în care stocați inventar, vindeți produse sau expediați ori onorați comenzi.

Pe această pagină

Configurare

Câmpuri

Acțiunea Obținere date locație conține următoarele câmpuri.

Câmpuri utilizate în acțiunile de obținere a datelor.
Câmp	Descriere
Sortare date după	Obligatoriu. Parametrii după care sunt sortate datele returnate de interogarea de căutare.
Număr maxim de rezultate	Obligatoriu. Numărul maxim de rezultate care pot fi returnate de interogarea de căutare pe care o selectați. Puteți returna până la 100 de rezultate odată.
Interogare	Obligatoriu. Alegeți dintre interogările comune sau selectați Avansat pentru a vă crea propria interogare.

Șir de interogare

Acesta este un exemplu de interogare pentru obținerea locațiilor care au activată opțiunea de ridicare din magazin:

pickup_in_store:enabled

Variabila pickup_in_store este un filtru disponibil în interogarea Locații și poate fi utilizată de mai multe ori sau combinată cu alte variabile.

Atunci când interogați date, este util să cunoașteți următoarele:

Listă de filtre disponibile pentru locații
Interogările trebuie să respecte o anumită sintaxă
Valorile câmpurilor de interogare nu sunt întotdeauna documentate. În unele cazuri, valorile pot fi găsite consultând documentația API. Alternativ, puteți găsi adesea valorile câmpurilor în URL-uri, în panoul de administrare, atunci când filtrați. De exemplu, pentru a găsi unele valori pentru interogarea comenzii, filtrați pagina Comenzi din panoul de administrare, apoi verificați URL-ul.
Puteți rula sau testa o interogare în magazinul dvs. utilizând aplicația Shopify GraphiQL.
Fiți atenți la ce se întâmplă în cazul în care interogarea eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).

Date returnate

Toate acțiunile de Obținere a datelor returnează o listă de la 0 la 100 de resurse. În funcție de cazul dvs. de utilizare, este posibil să doriți să utilizați aceste date în diverse moduri:

Dacă trebuie să gestionați individual fiecare articol din listă, de exemplu, pentru a adăuga o etichetă pentru fiecare, puteți utiliza acțiunea Pentru fiecare.
Dacă trebuie să agregați date, cum ar fi să numărați câte rezultate au fost returnate, puteți utiliza acțiunile Numărare sau Sumă.
Dacă trebuie să generați lista ca rezultat, cum ar fi să trimiteți un e-mail cu toate articolele, puteți utiliza datele returnate direct în acțiunile ulterioare.

Pentru a accesa datele returnate în pașii care urmează acestei acțiuni, utilizați variabila denumită Obținere date locație, care este o listă de locații. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de locații într-o acțiune Trimitere e-mail intern, astfel:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Declanșatori

Puteți utiliza această acțiune în orice flux de lucru, inclusiv în declanșatorul Oră programată. Într-un flux de lucru care utilizează declanșatorul Oră programată, fluxul de lucru pornește la o oră pe care ați specificat-o, mai degrabă decât ca urmare a unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dvs. sau de la o aplicație care să pornească fluxul de lucru, nu există date incluse automat.

Referință API

Pentru mai multe informații despre API-ul utilizat în această acțiune, consultați interogarea Locații.