Eski ve yeni değerler: Bir iş akışı bunlarla neler yapabilir?

Eski ve yeni değerler: Bir iş akışı bunlarla neler yapabilir?

Sayfayı kopyala

Shopify Flow

Shopify Flow’un güncellenmiş tetikleyicileri, iş akışına kaydı olduğu gibi aktarır. Shopify’un yardım sayfalarında her biri için şu açıklama yer almaktadır: Yalnızca güncel değerler kullanılabilir; değişiklikten önceki değerler kullanılamaz. Bir şeyin değiştiğine dair bir uyarı için bu yeterlidir.

Birçok iş akışı bundan daha fazlasını gerektirir. “Fiyat yüzde 10’dan fazla düştü” ifadesi için eski fiyat bilgisi gerekir. “Kullanıcı adı değişti, eski URL’yi yönlendir” ifadesi için eski kullanıcı adı bilgisi gerekir. “Müşteri aboneliğini iptal etti” ifadesi için ise müşterinin daha önce abone olduğunu bilmek gerekir. Bu uygulamanın her değişiklik tetikleyicisi her iki değeri de içerir; dolayısıyla bu iş akışları, kod yazmaya gerek kalmadan ve hiçbir şeyi manuel olarak kaydetmeye gerek kalmadan hem bir koşul hem de bir eylemdir.

Yukarıdaki değer nereden geliyor?

Uygulama, izlediği alanların her bir kayıt için bilinen son değerini hatırlar. Shopify bir güncelleme bildirdiğinde, bu değerleri karşılaştırır ve izlenen bir alanda farklılık olması durumunda her iki değeri de içeren tetikleyiciyi çalıştırır. Uygulamada iki ayrıntı önemlidir:

  • Uygulama bir kaydı ilk gördüğünde, sadece onu hafızasına alır. Karşılaştırılacak bir şey olmadığı için herhangi bir işlem gerçekleşmez. Bir tetikleyiciyi etkinleştirdiğinizde, uygulama arka planda mevcut kayıtlarınızı bir kez okur; böylece ilk gerçek değişiklikte işlem hemen tetiklenir. Siparişler için varsayılan olarak son 60 gün okunur ve bu aralığı uygulama içinden genişletebilirsiniz.
  • Değerler, değişikliğin gerçekleştiği ana aittir. Shopify Flow’daki bir tetikleyiciyle güncellenen iş akışı, iş akışı çalıştırıldığında kaydı okur. Kayıt bir saniye sonra tekrar değişirse veya silinirse, söz konusu iş akışı daha yeni durumu görür ya da kaydı yükleyemez. Bu uygulamanın bir olayı, oluşturulduğu andaki değerleri korur. Bu değerleri daha sonra uygulamanın Olay Geçmişi bölümünden inceleyebilirsiniz.
Etkinlik Geçmişi'nde, “Başarılı” olarak işaretlenmiş, eski ve yeni fiyatların yer aldığı bir etkinlik açıldı
Uygulamanın Etkinlik Geçmişi bölümünde açılan bir etkinlik: değişiklik öncesi ve sonrası fiyat.

Yalnızca önceki değerle oluşturabileceğiniz şey

