Pridobi podatke o podjetju

V potekih dela, ki uporabljajo podatke o podjetju, lahko uporabite dejanje Pridobi podatke o podjetju, da iz trgovine pridobite informacije o podjetju.

Konfiguracija

Polja

Dejanje Pridobi podatke o podjetju vsebuje naslednja polja, ki se uporabljajo za izdelavo poizvedbe:

Polja, uporabljena v dejanjih za pridobivanje podatkov.
PoljeOpis
Razvrsti podatke poObvezno. Parametri, po katerih so razvrščeni podatki, ki jih vrne iskalna poizvedba.
Največje število rezultatovObvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Naenkrat lahko vrne do 100 rezultatov.
PoizvedbaObvezno. Izberite eno od pogostih poizvedb ali izberite Napredno, da ustvarite svojo.

Niz poizvedbe

To je primer poizvedbe za pridobivanje podjetij, ki so bila posodobljena v zadnjem dnevu:

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

Spremenljivka updated_at je filter, ki je na voljo pri poizvedbi za podjetja, in ga je mogoče uporabiti večkrat ali kombinirati z drugimi spremenljivkami. Spremenljivka Liquid scheduledAt je na voljo pri potekih dela, ki so uporabili sprožilec Načrtovan čas. Oznaka Liquid date_minus je posebna oznaka za Flow, ki omogoča odštevanje časa od datuma.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

  • Seznam razpoložljivih filtrov za podjetja
  • Poizvedbe morajo upoštevati določeno sintakso
  • Vrednosti polj poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete v dokumentaciji API-ja. Pogosto pa lahko vrednosti polj najdete tudi v naslovih URL v skrbniški plošči, ko uporabite filtre. Če želite na primer poiskati nekatere vrednosti poizvedbe za naročila, filtrirajte stran »Naročila« v skrbniški plošči in nato preverite URL-naslov.
  • Poizvedbo lahko v trgovini zaženete ali preizkusite z aplikacijo Shopify GraphiQL.
  • Bodite pozorni na to, kaj se zgodi, če poizvedba ne uspe. API pogosto vrne vse rezultate (namesto nobenega).

Vrnjeni podatki

Vsa dejanja Pridobi podatke vrnejo seznam od 0 do 100 virov. Odvisno od primera uporabe boste morda te podatke želeli uporabiti na različne načine:

  • Če morate vsak element seznama obdelati posamezno, na primer tako, da vsakemu dodate oznako, lahko uporabite dejanje Za vsak.
  • Če morate združiti podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanji Štetje ali Vsota.
  • Če morate izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko vrnjene podatke uporabite neposredno v naslednjih dejanjih.

Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Pridobi podatke o podjetju, ki je seznam podjetij. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Seznam podjetij lahko na primer pošljete v dejanju Pošlji interno e-pošto na naslednji način:

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

Sprožilci

To dejanje lahko uporabite v katerem koli poteku dela, vključno s sprožilcem Načrtovani čas. V poteku dela, ki uporablja sprožilec Načrtovani čas, se potek dela začne ob času, ki ste ga določili, in ne kot rezultat dogodka. Ker v trgovini ali aplikaciji ni določenega dogodka, ki bi začel potek dela, podatki niso samodejno vključeni.

Referenca API-ja