Oude en nieuwe waarden: wat een workflow hiermee kan doen

Oude en nieuwe waarden: wat een workflow hiermee kan doen

Pagina kopiëren

Shopify Flow

De eigen, bijgewerkte triggers van Flow geven de workflow het record door zoals het er op dit moment uitziet. Op de helppagina’s van Shopify wordt voor elk van deze triggers vermeld: alleen de huidige waarden zijn beschikbaar; de waarden van vóór de wijziging zijn dat niet. Voor een melding dat er iets is gewijzigd, is dat voldoende.

Veel workflows hebben meer nodig dan dat. „De prijs is met meer dan 10 procent gedaald“ vereist de oude prijs. „De handle is gewijzigd, leid de oude URL om“ vereist de oude handle. „De klant heeft zich afgemeld“ moet weten dat hij of zij eerder was aangemeld. Elke wijzigingstrigger van deze app bevat beide waarden, zodat deze workflows bestaan uit een voorwaarde en een actie, zonder code en zonder dat er handmatig iets hoeft te worden opgeslagen.

Waar komt de eerder genoemde waarde vandaan?

De app onthoudt per record de laatst bekende waarde van de velden die zij in de gaten houdt. Wanneer Shopify een update meldt, voert de app een vergelijking uit, en wanneer een veld dat in de gaten wordt gehouden afwijkt, activeert de app de trigger met beide waarden. In de praktijk zijn twee details van belang:

  • De eerste keer dat de app een record waarneemt, onthoudt deze het alleen. Er wordt geen actie geactiveerd, omdat er niets is om mee te vergelijken. Wanneer u een trigger inschakelt, leest de app uw bestaande records eenmalig op de achtergrond in, zodat de eerste daadwerkelijke wijziging al een actie activeert. Voor bestellingen worden standaard de gegevens van de afgelopen 60 dagen ingelezen, en u kunt dit bereik in de app uitbreiden.
  • De waarden hebben betrekking op het moment van de wijziging. Een workflow die is gekoppeld aan een ‘Flow updated’-trigger leest het record op het moment dat de workflow wordt uitgevoerd. Als het record een seconde later opnieuw wordt gewijzigd of wordt verwijderd, ziet die workflow de nieuwere status of kan het record niet worden geladen. Een gebeurtenis van deze app behoudt de waarden waarmee deze is aangemaakt. U kunt deze later bekijken in de gebeurtenisgeschiedenis van de app.
Er is een gebeurtenis geopend in de gebeurtenisgeschiedenis, gemarkeerd als ‘Succes’, met de oude en de nieuwe prijs
Eén gebeurtenis, weergegeven in de gebeurtenisgeschiedenis van de app: de prijs vóór en na de wijziging.

Wat u alleen kunt samenstellen met de waarde die eraan voorafgaat

Workflow Trigger De voorwaarde waarvoor de oude waarde nodig is Klaar voor gebruik
De oude URL omleiden wanneer een product of collectie een nieuwe naam krijgt Productnaam gewijzigd, Collectienaam gewijzigd geen: de omleiding verloopt van oldHandle naar newHandle Oude product-URL’s omleiden wanneer een productcode verandert, Oude URL’s van collecties omleiden wanneer een collectie-ID verandert
Tag producten waarvan de prijs met 10 procent of meer is gedaald Prijswijziging productvariant priceChange.percentChange is kleiner dan of gelijk aan -10 Markeer producten wanneer de prijs van een productvariant met 10 procent of meer daalt
Een product als in de aanbieding markeren en de markering weer verwijderen Prijswijziging productvariant priceChange.oldCompareAtPrice.amount is leeg en priceChange.newCompareAtPrice.amount is niet leeg, of andersom Markeer producten als ‘in de aanbieding’ wanneer er een vergelijkingsprijs is toegevoegd, Verwijder het uitverkooplabel wanneer de vergelijkingsprijs wordt verwijderd
Geef een bestelling vrij zodra een openstaande betaling is ontvangen Wijziging in de financiële status van de bestelling oldFinancialStatus is gelijk aan pending en newFinancialStatus is gelijk aan paid Markeer bestellingen wanneer een openstaande betaling wordt ontvangen
Breng het magazijn op de hoogte wanneer het adres na checkout verandert Verzendadres van de bestelling gewijzigd geen: in het bericht worden oldShippingAddress en shippingAddress weergegeven Markeer bestellingen wanneer het afleveradres na checkout verandert
Markeer klanten die zich afmelden, en verwijder de tags wanneer zij terugkeren Wijziging in de toestemming voor e-mailmarketing aan klanten consentState is gelijk aan unsubscribed; oldConsentState geeft aan wat de waarde eerder was Voeg een tag toe aan klanten wanneer zij zich afmelden voor e-mailmarketing
Behoud de vorige SKU voor uw ERP-systeem of feed SKU van productvariant gewijzigd geen: skuChange.oldSku wordt naar een metaveld geschreven Sla de vorige SKU op wanneer een variant-SKU verandert
Controleer de marge wanneer de kosten stijgen Kosten van productvariant gewijzigd variantCostChange.percentChange is groter dan 5 Markeer producten voor een margebeoordeling wanneer de kosten van een variant stijgen
Tag een product één keer als ‘weinig op voorraad’ zodra het de drempel overschrijdt Voorraadniveau gewijzigd op locatie inventoryLevel.oldAvailable is groter dan of gelijk aan 5 en inventoryLevel.newAvailable is kleiner dan 5 Markeer producten als ‘weinig op voorraad’ wanneer de voorraad onder de vijf daalt

