Workflow Trigger ExtensionsWorkflow Trigger Extensions
Metafeld-Trigger

Metafeld-Trigger

Seite kopieren

Starten Sie Shopify Flow-Workflows, wenn sich ein bestimmtes Metafeld bei Produkten, Kunden, Bestellungen und 7 weiteren Eigentümertypen ändert.

Metafeld-Trigger werden ausgelöst, wenn sich eine bestimmte Metafelddefinition bei einem der 10 Eigentümertypen ändert. Sie wählen aus, welche Metafelder überwacht werden sollen - jeweils eine Definition nach der anderen -, sodass bei einem Shop mit Hunderten von Metafelder ein Trigger immer nur für diejenigen ausgelöst wird, die für einen Workflow von Bedeutung sind.

Unterstützte Eigentümertypen

Produkt, Produktvariante, Kollektion, Kunde, Bestellung, Unternehmen, Unternehmensstandort, Blog, Blogbeitrag und Seite.

Einrichtung

Das Beispiel auf dieser Seite überwacht ein Produkt-Metafeld namens „Rating“ (custom.rating), also genau die Art von Wert, die eine Bewertungs-App schreibt.

1. Wählen Sie das Metafeld aus

  1. Öffnen Sie „Metafeld-Trigger“ in der App-Navigation.
  2. Klicken Sie auf „Trigger hinzufügen“.
  3. Wählen Sie den Ressourcentyp aus, zu dem das Metafeld gehört, beispielsweise „Produkt“.
  4. Wählen Sie die Metafelddefinition aus der Liste aus - suchen Sie bei einer großen Anzahl nach dem Namen - und klicken Sie auf „Trigger hinzufügen“.

Es werden nur Metafelder mit einer Definition angezeigt (Shopify-Adminbereich, „Einstellungen“, „Benutzerdefinierte Daten“). Die Liste wird eine Stunde lang gespeichert; daher kann es vorkommen, dass eine Definition, die Sie gerade erst erstellt haben, noch nicht angezeigt wird: Klicken Sie neben „Trigger hinzufügen“ auf „Metafelder aktualisieren“ und öffnen Sie den Dialog erneut.

Das Dialogfeld „Metafeld-Trigger hinzufügen“ mit dem Ressourcentyp „Produkt“ und den ausgewählten Metafelden „Rating“ und „custom.rating“
Wählen Sie zunächst den Ressourcentyp und anschließend die Definition der Metafelder aus. Bei einer großen Anzahl ist die Suchfunktion hilfreich.

2. Das Metafeld wird nun überwacht

Das Metafeld wird in der Liste als „Aktiv“ angezeigt. Es gibt keine weitere Option zum Aktivieren: Durch das Hinzufügen hier wird es aktiviert. Durch das Löschen wird die Überwachung beendet.

Die App erfasst zunächst den aktuellen Wert dieses Metafelds in Ihren bestehenden Datensätzen, sodass bereits bei der allerersten Bearbeitung der richtige alte Wert verwendet wird.

Die Liste der Metafeld-Trigger mit dem Produkt-Metafeld „Rating“, „custom.rating“, das als „Aktiv“ angezeigt wird
Das überwachte Metafeld „Aktiv“. Mit „Metafelder aktualisieren“ wird die Liste der Definitionen neu geladen.

3. Was eine Veranstaltung mit sich bringt

Von diesem Zeitpunkt an löst jede Änderung an diesem Metafeld das Ereignis „Metafield Update“ in Shopify Flow aus. Das Ereignis enthält den Namespace und den Schlüssel, den Datensatz, zu dem es gehört, den neuen Wert sowie previousValue - den zuvor im Metafeld gespeicherten Wert. previousValue ist leer, wenn das Metafeld gerade erst zum ersten Mal gesetzt wurde. Dies gilt auch für ein Metafeld, das bereits bei der Erstellung des Datensatzes ausgefüllt ist, beispielsweise bei einem Kunden, der über ein Formular angelegt wurde und dessen Antworten in Metafelder gespeichert sind: Das Ereignis wird einmal ausgelöst, mit einem leeren previousValue.

Im Beispiel sank die Bewertung von 4,5 auf 2,5. Eine Workflow-Bedingung „Wert ist kleiner als 3 und previousValue ist 3 oder größer“ wird einmalig ausgelöst - und zwar in dem Moment, in dem die Bewertung unter 3 fällt, und nicht bei jeder späteren Bearbeitung. Schritt für Schritt: Metafeld-Trigger - Schritt für Schritt.

Ein Ereignis im Ereignisverlauf: Metafeld-Aktualisierung für ein Produkt, Wert 2,5 und vorheriger Wert 4,5
Ein Ereignis wurde eröffnet: Die Bewertung beträgt nun 2,5, während „previousValue“ angibt, dass sie zuvor 4,5 betrug.

Der generische Trigger und die typisierten Trigger

Es gibt zwei Möglichkeiten, Änderungen an Metafelder zu übernehmen:

Trigger Umschläge Liefert
Metafeld-Aktualisierung Alle 10 Eigentümertypen Namensraum, Schlüssel, Eigentümer-ID, alter und neuer Wert
Metafeld-Aktualisierung anfordern Nur Bestellungen Das Gleiche, zusätzlich die Anordnung als native Shopify Flow-Referenz
Aktualisierung der Produkt-Metafelder Nur Produkte Das Gleiche, zusätzlich das Produkt als native Referenz
Aktualisierung des Kunden-Metafelds Nur für Kunden Das Gleiche, zusätzlich der Kunde als native Referenz
Aktualisierung des Metafelds „Produktvariante“ Nur Produktvarianten Das Gleiche, zusätzlich das übergeordnete Produkt als native Referenz

Verwenden Sie einen typisierten Trigger, wenn Ihr Workflow auf die Ressource selbst einwirken muss, beispielsweise um die Bestellung mit Tags zu versehen oder deren Artikel auszulesen. Dank der nativen Referenz kann Shopify Flow seine eigenen Shopify-Aktionen direkt auf diese Ressource anwenden, ohne dass ein Nachschlagsschritt erforderlich ist.

Verwenden Sie den generischen Trigger, wenn Sie lediglich wissen möchten, dass sich ein Wert geändert hat, oder wenn Sie einen „Owner“-Typ überwachen, für den keine typisierte Variante vorhanden ist.

Die typisierten Trigger verfügen jeweils über einen eigenen Schalter auf der Seite „Trigger“ (durch Aktivieren eines Shopify Flow-Workflows, der einen solchen Trigger verwendet, wird dieser eingeschaltet) und werden zusätzlich zum generischen Trigger ausgelöst. Da sie sich ein Ereignis teilen, wird die Aktivierung beider Trigger nicht doppelt auf Ihr Kontingent angerechnet.

Leitfäden