Stare i nowe wartości: jak można je wykorzystać w procesie pracy
Shopify Flow
Zaktualizowane wyzwalacze w Shopify Flow przekazują do przepływu pracy rekord w jego aktualnym stanie. Strony pomocy Shopify wyjaśniają to w odniesieniu do każdego z nich: dostępne są wyłącznie bieżące wartości, a wartości sprzed zmiany nie są dostępne. W przypadku powiadomienia o zmianie to wystarczy.
Wiele procesów wymaga jednak czegoś więcej. W przypadku „Cena spadła o ponad 10 procent” potrzebna jest poprzednia cena. W przypadku „Zmienił się identyfikator - przekieruj poprzedni adres URL” potrzebny jest poprzedni identyfikator. W przypadku „Klient zrezygnował z subskrypcji” należy wiedzieć, że wcześniej był subskrybentem. Każdy wyzwalacz zmiany w tej aplikacji zawiera obie wartości, dzięki czemu procesy te składają się z warunku i działania, bez konieczności pisania kodu ani ręcznego zapisywania danych.
Skąd pochodzi podana powyżej wartość
Aplikacja zapamiętuje ostatnią znaną wartość pól, które monitoruje, dla każdego rekordu. Gdy Shopify zgłasza aktualizację, aplikacja dokonuje porównania, a w przypadku różnicy w monitorowanym polu uruchamia wyzwalacz, przekazując obie wartości. W praktyce istotne są dwie kwestie:
- Gdy aplikacja po raz pierwszy napotyka wpis, jedynie go zapamiętuje. Nie uruchamia się żadna akcja, ponieważ nie ma z czym porównać. Po włączeniu wyzwalacza aplikacja jednorazowo odczytuje istniejące wpisy w tle, dzięki czemu już pierwsza rzeczywista zmiana powoduje uruchomienie akcji. W przypadku zamówień domyślnie odczytywane są dane z ostatnich 60 dni, a zakres ten można rozszerzyć w aplikacji.
- Wartości odnoszą się do momentu zmiany. Przepływ pracy uruchomiony przez wyzwalacz aktualizacji w Shopify Flow odczytuje rekord w momencie uruchomienia tego przepływu. Jeśli rekord ulegnie ponownej zmianie sekundę później lub zostanie usunięty, przepływ ten uwzględni nowszy stan lub nie zdoła załadować rekordu. Zdarzenie w tej aplikacji zachowuje wartości, z którymi zostało utworzone. Można je później sprawdzić w historii zdarzeń aplikacji.