Nog drie die merchants zelf bouwen:

  • Geef het oude adres door wanneer het e-mailadres van een klant verandert. De melding ‘E-mailadres klant gewijzigd’ bevat oldEmail en email. Verstuur de kennisgeving naar oldEmail met een e-mailactie die een variabele als ontvanger gebruikt, bijvoorbeeld Workflow Transactional Email. Zonder het oude adres is er niemand meer om te waarschuwen.
  • Reageer op een stap in een aangepaste status. Een metaveld loyalty.tier verandert van silver naar gold: de update van het klantmetaveld bevat metafield.previousValue en metafield.value, zodat de workflow de klant kan feliciteren bij een upgrade en niets hoeft te melden bij een downgrade.
  • Handel op basis van één verwijderde tag. Nadat een tag is verwijderd, ziet een record eruit alsof deze tag er nooit op heeft gestaan. De verwijderde tags zijn: Order, Klant, Product en Conceptbestelling Tags Removed. Zie Een workflow uitvoeren wanneer een bepaalde tag wordt toegevoegd of verwijderd.

Elke waarde ervoor en erna, per trigger

Bestellingen

Trigger Voor en na
Bestellingtags toegevoegd, bestellingstags verwijderd addedTags, removedTags, previousTags, currentTags
Wijziging in de bestelopmerking oldNote, newNote
Wijziging in de financiële status van de bestelling oldFinancialStatus, newFinancialStatus
Wijziging in de afhandeling van bestellingen oldFulfillmentStatus, newFulfillmentStatus en per regel of zending in changes.items: afhandeling, niet afgehandeld, tracking bijgewerkt met nummer, URL en bedrijf
De status van de bestelling is gewijzigd oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
Wijzigingen in de kenmerken van de bestelling changes.items met changeType, key, oldValue en newValue
Wijzigingen in de artikelen van de bestelling changes.items, met changeType (toegevoegd, verwijderd, hoeveelheid, prijs of variant gewijzigd) en de oude en nieuwe hoeveelheid, prijs en variant
Verzendadres van de bestelling gewijzigd shippingAddress en oldShippingAddress, beide eveneens als afzonderlijke velden
Bestelling voor bijwerking van metavelden metafield.value, metafield.previousValue
Update betreffende uw bestelling changes.fields en changes.items met field, oldValue en newValue voor de financiële status, de afhandeling, tags, opmerkingen, artikelen en aangepaste kenmerken

Klanten

Trigger Voor en na
Toegevoegde klanttags, verwijderde klanttags addedTags, removedTags, previousTags, currentTags
Opmerking van de klant gewijzigd oldNote, newNote
De status van de klant is gewijzigd oldState, newState
Naam van de klant gewijzigd firstName, lastName, oldFirstName, oldLastName
E-mailadres van de klant gewijzigd email, oldEmail
Telefoonnummer van de klant gewijzigd phone, oldPhone
Het adres van de klant is gewijzigd address en oldAddress, elk eveneens als afzonderlijke velden
Toestemming voor e-mailmarketing is gewijzigd, toestemming voor sms-marketing is gewijzigd consentState, optInLevel, oldConsentState, oldOptInLevel
Update van het metaveld ‘Klant’ metafield.value, metafield.previousValue
Klantupdate changes.fields en changes.items voor tags, notities en status

Producten en productvarianten

