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

Når du udvikler et workflow, vil du muligvis ofte bruge data fra din butik i betingelser og handlinger. Shopify Flow får adgang til butiksdata ved at kalde GraphQL Admin API'en, hvilket betyder, at du har adgang til næsten alle felter i API'en.

Når du udvikler et workflow, vil du ofte møde feltnavne og -beskrivelser baseret på API'en, men du skal muligvis vide, hvilke data API'en outputter. Du kan f.eks. ønske at få navnet på appen for en ordre, der er oprettet ud fra en ordrekladde. Du bør også sørge for, at dit workflow outputter de data, som du forventer, eller i det format, du forventer.

Du har flere valgmuligheder i Shopify Flow, hvis du vil gennemgå dataene.

Find et felt i Shopify-administratoren

I de fleste tilfælde er dataene tilgængelige i Shopify-administratoren.

Brug feltet i et live workflow

Du kan udvikle et workflow ved hjælp af handlinger, der hjælper dig med at gennemgå dataene i stedet for de handlinger, du planlægger at bruge i den endelige version.Lad os f.eks. sige, at du vil oprette et workflow, der annullerer en ordre.I stedet for at bruge handlingen Annuller ordre og muligvis komme til at annullere den forkerte ordre, kan du starte med handlingen Send intern mail eller handlingen Send Slack-besked, hvis du bruger Slack.

Trin:

1. Vælg en trigger, der kan udløses manuelt.
2. Føj en handling til workflowet, og knyt den til udløseren, som f.eks. Send intern mail.
3. Tilføj de variabler, som du vil undersøge, i afsnittet Besked i handlingen Send intern mail.
4. Klik på Slå workflow til.
5. Udløs workflowet, enten ved at køre det manuelt eller ved at aktivere udløseren. Hvis du f.eks. bruger udløseren Ordre oprettet, skal du oprette en testordre.
6. Når workflowet kører, skal du tjekke din mail for at finde variablerne.

Se JSON-siden for ressourcer

De fleste ressourcesider i Shopify-administratoren, f.eks. siderne Ordre, Produkt eller Kunde, giver dig mulighed for at se de data, der bruges på siden. Disse data har ikke helt den samme navngivning og det samme format, som Shopify Flow bruger, men værdierne matcher det, der er i GraphQL Admin API'en. Hvis du vil gennemgå dataene, skal du føje .json til webadressen.

Du kan f.eks. navigere til en ordre ved at gå til siden Ordrer i Shopify-administratoren og klikke på en ordre. På sidens adresse i adresselinjen i din browser skal du ændre adressen fra:

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

Gør følgende:

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

Bemærk

.json-formatet følger REST API'en. Variabelnavnene i REST API'en bruger understregning, som f.eks. line_items. GraphQL og Shopify Flow bruger camelCasing, som f.eks. lineItems. Nogle gange kan feltnavne også variere, f.eks. properties i stedet for customAttributes. Bekræft de oplysninger, du finder ved hjælp af denne fremgangsmåde.

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

Du kan sende direkte forespørgsler til API'en ved hjælp af et tredjeparts-API-værktøj som Postman eller det gratis værktøj GraphiQL fra Shopify. Denne mulighed giver de mest nøjagtige resultater, men den kræver en vis kendskab til oprettelse af GraphQL-forespørgsler.

Shopify tilbyder både en webbaseret GraphiQL Explorer med generiske data og GraphiQL-appen til GraphiQL. Med GraphiQL kan du oprette en GraphQL-forespørgsel, som nøjagtigt matcher de feltnavne, du ser i Shopify Flow. Værdierne matcher også din butik nøjagtigt, hvis du bruger appen.

Ved at bruge dette værktøj kan du bestemme præcist, hvilke data Shopify Flow bruger, med dine egentlige butiksdata. Du kan f.eks. oprette følgende forespørgsel:

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

I følgende resultater viser variablen order / app / name navnet på appen for ordren. I dette tilfælde er ordren oprettet ud fra ordrekladdeappen, 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"
            }
          }
        }
      ]
    }
  }