Daten zu Abonnementverträgen abrufen

In Workflows, die Daten zu Abonnementverträgen verwenden, kannst du die Aktion Daten zu Abonnementverträgen abrufen verwenden, um Informationen zu Abonnementverträgen aus deinem Shop abzurufen.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Daten zu Abonnementverträgen abrufen enthält die folgenden Felder, die zur Erstellung der Suchanfrage verwendet werden:

Felder, die in den Aktionen zum Abrufen von Daten verwendet werden.
Feld	Beschreibung
Daten sortieren nach	Erforderlich. Die Parameter, nach denen die von der Suchanfrage zurückgegebenen Daten sortiert werden.
Maximale Anzahl an Ergebnissen	Erforderlich. Die maximale Anzahl an Ergebnissen, die von der von dir ausgewählten Suchanfrage zurückgegeben werden können. Du kannst bis zu 100 auf einmal zurückgeben.
Suchanfrage	Erforderlich. Wähle aus allgemeinen Suchanfragen oder wähle Erweitert aus, um deine eigene zu erstellen.

Suchanfrage-String

Dies ist eine Beispiel-Suchanfrage, um Abonnementverträge mit dem Status ACTIVE abzurufen:

status: ACTIVE

Die Variable status ist ein Filter, der für die Suchanfrage für Abonnementverträge verfügbar ist und mehrmals verwendet werden kann.

Beim Abfragen von Daten ist es hilfreich, Folgendes zu wissen:

Liste der verfügbaren Filter
Suchanfragen müssen einer bestimmten Syntax folgen
Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in der API-Dokumentation. Alternativ findest du die Feldwerte oft in den URLs im Adminbereich, wenn du filterst. Um beispielsweise einige Werte für Bestellungs-Suchanfragen zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.
Du kannst eine Suchanfrage in deinem Shop mit der Shopify-GraphiQL-App ausführen oder testen.
Sei dir bewusst, was passiert, wenn deine Suchanfrage fehlschlägt. Oft gibt die API alle Ergebnisse zurück (anstatt gar keine).

Zurückgegebene Daten

Alle Aktionen vom Typ Daten abrufen geben eine Liste mit 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall kannst du diese Daten auf unterschiedliche Weise verwenden:

Wenn du jedes Listenelement einzeln verarbeiten musst, z. B. um für jedes Element einen Tag hinzuzufügen, kannst du die Aktion Für jedes verwenden.
Wenn du Daten aggregieren musst, z. B. um die Anzahl der zurückgegebenen Ergebnisse zu zählen, kannst du die Aktionen Zählen oder Summe verwenden.
Wenn du die Liste ausgeben musst, z. B. um eine E-Mail mit allen Artikeln zu senden, kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.

Um in den Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable Daten zu Abonnementverträgen abrufen. Dies ist eine Liste von Abonnementverträgen. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst die Liste der Bestellungen beispielsweise wie folgt in einer Aktion vom Typ Interne E-Mail senden versenden:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Trigger

Du kannst diese Aktion in jedem Workflow verwenden, einschließlich des Triggers Geplante Zeit. In einem Workflow, der den Trigger Geplante Zeit verwendet, startet der Workflow zu einer von dir festgelegten Zeit und nicht als Ergebnis eines Ereignisses. Da es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, werden keine Daten automatisch miteinbezogen.