Co można zbudować wyłącznie przy użyciu poprzedniej wartości
| Przebieg pracy | Wyzwalacz | Warunek, w którym wymagana jest poprzednia wartość | Gotowe do użycia |
|---|---|---|---|
| Przekierowanie starego adresu URL w przypadku zmiany nazwy produktu lub kolekcji | Zmieniono nazwę produktu, zmieniono nazwę kolekcji | brak: przekierowanie odbywa się z oldHandle do newHandle |
Przekierowanie starych adresów URL produktów w przypadku zmiany identyfikatora produktu, Przekierowanie starych adresów URL kolekcji w przypadku zmiany identyfikatora kolekcji |
| Proszę oznaczyć produkty, których cena spadła o co najmniej 10 procent | Zmieniono cenę wariantu produktu | priceChange.percentChange jest mniejsze lub równe -10 |
Proszę oznaczyć produkty, gdy cena danego wariantu spadnie o co najmniej 10 procent |
| Oznacz produkt jako objęty promocją, a następnie usuń to oznaczenie | Zmieniono cenę wariantu produktu | priceChange.oldCompareAtPrice.amount jest puste, a priceChange.newCompareAtPrice.amount nie jest, lub odwrotnie |
Proszę oznaczyć produkty jako objęte promocją po dodaniu ceny porównawczej, Proszę usunąć metkę promocyjną po usunięciu ceny porównawczej |
| Zrealizuj zamówienie po otrzymaniu oczekującej płatności | Zmiana statusu finansowego zlecenia | oldFinancialStatus ma wartość pending, a newFinancialStatus ma wartość paid |
Oznaczanie zleceń po otrzymaniu oczekującej płatności |
| Proszę powiadomić magazyn w przypadku zmiany adresu po sfinalizowaniu zamówienia | Zmieniono adres wysyłki zamówienia | brak: w komunikacie widnieją wartości oldShippingAddress oraz shippingAddress |
Prosimy o oznaczenie zamówień, w przypadku których adres wysyłki uległ zmianie po sfinalizowaniu zamówienia |
| Proszę oznaczyć klientów, którzy zrezygnowali z subskrypcji, a gdy powrócą - usunąć te oznaczenia | Zmiana zgody klienta na marketing e-mailowy | consentState ma wartość unsubscribed; oldConsentState wskazuje, jaką wartość miało to pole wcześniej |
Prosimy o oznaczenie klientów, gdy zrezygnują z subskrypcji wiadomości e-mailowych w ramach działań marketingowych |
| Prosimy o zachowanie poprzedniego numeru SKU na potrzeby systemu ERP lub pliku eksportowego | Zmieniono numer katalogowy wariantu produktu | brak: wartość skuChange.oldSku jest zapisywana w polu metadanych |
W przypadku zmiany numeru SKU wariantu należy zachować poprzedni numer SKU |
| Proszę sprawdzić marżę w przypadku wzrostu kosztów | Zmieniono koszt wariantu produktu | variantCostChange.percentChange większe niż 5 |
Prosimy o oznaczenie produktów do przeglądu marży w przypadku wzrostu kosztu wariantu |
| Proszę oznaczyć produkt jako „niski stan magazynowy” tylko raz, gdy jego poziom zapasów spadnie poniżej określonego progu | Zmiana stanu zapasów w lokalizacji | inventoryLevel.oldAvailable jest większe lub równe 5, a inventoryLevel.newAvailable jest mniejsze niż 5 |
Proszę oznaczyć produkty jako „niski stan magazynowy”, gdy ilość zapasów spadnie poniżej pięciu |
Kolejne trzy, które kupcy budują we własnym zakresie:
- W przypadku zmiany adresu e-mail klienta prosimy o podanie starego adresu. Powiadomienie „Zmiana adresu e-mail klienta” zawiera pola
oldEmailorazemail. Prosimy o wysłanie powiadomienia na adresoldEmailza pomocą akcji e-mailowej, która przyjmuje zmienną jako adresata, na przykład Workflow Transactional Email. Bez podania starego adresu nie ma komu przekazać powiadomienia. - Reagowanie na zmianę statusu niestandardowego. Metapole
loyalty.tierzmienia wartość zsilvernagold: zdarzenie „Aktualizacja metapola klienta” zawiera parametrymetafield.previousValueorazmetafield.value, dzięki czemu przepływ pracy może pogratulować podwyższenia statusu, a w przypadku obniżenia statusu nie podejmować żadnych działań. - Działanie dotyczy jednego usuniętego znacznika. Po usunięciu znacznika rekord wygląda tak, jakby nigdy go nie posiadał. Nazwy usuniętych znaczników to: „Order”, „Customer”, „Product” oraz „Draft Order Tags Removed”. Zobacz Uruchomienie przepływu pracy w przypadku dodania lub usunięcia określonego tagu.
Każda wartość przed i po, według wyzwalacza
Zamówienia
| Wyzwalacz | Przed i po |
|---|---|
| Dodano tagi zamówień, usunięto tagi zamówień | addedTags, removedTags, previousTags, currentTags |
| Zmieniono uwagę dotyczącą zamówienia | oldNote, newNote |
| Zmiana statusu finansowego zlecenia | oldFinancialStatus, newFinancialStatus |
| Zmiana w realizacji zamówień | oldFulfillmentStatus, newFulfillmentStatus oraz dla każdej pozycji lub przesyłki w changes.items: zrealizowane, niezrealizowane, zaktualizowane dane śledzenia wraz z numerem, adresem URL i nazwą firmy |
| Zmieniono status wyświetlania zamówienia | oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus |
| Zmieniono atrybuty zamówienia | changes.items wraz z changeType, key, oldValue, newValue |
| Zmiany w pozycjach zamówienia | changes.items wraz z changeType (dodano, usunięto, zmieniono ilość, cenę lub wariant) oraz poprzednią i obecną ilością, ceną i wariantem |
| Zmieniono adres wysyłki zamówienia | shippingAddress oraz oldShippingAddress - każde z nich również jako osobne pola |
| Zlecenie aktualizacji metapola | metafield.value, metafield.previousValue |
| Aktualizacja zamówienia | changes.fields oraz changes.items wraz z field, oldValue, newValue dla statusu finansowego, statusu realizacji, tagów, notatek, pozycji zamówienia oraz atrybutów niestandardowych |
Klienci
| Wyzwalacz | Przed i po |
|---|---|
| Dodano tagi klientów, usunięto tagi klientów | addedTags, removedTags, previousTags, currentTags |
| Zmieniono notatkę dotyczącą klienta | oldNote, newNote |
| Zmiana statusu klienta | oldState, newState |
| Zmieniono nazwisko klienta | firstName, lastName, oldFirstName, oldLastName |
| Zmieniono adres e-mail klienta | email, oldEmail |
| Zmieniono numer telefonu klienta | phone, oldPhone |
| Zmiana adresu klienta | address i oldAddress, z których każde stanowi osobne pole |
| Zmiana zgody na marketing e-mailowy skierowany do klientów, zmiana zgody na marketing SMS-owy skierowany do klientów | consentState, optInLevel, oldConsentState, oldOptInLevel |
| Aktualizacja metapola klienta | metafield.value, metafield.previousValue |
| Informacja dla klientów | changes.fields oraz changes.items dla tagów, notatek i stanu |
Produkty i warianty
| Wyzwalacz | Przed i po |
|---|---|
| Dodano tagi produktów, usunięto tagi produktów | addedTags, removedTags, previousTags, currentTags |
| Zmieniono nazwę produktu, identyfikator, opis, status, dostawcę i typ | stara i nowa wartość, na przykład oldTitle i newTitle |
| Produkt opublikowano w kanale, produkt usunięto z kanału | channels.added, channels.removed, channels.current |
| Zmieniono cenę wariantu produktu | priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction |
| Zmieniono cenę jednostkową wariantu produktu | unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction |
| Zmieniono koszt wariantu produktu | variantCostChange.oldCost, newCost, delta, percentChange, direction |
| Zmieniono numer katalogowy wariantu produktu | skuChange.oldSku, newSku |
| Zmieniono kod kreskowy wariantu produktu | barcodeChange.oldBarcode, newBarcode, stare i nowe listy kodów kreskowych, added, removed |
| Aktualizacja metapola produktu, aktualizacja metapola wariantu produktu | metafield.value, metafield.previousValue |
| Aktualizacja produktu | changes.fields oraz changes.items dla nazwy, identyfikatora, opisu, statusu, dostawcy, typu produktu i tagów, a także dla poszczególnych wariantów w odniesieniu do ceny, ceny porównawczej, numeru SKU, kodu kreskowego, zasad zarządzania zapasami, opodatkowania, nazwy, opcji i zdjęcia |
Zapasy, kolekcje, lokalizacje i inne informacje
| Wyzwalacz | Przed i po |
|---|---|
| Zmiana stanu zapasów, brak towaru i ponowne pojawienie się towaru w placówce | inventoryLevel.oldAvailable, newAvailable, delta, percentChange, direction wraz z lokalizacją |
| Zmieniono tytuł, identyfikator i opis kolekcji | stara i nowa wartość |
| Aktualizacja lokalizacji, Aktualizacja dotycząca firmy, Aktualizacja lokalizacji firmy, Aktualizacja zniżki, Aktualizacja bloga, Aktualizacja wpisu na blogu, Aktualizacja strony | changes.fields oraz changes.items w rekordzie, zawsze |
| Aktualizacja kolekcji, aktualizacja projektu zamówienia, aktualizacja rynku | ta sama lista changes, gdy włączona jest opcja Wyślij stare i nowe wartości |
| Dziesięć warunków uruchamiających projekt rozporządzenia | taki sam schemat jak w przypadku zamówień: tagi, notatki, atrybuty, pozycje, status, adresy e-mail i adresy |
| Aktualizacja metapól dla 15 rodzajów rekordów | metafield.value, metafield.previousValue |
Kompletny przewodnik po wyzwalaczach zawiera listę wszystkich wyzwalaczy wraz ze wszystkimi ich polami.
Liczby są podane wraz z wynikami obliczeń
Warunki w Shopify Flow służą do porównywania, a nie do obliczania, a kwoty pieniężne są przekazywane do Shopify Flow w postaci tekstu. W związku z tym nie można w ramach przepływu pracy obliczyć, czy „spadek o ponad 10 procent” nastąpił na podstawie dwóch cen. Dlatego wyzwalacze dotyczące ceny, ceny jednostkowej, kosztu i stanu magazynowego przekazują wynik w postaci liczb:
| Dziedzina | Znaczenie | Przykład |
|---|---|---|
delta |
nowa wartość minus stara wartość | -5 |
percentChange |
zmiana wyrażona jako procent poprzedniej wartości | -12.5 oznacza spadek o 12,5 procent |
direction |
increase, decrease lub unchanged |
decrease |


