Metafeld-Trigger
Metafeld-Trigger für Shopify Flow: Workflows bei Änderungen an Metafeldern von Produkt, Kunde, Bestellung und 7 weiteren Typen auslösen.
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 relevant 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, den eine Bewertungs-App schreibt.
1. Wählen Sie das Metafeld aus
- Öffnen Sie „Metafeld-Trigger“ in der App-Navigation.
- Klicken Sie auf „Trigger hinzufügen“.
- Wählen Sie den Ressourcentyp aus, zu dem das Metafeld gehört, beispielsweise „Produkt“.
- Wählen Sie die Definition des Metafelds 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 (Shopifyadmin, 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.
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 an dieser Stelle 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.
3. Was eine Veranstaltung mit sich bringt
Von diesem Zeitpunkt an löst jede Änderung an diesem Metafeld das Ereignis „Metafield Update“ in der 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.
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.
Der generische Trigger und die typisierten Trigger
Es gibt zwei Möglichkeiten, Änderungen an Metafelder zu übernehmen:
| Trigger | Einbände | Liefert |
|---|---|---|
| Metafeld-Aktualisierung | Alle 10 Eigentümertypen | Namensraum, Schlüssel, Eigentümer-ID, alter und neuer Wert |
| Metafeld-Aktualisierung anweisen | 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 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 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.