Forhåndsvisning av API-data som brukes i Shopify Flow

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

Når du bygger en arbeidsflyt, vil du ofte støte på feltnavn og beskrivelser basert på API-et, men du må kanskje kjenne til verdiene til disse dataene. Du vil for eksempel kanskje vite appnavnet for en bestilling som ble opprettet fra et bestillingsutkast. I tillegg vil du kanskje sikre at arbeidsflyten gir dataene du forventer, eller i forventet format.

Du har flere alternativer for å se gjennom dataverdiene i Shopify Flow.

På denne siden

Finn et felt i Shopify-administratoren

I de fleste tilfeller kan du finne data ved å se i Shopify-administratoren. For eksempel er product.title oppført på Produktsiden.

Hent eksempeldata

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

Åpne en handling der du vil bruke dataene i Flow-redigeringsverktøyet og klikk på Legg til en variabel. Alternativt kan du klikke på Legg til kriterier i en betingelse.
Klikk på Konfigurer eksempeldata.
Flow viser tidligere hendelser basert på arbeidsflytens utløser. Klikk på Oppdater hendelser for å hente hendelser fra nylige kjøringer, eller klikk på Start lytting etter aktive hendelser og utløs deretter hendelsen manuelt i administratorpanelet eller den relevante appen (for appbaserte utløsere).
Når hendelsen har inntruffet, viser Flow detaljer om hendelsen. Velg hendelsen du vil bruke til å hente eksempeldata. Klikk på Bruk denne utløserhendelsen.
Når du nå blar gjennom hendelser, skal det vises eksempeldata for hver variabel.

Begrensninger:

På grunn av plassbegrensninger viser Flow bare data fra det første elementet i listen for data som er i en liste.
Flow lagrer opptil 5 hendelser om gangen, per arbeidsflyt.
Flow kan ikke hente hendelser fra nylige kjøringer for enkelte utløsere, som Planlagt tidspunkt, Metaobjektoppføring opprettet, Kunde ble med i segment eller Kunde forlot segment.

Bruk feltet i en aktiv arbeidsflyt

Du kan trygt bruke feltene i en arbeidsflyt ved å benytte deg av handlingen Logg utdata. Når du kjører en arbeidsflyt, vil handlingen Logg utdata skrive ut utdataene for eventuelle variabler og tekst til siden Kjøringslogg. Du kan også bruke varslingshandlinger som Send intern e-post.

Fremgangsmåte for å bruke Logg utdata:

Velg en utløser som kan utløses manuelt.
Legg til en Logg utdata-handling i arbeidsflyten og koble den til utløseren.
I Logg utdata-konfigurasjonen klikker du på Legg til en variabel for å legge til variablene du vil inspisere i Utdata-seksjonen.
Klikk på Slå på arbeidsflyt når du er ferdig.
Utløs arbeidsflyten, enten ved å kjøre den manuelt eller ved å få utløseren til å aktiveres. Hvis du for eksempel bruker Bestilling opprettet-utløseren, kan du opprette en testbestilling.
Når arbeidsflyten er kjørt, sjekker du aktivitetsloggen for variablene.

Se ressursens JSON-side

De fleste ressurssider i Shopify-administratoren, som Bestilling-, Produkt- eller Kunde-sidene, lar deg se dataene som brukes på siden. Disse dataene har ikke nøyaktig samme navngiving og format som Shopify Flow bruker, men verdiene samsvarer med det som er i GraphQL Admin API. For å se gjennom dataene, kan du legge til .json i URL-adressen.

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

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

Til følgende:

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

Bruk GraphiQL eller et tredjeparts API-verktøy

Du kan stille spørringer direkte til API-et ved å bruke et tredjeparts API-verktøy som Postman eller det gratis Shopify-leverte verktøyet, GraphiQL. Dette alternativet gir de mest nøyaktige resultatene, men det krever en viss kjennskap til å opprette GraphQL-spørringer.

For GraphiQL tilbyr Shopify både en nettbasert GraphiQL-utforsker med generiske data og GraphiQL-appen. Med GraphiQL kan du bygge en GraphQL-spørring som samsvarer nøyaktig med feltnavnene i Shopify Flow. Verdiene vil også samsvare nøyaktig med butikken din hvis du bruker appen.

Ved å bruke dette verktøyet kan du finne ut nøyaktig hvilke data Shopify Flow bruker, med dine reelle butikkdata. Du kan for eksempel opprette følgende spørring:

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

I de følgende resultatene viser variabelen order / app / name appnavnet for bestillingen. I dette tilfellet ble bestillingen opprettet fra appen for bestillingsutkast, så verdien er Draft Orders. Kanalinformasjon 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"
            }
          }
        }
      ]
    }
  }