İş Akışı Tetikleyici Eski değerin gerekli olduğu durum Kullanıma hazır
Bir ürünün veya koleksiyonun adı değiştirildiğinde eski URL’yi yeniden yönlendirin Ürün Adı Değiştirildi, Koleksiyon Adı Değiştirildi yok: yönlendirme oldHandle’den newHandle’e yapılır Bir ürün kimliği değiştiğinde eski ürün URL’lerini yeniden yönlendirin, Bir koleksiyon tanıtıcısı değiştiğinde eski koleksiyon URL’lerini yeniden yönlendirin
Fiyatı yüzde 10 veya daha fazla düşen ürünleri etiketleyin Ürün Varyantının Fiyatı Değişti priceChange.percentChange, -10'ye eşit veya bundan küçük Bir ürün çeşidinin fiyatı yüzde 10 veya daha fazla düştüğünde ürünleri etiketleyin
Bir ürünü indirimli olarak işaretleyin ve bu işaretlemeyi kaldırın Ürün Varyantının Fiyatı Değişti priceChange.oldCompareAtPrice.amount boşken priceChange.newCompareAtPrice.amount boş değilse ya da tam tersi durum söz konusuysa Karşılaştırma fiyatı eklendiğinde ürünleri “indirimde” olarak etiketleyin, Karşılaştırma fiyatı kaldırıldığında indirim etiketini de kaldırın
Bekleyen bir ödeme geldiğinde siparişi serbest bırak Siparişin Mali Durumu Değişti oldFinancialStatus'ın değeri pending ve newFinancialStatus'ın değeri paid Bekleyen bir ödeme alındığında siparişleri etiketle
Ödeme işlemi tamamlandıktan sonra adres değiştiğinde depoya bildirimde bulun Sipariş Teslimat Adresi Değiştirildi yok: mesajda oldShippingAddress ve shippingAddress gösterilir Ödeme işlemi tamamlandıktan sonra teslimat adresi değiştiğinde siparişleri etiketle
Aboneliğini iptal eden müşterileri etiketleyin ve geri döndüklerinde etiketlerini kaldırın Müşteri E-posta Pazarlama Onayı Değiştirildi consentState, unsubscribed değerine eşittir; oldConsentState ise daha önceki durumunu gösterir Müşteriler e-posta pazarlama listesinden çıkınca onları etiketleyin
ERP sisteminiz veya veri akışınız için önceki SKU’yu koruyun Ürün Varyantı SKU'su Değiştirildi yok: skuChange.oldSku, bir meta alana yazılır Bir varyant SKU’su değiştiğinde önceki SKU’yu kaydet
Bir maliyet arttığında marjı gözden geçirin Ürün Varyantının Maliyeti Değiştirildi variantCostChange.percentChange, 5'ten büyük Bir varyantın maliyeti arttığında, kâr marjı incelemesi için ürünleri etiketleyin
Bir ürün, stok seviyesi belirli bir eşiği aştığında bir kez “stok az” olarak işaretlenmelidir Konumda Stok Seviyesi Değişti inventoryLevel.oldAvailable, 5'e eşit veya bundan büyük ve inventoryLevel.newAvailable, 5'den küçük Stok seviyesi beşin altına düştüğünde ürünleri “stok az” olarak etiketleyin

Tüccarların kendi başlarına yaptıkları üç tane daha:

  • Bir müşterinin e-posta adresi değiştiğinde eski adresi bildirin. “Müşteri E-posta Adresi Değişti” olayı, oldEmail ve email değişkenlerini içerir. Bildirimi, alıcı olarak bir değişken alan bir e-posta eylemi (örneğin, Workflow Transactional Email) kullanarak oldEmail adresine gönderin. Eski adres olmadan uyarı gönderilecek kimse kalmaz.
  • Özel bir durumdaki bir adıma tepki verin. loyalty.tier adlı bir meta alanı silver’dan gold’a geçer: Müşteri Meta Alanı Güncellemesi, metafield.previousValue ve metafield.value değerlerini içerir; böylece iş akışı, seviye yükseldiğinde tebrik edebilir ve seviye düştüğünde herhangi bir işlem yapmaz.
  • Kaldırılan bir etikete ilişkin işlem yapın. Bir etiket kaldırıldıktan sonra, kayıt sanki o etikete hiç sahip olmamış gibi görünür. Kaldırılan etiketlerin adları şunlardır: Sipariş, Müşteri, Ürün ve Taslak Sipariş Etiketleri. Bkz. Belirli bir etiket eklendiğinde veya kaldırıldığında bir iş akışını çalıştır.

Tetikleyiciye göre, öncesindeki ve sonrasındaki her değer

Siparişler

