Alte und neue Werte: Was ein Workflow damit bewirken kann

Alte und neue Werte: Was ein Workflow damit bewirken kann

Seite kopieren

Shopify Flow

Die von Flow selbst aktualisierten Trigger übergeben einem Workflow den Datensatz in seinem aktuellen Zustand. Auf den Hilfeseiten von Shopify wird dies für jeden einzelnen Trigger ausdrücklich erwähnt: Es stehen nur die aktuellen Werte zur Verfügung, die Werte vor der Änderung hingegen nicht. Für eine Benachrichtigung darüber, dass sich etwas geändert hat, reicht dies aus.

Viele Workflows benötigen jedoch mehr als das. „Der Preis ist um mehr als 10 Prozent gefallen“ benötigt den alten Preis. „Der Handle hat sich geändert - leiten Sie die alte URL um“ benötigt den alten Handle. „Der Kunde hat sich abgemeldet“ muss wissen, dass er zuvor angemeldet war. Jeder Trigger dieser App enthält beide Werte, sodass diese Workflows sowohl eine Bedingung als auch eine Aktion darstellen - ganz ohne Code und ohne manuelle Speicherung.

Woher der zuvor genannte Wert stammt

Die App speichert für jeden Datensatz den zuletzt bekannten Wert der von ihr überwachten Felder. Wenn Shopify eine Aktualisierung meldet, führt sie einen Vergleich durch; weicht ein überwachtes Feld ab, löst sie den Trigger mit beiden Werten aus. In der Praxis sind dabei zwei Details von Bedeutung:

  • Wenn die App zum ersten Mal einen Datensatz erkennt, speichert sie diesen lediglich ab. Es wird keine Aktion ausgelöst, da es nichts gibt, womit ein Vergleich möglich wäre. Wenn Sie einen Trigger aktivieren, liest die App Ihre vorhandenen Datensätze einmalig im Hintergrund ein, sodass bereits bei der ersten tatsächlichen Änderung eine Aktion ausgelöst wird. Bei Bestellungen werden standardmäßig die letzten 60 Tage eingelesen; diesen Zeitraum können Sie in der App erweitern.
  • Die Werte beziehen sich auf den Zeitpunkt der Änderung. Ein Workflow, der auf einen „Flow updated“-Trigger abzielt, liest den Datensatz, wenn der Workflow ausgeführt wird. Ändert sich der Datensatz eine Sekunde später erneut oder wird er gelöscht, erkennt dieser Workflow den neueren Zustand oder kann den Datensatz nicht laden. Ein Ereignis dieser App behält die Werte bei, mit denen es erstellt wurde. Sie können diese Werte später im Ereignisverlauf der App einsehen.
In der Ereignisübersicht wurde ein Ereignis mit dem Status „Erfolgreich“ und den alten sowie neuen Preisen angezeigt
Ein Ereignis, das im Ereignisverlauf der App angezeigt wird: der Preis vor und nach der Änderung.

Was Sie nur mit dem vorherigen Wert erstellen können

