Hilfe
Einloggen

Vorschau der in Shopify Flow verwendeten API-Daten

Die meisten Workflows greifen auf Daten aus deinem Shop zu, damit du sie in Bedingungen und Aktionen verwenden kannst. Shopify Flow greift auf Shop-Daten zu, indem es die GraphQL Admin API aufruft, wodurch du Zugriff auf fast alle Felder in der API erhältst.

Während du einen Workflow erstellst, wirst du oft auf Feldnamen und Beschreibungen stoßen, die auf der API basieren. Möglicherweise musst du aber die Werte dieser Daten kennen. Du könntest zum Beispiel den App-Namen für eine Bestellung wissen wollen, die aus einem Bestellentwurf erstellt wurde. Darüber hinaus möchtest du vielleicht sicherstellen, dass dein Workflow die Daten ausgibt, die du erwartest, oder in der Form, die du erwartest.

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

Auf dieser Seite

Ein Feld im Shopify-Adminbereich finden

In den meisten Fällen kannst du Daten finden, indem du im Shopify-Adminbereich nachsiehst. So ist beispielsweise product.title auf der Seite Produkt aufgeführt.

Beispieldaten abrufen

Wenn du einen Workflow erstellst, kannst du Beispieldaten direkt im Flow-Editor abrufen. Da die Daten von Flow von Ereignissen stammen, musst du, um genaue Beispieldaten zu erhalten, zuerst ein relevantes Ereignis auswählen:

  1. Öffne im Flow-Editor eine Aktion, in der du die Daten verwenden möchtest, und klicke auf Variable hinzufügen. Klicke alternativ in einer Bedingung auf Kriterien hinzufügen.
  2. Klicke auf Beispieldaten konfigurieren.
  3. Flow zeigt frühere Ereignisse basierend auf dem Trigger des Workflows an. Klicke auf Ereignisse aktualisieren, um Ereignisse aus den letzten Durchläufen abzurufen, oder klicke auf Live-Ereignisse abhören und löse das Ereignis dann manuell im Adminbereich oder in der entsprechenden App aus (bei App-basierten Triggern).
  4. Nachdem das Ereignis eingetreten ist, zeigt Flow Details zu dem Ereignis an. Wähle das Ereignis aus, das du für die Beispieldaten verwenden möchtest. Klicke auf Dieses Trigger-Ereignis verwenden.
  5. Wenn du jetzt die Ereignisse durchgehst, sollten für jede Variable Beispieldaten angezeigt werden.

Einschränkungen:

  • Aus Platzgründen zeigt Flow bei Daten in einer Liste nur die Daten des ersten Artikels in der Liste an.
  • Flow speichert bis zu 5 Ereignisse gleichzeitig pro Workflow.
  • Flow kann für einige Trigger keine Ereignisse aus den letzten Durchläufen abrufen, z. B. „Geplante Zeit“, „Metaobjekt-Eintrag erstellt“, „Kund:in ist Segment beigetreten“ oder „Kund:in hat Segment verlassen“.

Das Feld in einem Live-Workflow verwenden

Du kannst die Felder in einem Workflow sicher verwenden, indem du die Aktion Protokollausgabe nutzt. Wenn ein Workflow ausgeführt wird, gibt die Aktion Protokollausgabe die Ausgabe aller Variablen und Texte auf der Seite Ausführungsverlauf aus. Du kannst auch Benachrichtigungsaktionen wie Interne E-Mail senden verwenden.

Schritte zur Verwendung der Protokollausgabe:

  1. Wähle einen Trigger aus, der manuell ausgelöst werden kann.
  2. Füge dem Workflow eine Aktion Protokollausgabe hinzu und verbinde sie mit dem Trigger.
  3. Klicke in der Konfiguration für Protokollausgabe auf Variable hinzufügen, um die Variablen, die du prüfen möchtest, zum Abschnitt Ausgabe hinzuzufügen.
  4. Wenn du fertig bist, klicke auf Workflow aktivieren.
  5. Löse den Workflow aus, indem du ihn entweder manuell ausführst oder den Trigger aktivierst. Wenn du beispielsweise den Trigger Bestellung erstellt verwendest, erstelle eine Testbestellung.
  6. Überprüfe nach der Ausführung des Workflows das Aktivitätsprotokoll auf die Variablen.

Die JSON-Seite der Ressource heranziehen

Die meisten Ressourcenseiten im Shopify-Adminbereich, wie die Seiten Bestellung, Produkt oder Kunde, ermöglichen es dir, die Daten anzuzeigen, die für die Seite bereitgestellt werden. Benennung und Format dieser Daten sind nicht genau dieselben wie die, die Shopify Flow verwendet, aber die Werte stimmen mit denen in der GraphQL Admin API überein. Um die Daten zu überprüfen, füge .json zur URL hinzu.

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

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

In die folgende:

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

GraphiQL oder ein externes API-Tool verwenden

Du kannst die API direkt abfragen, indem du ein externes API-Tool wie Postman oder das kostenlose, von Shopify bereitgestellte Tool GraphiQL verwendest. Diese Option liefert die genauesten Ergebnisse, erfordert aber eine gewisse Vertrautheit mit der Erstellung von GraphQL-Abfragen.

Für GraphiQL bietet Shopify sowohl einen webbasierten GraphiQL-Explorer mit generischen Daten als auch die GraphiQL-App. Mit GraphiQL kannst du eine GraphQL-Abfrage erstellen, die genau den Feldnamen in Shopify Flow entspricht. Die Werte stimmen auch genau mit deinem Shop überein, wenn du die App verwendest.

Mithilfe dieses Tools kannst du mit deinen echten Shop-Daten genau bestimmen, welche Daten Shopify Flow verwendet. Du erstellst zum Beispiel die folgende Abfrage:

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

In den folgenden Ergebnissen zeigt die Variable order / app / name den App-Namen für die Bestellung an. In diesem Fall wurde die Bestellung aus der App für Bestellentwürfe erstellt, sodass der Wert Draft Orders ist. Kanalinformationen sind nur für die App Point of Sale 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"
            }
          }
        }
      ]
    }
  }