Stare i nowe wartości: jak można je wykorzystać w procesie pracy

Stare i nowe wartości: jak można je wykorzystać w procesie pracy

Skopiuj stronę

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.
W sekcji „Historia zdarzeń” utworzono wpis oznaczony jako „Powodzenie”, zawierający starą i nową cenę
Jedno zdarzenie, wyświetlone w sekcji „Historia zdarzeń” aplikacji: cena przed zmianą i po zmianie.

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 oldEmail oraz email. Prosimy o wysłanie powiadomienia na adres oldEmail za 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.tier zmienia wartość z silver na gold: zdarzenie „Aktualizacja metapola klienta” zawiera parametry metafield.previousValue oraz metafield.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
Shopify Flow
Zmienne „Zmiana ceny wariantu produktu” w selektorze Shopify Flow.
Warunek w Shopify Flow: wartość parametru priceChange.percentChange jest mniejsza niż -10
Warunek dotyczący wartości procentowej został obliczony przez aplikację. Nie jest wymagane wprowadzanie żadnego kodu.
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