Tetikleyici Öncesi ve sonrası
Eklenen Sipariş Etiketleri, Kaldırılan Sipariş Etiketleri addedTags, removedTags, previousTags, currentTags
Sipariş Notu Değiştirildi oldNote, newNote
Siparişin Mali Durumu Değişti oldFinancialStatus, newFinancialStatus
Sipariş Karşılama Süreci Değiştirildi oldFulfillmentStatus, newFulfillmentStatus ve changes.items içindeki her satır veya sevkiyat için: yerine getirilmiş, yerine getirilmemiş, takip bilgisi güncellenmiş (numara, URL ve şirket ile birlikte)
Sipariş Görüntüleme Durumu Değişti oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
Sipariş Özellikleri Değiştirildi changes.items; changeType, key, oldValue, newValue ile
Sipariş Satır Öğelerinde Değişiklik Yapıldı changes.items, changeType (eklendi, kaldırıldı, miktar, fiyat veya varyant değişti) ile birlikte eski ve yeni miktar, fiyat ve varyant bilgilerini içerir
Sipariş Teslimat Adresi Değiştirildi shippingAddress ve oldShippingAddress; her ikisi de ayrı alanlar olarak
Metafield Güncelleme Emri metafield.value, metafield.previousValue
Sipariş Güncellemesi changes.fields ve changes.items, finansal durum, sipariş yerine getirme durumu, etiketler, not, satır öğeleri ve özel öznitelikler için field, oldValue, newValue ile

Müşteriler

Tetikleyici Öncesi ve sonrası
Eklenen Müşteri Etiketleri, Kaldırılan Müşteri Etiketleri addedTags, removedTags, previousTags, currentTags
Müşteri Notu Değiştirildi oldNote, newNote
Müşteri Durumu Değişti oldState, newState
Müşteri Adı Değiştirildi firstName, lastName, oldFirstName, oldLastName
Müşterinin E-posta Adresi Değiştirildi email, oldEmail
Müşterinin Telefon Numarası Değişti phone, oldPhone
Müşteri Adresi Değişti address ve oldAddress; her ikisi de ayrı alanlar olarak
Müşteri E-posta Pazarlama Onayı Değiştirildi, Müşteri SMS Pazarlama Onayı Değiştirildi consentState, optInLevel, oldConsentState, oldOptInLevel
Müşteri Meta Alanı Güncellemesi metafield.value, metafield.previousValue
Müşteriye Yönelik Güncelleme Etiketler, notlar ve durumlar için changes.fields ve changes.items

Ürünler ve varyantlar

Tetikleyici Öncesi ve sonrası
Eklenen Ürün Etiketleri, Kaldırılan Ürün Etiketleri addedTags, removedTags, previousTags, currentTags
Ürün Adı, Tanımlayıcı, Açıklama, Durum, Satıcı ve Tür Değiştirildi eski ve yeni değer, örneğin oldTitle ve newTitle
Ürün Kanala Yayınlandı, Ürün Kanaldan Kaldırıldı channels.added, channels.removed, channels.current
Ürün Varyantının Fiyatı Değişti priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
Ürün Varyantının Birim Fiyatı Değiştirildi unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Ürün Varyantının Maliyeti Değişti variantCostChange.oldCost, newCost, delta, percentChange, direction
Ürün Varyantı SKU'su Değiştirildi skuChange.oldSku, newSku
Ürün Varyantının Barkodu Değiştirildi barcodeChange.oldBarcode, newBarcode, eski ve yeni barkod listeleri, added, removed
Ürün Meta Alanı Güncellemesi, Ürün Varyantı Meta Alanı Güncellemesi metafield.value, metafield.previousValue
Ürün Güncellemesi changes.fields ve changes.items: başlık, tanıtıcı, açıklama, durum, satıcı, ürün türü ve etiketler için; fiyat, karşılaştırma fiyatı, SKU, barkod, stok politikası, vergilendirilebilirlik, başlık, seçenekler ve resim ise her bir varyant için

Stok, koleksiyonlar, konumlar ve daha fazlası

