Vorschau der in Shopify Flow verwendeten API-Daten

Wenn du einen Workflow erstellst, möchtest du möglicherweise Daten aus deinem Shop in Bedingungen und Aktionen verwenden. Shopify Flow greift auf Shop-Daten zu, indem dieGraphQL Admin APIaufgerufen wird. Das bedeutet, dass du Zugriff auf fast alle Felder in der API hast.

要是du杯工作流erstellst,国标ßt du haufigauf Feldnamen und Beschreibungen, die auf der API basieren, aber du musst möglicherweise wissen, welche Daten von der API ausgegeben werden. So kann es zum Beispiel sein, dass du den App-Namen für eine Bestellung wissen möchtest, die aus einem Bestellentwurf erstellt wurde. Darüber hinaus solltest du sicherstellen, dass dein Workflow die Daten ausgibt, die du erwartest, und dass sie die Form haben, die du erwartest.

Um die Daten zu überprüfen, hast du mehrere Optionen in Shopify Flow.

Ein Feld im Shopify-Adminbereich suchen

In den meisten Fällen sind die Daten im Shopify-Adminbereich verfügbar.

Das Feld in einem Live-Workflow verwenden

Du kannst einen Workflow anstatt mit den Aktionen, die du in der endgültigen Version verwenden willst, mit Aktionen erstellen, die dir helfen, die Daten zu überprüfen. Nehmen wir zum Beispiel an, du möchtest einen Workflow erstellen, mit dem eine Bestellung storniert wird. Anstatt die AktionBestellung stornierenzu verwenden und möglicherweise die falsche Bestellung zu stornieren, kannst du mit der AktionInterne E-Mail sendenbeginnen. Du kannst auch mit der AktionSlack-Nachricht sendenbeginnen, wenn du Slack verwendest.

Schritte:

1. Wähle einen Trigger, der manuell ausgelöst werden kann.
2. Füge eine Aktion zum Workflow hinzu und verbinde sie mit dem Trigger, z. B.Interne E-Mail senden.
3. Füge die Variablen, die du überprüfen möchtest, im AbschnittNachrichtder AktionInterne E-Mail sendenhinzu.
4. Klicke aufWorkflow aktivieren.
5. Löse den Workflow aus, entweder indem duihn manuell ausführstoder indem du den Trigger auslösen lässt. Wenn du beispielsweise den von dir erstellten TriggerBestellung erstelltverwendest, erstelle eine Testbestellung.
6. Nachdem der Workflow ausgeführt wurde, überprüfe deine E-Mails auf die Variablen.

Auf die JSON-Ressourcen-Seite verweisen

Auf den meisten Ressourcenseiten im Shopify-Adminbereich, z. B.Bestellung,ProduktoderKunde, kannst du die Daten anzeigen, die auf der Seite enthalten sind. Diese Daten haben nicht genau dieselbe Benennung und dasselbe Format wie in Shopify Flow, aber die Werte stimmen mit denen in der GraphQL Admin API überein. Um die Daten zu überprüfen, füge.jsonzur URL hinzu.

Navigiere beispielsweise zu einer Bestellung, indem du im Shopify-Adminbereich zur SeiteBestellungengehst und auf eine Bestellung klickst. Ändere in der Adresse der Seite in der Adressleiste deines Browsers die Adresse aus

https://.myshopify.com/admin/orders/3804849891234

in Folgendes:

https://.myshopify.com/admin/orders/3804849891234.json

GraphiQL oder ein API-Tool eines Drittanbieters verwenden

Du kannst die API direkt abfragen, indem du ein API-Tool eines Drittanbieters wie Postman oder das kostenlose von Shopify bereitgestellte Tool GraphiQL verwendest. Diese Option bietet die genauesten Ergebnisse, erfordert jedoch einige Kenntnisse bei der Erstellung von GraphQL-Abfragen.

Für GraphiQL bietet Shopify sowohl einenwebbasierten GraphiQL-Explorermit generischen Daten als auch dieGraphiQL-Appan. Mit GraphiQL kannst du eine GraphQL-Abfrage erstellen, die genau mit den Feldnamen übereinstimmt, die du in Shopify Flow siehst. Die Werte stimmen auch exakt mit deinem Shop überein, wenn du die App verwendest.

Mit diesem Tool kannst du genau bestimmen, welche Daten deiner echten Shop-Daten Shopify Flow verwendet. Du erstellst beispielsweise die folgende Abfrage:

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

In den folgenden Ergebnissen zeigt die Variableorder / app / nameden App-Namen für die Bestellung an. In diesem Fall wurde die Bestellung über die Bestellentwurf-App erstellt, daher ist der WertDraft Orders. Kanalinformationen sind nur für diePoint of Sale-App verfügbar.

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