İçeriğe geç
Tüm dokümanlar

Varlık Tetikleyicileri

Markdown olarak görüntüle
AI'ya sor

Kayıt olaylarına bağlı otomatik aksiyonlar ve durum makineleri.

Özet

Varlık Tetikleyicileri, Custom Entity’lerinizde bir şey olduğunda otomatik bir aksiyonun çalışmasını sağlar. “Yeni bir talep kaydı oluştuğunda ilgili ekibe bildirim gönder”, “bir sipariş kaydı güncellenince başka bir sisteme haber ver”, “durum ‘Tamamlandı’ya geçtiğinde tamamlanma tarihini otomatik doldur” gibi kuralları elle iş takibi yapmadan platforma bırakırsınız.

Her tetikleyici üç sorunun cevabıdır: ne zaman (bir kayıt oluşturulunca, güncellenince, silinince ya da belirli bir alan değişince), hangi koşulda (isteğe bağlı — örneğin yalnızca tutar belirli bir eşiği aşarsa) ve ne yapılacak (bir bildirim gönder, dış bir servise çağrı yap ya da bir alanı otomatik doldur). Kuralları belirlersiniz, gerisini platform yürütür.

Tetikleyiciler arka planda çalışır: kaydı oluşturan kişi anında yanıt alır, aksiyon ise ayrı yürütülür. Bir aksiyon geçici olarak başarısız olursa platform otomatik olarak yeniden dener; sürekli başarısız olan işler ayrı bir listede toplanır, böylece hiçbir olay sessizce kaybolmaz. Güvenlik gereği tetikleyiciler yalnızca izin verilen aksiyon türlerini çalıştırır ve bir tetikleyicinin başka bir tetikleyiciyi sonsuz döngüye sokması engellenir.

Kimler kullanır

  • Süreç sorumluları: Tekrarlayan manuel adımları (bildirim gönderme, alan doldurma, başka ekibi haberdar etme) otomasyona bağlamak isteyen kişiler.
  • Organizasyon yöneticileri: Hangi varlıkta hangi olayda ne olacağını tanımlayan ve tetikleyicileri yöneten kişiler.
  • Entegrasyon sorumluları: Bir kayıt değiştiğinde dış bir sistemi (örneğin bir muhasebe ya da bildirim servisi) haberdar etmek isteyen kişiler.

Örneğin bir destek ekibi, yeni şikayet kaydı açıldığında sorumluya bildirim gidecek şekilde bir tetikleyici kurar; bir satış ekibi, sipariş onaylandığında dış bir servise çağrı yaparak faturalamayı başlatır.

Adım adım süreç

  1. Bir varlık seçin. Tetikleyiciyi hangi Custom Entity için kuracağınıza karar verin ve o varlığın Tetikleyiciler bölümünü açın.
  2. Olayı belirleyin. Tetikleyicinin ne zaman çalışacağını seçin: kayıt oluşturulunca, güncellenince, silinince ya da belirli bir alan değişince.
  3. Koşul ekleyin (opsiyonel). Aksiyonun her seferinde değil, yalnızca belirli bir durumda çalışmasını istiyorsanız bir koşul tanımlayın — örneğin yalnızca öncelik “Yüksek” ise.
  4. Aksiyonu seçin. Ne yapılacağını belirleyin: bir bildirim gönderin, dış bir servise güvenli bir çağrı (webhook) yapın ya da kaydın bir alanını otomatik doldurun.
  5. Aksiyon ayarlarını girin. Seçtiğiniz aksiyona göre gerekli bilgileri girin: bildirimde alıcı ve mesaj, dış çağrıda hedef adres, alan doldurmada hangi alanın hangi değeri alacağı.
  6. Tetikleyiciyi etkinleştirin. Kaydettiğinizde tetikleyici aktif olur. İstediğiniz zaman pasife alabilir, düzenleyebilir ya da aynı olay için birden fazla tetikleyiciyi sıralı çalışacak şekilde tanımlayabilirsiniz.

Süreç akışı

flowchart TD
    A[Kayıt oluşturuldu / güncellendi / silindi] --> B{Eşleşen tetikleyici var mı?}
    B -- Hayır --> Z[Hiçbir şey yapılmaz]
    B -- Evet --> C{Koşul sağlanıyor mu?}
    C -- Hayır --> Z
    C -- Evet --> D[Aksiyon arka planda çalıştırılır]
    D --> E{Başarılı mı?}
    E -- Evet --> F[Tamamlandı]
    E -- Hayır --> G[Otomatik yeniden dene]
    G --> H[Hâlâ başarısızsa ayrı listede işaretle]

Sık sorulan sorular

Tetikleyici çalışırken kaydımı beklemem gerekir mi? Hayır. Aksiyonlar arka planda yürütülür; kaydı oluşturduğunuz anda yanıtınızı alırsınız. Bir dış servis yavaş yanıt verse bile siz beklemezsiniz.

Bir aksiyon başarısız olursa ne olur? Platform aksiyonu otomatik olarak birkaç kez yeniden dener. Belirli bir denemeden sonra hâlâ başarısızsa, iş ayrı bir listede işaretlenir ve incelenmek üzere saklanır — sessizce kaybolmaz.

Dış bir sisteme çağrı yapmak güvenli mi? Evet. Dış çağrılar yalnızca güvenli adreslere (şifreli bağlantı üzerinden) gider ve iç ağ ya da sistem adreslerine erişim engellenir. Böylece bir tetikleyici hassas iç kaynaklara ulaşamaz.

Bir tetikleyici başka bir tetikleyiciyi tetikleyip sonsuz döngü oluşturabilir mi? Hayır. Platform, bir kaydın değişiminin başka bir değişimi tetiklediği zincirlerin uzunluğunu sınırlar. Bu koruma sonsuz döngüleri baştan keser.

Aynı olay için birden fazla tetikleyici tanımlayabilir miyim? Evet. Örneğin bir kayıt oluşturulduğunda hem bildirim gönderip hem de bir alanı doldurabilirsiniz. Tetikleyicilere sıra verebilir, her birini bağımsız olarak aktif ya da pasif tutabilirsiniz.

Kullanıcılar tetikleyiciye kendi kodlarını yazabilir mi? Güvenlik için tetikleyiciler yalnızca önceden tanımlı, güvenli aksiyon türlerini çalıştırır (bildirim, dış çağrı, alan doldurma). Serbest kod çalıştırma bu kapsamda yer almaz; daha ileri otomasyon ihtiyaçları ayrı ve denetimli yollarla ele alınır.