Preluare date societate

În fluxurile de lucru care utilizează date despre societate, puteți utiliza acțiunea Preluare date societate pentru a recupera informații despre societate din magazinul dvs.

Configurare

Câmpuri

Acțiunea Preluare date societate conține următoarele câmpuri, care sunt utilizate pentru a construi interogarea:

Câmpuri utilizate în acțiunile de Preluare date.
CâmpDescriere
Sortare date dupăObligatoriu. Parametrii după care sunt sortate datele returnate de interogarea de căutare.
Număr maxim de rezultateObligatoriu. 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 deodată.
InterogareObligatoriu. 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 societăților care au fost actualizate în ultima zi:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Variabila updated_at este un filtru disponibil în interogarea Societăți și poate fi utilizată de mai multe ori sau combinată cu alte variabile. Variabila Liquid scheduledAt este disponibilă în fluxurile de lucru care au utilizat declanșatorul Oră programată. Eticheta Liquid date_minus este o etichetă specială Flow, care vă permite să scădeți timp dintr-o dată.

La interogarea datelor, este util să știți:

  • Listă de filtre de societate disponibile
  • 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. Ca alternativă, puteți găsi adesea valorile câmpurilor în adresele URL din panoul de administrare atunci când filtrați. De exemplu, pentru a găsi unele valori de interogare pentru comenzi, filtrați pagina Comenzi din panoul de administrare, apoi verificați adresa URL.
  • Puteți executa sau testa o interogare în magazinul dvs. utilizând aplicația Shopify GraphiQL.
  • Fiți atent la ce se întâmplă dacă interogarea dvs. eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).

Date returnate

Toate acțiunile de tip Preluare date 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 fiecare element din listă individual, cum ar fi să adăugați o etichetă pentru fiecare, atunci 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, atunci puteți utiliza acțiunile Numărare sau Însumare.
  • Dacă trebuie să folosiți lista rezultată, de exemplu, pentru a trimite un e-mail cu toate articolele, atunci puteți utiliza datele returnate direct în acțiunile ulterioare.

Pentru a accesa datele returnate în pașii care urmează după această acțiune, utilizați variabila denumită Preluare date societate, care este o listă de societăți. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de societăți printr-o acțiune Trimitere e-mail intern în felul următor:

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

Declanșatori

Puteți utiliza această acțiune în orice flux de lucru, inclusiv cu declanșatorul Oră programată. Într-un flux de lucru care utilizează declanșatorul Oră programată, fluxul de lucru pornește la o oră specificată de dumneavoastră, în loc să pornească în urma unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dumneavoastră sau de la o aplicație care să pornească fluxul de lucru, nu sunt incluse automat date.

Referință API