Tetikleyici Öncesi ve sonrası
Konumda Stok Seviyesi Değişikliği, Stokta Yok ve Tekrar Stokta inventoryLevel.oldAvailable, newAvailable, delta, percentChange, direction ve konum
Koleksiyon Başlığı, Kimlik ve Açıklama Değiştirildi eski ve yeni değer
Konum Güncellemesi, Şirket Güncellemesi, Şirket Konumu Güncellemesi, İndirim Güncellemesi, Blog Güncellemesi, Blog Yazısı Güncellemesi, Sayfa Güncellemesi Kayıttaki changes.fields ve changes.items, her zaman
Portföy Güncellemesi, Taslak Sipariş Güncellemesi, Piyasa Güncellemesi changes listesi, Eski ve yeni değerleri gönder seçeneği etkin olduğunda
On adet taslak emir tetikleyicisi siparişlerle aynı yapı: etiketler, not, özellikler, satır öğeleri, durum, e-posta ve adresler
15 farklı kayıt türü için Metafield Güncellemesi metafield.value, metafield.previousValue

Tetikleyicilerle ilgili eksiksiz kılavuz, her bir tetikleyiciyi tüm alanlarıyla birlikte listeler.

Sayılar, aritmetik işlemleri yapılmış halde gelir

Shopify Flow koşulları karşılaştırma yapar, hesaplama yapmaz ve para tutarları Shopify Flow’a metin olarak gelir. Dolayısıyla, “yüzde 10’dan fazla düşüş” koşulu, iki fiyat üzerinden bir iş akışı içinde hesaplanamaz. Bu nedenle fiyat, birim fiyat, maliyet ve stok tetikleyicileri sonucu sayı olarak gönderir:

Alan Anlamı Örnek
delta yeni değer eksi eski değer -5
percentChange değişimin eski değerin yüzdesi olarak ifade edilmesi -12.5, yüzde 12,5 oranında düşüş anlamına gelir
direction increase, decrease veya unchanged decrease
Shopify Flow
Shopify Flow’daki seçim aracında “Ürün Varyantı Fiyatı Değişti” değişkenleri.
Bir Shopify Flow koşulu: priceChange.percentChange değeri -10'dan küçük
Uygulamanın hesapladığı yüzdeye ilişkin bir koşul. Herhangi bir kodlama adımı gerekmez.
Shopify Flow, bir alanın önceki değerini sağlıyor mu?

Kendi güncellenmiş tetikleyicileriyle değil. Shopify’ın “Ürün güncellendi”, “Sipariş güncellendi”, “Müşteri güncellendi” ve diğer güncellenmiş tetikleyicilere ilişkin yardım sayfalarında, iş akışında yalnızca güncel değerlerin kullanılabileceği belirtilmektedir. Bu uygulamanın tetikleyicileri ise hem önceki hem de sonraki değeri gönderir.

Shopify Flow içinde eski değeri hesaplayabilir miyim?

Ancak, değişiklikten önce bunu kendiniz kaydetmiş olmanız gerekir; örneğin, başka bir iş akışıyla bir değeri bir meta alana kopyalayıp daha sonra onu geri okumanız gibi. Bu kopyanın ilk değişiklikten önce mevcut olması ve her kayıt için adım adım korunması gerekir. Uygulama, izlediği alanlar için bu kayıt tutma işlemini kendisi gerçekleştirir.

Metatarlarda önceki değer kullanılabilir mi?

Evet. Bu uygulamanın her bir metafield tetikleyicisi, 15 farklı kayıt türü için metafield.value'nin yanı sıra metafield.previousValue değerini de içerir. Shopify Flow’daki meta alan değişiklikleri: güncellenen tetikleyiciler ve meta alan tetikleyicileri bölümüne bakınız.

Bir plağın ilk çalınışında neden hiçbir ses çıkmadı?

Uygulamanın bir başlangıç noktasına ihtiyacı vardır. Bir tetikleyici etkinleştirildiğinde, uygulama arka planda mevcut kayıtlarınızı bir kez okur. Bu okuma işlemi kayda ulaşmadan önce yapılan bir değişiklik yalnızca hatırlanır. Bir sonraki değişiklik ise tetiklenir. Olay geçmişi ve sorun giderme, bu senkronizasyonun durumunu gösterir.

Sonraki adımlar