Czy usługa Shopify Flow udostępnia poprzednią wartość pola?
Nie w przypadku jej własnych zaktualizowanych wyzwalaczy. Na stronach pomocy serwisu Shopify dotyczących wyzwalaczy „Produkt zaktualizowany”, „Zamówienie zaktualizowane”, „Klient zaktualizowany” oraz innych wyzwalaczy typu „zaktualizowane” podano, że w przepływie pracy dostępne są wyłącznie bieżące wartości. Wyzwalacze tej aplikacji przesyłają wartości zarówno przed, jak i po aktualizacji.
Czy mogę obliczyć poprzednią wartość w ramach Shopify Flow?
Tylko wtedy, gdy zapisał Pan/Pani tę wartość samodzielnie przed wprowadzeniem zmiany, na przykład poprzez skopiowanie wartości do metapola za pomocą innego przepływu pracy, a następnie odczytanie jej ponownie. Ta kopia musi istnieć przed pierwszą zmianą i być zachowana na każdym etapie dla każdego rekordu. Aplikacja zajmuje się tymi operacjami dla pól, które monitoruje.
Czy poprzednia wartość jest dostępna w przypadku metapól?
Tak. Każdy wyzwalacz metapola tej aplikacji zawiera metafield.previousValue obok metafield.value dla 15 rodzajów rekordów. Zobacz Zmiany w metapolu w Shopify Flow: zaktualizowane wyzwalacze oraz wyzwalacze metapola.
Dlaczego przy pierwszym przewinięciu płyty nic się nie uruchomiło?
Aplikacja wymaga punktu początkowego. Po włączeniu wyzwalacza aplikacja jednorazowo odczytuje istniejące zapisy w tle. Zmiana wprowadzona przed dotarciem tego odczytu do danego zapisu zostaje jedynie odnotowana. Kolejna zmiana powoduje uruchomienie aplikacji. Historia zdarzeń i rozwiązywanie problemów przedstawia stan tej synchronizacji.
Kolejne kroki
- Shopify Flow - Porównanie zaktualizowanych wyzwalaczy Shopify Flow i tej aplikacji.
- Monitorowanie ponad pięciu pól w ramach jednego procesu - monitorowanie dowolnej liczby pól w ramach jednego przepływu pracy.
- Szablony procesów roboczych - gotowe schematy pracy oparte na starych i nowych wartościach.
