Získať záznamy metaobjektu

Akciu Získať záznamy metaobjektu môžete použiť na získanie zoznamu záznamov pre metaobjekt z vášho obchodu na základe voliteľného dopytu. Ďalšie informácie nájdete v dokumentácii k metaobjektom.

Konfigurácia

Polia

Akcia Získať záznamy metaobjektu obsahuje rozbaľovaciu ponuku na určenie definície metaobjektu, ako aj nasledujúce polia, ktoré sa používajú na zostavenie dopytu:

Reťazec dopytu

Toto je príklad dopytu na získanie záznamov metaobjektu v prípade, že sa hodnota poľa email zhoduje s e‑mailovou adresou v objednávke:

{{fields.email}}:"{{order.email}}"

Toto je príklad dopytu na získanie záznamov metaobjektu, ktoré boli aktualizované za posledný deň:

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

Premenná updated_at je filter dostupný v dopyte pre metaobjekty a možno ho použiť viackrát alebo skombinovať s inými premennými. Premenná Liquid scheduledAt je dostupná v pracovných postupoch, ktoré použili spúšťač Naplánovaný čas. Značka Liquid date_minus je špeciálna značka aplikácie Flow, ktorá umožňuje odpočítať čas od dátumu.

Pri zadávaní dopytov na údaje je užitočné vedieť:

• Zoznam dostupných filtrov metaobjektu
• Zadávanie dopytov na metaobjekty podľa hodnoty poľa si vyžaduje, aby mal metaobjekt povolené filtrovanie, ktoré sa dá povoliť v možnostiach pre vlastné údaje v administrátorovi Shopify.
• Dopyty musia dodržiavať určitú syntax
• Hodnoty polí dopytu nie sú vždy zdokumentované. V niektorých prípadoch ich nájdete v dokumentácii rozhrania API. Hodnoty polí môžete často nájsť aj v adresách URL v administrátorskom paneli, keď použijete filtre. Ak chcete napríklad zistiť niektoré hodnoty dopytov pre objednávky, vyfiltrujte stránku Objednávky v administrátorskom paneli a potom skontrolujte adresu URL.
• Dopyt môžete vo svojom obchode spustiť alebo otestovať pomocou aplikácie Shopify GraphiQL.
• Berte do úvahy, čo sa stane, ak váš dopyt zlyhá. Rozhranie API často vráti všetky výsledky (namiesto žiadnych).

Vrátené údaje

Všetky akcie Získať údaje vracajú zoznam obsahujúci 0 až 100 zdrojov. V závislosti od vášho prípadu použitia môžete tieto údaje využiť rôznymi spôsobmi:

• Ak potrebujete spracovať každú položku zoznamu samostatne, napríklad pridať ku každej štítok, môžete použiť akciu For each.
• Ak potrebujete agregovať údaje, napríklad spočítať, koľko výsledkov sa vrátilo, môžete použiť akcie Count alebo Sum.
• Ak potrebujete vytvoriť výstupný zoznam, napríklad odoslať e‑mail so všetkými položkami, môžete vrátené údaje použiť priamo v nasledujúcich akciách.

Ak chcete v krokoch nasledujúcich po tejto akcii pracovať s vrátenými údajmi, použite premennú s názvom Získať položky metaobjektu, ktorá predstavuje zoznam položiek metaobjektu. Túto premennú môžete použiť v podmienkach aj v akciách. Zoznam párov kľúč – hodnota pre položky metaobjektu môžete napríklad odoslať prostredníctvom akcie Odoslať interný e‑mail takto:

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% endfor %}

Spúšťače

Túto akciu môžete použiť v akomkoľvek pracovnom postupe vrátane spúšťača Plánovaný čas. V pracovnom postupe, ktorý používa spúšťač Plánovaný čas, sa pracovný postup začne vo vami určenom čase, a nie ako výsledok udalosti. Keďže v obchode alebo z aplikácie neexistuje žiadna konkrétna udalosť, ktorá by pracovný postup spúšťala, nezahŕňajú sa do neho automaticky žiadne údaje.

Podrobnosti o rozhraní API

• Zdroj metaobjektu
• Filtre dopytov na metaobjekt
• Dopytovanie metaobjektov podľa hodnoty poľa