Workflow Trigger Die Bedingung, für die der alte Wert benötigt wird Gebrauchsfertig
Die alte URL umleiten, wenn ein Produkt oder eine Kollektion umbenannt wird Produktbezeichnung geändert, Bezeichnung der Kollektion geändert keine: Die Weiterleitung erfolgt von oldHandle zu newHandle Umleitung alter Produkt-URLs bei Änderung einer Produkt-ID, Umleitung alter URLs für Kollektionen bei Änderung eines Sammlungs-Handles
Markieren Sie Produkte, deren Preis um 10 Prozent oder mehr gesunken ist Preisänderung bei einer Produktvariante priceChange.percentChange ist kleiner oder gleich -10 Kennzeichnen Sie Produkte, wenn der Preis einer Variante um 10 Prozent oder mehr sinkt
Ein Produkt als im Angebot kennzeichnen und die Kennzeichnung wieder entfernen Preisänderung bei einer Produktvariante priceChange.oldCompareAtPrice.amount ist leer und priceChange.newCompareAtPrice.amount ist nicht leer, oder umgekehrt Kennzeichnen Sie Produkte als im Angebot, sobald ein Vergleichspreis hinzugefügt wurde, Entfernen Sie das Preisetikett, sobald der Vergleichspreis entfernt wurde.
Eine Bestellung freigeben, sobald eine ausstehende Zahlung eingegangen ist Änderung des finanziellen Status der Bestellung oldFinancialStatus ist gleich pending und newFinancialStatus ist gleich paid Bestellungen kennzeichnen, wenn eine ausstehende Zahlung eingeht
Benachrichtigen Sie das Lager, wenn sich die Adresse nach dem Checkout ändert Änderung der Lieferadresse für die Bestellung keine: In der Meldung werden oldShippingAddress und shippingAddress angezeigt Bestellungen kennzeichnen, wenn sich die Lieferadresse nach dem Checkout ändert
Kennzeichnen Sie Kunden, die sich abmelden, und entfernen Sie die Kennzeichnung, wenn sie zurückkehren Änderung der Einwilligung zum E-Mail-Marketing für Kunden consentState ist gleich unsubscribed; oldConsentState gibt an, welchen Wert es zuvor hatte Kennzeichnen Sie Kunden, wenn diese sich vom E-Mail-Marketing abmelden
Behalten Sie die bisherige Artikelnummer für Ihr ERP-System oder Ihren Feed bei Produktvariante - Artikelnummer geändert keine: skuChange.oldSku wird in ein Metafeld geschrieben Speichern Sie die vorherige SKU, wenn sich die SKU einer Variante ändert
Überprüfen Sie die Marge, wenn die Kosten steigen Kosten der Produktvariante geändert variantCostChange.percentChange ist größer als 5 Markieren Sie Produkte für eine Margenüberprüfung, wenn die Kosten einer Variante steigen
Kennzeichnen Sie ein Produkt einmalig als „geringer Lagerbestand“, sobald es den Schwellenwert unterschreitet Bestandsmenge am Standort geändert inventoryLevel.oldAvailable ist größer oder gleich 5 und inventoryLevel.newAvailable ist kleiner als 5 Kennzeichnen Sie Artikel als „gerester Vorrat“, sobald das Inventar unter fünf sinkt

Drei weitere, die Händler selbst bauen:

  • Teilen Sie die alte E-Mail-Adresse mit, wenn sich die E-Mail-Adresse eines Kunden ändert. Die Benachrichtigung „Kunden-E-Mail geändert“ enthält die Variablen oldEmail und email. Senden Sie die Benachrichtigung an oldEmail mithilfe einer E-Mail-Aktion, die eine Variable als Empfänger akzeptiert, beispielsweise Workflow Transactional Email. Ohne die alte Adresse gibt es niemanden mehr, den Sie benachrichtigen können.
  • Reagieren Sie auf einen Schritt in einem benutzerdefinierten Status. Ein Metafeld loyalty.tier wechselt von silver zu gold: Die Aktualisierung des Kunden-Metafelds enthält metafield.previousValue und metafield.value, sodass der Workflow zum Upgrade gratulieren und bei einem Downgrade keine Aktion auslösen kann.
  • Beziehen Sie sich auf ein entferntes Tag. Nachdem ein Tag entfernt wurde, sieht ein Datensatz so aus, als hätte er dieses Tag nie gehabt. Die entfernten Tags heißen „Bestellung“, „Kunde“, „Produkt“ und „Bestellentwurf“. Siehe Einen Workflow ausführen, wenn ein bestimmtes Tag hinzugefügt oder entfernt wird.

Jeder Wert davor und danach, nach Trigger

Bestellungen

