İŞ AKIŞI / GÜVENILIRLIK / VERITABANI
Her Etiketin Tam Bir Kez Basıldığından Emin Olun
Her tetikleyiciye hatırlayacağı bir şey verin: tablolar ve dosyalar için satır anahtarı, kendi tablonuza geri yazılan "basıldı" işareti ve API çağrıları için idempotency anahtarı. Aşağıdaki geri yazma gerçek bir PostgreSQL'de LabelInn bağlayıcısı üzerinden çalıştırıldı; izin verilenden fazla satıra dokunmayı reddettiği durum dahil.

SORUN

Otomatik baskının klasik hatası: aynı etiket iki kez çıkar. Bir betik sipariş tablosunu yoklar ve gördüğü her şeyi basar. Yeniden başlatma sonrası bir dosya tekrar alınır. API çağrısı zaman aşımına uğrar, tekrar denenir, iki deneme de basar. Mükerrer kargo etiketi para kaybettirir; mükerrer seri numarası etiketi uyum sorunu olabilir.
LabelInn'de her giriş noktasında bir koruma vardır.
Tasarımı gereği tam bir kez. Her tetikleyici neyi bastığını hatırlar. Ücretsiz başlayın →
01 / MÜKERRER
Veritabanı tabloları: anahtar ve işaret
- Satır anahtarı. Veri Kaynağına satırı tanımlayan sütunu söyleyin (sipariş no, seri no). LabelInn işlediği anahtarları hatırlar, aynısını iki kez basmaz.
- Basıldı işareti. Baskıdan sonra LabelInn yerel veritabanı köprüsü üzerinden o satırın bir sütununa
basildigibi bir değer yazar; ERP'niz ve ekibiniz de görür. - Sadece hazır olunca. Satırın sayılması için dolu olması gereken bir sütun belirleyin. Hâlâ yazılan satır bekler, o sütun dolduğu anda basılır.
02 / GERI YAZMA
Dosyalar: basıldıktan sonra hatırlanır
Klasör izleme her dosyayı yol, değişiklik zamanı ve boyutla hatırlar; basıldıktan sonra dosyayı taşıyabilir, yeniden adlandırabilir veya silebilir.
03 / GÜVENILIRLIK
Yokladığınız API'ler: kalem başına anahtar
HTTP Fetcher düğümü dış bir API'yi yoklarken her kalemi tanımlayan alanı verin, örneğin order_id. Görülen kalemler bir daha başlatılmaz.
04 / OTOMASYON
Her kaynak: sonucu geri yazın
İş akışının sonundaki Geri Yazma düğümü sonucu verinin durduğu yere kaydeder, örneğin durum = basildi. Diğer sistemleriniz o kaydı baskı için bir daha önermez.
05 / MÜKERRER
İpucu: önce kopyada deneyin
İş akışını tablonun bir kopyasında, durum veya hazır olma sütunuyla kurup deneyin; sonra canlı tabloya bağlayın.
POSTGRESQL'DE ÇALIŞTIRILDI
Geri yazma, adım adım
Dört siparişli (biri hâlâ taslak) bir deneme tablosu labelinn_demo_orders. Bağlayıcı program, iş akışının Geri Yaz düğümünün çağırdığı gibi çağrıldı.
| Adım | İstek | Sonuç |
|---|---|---|
| 1. Yokla | SELECT order_id, sku, qty FROM labelinn_demo_orders WHERE label_printed IS NULL AND status = 'paid' | 3 satır: SO-10442, SO-10443, SO-10445 |
| 2. Bas, sonra birini işaretle | row/write: order_id = 'SO-10442' olan satırda label_printed = 'printed' | rowsAffected: 1 |
| 3. Yeniden yokla | aynı sorgu | 2 satır: SO-10443, SO-10445. SO-10442 bir daha sunulmaz |
| 4. Daha çok satıra değecek bir işaret | status = 'paid' olan satırlar için row/write (3 satır eşleşir, sınır 1) | ok: false, rolledBack: true, too_many_rows: "The statement would change 3 rows (the limit is 1), so nothing was changed." 3. yoklama yine 2 satır gösterir |
| 5. Sorgu ucundan serbest UPDATE | UPDATE labelinn_demo_orders SET label_printed = 'x' | red: sql_blocked, yalnızca SELECT/WITH sorgularına izin var |
| 6. Koşulsuz UPDATE | boş where ile row/write | red: "an update needs at least one condition" |
| 7. İçinde SQL olan tablo adı | labelinn_demo_orders; DROP TABLE x | red: geçersiz tablo adı |
İşaret, adını verdiğiniz tablo ve sütunlarda bağlı parametreli bir UPDATE'tir; değiştirebileceği satır sayısı sınırlıdır (varsayılan 1, en çok 1000) ve sınır aşılırsa ifadenin tamamı geri alınır. Geri yazma, o tek tabloyu UPDATE edebilen bir veritabanı hesabı ister; bu, etiket sorgusu için kullanılan salt okunur hesaptan farklı bir hesaptır.
17 Ekim 2026'da PostgreSQL 16.14'te çalıştırıldı. Oracle ve MySQL aynı ucu kullanır; SQL Server ve SAP HANA denemek için mevcut değildi.
İŞARET NEREDE DURUR
Basıldı işaretini kendi tablonuzda tutun
Sabit bir satır anahtarıyla eşleşip "basıldı" bilgisini ERP'nin kendi tablolarına değil kendi tablonuza yazmak tedarikçi desteğini korur; API başvurusu aynı öneriyi verir. İşareti yoklama sorgusundaki bir hazır olma sütunuyla birleştirin (yukarıda status = 'paid'), böylece yarım yazılmış satırlar bekler.
- Veritabanı kaynakları ve geri yazma Pro (aylık $24.90) ister; 14 günlük deneme bunları içerir.
- Webhook tetikleyicilerinin kendi koruması vardır: token başına 250 ms'de bir istek taşkın freni. Sizin tarafınızdaki yeniden denemeler yine idempotency anahtarı ister (aşağıda).
- API çağrıları için deneme sayacıyla
X-Idempotency-Keykullanın (order-SO-10442:1): tekrarlanan anahtar 24 saat özgün işi döndürür, ama başarısız işten sonra aynı anahtarla yeniden deneme başarısızlığı yine döndürür. Bkz. Etiket yazdırma API.
SORULAR / SSS
Sık sorulan sorular
Etiketlerim neden iki kez basılıyor?
Genellikle tetikleyici yeni kaydı daha önce işlediğinden ayıramadığı için: bastığını hatırlamadan tablo yoklayan bir betik ya da tekrar denenen bir API çağrısı. Her tetikleyiciye hatırlayacağı bir anahtar verin ve kayıtları basıldı olarak işaretleyin.
LabelInn veritabanındaki satırı basıldı olarak işaretleyebilir mi?
Evet. Baskıdan sonra ağınızdaki LabelInn veritabanı köprüsü üzerinden o satırın bir sütununa seçtiğiniz değeri yazar.
Hâlâ yazılmakta olan satırlar ne olur?
Bir hazır olma sütunu belirleyin. Satır ancak o sütun dolunca sayılır; yarım satırlar bekler.
Klasör izleme yeniden başlatmadan sonra dosyayı tekrar basar mı?
Hayır. İşlenen dosyalar yol, değişiklik zamanı ve boyutla hatırlanır; baskıdan sonra taşınabilir, yeniden adlandırılabilir veya silinebilir.
Bir veritabanı satırının iki kez basılmasını ne engeller?
İşaretli satırları atlayan bir yoklama sorgusu (WHERE label_printed IS NULL) ve basıldıktan sonra işareti koyan bir geri yazma. Geri yazma yalnızca adını verdiğiniz satırı günceller; izin verilenden fazla satıra değecekse geri alınır.
LabelInn ERP tablolarıma yazabilir mi?
Adını verdiğiniz tablo ve sütunları bağlı parametrelerle, varsayılan olarak tek satırlık adımlarla güncelleyebilir. Önerilen tasarım, basıldı işaretini ERP'nin şemasında değil kendi tablonuzda tutmaktır.
DEVAMI
İlgili sayfalar
SONRAKİ ADIM / LABELINN
Bir kez basın. Sadece bir kez.
Korumayı birinin hafızasına değil, tetikleyiciye koyun. · Hatırlanan satır anahtarları · Basıldı işaretli satırlar · Hazır olma kontrolü