Otomasyon Tetikleyicileri
Tetikleyiciler, her otomasyon kuralinin baslangic noktasidir. Bir tetikleyici, kuralin kosullarini degerlendirmesine ve eylemlerini yurutmesine neden olan olayi tanimlar. SetGet, is ogelerinin olusturulmasindan durum gecislerine ve zaman tabanli zamanlamalara kadar tum yasam dongusunu kapsayan 10 tetikleyici tipi saglar.
Tetikleyiciler nasil calisir
Bir SetGet projesinde bir olay meydana geldiginde (ornegin, bir is ogesinin durumu degistiginde), otomasyon motoru o projedeki tum aktif kurallari kontrol eder. Bir kuralin tetikleyicisi olayla eslesirse, motor kuralin kosullarini degerlendirir. Kosullar saglanirsa, kuralin eylemleri yurutulur.
Degerlendirme akisi:
- Olay meydana gelir projede.
- Tetikleyici eslesmesi: Motor, tetikleyici tipi olayla eslesen tum kurallari belirler.
- Kosul degerlendirmesi: Eslesen her kural icin, motor kosullari is ogesinin mevcut durumuna gore degerlendirir.
- Eylem yurutme: Kosullar saglanirsa, eylemler sirayla yurutulur.
TIP
Tek bir olay birden fazla kuralla eslesebilir. Eslesen tum kurallar bagimsiz olarak yurutulur. Yurutme sirasi ve catisma cozumu hakkinda ayrintilar icin Gelismis Kaliplar sayfasina bakin.
Tetikleyici ozet tablosu
| Tetikleyici | Olay | Ne zaman tetiklenir |
|---|---|---|
issue_created | Yeni is ogesi | Projede bir is ogesi olusturulur |
issue_updated | Herhangi bir ozellik degisikligi | Is ogesindeki herhangi bir alan degisir |
state_changed | Durum gecisi | Bir is ogesinin is akisi durumu degisir |
priority_changed | Oncelik degisikligi | Bir is ogesinin oncelik seviyesi degisir |
assignee_changed | Atanan degisikligi | Atananlar eklenir veya kaldirilir |
label_changed | Etiket degisikligi | Etiketler eklenir veya kaldirilir |
due_date_passed | Son tarih gecmiste | Bir is ogesinin son tarihi artik gecmiste |
comment_added | Yeni yorum | Bir is ogesine yorum gonderilir |
manual | Talep uzerine | Bir kullanici Calistir dugmesine tiklar veya API'yi cagirir |
scheduled | Zaman tabanli | Bir zamanlama tetiklenir (bir kez, aralik veya cron) |
issue_created
Projede nasil olusturulduguna bakilmaksizin (arayuz, API, ice aktarma veya otomasyon) yeni bir is ogesi olusturuldugunda tetiklenir.
Ne zaman tetiklenir
- Bir ekip uyesi arayuz uzerinden bir is ogesi olusturur.
- SetGet API'si araciligiyla bir is ogesi olusturulur.
- Baska bir otomasyonun eylemi tarafindan bir is ogesi olusturulur.
- Harici bir kaynaktan bir is ogesi ice aktarilir.
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
issue | Olusturma anindaki tam is ogesi nesnesi |
issue.state | Is ogesine atanan ilk durum |
issue.priority | Ilk oncelik |
issue.assignees | Ilk atanan listesi (bos olabilir) |
issue.labels | Ilk etiket listesi (bos olabilir) |
issue.created_by | Is ogesini olusturan kullanici |
issue.project | Is ogesinin ait oldugu proje |
Ornek kullanim senaryosu
Yeni hatalari otomatik olarak triyaj sorumlusuna ata:
- Tetikleyici:
issue_created - Kosul: Etiket "Bug" iceriyor
- Eylem: Belirlenen triyaj sorumlusuna ata
Yaygin kaliplar
- Olusturma sirasinda ture veya etikete gore is ogelerini otomatik ata.
- Olusturucunun rolune gore ilk onceligi ayarla.
- Yeni olusturulan ogeleri mevcut aktif dongiye tasi.
- Yeni bir is ogesi gorundigunde proje liderine bildirim gonder.
- Tum yeni is ogelerine varsayilan bir etiket ekle.
WARNING
issue_created tetikleyicisini is ogesini degistiren eylemlerle (durum degistirme gibi) birlestirirken dikkatli olun. Bu degisiklikler issue_updated veya state_changed kurallarini tetikleyebilir ve potansiyel olarak zincirler olusturabilir. Yeniden giris korumalari icin Gelismis Kaliplar sayfasina bakin.
issue_updated
Bir is ogesindeki herhangi bir ozellik degistiginde tetiklenir. Bu en genis kapsamli tetikleyicidir ve durum degisiklikleri, oncelik degisiklikleri, atanan degisiklikleri, etiket degisiklikleri, baslik duzenlemeleri, aciklama duzenlemeleri, tarih degisiklikleri ve diger tum alan degisikliklerini eslestirir.
Ne zaman tetiklenir
- Is ogesindeki herhangi bir alan arayuz, API veya otomasyon araciligiyla degistirilir.
- Toplu guncellemeler, etkilenen her is ogesi icin bu olayi bir kez tetikler.
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
issue | Guncellemeden sonraki is ogesi |
changes | Hangi alanlarin degistigini, old ve new degerleriyle listeleyen nesne |
changes.field_name.old | Degisen alanin onceki degeri |
changes.field_name.new | Degisen alanin yeni degeri |
actor | Degisikligi yapan kullanici veya sistem |
Ornek kullanim senaryosu
Acil ogelerdeki herhangi bir degisiklikte proje yoneticisini bilgilendir:
- Tetikleyici:
issue_updated - Kosul: Oncelik "Acil" esittir
- Eylem: Proje yoneticisine bildirim gonder
Yaygin kaliplar
- Denetim kaydi: yuksek oncelikli ogelerdeki her degisikligi takip et.
- Belirli alanlar degistiginde paydaslari bilgilendir.
- Alan gereksinimlerini zorla (ornegin, son tarih kaldirilirsa yeniden ekle).
TIP
Yalnizca belirli bir alan degisikligiyle ilgileniyorsaniz (durum veya oncelik gibi), issue_updated yerine ozel tetikleyici tipini (state_changed, priority_changed) tercih edin. Ozel tetikleyiciler daha verimlidir cunku ilgisiz alanlar degistiginde motor degerlendirmeyi atlar.
state_changed
Bir is ogesinin is akisi durumu bir durumdan digerine gectiginde tetiklenir.
Ne zaman tetiklenir
- Bir kullanici Kanban panosunda bir is ogesini yeni bir sutuna surukler.
- Bir kullanici is ogesi detay paneli uzerinden durumu degistirir.
- Bir API cagrisi durum alanini gunceller.
- Baska bir otomasyon durumu degistirir.
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
issue | Durum degisikliginden sonraki is ogesi |
previous_state | Is ogesinin degisiklikten onceki durumu |
new_state | Is ogesinin tasindigi durum |
state_group | Yeni durumun grubu (birikmis, baslanmamis, baslamis, tamamlanmis, iptal edilmis) |
actor | Durumu degistiren kullanici veya sistem |
Ornek kullanim senaryosu
Is "Inceleme Asamasinda" durumuna gectiginde otomatik olarak QA incelemecisi ata:
- Tetikleyici:
state_changed - Kosul: Yeni durum "Inceleme Asamasinda" esittir
- Eylem: Belirlenen QA incelemecisini ata
Yaygin kaliplar
- Is inceleme durumlarina girdiginde incelemeci ata.
- Ogeler "Tamamlandi" veya "Iptal Edildi" durumuna gectiginde paydaslari bilgilendir.
- Tamamlanan ogeleri belirli bir dongu veya module tasi.
- Geriye giden ogeleri yukselt (ornegin, "Devam Ediyor"dan "Birikme"ye geri).
- Terminal durumuna ulasan ogeleri arsivle.
priority_changed
Bir is ogesinin oncelik seviyesi degistiginde tetiklenir.
Ne zaman tetiklenir
- Bir kullanici arayuz uzerinden onceligi degistirir.
- Bir API cagrisi oncelik alanini gunceller.
- Baska bir otomasyon onceligi degistirir.
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
issue | Oncelik degisikliginden sonraki is ogesi |
previous_priority | Degisiklikten onceki oncelik (yok, dusuk, orta, yuksek, acil) |
new_priority | Degisiklikten sonraki oncelik |
actor | Onceligi degistiren kullanici veya sistem |
Ornek kullanim senaryosu
Bir oge Acil'e yukseltildiginde uyari gonder:
- Tetikleyici:
priority_changed - Kosul: Yeni oncelik "Acil" esittir
- Eylem: Muhendislik liderine bildirim gonder ve "yukseltme" etiketini ekle
Yaygin kaliplar
- Ogeler yukseltildiginde liderleri bilgilendir.
- Oncelik "Yuksek" veya "Acil"e ulastiginda otomatik olarak kidemli bir muhendis ata.
- Yukseltme yolunu gosteren bir etiket ekle.
- Acil ogeleri mevcut sprint dongusune tasi.
assignee_changed
Bir is ogesine atananlar eklendiginde veya kaldirildiginda tetiklenir.
Ne zaman tetiklenir
- Bir kullanici arayuz uzerinden bir uye atar veya atamasini kaldirir.
- Bir API cagrisi atanan listesini degistirir.
- Baska bir otomasyon bir atanan ekler veya kaldirir.
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
issue | Atanan degisikliginden sonraki is ogesi |
added_assignees | Atanan olarak eklenen kullanicilarin listesi |
removed_assignees | Atamasi kaldirilan kullanicilarin listesi |
current_assignees | Mevcut atananlarin tam listesi |
actor | Atananlari degistiren kullanici veya sistem |
Ornek kullanim senaryosu
Yeni atanani bilgilendir ve ogeyi "Devam Ediyor" durumuna tasi:
- Tetikleyici:
assignee_changed - Kosul: En az bir atanan eklendi VE durum "Birikme"
- Eylem: Durumu "Devam Ediyor"a degistir, yeni atananlara bildirim gonder
Yaygin kaliplar
- Bir atanan eklendiginde durumu otomatik olarak gecir.
- Ogeler ekip uyelerine atandiginda takim liderlerini bilgilendir.
- Atama sinirlarini zorla (bir kullanicinin cok fazla atamasi varsa bildirim gonder).
- Is yuku takibi icin atama gecmisini kaydet.
label_changed
Bir is ogesine etiketler eklendiginde veya kaldirildiginda tetiklenir.
Ne zaman tetiklenir
- Bir kullanici arayuz uzerinden bir etiket ekler veya kaldirir.
- Bir API cagrisi etiket listesini degistirir.
- Baska bir otomasyon bir etiket ekler veya kaldirir.
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
issue | Etiket degisikliginden sonraki is ogesi |
added_labels | Eklenen etiketlerin listesi |
removed_labels | Kaldirilan etiketlerin listesi |
current_labels | Mevcut etiketlerin tam listesi |
actor | Etiketleri degistiren kullanici veya sistem |
Ornek kullanim senaryosu
"Bug" etiketi eklendiginde hatalari triyaj kuyruguna yonlendir:
- Tetikleyici:
label_changed - Kosul: "Bug" eklenen etiketlerde
- Eylem: Durumu "Triyaj"a degistir, triyaj sorumlusuna ata
Yaygin kaliplar
- Etiketlere gore is ogelerini belirli is akislarina yonlendir.
- Etiketleri uygulandiginda uzman ekipleri bilgilendir (ornegin, "Guvenlik", "Performans").
- Iliskili etiketleri otomatik ekle ("Kritik Hata" eklemek ayrica "Bug" da ekler).
- Celisen etiketleri otomatik olarak kaldir.
due_date_passed
Bir is ogesinin son tarihi artik gecmiste oldugunda ve oge tamamlanmis veya iptal edilmis durumda olmadiginda tetiklenir.
Ne zaman tetiklenir
- Sistem zamanlayicisi son tarihleri periyodik olarak kontrol eder (her 15 dakikada bir).
- Bir is ogesinin son tarihi gecmisse ve hala aktif bir durum grubundaysa (birikmis, baslanmamis veya baslamis), tetikleyici calisir.
- Bu tetikleyici, her is ogesi icin son tarih gecisi basina bir kez calisir. Sonraki kontrollerde yeniden calismaz.
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
issue | Suresi gecmis is ogesi |
due_date | Gecmis olan son tarih |
days_overdue | Son tarihten itibaren gecen gun sayisi |
current_state | Is ogesinin mevcut durumu |
assignees | Mevcut atanan listesi |
Ornek kullanim senaryosu
Suresi gecmis ogeleri Acil oncellige yukselt ve proje yoneticisini bilgilendir:
- Tetikleyici:
due_date_passed - Kosul: Oncelik zaten "Acil" degil
- Eylem: Onceligi "Acil"e degistir, proje yoneticisine bildirim gonder
Yaygin kaliplar
- Suresi gecmis ogelerin onceligini yukselt.
- Atananlari ve yoneticileri suresi gecmis isler hakkinda bilgilendir.
- Gorsel takip icin "Suresi Gecmis" etiketi ekle.
- Ogenin suresinin gectigini belirten otomatik bir yorum gonder.
WARNING
due_date_passed tetikleyicisi gercek zamanli degil, periyodik bir zamanlamayla calisir. Son tarihin gecmesi ile tetikleyicinin calismasi arasinda 15 dakikaya kadar bir gecikme olabilir.
comment_added
Bir is ogesine yeni bir yorum gonderildiginde tetiklenir.
Ne zaman tetiklenir
- Bir kullanici arayuz uzerinden bir yorum gonderir.
- Bir API cagrisi bir yorum olusturur.
- Baska bir otomasyon bir yorum ekler (dongulerden sakinin).
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
issue | Yorumun eklendigi is ogesi |
comment | Yorum nesnesi (metin, yazar, zaman damgasi) |
comment.body | Yorumun metin icerigi |
comment.author | Yorumu gonderen kullanici |
actor | Yorum yazariyla ayni |
Ornek kullanim senaryosu
Birisi is ogesine yorum yaptiginda atanani bilgilendir:
- Tetikleyici:
comment_added - Kosul: Yorum yazari atanan degil
- Eylem: Tum atananlara bildirim gonder
Yaygin kaliplar
- Yeni yorumlar hakkinda atananlari bilgilendir.
- Yorumlardaki anahtar kelimeleri tespit et (ornegin, "engellendi", "yardim gerekli") ve harekete gec.
- Bir yorum belirli bir metin icerdiginde otomatik olarak etiket ekle.
- SLA amaclari icin yorum aktivitesini takip et.
WARNING
Kuraliniz bir eylem olarak yorum ekliyorsa ve baska bir kural comment_added uzerinde tetikleniyorsa, sonsuz dongu olusturabilirsiniz. Gelismis Kaliplar sayfasinda aciklanan yeniden giris korumasini kullanin.
manual
Bir kullanici kurali arayuz veya API uzerinden acikca tetiklediginde talep uzerine calisir. Manuel tetikleyiciler, otomatik olarak calismamasi gereken ancak tek tikla eylem olarak kullanilabilir olmasi gereken kurallar icin kullanislidir.
Ne zaman tetiklenir
- Bir kullanici Otomasyon ayarlari sayfasindaki kuralda Calistir dugmesine tiklar.
- Bir kullanici SetGet API
POST /api/automations/{rule_id}/executeucu noktasi araciligiyla kurali cagirir.
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
actor | Kurali tetikleyen kullanici |
project | Kuralin ait oldugu proje |
scope | Kuralin kosullariyla eslesen tum is ogeleri |
Ornek kullanim senaryosu
Talep uzerine eski ogeleri toplu temizle:
- Tetikleyici:
manual - Kosul: Durum "Birikme" VE 90 gunden fazla suredir guncellenmemis
- Eylem: Eslesen tum is ogelerini arsivle
Yaygin kaliplar
- Eski veya bayat ogelerin talep uzerine temizligi.
- Yalnizca bir insan karar verdiginde calistirilmasi gereken toplu islemler.
- Tek tikla triyaj is akislari.
- Otomatik bir tetikleyiciyi etkinlestirmeden once kurali test etme.
TIP
Manuel tetikleyiciler test icin harikdir. Kuralinizi once manuel tetikleyiciyle olusturun, beklenildigi gibi calistigini dogrulayin, ardindan otomatik bir tetikleyici tipine gecin.
scheduled
Zaman tabanli bir zamanlamayla tetiklenir. Zamanlanmis tetikleyiciler, is ogesi olaylarindan bagimsiz olarak belirlenen zamanlarda kurali calistirir.
Ne zaman tetiklenir
Uc zamanlama modu mevcuttur:
| Mod | Aciklama | Ornek |
|---|---|---|
| Bir kez | Belirli bir tarih ve saatte tek sefer tetiklenir | 30 Mart 2026 saat 09:00 UTC |
| Aralik | Her N dakika, saat, gun veya haftada tekrar tekrar tetiklenir | Her 24 saatte bir |
| Cron | Bir cron zamanlamasinda tetiklenir | 0 2 * * * (her gun saat 02:00'de) |
Baglamda mevcut veriler
| Alan | Aciklama |
|---|---|
project | Kuralin ait oldugu proje |
scope | Kuralin kosullariyla eslesen tum is ogeleri |
schedule_time | Zamanlamanin tetiklendigi zaman |
schedule_type | "once", "interval" veya "cron" |
Ornek kullanim senaryosu
Her Pazartesi sabah 9'da haftalik bayat oge raporu:
- Tetikleyici:
scheduled(cron:0 9 * * 1) - Kosul: Durum "Devam Ediyor" VE son 7 gunde guncelleme yok
- Eylem: "Bayat" etiketini ekle, proje yoneticisine bildirim gonder
Yaygin kaliplar
- Suresi gecmis veya terk edilmis ogelerin gunluk temizligi.
- Haftalik raporlar ve ozetler.
- Tamamlanan ogelerin aylik arsivlenmesi.
- Periyodik oncelik incelemeleri.
- Son tarihleri yaklasan ogeler icin zamanlanmis hatirlatmalar.
Uc zamanlama modunun tumu icin detayli yapilandirma icin Zamanlama sayfasina bakin.
Dogru tetikleyiciyi secme
| Senaryo | Onerilen tetikleyici |
|---|---|
| Yeni is ogelerine tepki verme | issue_created |
| Belirli bir alan degisikligine tepki verme | Ozel tetikleyiciyi kullanin (state_changed, priority_changed, assignee_changed, label_changed) |
| Herhangi bir degisiklige tepki verme | issue_updated |
| Son tarihleri zorlama | due_date_passed |
| Tartismaya yanit verme | comment_added |
| Talep uzerine calistirma | manual |
| Zamanlamaya gore calistirma | scheduled |
TIP
Mumkun oldugunda issue_updated yerine ozel tetikleyicileri tercih edin. Ozel tetikleyiciler daha verimlidir ve kurallarin bir bakista anlasilmasini kolaylastirir.
Ilgili sayfalar
- Otomasyon Kurallari -- Kurallari olusturma ve yonetme
- Kosullar -- Bir kuralin hangi ogelere uygulanacagini filtreleme
- Eylemler -- Bir kural tetiklendiginde ne olur
- Zamanlama -- Zamanlanmis tetikleyicileri yapilandirma
- Gelismis Kaliplar -- Zincirleme, donguler ve catisma cozumu
- Yurutme Gecmisi -- Gecmis kural yurutmelerini inceleme