Náhľad dát z rozhrania API používaných v aplikácii Shopify Flow

Väčšina pracovných postupov pristupuje k dátam z vášho obchodu, aby ste ich mohli použiť v podmienkach a akciách. Aplikácia Shopify Flow pristupuje k dátam obchodu volaním rozhrania GraphQL Admin API, vďaka čomu získate prístup k takmer všetkým poliam v rozhraní API.

Pri vytváraní pracovného postupu sa často stretnete s názvami polí a popismi založenými na rozhraní API, ale možno budete potrebovať poznať aj hodnoty týchto údajov. Napríklad možno budete chcieť vedieť názov aplikácie pre objednávku, ktorá sa vytvorila z návrhu objednávky. Okrem toho sa možno budete chcieť uistiť, že váš pracovný postup vráti údaje, ktoré očakávate, alebo vo formáte, aký očakávate.

Na kontrolu hodnôt údajov máte v aplikácii Shopify Flow niekoľko možností.

Vyhľadanie poľa v administrátorovi Shopify

Vo väčšine prípadov môžete údaje nájsť priamo v administrátorovi Shopify. Napríklad pole product.title je uvedené na stránke Produkt.

Získanie vzorových údajov

Pri vytváraní pracovného postupu môžete získať vzorové údaje priamo v editore aplikácie Flow. Keďže údaje v aplikácii Flow pochádzajú z udalostí, na získanie presných vzorových údajov musíte najprv vybrať relevantnú udalosť:

1. V editore aplikácie Flow otvorte akciu, v ktorej chcete údaje použiť, a kliknite na Pridať premennú. Prípadne v podmienke kliknite na Pridať kritériá.
2. Kliknite na Nakonfigurovať vzorové údaje.
3. Aplikácia Flow zobrazí predchádzajúce udalosti na základe spúšťača pracovného postupu. Kliknutím na Obnoviť udalosti načítate udalosti z posledných spustení, prípadne kliknite na Začať počúvať živé udalosti a potom udalosť manuálne spustite v administrátorovi alebo príslušnej aplikácii (pri spúšťačoch založených na aplikáciách).
4. Keď dôjde k udalosti, aplikácia Flow o nej zobrazí podrobnosti. Vyberte udalosť, ktorú chcete použiť na získanie vzorových údajov. Kliknite na Použiť túto udalosť spúšťača.
5. Teraz by sa vám pri prehliadaní udalostí mali pri každej premennej zobrazovať vzorové údaje.

Obmedzenia:

• Z dôvodu obmedzeného priestoru zobrazí aplikácia Flow pri údajoch v zozname len údaje z prvej položky.
• Aplikácia Flow uchováva naraz maximálne 5 udalostí pre jeden pracovný postup.
• Aplikácia Flow nedokáže načítať udalosti z nedávnych spustení pre niektoré spúšťače, ako napríklad Plánovaný čas, Vytvorená položka metaobjektu, Zákazník sa pridal do segmentu alebo Zákazník opustil segment.

Použitie poľa v aktívnom pracovnom postupe

Polia v pracovnom postupe môžete bezpečne používať pomocou akcie Zaznamenať výstup. Keď spustíte pracovný postup, akcia Zaznamenať výstup vypíše výstup všetkých premenných a textu na stránku História spustení. Môžete použiť aj akcie s upozorneniami, ako napríklad Odoslať interný e-mail.

Kroky na použitie akcie Zaznamenať výstup:

1. Vyberte spúšťač, ktorý sa dá spustiť manuálne.
2. Do pracovného postupu pridajte akciu Zaznamenať výstup a prepojte ju so spúšťačom.
3. V konfigurácii akcie Zaznamenať výstup kliknite na Pridať premennú a do sekcie Výstup pridajte premenné, ktoré chcete skontrolovať.
4. Po dokončení kliknite na Zapnúť pracovný postup.
5. Spustite pracovný postup – buď manuálnym spustením, alebo vyvolaním spúšťača. Ak napríklad používate spúšťač Vytvorená objednávka, vytvorte skúšobnú objednávku.
6. Po spustení pracovného postupu skontrolujte premenné v protokole aktivít.

Zobrazenie stránky zdroja vo formáte JSON

Väčšina stránok zdrojov v administrátorovi Shopify, napríklad stránky Objednávka, Produkt alebo Zákazník, umožňuje zobraziť údaje, z ktorých stránka čerpá. Názvy a formát týchto údajov nie sú úplne rovnaké, aké používa Shopify Flow, ale ich hodnoty zodpovedajú hodnotám v rozhraní GraphQL Admin API. Ak chcete tieto údaje zobraziť, pridajte k URL adrese príponu .json.

Ak chcete napríklad prejsť na objednávku, otvorte si v administrátorovi Shopify stránku Objednávky a kliknite na objednávku. V paneli s adresou vo vašom prehliadači zmeňte adresu z:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

Na túto:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

Poznámka

Formát .json sa riadi rozhraním REST API. Názvy premenných v REST API používajú na oddelenie slov podčiarkovníky, napríklad line_items. GraphQL a Shopify Flow používajú formát camelCase (ťavie písmo), napríklad lineItems. Okrem toho sa názvy polí niekedy líšia, napríklad properties namiesto customAttributes. Informácie, ktoré nájdete týmto spôsobom, si pre istotu overte.

Použitie nástroja GraphiQL alebo nástroja API tretej strany

Na rozhranie API sa môžete dopytovať priamo pomocou nástroja API tretej strany, ako je napríklad Postman, alebo pomocou bezplatného nástroja od spoločnosti Shopify s názvom GraphiQL. Táto možnosť poskytuje najpresnejšie výsledky, vyžaduje si však určité znalosti o vytváraní dopytov GraphQL.

Pre GraphiQL ponúka Shopify webový prieskumník GraphiQL so všeobecnými údajmi a aplikáciu GraphiQL. Pomocou nástroja GraphiQL môžete vytvoriť dopyt GraphQL, ktorý presne zodpovedá názvom polí v aplikácii Shopify Flow. Ak použijete aplikáciu, hodnoty budú tiež presne zodpovedať vášmu obchodu.

Použitím tohto nástroja môžete so svojimi reálnymi údajmi z obchodu presne zistiť, aké údaje Shopify Flow používa. Vytvoríte napríklad nasledujúci dopyt:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

V nasledujúcich výsledkoch premenná order / app / name zobrazí názov aplikácie pre objednávku. V tomto prípade sa objednávka vytvorila z aplikácie na návrhy objednávok, takže hodnota je Draft Orders. Informácie o kanáli sú dostupné len pre aplikáciu Point of Sale.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }