Workflow Trigger ExtensionsWorkflow Trigger Extensions

Metafeld-Trigger

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 Metafeldern nur die Trigger ausgelöst werden, die für einen bestimmten Workflow relevant sind.

Unterstützte Eigentümertypen

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

Einrichten

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, zum Beispiel „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 admin, Einstellungen, Benutzerdefinierte Daten). Die Liste wird eine Stunde lang gespeichert, daher kann es sein, 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 Metafeldern „Bewertung“, „custom.rating“ (ausgewählt)
Wählen Sie zunächst den Ressourcentyp und anschließend die Metafelddefinition aus. Bei einer großen Auswahl 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 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“, wird als „Aktiv“ angezeigt
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 vorherigen Wert des Metafelds. previousValue ist leer, wenn das Metafeld gerade zum ersten Mal gesetzt wurde.

Im Beispiel sank die Bewertung von 4,5 auf 2,5. Eine Workflow-Bedingung „Wert ist kleiner als 3 und vorherigerWert ist 3 oder größer“ wird einmal 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 geö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 Metafeldern zu übernehmen:

Auslöser Umschläge Liefert
Metafeld-Aktualisierung Alle 10 Eigentümertypen Namensraum, Schlüssel, Eigentümer-ID, alter und neuer Wert
Reihenfolge der Metafeld-Aktualisierung Nur Bestellungen Das Gleiche, zusätzlich die Anordnung als native 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 Einzelposten auszulesen. Dank der nativen Referenz kann Flow seine eigenen Shopify-Aktionen direkt auf die Ressource anwenden, ohne dass ein Lookup-Schritt 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 es keine typisierte Variante gibt.

Die typbasierten Trigger verfügen jeweils über einen eigenen Schalter auf der Seite „Trigger“ (durch Aktivieren eines Flow-Workflows, der einen solchen Trigger nutzt, 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.

Anleitungen