Trigger Vorher und nachher
Bestellkennzeichnungen hinzugefügt, Bestellkennzeichnungen entfernt addedTags, removedTags, previousTags, currentTags
Hinweis zur Bestellung geändert oldNote, newNote
Änderung des finanziellen Status der Bestellung oldFinancialStatus, newFinancialStatus
Änderung bei der Fulfillment-Abwicklung oldFulfillmentStatus, newFulfillmentStatus sowie pro Zeile oder Sendung in changes.items: Fulfillment, noch nicht abgewickelt, Sendungsverfolgung aktualisiert mit Nummer, URL und Unternehmen
Der Status der Bestellung wurde geändert oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
Bestellung-Attribute wurden geändert changes.items mit changeType, key, oldValue, newValue
Geänderte Artikel changes.items mit changeType (hinzugefügt, entfernt, Menge, Preis oder Variante geändert) sowie der alten und der neuen Menge, dem alten und dem neuen Preis sowie der alten und der neuen Variante
Änderung der Lieferadresse für die Bestellung shippingAddress und oldShippingAddress, jeweils ebenfalls als separate Felder
Metafeld-Aktualisierung anweisen metafield.value, metafield.previousValue
Aktualisierung zur Bestellung changes.fields und changes.items mit field, oldValue und newValue für den Finanzstatus, den Fulfillment-Status, Tags, Notizen, Artikel und benutzerdefinierte Attribute

Kunden

Trigger Vorher und nachher
Kunden-Tags hinzugefügt, Kunden-Tags entfernt addedTags, removedTags, previousTags, currentTags
Kundenhinweis geändert oldNote, newNote
Der Status des Kunden hat sich geändert oldState, newState
Kundenname geändert firstName, lastName, oldFirstName, oldLastName
E-Mail-Adresse des Kunden geändert email, oldEmail
Die Telefonnummer des Kunden wurde geändert phone, oldPhone
Kundenadresse geändert address und oldAddress, jeweils ebenfalls als separate Felder
Änderung der Einwilligung zum E-Mail-Marketing für Kunden, Änderung der Einwilligung zum SMS-Marketing für Kunden consentState, optInLevel, oldConsentState, oldOptInLevel
Aktualisierung der Kunden-Metafelder metafield.value, metafield.previousValue
Kundeninformation changes.fields und changes.items für Tags, Notizen und Status

Produkte und Varianten

Trigger Vorher und nachher
Produkt-Tags hinzugefügt, Produkt-Tags entfernt addedTags, removedTags, previousTags, currentTags
Produkttitel, Kurzbezeichnung, Beschreibung, Status, Anbieter und Typ wurden geändert der alte und der neue Wert, zum Beispiel oldTitle und newTitle
Produkt im Kanal veröffentlicht, Produkt aus dem Kanal entfernt channels.added, channels.removed, channels.current
Preisänderung bei einer Produktvariante priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
Stückpreis der Produktvariante wurde geändert unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Kosten der Produktvariante geändert variantCostChange.oldCost, newCost, delta, percentChange, direction
Produktvariante - Artikelnummer geändert skuChange.oldSku, newSku
Barcode der Produktvariante geändert barcodeChange.oldBarcode, newBarcode, die Liste der alten und der neuen Barcodes, added, removed
Aktualisierung des Produkt-Metafelds, Aktualisierung des Metafelds für Produktvariante metafield.value, metafield.previousValue
Produktaktualisierung changes.fields und changes.items für Titel, Handle, Beschreibung, Status, Anbieter, Produkttyp und Tags sowie pro Variante für Preis, Vergleichspreis, SKU, Barcode, Bestandsrichtlinie, Steuerpflicht, Titel, Optionen und Bild

Lagerbestand, Kollektionen, Standorte und mehr

