Forhåndsvis API-data som brukes i Shopify Flow

De fleste arbeidsflyter henter data fra butikken din, slik at du kan bruke dem i vilkår og handlinger. Shopify Flow får tilgang til butikkdata ved å kalle opp GraphQL Admin API, som gir deg tilgang til nesten alle feltene i API-en.

Når du bygger en arbeidsflyt, ser du gjerne feltnavn og beskrivelser basert på API-en, men du må kanskje vite hva dataverdiene er. Det kan for eksempel hende du ønsker å vite appnavnet til en bestilling som ble opprettet fra et bestillingsutkast. I tillegg bør du kanskje sørge for at arbeidsflyten produserer dataene du forventer, eller er i samme form som du forventer.

Det er flere alternativer for gjennomgang av dataverdiene i Shopify Flow.

Finn et felt i Shopify-administratoren

I de fleste tilfeller kan du finne data ved å se i Shopify-administrator. product.title er for eksempel oppført på produktsiden.

Hent eksempeldata

Når du bygger en arbeidsflyt, kan du hente eksempeldata direkte i Flow-redigeringsprogrammet. Siden Flow-data kommer fra hendelser, må du begynne med å velge en relevant hendelse for å få nøyaktige eksempeldata:

1. I Flow-redigeringsprogrammet åpner du en handling der du vil bruke dataene, og klikker på Legg til en variabel. Alternativt kan du klikke på Legg til kriterier i en tilstand.
2. Klikk på Konfigurer eksempeldata.
3. Flow vil begynne å lytte etter hendelser basert på arbeidsflytens utløser. Hvis hendelsen ikke skjer ofte, kan du manuelt avslutte hendelsen i administratorpanelet eller den relevante appen (for appbaserte utløsere).
4. Etter at hendelsen har inntruffet, vil Flow vise informasjon om den. Velg hendelsen du vil bruke for å hente eksempeldata. Klikk på Bruk denne utløser-hendelsen.
5. Når du nå blar gjennom hendelser, skal eksempeldata vises for hver variabel.

Begrensninger:

• På grunn av plassbegrensninger for data i lister vil Flow bare vise data fra den første variabelen i listen.
• Flow lagrer opptil fem hendelser om gangen per arbeidsflyt.

Bruk feltet i en aktiv arbeidsflyt

Du kan trygt bruke feltene i en arbeidsflyt ved å bruke handlingen Logg utdata. Når du kjører en arbeidsflyt, returnerer handlingen Logg utdata utdata fra variabler og tekst til siden Kjørehistorikk. Du kan også bruke varslingshandlinger, som Send intern e-postmelding.

Trinn for bruk av Logg utdata:

1. Velg en utløser som kan utløses manuelt.
2. Legg til handlingen Logg utdata i arbeidsflyten og koble den til utløseren.
3. Klikk på Legg til en variabel i konfigurasjonen for Logg utdata for å legge til variablene du vil inspisere i seksjonen Utdata.
4. Klikk på Aktiver arbeidsflyt når du er ferdig.
5. Utløs arbeidsflyten, enten ved å kjøre den manuelt eller ved å forårsake at utløseren starter. Hvis du for eksempel bruker utløseren Bestilling opprettet, kan du opprette en testbestilling.
6. Kontroller aktivitetsloggen og se etter variablene når arbeidsflyten er kjørt.

Se siden med JSON-ressurser

De fleste ressurssider i Shopify-administrator, som sidene Bestilling, Produkt eller Kunde, viser data som er relevante for siden. Disse dataene har ikke helt samme navn og format som Shopify Flow, men verdiene samsvarer med verdiene i GraphQL Admin API. Legg til .json i URL-adressen for å se dataene.

Du kan for eksempel finne en bestilling ved å gå fra Shopify-administrator til siden Bestillinger og klikke på en bestilling. Endre adressen til siden i adresselinjen i nettleseren fra:

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

Til følgende:

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

Merk

.json-formatet følger REST API. Bokstavene i variabelnavnene i REST API bruker understreking, for eksempel line_items. GraphQL og Shopify Flow bruker CamelCase, for eksempel lineItems. I tillegg varierer feltenes navn iblant, for eksempel properties i stedet for customAttributes. Bekreft informasjonen du finner ved hjelp av denne tilnærmingen.

Bruk GraphQL eller et tredjeparts API-verktøy

Du kan sende spørringer direkte til API-en med et tredjeparts-API-verktøy, for eksempel Postman eller det gratis Shopify-leverte verktøyet GraphQL. Dette alternativet gir de mest nøyaktige resultatene, men det krever at du har litt kjennskap til GraphQL-spørringer.

For GraphQL tilbyr Shopify både en nettbasert GraphQL-explorer med generelle data og GraphQL-appen. Med GraphQL kan du bygge en GraphQL-spørring som stemmer helt med feltnavnene i Shopify Flow. Verdiene stemmer også helt med butikken hvis du bruker appen.

Ved å bruke dette verktøyet kan du fastslå nøyaktig hvilke data Shopify Flow bruker med de faktiske dataene for butikken din. Du oppretter for eksempel følgende spørring:

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

I disse resultatene viser variabelen order / app / name appnavnet for bestillingen. I dette tilfellet ble bestillingen opprettet fra bestillingsutkast-appen, så verdien er Draft Orders. Kanalinformasjonen er bare tilgjengelig for Point of Sale-appen.

{
  "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"
            }
          }
        }
      ]
    }
  }