Sık Görülen Sorunlar ve Çözümleri
İş Akışı Tetiklenmiyor
Belirtiler: İş akışınız beklediğinizde çalışmıyor.
Olası Nedenler:
- İş akışı etkinleştirilmemiş: İş akışının “Draft” değil “Active” olarak ayarlandığından emin olun
- Tetikleyici koşulları karşılanmıyor: Tetikleyicinin beklediğiniz olaya uyduğunu doğrulayın
- Alan izlenmiyor: “Record is Updated” tetikleyicileri için, belirli alanın izlendiğinden emin olun
- İzinler: İş akışlarını çalıştırma iznine sahip olduğunuzu kontrol edin
Çözümler:
- İş akışı listesindeki iş akışı durumunu doğrulayın
- Tetiklemesini beklediğiniz belirli işlemle test edin
- Tetikleyici yapılandırmasını gözden geçirin
- İzinler konusunda yöneticinizle iletişime geçin
İş Akışı Çok Erken Tetikleniyor (Boş Alanlar)
Belirtiler: Kullanıcı arayüzünde (UI) bir kaydı manuel olarak oluştururken, tüm alanları dolduracak zamanınız olmadan iş akışınız tetikleniyor. İş akışı, alan değerlerinin çoğu boşken çalışır.
Bunun nedeni: Twenty her şeyi gerçek zamanlı olarak kaydeder — ayrı bir “düzenleme” ve “okuma” modu yoktur. Bir kayıt oluşturduğunuzda, ek alanları doldurmadan önce “Record is created” olayını tetikleyerek hemen kaydedilir.
“Record is created” ne zaman iyi çalışır:
- API çağrılarıyla oluşturulan kayıtlar (alanlar tek bir istekte doldurulur)
- İçe aktarma yoluyla oluşturulan kayıtlar
- Diğer iş akışlarından otomatik kayıt oluşturma
Çözüm: UI’da manuel olarak oluşturulan kayıtlar için tetikleyici olarak “Record is created or updated” kullanın. Bu şekilde:
- Kullanıcı alanları doldurup kaydetmeyi bitirdikten sonra iş akışı tetiklenir
- Boş değerler yerine eksiksiz verileri alırsınız
Kayıt başına iş akışının yalnızca bir kez çalışmasını istiyorsanız, createdAt equals updatedAt (ilk kaydetme) gibi bir alanı kontrol etmek için bir Filtre eylemi ekleyin veya iş akışının daha önce çalışıp çalışmadığını izlemek için özel bir onay kutusu alanı kullanın.
Eylemler Başarısız Oluyor
Belirtiler: İş akışı çalışıyor ancak bazı eylemler başarısız oluyor.
Olası Nedenler:
- Eksik veri: Gerekli alanlar boş
- Geçersiz başvurular: Önceki adımlardan gelen değişkenler mevcut değil
- API hataları: Dış hizmetler hata döndürüyor
- İzin sorunları: Eylem, sahip olmadığınız izinler gerektiriyor
Çözümler:
- Hata mesajları için iş akışı çalıştırma ayrıntılarını kontrol edin
- Gerekli tüm alanların dolu olduğunu doğrulayın
- API bağlantılarını bağımsız olarak test edin
- Rol izinlerini gözden geçirin
HTTP İstek Hataları
Belirtiler: HTTP Request eylemleri başarısız oluyor veya beklenmeyen sonuçlar döndürüyor.
Yaygın Hata Kodları:
- 400: Hatalı istek - istek gövdesi biçiminizi kontrol edin
- 401: Yetkisiz - API anahtarını doğrulayın
- 403: Yasak - API izinlerini kontrol edin
- 404: Bulunamadı - endpoint URL’sini doğrulayın
- 429: Çok fazla istek - hız sınırlaması uygulayın
- 500: Sunucu hatası - harici hizmet sorunu
Çözümler:
- API endpoint URL’sini doğrulayın
- Kimlik doğrulama başlıklarını kontrol edin
- Önce API çağrısını Twenty dışında test edin
- Code eylemlerine hata işleme ekleyin
Code Eylemi Hataları
Belirtiler: JavaScript kodu yürütülemiyor.
Yaygın Sorunlar:
- Sözdizimi hataları: Yazım hataları veya geçersiz JavaScript
- Tanımsız değişkenler: Var olmayan değişkenlere başvurma
- Tür hataları: Yanlış veri türleri üzerinde işlemler
- Zaman aşımı: Kodun çalıştırılması çok uzun sürüyor
Çözümler:
- Yerleşik kod düzenleyicisi doğrulamasını kullanın
- Önce JavaScript konsolunda kod mantığını test edin
- Hata ayıklama için console.log ifadeleri ekleyin
- Karmaşık işlemleri basitleştirin
E-posta Gönderilmiyor
Belirtiler: Send Email eylemi e-postaları göndermiyor.
Olası Nedenler:
- Bağlı e-posta hesabı yok: Settings → Accounts’ı kontrol edin
- Geçersiz e-posta adresi: Alıcı e-posta adresi hatalı biçimlendirilmiş
- Gönderim sınırları: E-posta sağlayıcısının hız sınırı aşıldı
- Spam filtreleri: E-postalar engelleniyor
Çözümler:
- E-posta hesabı bağlantısını doğrulayın
- Alıcı e-posta adreslerini doğrulayın
- E-posta sağlayıcısı limitlerini kontrol edin
- Spam tetikleyicileri açısından e-posta içeriğini gözden geçirin
İş Akışlarında Hata Ayıklama
İş Akışı Çalıştırmalarını Kullanma
- İş akışı düzenleyicisine gidin
- Runs panelini açın
- Başarısız olan çalıştırmayı bulun
- Adım adım ayrıntıları görmek için tıklayın
- Hata mesajlarını ve çıktı verilerini gözden geçirin
Bireysel Adımları Test Etme
- Code eylemleri için Test düğmesini kullanın
- HTTP istekleri için endpoint’i ayrı olarak test edin
- İş akışlarını tetiklemek için test kayıtları oluşturun
- Kontrollü test için manuel tetikleyiciler kullanın
Yaygın Hata Ayıklama Kalıpları
Günlükleme ekleyin:
Hata ayıklama için ara değerleri kaydetmek üzere Code eylemlerini kullanın.
Adımları izole edin:
Hataları belirlemek için her adımı bağımsız olarak test edin.
Veri akışını kontrol edin:
Her adımın beklenen giriş verilerini aldığını doğrulayın.
Sorunlardan Kaçınmak İçin En İyi Uygulamalar
Etkinleştirmeden Önce
- Taslak modunda kapsamlı şekilde test edin
- Tüm API bağlantılarını doğrulayın
- Tetikleyici koşullarını dikkatlice gözden geçirin
- Beklenen davranışı belgeleyin
Geliştirme Sırasında
- Açıklayıcı adım adları kullanın
- Code eylemlerine yorum ekleyin
- Gerçekçi verilerle test edin
- Uç durumlar için plan yapın
Etkinleştirmeden Sonra
- İlk çalıştırmaları yakından izleyin
- Başarısızlıklar için uyarılar ayarlayın
- Çalıştırma geçmişini düzenli olarak gözden geçirin
- Mümkün olduğunda iş akışlarını basit tutun