Trigger Vorher und nachher
Bestandsänderung, nicht vorrätig und wieder vorrätig am Standort inventoryLevel.oldAvailable, newAvailable, delta, percentChange, direction sowie den Standort
Titel, Kennung und Beschreibung der Kollektion geändert der alte und der neue Wert
Standort aktualisiert, Aktualisierung des Unternehmens, Aktualisierung des Unternehmensstandorts, Rabatt aktualisiert, Blog-Aktualisierung, Blogbeitrag aktualisiert, Seite aktualisiert changes.fields und changes.items des Datensatzes, immer
Aktualisierung der Kollektionen, Aktualisierung des Bestellentwurfs, Aktualisierung der Märkte dieselbe Liste changes, wenn die Option Alte und neue Werte senden aktiviert ist
Die zehn Bestellentwürfe das gleiche Schema wie bei Bestellungen: Tags, Notizen, Attribute, Artikel, Status, E-Mail-Adressen und Anschriften
Metafeld-Aktualisierung für 15 Datensatztypen metafield.value, metafield.previousValue

Vollständige Referenz zu Triggern listet jeden Trigger mit all seinen Feldern auf.

Zahlen sind bereits berechnet

Flow-Bedingungen vergleichen, sie berechnen nicht, und Geldbeträge werden in Flow als Text übermittelt. Daher lässt sich „um mehr als 10 Prozent gesunken“ innerhalb eines Workflows nicht anhand zweier Preise berechnen. Die Trigger „Preis“, „Einheitspreis“, „Kosten“ und „Bestand“ übermitteln das Ergebnis daher als Zahlen:

Feld Bedeutung Beispiel
delta neuer Wert minus alter Wert -5
percentChange die Veränderung als Prozentsatz des alten Wertes -12.5 bedeutet einen Rückgang um 12,5 Prozent
direction increase, decrease oder unchanged decrease
Der Variablenauswähler von Shopify Flow für „Preisänderung bei Produktvarianten“ mit den Feldern „alter Preis“, „neuer Preis“, „Differenz“, „prozentuale Änderung“ und „Richtung“
Die Variablen „Produktvariante“ und „Preis“ wurden im Auswahldialog von Shopify Flow geändert.
Eine Shopify Flow-Bedingung: priceChange.percentChange ist kleiner als -10
Eine Bedingung bezüglich des Prozentsatzes, den die App berechnet hat. Es ist kein Programmierschritt erforderlich.
Stellt Shopify Flow den vorherigen Wert eines Feldes bereit?

Nicht mit den eigenen aktualisierten Triggern. Auf den Hilfeseiten von Shopify zu den Triggern „Produkt aktualisiert“, „Bestellung aktualisiert“, „Kunde aktualisiert“ und den anderen aktualisierten Triggern heißt es, dass im Workflow nur die aktuellen Werte verfügbar sind. Die Trigger dieser App senden den Wert vor und nach der Änderung.

Kann ich den alten Wert in Shopify Flow berechnen?

Nur wenn Sie den Wert vor der Änderung selbst gespeichert haben, beispielsweise indem Sie einen Wert mithilfe eines anderen Workflows in ein Metafeld kopiert und anschließend wieder ausgelesen haben. Diese Kopie muss bereits vor der ersten Änderung vorhanden sein und für jeden Datensatz beibehalten werden. Die App übernimmt diese Nachverfolgung für die Felder, die sie überwacht.

Ist der vorherige Wert für Metafelder verfügbar?

Ja. Jeder Metafeld-Trigger dieser App enthält neben metafield.value auch metafield.previousValue für 15 verschiedene Datensatztypen. Siehe Änderungen an Metafelder in Shopify Flow: die aktualisierten Trigger und die Metafeld-Trigger.

Warum wurde beim ersten Wechsel einer Schallplatte nichts ausgelöst?

Die App benötigt einen Ausgangspunkt. Wenn ein Trigger aktiviert wird, liest sie Ihre vorhandenen Datensätze einmal im Hintergrund ein. Eine Änderung, die vorgenommen wurde, bevor dieser Lesevorgang den Datensatz erreicht hat, wird lediglich vermerkt. Die nächste Änderung löst den Trigger aus. Ereignisverlauf und Fehlerbehebung zeigt den Status dieser Synchronisierung an.

Nächste Schritte