Forhåndsvisning af API-data, der bruges i Shopify Flow

De fleste workflows tilgår data fra din butik, så du kan bruge dem i betingelser og handlinger. Shopify Flow tilgår butiksdata ved at kalde GraphQL Admin API, hvilket giver dig adgang til næsten alle felter i API'en.

Når du opretter et workflow, støder du ofte på feltnavne og beskrivelser, der er baseret på API'en, men du har måske brug for at kende værdierne for disse data. Du vil f.eks. måske gerne kende appnavnet for en ordre, der er oprettet ud fra en ordrekladde. Derudover vil du måske gerne sikre dig, at dit workflow udsender de data, du forventer, eller i den form, du forventer.

Du har flere muligheder i Shopify Flow for at gennemgå værdierne for dataene.

På denne side

Find et felt i Shopify-administratoren

I de fleste tilfælde kan du finde data ved at kigge i Shopify-administratoren. product.title er f.eks. angivet på siden Produkt.

Hent eksempeldata

Når du opretter et workflow, kan du hente eksempeldata direkte i Flow-editoren. Da Flows data kommer fra hændelser, skal du starte med at vælge en relevant hændelse for at kunne hente nøjagtige eksempeldata:

Åbn en handling, hvor du vil bruge dataene, i Flow-editoren, og klik på Tilføj en variabel. Alternativt kan du klikke på Tilføj kriterier i en betingelse.
Klik på Konfigurer eksempeldata.
Flow viser tidligere hændelser baseret på workflowets udløser. Klik på Opdater hændelser for at hente hændelser fra de seneste kørsler, eller klik på Begynd at lytte efter livehændelser, og udløs derefter hændelsen manuelt i administratoren eller den relevante app (for appbaserede udløsere).
Når hændelsen finder sted, viser Flow oplysninger om hændelsen. Vælg den hændelse, du vil bruge til at hente eksempeldata. Klik på Brug denne udløserhændelse.
Når du nu gennemser hændelser, bør der blive vist eksempeldata for hver variabel.

Begrænsninger:

Af pladshensyn viser Flow kun data fra det første element på en liste.
Flow gemmer op til 5 hændelser ad gangen pr. workflow.
Flow kan ikke hente hændelser fra de seneste kørsler for visse udløsere, f.eks. Planlagt tidspunkt, Post for metaobjekt oprettet, Kunde har tilmeldt sig segment eller Kunde har forladt segment.

Brug feltet i et aktivt workflow

Du kan roligt bruge felterne i et workflow ved at benytte handlingen Log output. Når du kører et workflow, udskriver handlingen Log output outputtet af alle variabler og tekst på siden Kørselshistorik. Du kan også bruge notifikationshandlinger som f.eks. Send intern mail.

Trin til at bruge Log output:

Vælg en udløser, der kan aktiveres manuelt.
Føj handlingen Log output til workflowet, og knyt den til udløseren.
I konfigurationen for Log output skal du klikke på Tilføj en variabel for at føje de variabler, du vil inspicere, til afsnittet Output.
Klik på Slå workflow til, når du er færdig.
Udløs workflowet ved enten at køre det manuelt eller ved at få udløseren til at aktiveres. Hvis du f.eks. bruger udløseren Ordre oprettet, skal du oprette en testordre.
Når workflowet er kørt, skal du tjekke aktivitetsloggen for variablerne.

Se JSON-siden for ressourcen

De fleste ressourcesider i Shopify-administratoren, f.eks. siderne Ordre, Produkt eller Kunde, giver dig mulighed for at se de data, som siden bruger. Navngivningen og formatet for disse data er ikke helt de samme som dem, Shopify Flow bruger, men værdierne matcher det, der er i GraphQL Admin API. Hvis du vil gennemgå dataene, skal du tilføje .json til webadressen.

Naviger f.eks. til en ordre ved at gå til siden Ordrer i Shopify-administratoren og klikke på en ordre. I sidens adresse i din browsers adresselinje skal du ændre adressen fra:

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

Til følgende:

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

Brug GraphiQL eller et tredjeparts-API-værktøj

Du kan forespørge API'en direkte ved at bruge et tredjeparts-API-værktøj som f.eks. Postman eller det gratis Shopify-værktøj GraphiQL. Denne mulighed giver de mest nøjagtige resultater, men det kræver et vist kendskab til, hvordan man opretter GraphQL-forespørgsler.

Til GraphiQL tilbyder Shopify både en webbaseret GraphiQL-udforsker med generiske data og GraphiQL-appen. Med GraphiQL kan du opbygge en GraphQL-forespørgsel, der præcist matcher feltnavnene i Shopify Flow. Værdierne matcher også din butik præcist, hvis du bruger appen.

Ved at bruge dette værktøj kan du afgøre præcist, hvilke data Shopify Flow bruger, med data fra din egen butik. Du opretter f.eks. følgende forespørgsel:

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

I de følgende resultater viser variablen order / app / name appnavnet for ordren. I dette tilfælde blev ordren oprettet fra appen til ordrekladder, så værdien er Draft Orders. Kanaloplysninger er kun tilgængelige for appen 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"
            }
          }
        }
      ]
    }
  }