Trigger Voor en na
Producttags toegevoegd, producttags verwijderd addedTags, removedTags, previousTags, currentTags
Productnaam, identificatiecode, beschrijving, status, leverancier en type gewijzigd de oude en de nieuwe waarde, bijvoorbeeld oldTitle en newTitle
Product gepubliceerd op het kanaal, product verwijderd uit het kanaal channels.added, channels.removed, channels.current
Prijswijziging productvariant priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
De eenheidsprijs van de productvariant is gewijzigd unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Kosten van productvariant gewijzigd variantCostChange.oldCost, newCost, delta, percentChange, direction
SKU van productvariant gewijzigd skuChange.oldSku, newSku
De barcode van de productvariant is gewijzigd barcodeChange.oldBarcode, newBarcode, de oude en nieuwe barcodelijsten, added, removed
Update van het metaveld ‘Product’, update van het metaveld ‘Productvariant’ metafield.value, metafield.previousValue
Productupdate changes.fields en changes.items voor titel, handle, beschrijving, status, leverancier, producttype en tags, en per variant voor prijs, vergelijkingsprijs, SKU, barcode, voorraadbeleid, belastbaar, titel, opties en afbeelding

Voorraad, collecties, locaties en meer

Trigger Voor en na
Wijziging voorraadniveau, niet op voorraad en weer op voorraad op de locatie inventoryLevel.oldAvailable``newAvailable``delta``percentChange``direction, samen met de locatie
Titel, referentie en beschrijving van de collectie gewijzigd de oude en de nieuwe waarde
Locatie bijgewerkt, Bedrijfsupdate, Locatie van het bedrijf bijgewerkt, Korting bijgewerkt, Blogupdate, Blogbericht bijgewerkt, Pagina bijgewerkt changes.fields en changes.items in het record, altijd
Update inzake incasso, update inzake conceptbestelling, marktupdate dezelfde lijst met changes, wanneer de optie Oude en nieuwe waarden verzenden is ingeschakeld
De tien voorwaarden voor het uitvaardigen van een besluit hetzelfde patroon als bij bestellingen: tags, opmerkingen, kenmerken, artikelen, status, e-mail en adressen
Metaveldupdate voor 15 soorten records metafield.value, metafield.previousValue

Volledig overzicht van de triggers geeft een overzicht van alle triggers met al hun velden.

Bij getallen is de rekenkundige bewerking al uitgevoerd

Flow-voorwaarden vergelijken, maar voeren geen berekeningen uit, en geldbedragen worden in Flow als tekst binnengebracht. Daarom kan „met meer dan 10 procent gedaald” niet binnen een workflow worden berekend op basis van twee prijzen. De triggers voor prijs, eenheidsprijs, kosten en voorraad sturen het resultaat daarom als getallen door:

Veld Betekenis Voorbeeld
delta nieuwe waarde minus oude waarde -5
percentChange de verandering uitgedrukt als percentage van de oude waarde -12.5 betekent een daling van 12,5 procent
direction increase, decrease of unchanged decrease
De variabelekiezer van Shopify Flow voor ‘Prijswijziging productvariant’ met de velden ‘oudePrijs’, ‘nieuwePrijs’, ‘delta’, ‘procentueleVerandering’ en ‘richting’
De variabelen van de prijswijziging van de productvariant in de picker van Shopify Flow.
Een Shopify Flow-voorwaarde: priceChange.percentChange is kleiner dan -10
Er is een voorwaarde met betrekking tot het percentage dat de app heeft berekend. Er is geen codestap nodig.
Geeft Shopify Flow de vorige waarde van een veld weer?

Niet met de eigen bijgewerkte triggers. Op de helppagina’s van Shopify voor de triggers ‘Product bijgewerkt’, ‘Bestelling bijgewerkt’, ‘Klant bijgewerkt’ en de overige bijgewerkte triggers staat vermeld dat in de workflow uitsluitend de huidige waarden beschikbaar zijn. De triggers van deze app verzenden zowel de waarde van vóór als die van na de wijziging.

Kan ik de oude waarde binnen Shopify Flow berekenen?

Alleen als u deze waarde vóór de wijziging zelf hebt opgeslagen, bijvoorbeeld door een waarde via een andere workflow naar een metaveld te kopiëren en deze vervolgens weer op te halen. Die kopie moet al vóór de eerste wijziging bestaan en voor elk record in elke stap worden bijgehouden. De app voert deze administratie uit voor de velden die zij in de gaten houdt.

Is de vorige waarde beschikbaar voor metavelden?

Ja. Elke metafield-trigger van deze app bevat naast metafield.value ook metafield.previousValue, voor 15 soorten records. Zie Wijzigingen in metavelden in Shopify Flow: de bijgewerkte triggers en de metaveldtriggers.

Waarom werd er bij de eerste wisseling van een plaat niets geactiveerd?

De app heeft een startpunt nodig. Wanneer een trigger wordt geactiveerd, leest deze uw bestaande records eenmalig op de achtergrond in. Een wijziging die is aangebracht voordat die inlezing het record bereikte, wordt alleen onthouden. De volgende wijziging wordt doorgevoerd. Gebeurtenisgeschiedenis en probleemoplossing toont de status van die synchronisatie.

Volgende stappen