Otomasyon Eylemleri

Eylemler, bir kuralin tetikleyicisi calisip kosullari saglandiginda ne olacagini tanimlar. Her kuralda bir veya daha fazla eylem olabilir ve bunlar listelendikleri sirada yurutulur. SetGet, durum yonetimi, atamalar, organizasyon, iletisim ve entegrasyonlari kapsayan 12 eylem tipi saglar.

Eylemler nasil yurutulur

Bir kural eslestiginde:

1. Eylemler kuralda gorundukleri sirada sirayla yurutulur.
2. Her eylem bir sonraki baslamadan once tamamlanir.
3. Bir eylem basarisiz olursa, ayni kuraldaki sonraki eylemler yine de yurutulur (acik-basarisiz davranisi).
4. Basarisiz eylemler Yurutme Gecmisi sayfasinda hata ayrintilariyla kaydedilir.
5. Is ogesini degistiren eylemler degisiklikleri hemen veritabanina kaydeder.

WARNING

Is ogesi ozelliklerini degistiren eylemler (durum, oncelik, atananlar, etiketler) diger otomasyon kurallarini tetikleyebilir. Sonsuz donguleri onleme rehberligi icin Gelismis Kaliplar sayfasina bakin.

Eylem ozet tablosu

Eylem	Etki	Parametreler
change_state	Belirtilen duruma tasi	Hedef durum
change_priority	Oncelik seviyesini ayarla	Hedef oncelik
assign	Atanan(lar) ekle	Atanacak kullanici(lar)
unassign	Atanan(lari) kaldir	Kaldirilacak kullanici(lar) veya tumunu
add_label	Etiket(ler) uygula	Eklenecek etiket(ler)
remove_label	Etiket(leri) kaldir	Kaldirilacak etiket(ler)
move_to_cycle	Bir donguye ekle	Hedef dongu
move_to_module	Bir module ekle	Hedef modul
add_comment	Otomatik yorum gonder	Yorum metni
send_notification	Bildirim tetikle	Alicilar, mesaj
call_webhook	HTTP istegi yap	URL, metod, basliklar, govde
archive	Is ogesini arsivle	(yok)

---

change_state

Is ogesini belirtilen is akisi durumuna tasir.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
target_state	Durum secici	Evet	Gecis yapilacak durum

Yapilandirma

1. Eylem duzenleyicisinde Durum Degistir secin.
2. Acilir menuden hedef durumu secin. Acilir menu, projede tanimli tum durumlari durum grubuna gore gruplandirarak gosterir.
3. Eylemi kaydedin.

Ornek kullanim

Bir incelemeci atandiginda is ogelerini "Inceleme Asamasinda" durumuna tasi:

• Tetikleyici: assignee_changed
• Kosul: Eklenen atananin "Incelemeci" rol etiketi var
• Eylem: change_state ile "Inceleme Asamasinda"na

Yan etkiler

• Durum degistirme, is ogesinin tum abonelerine bildirim gonderir.
• Durum degisikligi is ogesinin aktivite gunlugune kaydedilir.
• state_changed tetikleyicisi olan diger kurallar calisabilir.

Hata isleme

Hedef durum mevcut degilse (ornegin, kural olusturulduktan sonra silindiyse), eylem basarisiz olur ve bir hata kaydeder: "Hedef durum bulunamadi". Is ogesi mevcut durumunda kalir.

---

change_priority

Is ogesinin onceligini belirtilen seviyeye ayarlar.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
target_priority	Enum	Evet	none, low, medium, high veya urgent

Yapilandirma

1. Eylem duzenleyicisinde Oncelik Degistir secin.
2. Acilir menuden hedef onceligi secin.
3. Eylemi kaydedin.

Ornek kullanim

Suresi gecmis ogeleri Acil'e yukselt:

• Tetikleyici: due_date_passed
• Kosul: Oncelik "Acil" degil
• Eylem: change_priority ile urgent

Yan etkiler

• Oncelik degisiklikleri abonelere bildirim gonderir.
• Degisiklik aktivite gunlugune kaydedilir.
• priority_changed tetikleyicisi olan kurallar calisabilir.

Hata isleme

Oncelik degerleri sabit enum'lardir. Bu eylem normal kosullar altinda basarisiz olmaz. Bir sekilde gecersiz bir oncelik degeri yapilandirilirsa, eylem bir hata kaydeder ve atlar.

---

assign

Bir veya daha fazla kullaniciyi is ogesine atanan olarak ekler.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
user_ids	Kullanici kimliklerinin dizisi	Evet	Atanan olarak eklenecek kullanicilar

Yapilandirma

1. Eylem duzenleyicisinde Ata secin.
2. Bir veya daha fazla calisma alani uyesi secmek icin uye seciciyi kullanin.
3. Eylemi kaydedin.

Ornek kullanim

Yeni hatalari otomatik olarak triyaj sorumlusuna ata:

• Tetikleyici: issue_created
• Kosul: Etiket "Bug" iceriyor
• Eylem: Triyaj sorumlusunu assign et

Yan etkiler

• Yeni atananlar otomatik olarak is ogesinin bildirimlerine abone olur.
• Atama, aktivite gunlugune kaydedilir.
• assignee_changed tetikleyicisi olan kurallar calisabilir.
• Kullanici zaten atanmissa, eylem o kullanici icin islem yapmaz (tekrar atama olmaz).

Hata isleme

Belirtilen bir kullanici kimligi gecerli bir calisma alani uyesine karsilik gelmiyorsa, o kullanici atlanir. Bir hata kaydedilir ancak eylem kalan gecerli kullanicilarla devam eder.

---

unassign

Bir veya daha fazla kullaniciyi is ogesinin atanan listesinden kaldirir.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
user_ids	Kullanici kimliklerinin dizisi	Kosullu	Kaldirilacak kullanicilar. remove_all false ise zorunludur.
remove_all	Boolean	Hayir	True ise tum atananlari kaldir. Varsayilan: false.

Yapilandirma

1. Eylem duzenleyicisinde Atamayi Kaldir secin.
2. Ya Tum Atananlari Kaldir gecisini acin ya da kaldirilacak belirli uyeleri secin.
3. Eylemi kaydedin.

Ornek kullanim

Bir oge "Iptal Edildi" durumuna tasindiginda tum atananlari kaldir:

• Tetikleyici: state_changed
• Kosul: Yeni durum grubu "cancelled"
• Eylem: unassign ile remove_all: true

Yan etkiler

• Kaldirilan atananlar, manuel olarak abonelikten cikmedikleri surece is ogesine abone olarak kalir.
• Atama kaldirma, aktivite gunlugune kaydedilir.
• assignee_changed tetikleyicisi olan kurallar calisabilir.

Hata isleme

Belirtilen bir kullanici su anda atanmamissa, eylem o kullanici icin islem yapmaz. Hata kaydedilmez.

---

add_label

Bir veya daha fazla etiketi is ogesine uygular.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
label_ids	Etiket kimliklerinin dizisi	Evet	Eklenecek etiketler

Yapilandirma

1. Eylem duzenleyicisinde Etiket Ekle secin.
2. Bir veya daha fazla proje etiketi secmek icin etiket seciciyi kullanin.
3. Eylemi kaydedin.

Ornek kullanim

Yukseltilmis ogeleri gorsel bir gostergeyle etiketle:

• Tetikleyici: priority_changed
• Kosul: Yeni oncelik "Acil"
• Eylem: add_label "Yukseltildi"

Yan etkiler

• Etiket degisiklikleri aktivite gunlugune kaydedilir.
• label_changed tetikleyicisi olan kurallar calisabilir.
• Etiket zaten mevcutsa, eylem islem yapmaz (tekrar ekleme olmaz).

Hata isleme

Bir etiket kimligi gecerli bir proje etiketine karsilik gelmiyorsa (ornegin, etiket silindiyse), o etiket atlanir ve bir hata kaydedilir.

---

remove_label

Bir veya daha fazla etiketi is ogesinden kaldirir.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
label_ids	Etiket kimliklerinin dizisi	Evet	Kaldirilacak etiketler

Yapilandirma

1. Eylem duzenleyicisinde Etiket Kaldir secin.
2. Kaldirilacak etiketleri secmek icin etiket seciciyi kullanin.
3. Eylemi kaydedin.

Ornek kullanim

Triyaj tamamlandiktan sonra "Triyaj Gerekli" etiketini kaldir:

• Tetikleyici: state_changed
• Kosul: Yeni durum "Devam Ediyor"
• Eylem: remove_label "Triyaj Gerekli"

Yan etkiler

• Etiket degisiklikleri aktivite gunlugune kaydedilir.
• label_changed tetikleyicisi olan kurallar calisabilir.

Hata isleme

Etiket su anda is ogesinde degilse, eylem islem yapmaz. Hata kaydedilmez.

---

move_to_cycle

Is ogesini belirtilen bir donguye ekler.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
cycle_id	Dongu secici	Evet	Hedef dongu

Yapilandirma

1. Eylem duzenleyicisinde Donguye Tasi secin.
2. Acilir menuden hedef donguyu secin. Aktif ve yaklasmakta olan donguler listelenir.
3. Eylemi kaydedin.

Ornek kullanim

Yeni yuksek oncelikli ogeleri otomatik olarak mevcut sprint'e ekle:

• Tetikleyici: issue_created
• Kosul: Oncelik "Yuksek" veya "Acil"
• Eylem: move_to_cycle mevcut aktif dongu

Yan etkiler

• Is ogesi dongunun is ogesi listesinde goruntulenir.
• Dongu ilerleme metrikleri guncellenir.
• Is ogesi zaten hedef dongudeyse, eylem islem yapmaz.

Hata isleme

Hedef dongu sona erdiyse veya silindiyse, eylem basarisiz olur ve su kaydi olusturur: "Hedef dongu bulunamadi veya etkin degil". Is ogesi hicbir donguye eklenmez.

TIP

Bir dongu secerken mevcut aktif donguyu secin. Kuralin her zaman en son aktif donguyu hedeflemesini istiyorsaniz, her yeni sprint'in basinda kuralin dongu secimini guncelleyin.

---

move_to_module

Is ogesini belirtilen bir module ekler.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
module_id	Modul secici	Evet	Hedef modul

Yapilandirma

1. Eylem duzenleyicisinde Module Tasi secin.
2. Acilir menuden hedef modulu secin.
3. Eylemi kaydedin.

Ornek kullanim

Guvenlikle ilgili ogeleri Guvenlik modulune yonlendir:

• Tetikleyici: label_changed
• Kosul: Eklenen etiketler "Guvenlik" iceriyor
• Eylem: move_to_module "Guvenlik Guclandirme"

Yan etkiler

• Is ogesi modulun is ogesi listesinde goruntulenir.
• Modul ilerleme metrikleri guncellenir.
• Is ogesi zaten hedef moduldeyse, eylem islem yapmaz.

Hata isleme

Hedef modul mevcut degilse, eylem basarisiz olur ve su kaydi olusturur: "Hedef modul bulunamadi". Is ogesi hicbir module eklenmez.

---

add_comment

Is ogesine otomatik bir yorum gonderir. Yorum, herhangi bir bireysel kullanici yerine otomasyon sistemine atfedilir.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
body	String	Evet	Yorum metni. Duz metin ve temel Markdown destekler.

Yapilandirma

1. Eylem duzenleyicisinde Yorum Ekle secin.
2. Metin alanina yorum metnini girin. Bicimlendirme icin Markdown kullanabilirsiniz.
3. Eylemi kaydedin.

Sablon degiskenleri

Yorum metnine sablon degiskenleri kullanarak dinamik degerler dahil edebilirsiniz:

Degisken	Aciklama
{{issue.identifier}}	Is ogesi tanimlayicisi (ornegin, PROJ-123)
{{issue.title}}	Is ogesi basligi
{{issue.state}}	Mevcut durum adi
{{issue.priority}}	Mevcut oncelik seviyesi
{{actor.name}}	Olayi tetikleyen kullanicinin adi
{{rule.name}}	Otomasyon kuralinin adi

Ornek yorum sablonu:

Bu oge "{{rule.name}}" otomasyonu tarafindan otomatik olarak **{{issue.priority}}** onceligine yukseltildi.

Yan etkiler

• Yorum, is ogesinin aktivite akisinda goruntulenir.
• Aboneler yeni yorum hakkinda bilgilendirilir.
• comment_added tetikleyicisi olan kurallar calisabilir. Donguleri onlemek icin dikkatli olun.

Hata isleme

Yorum govdesi bossa, eylem atlanir. Bir hata kaydedilir: "Yorum govdesi bos".

WARNING

Baska bir kuralda comment_added tetikleyicisi varsa, otomasyon araciligiyla yorum eklemek o kuralin calismasina neden olabilir. Yeniden giris korumalarinin mevcut oldugundan emin olun. Gelismis Kaliplar sayfasina bakin.

---

send_notification

Belirtilen alicilara uygulama ici bildirim ve istege bagli olarak e-posta bildirimi gonderir.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
recipients	Dizi	Evet	Kime bildirilecek: belirli kullanicilar, atananlar, aboneler veya proje uyeleri
message	String	Evet	Bildirim mesaj metni. Sablon degiskenlerini destekler.
include_email	Boolean	Hayir	Ayrica e-posta bildirimi gonder. Varsayilan: false.

Yapilandirma

1. Eylem duzenleyicisinde Bildirim Gonder secin.
2. Acilir menuden alicilari secin:
   • Belirli kullanicilar: Bireysel uyeleri secin.
   • Atananlar: Is ogesinin tum mevcut atananlari.
   • Aboneler: Is ogesine abone tum kullanicilar.
   • Proje uyeleri: Projenin tum uyeleri.
3. Bildirim mesajini girin.
4. Istege bagli olarak E-posta gonder gecisini acin.
5. Eylemi kaydedin.

Ornek kullanim

Bir engelleyici olusturuldugunda muhendislik liderini uyar:

• Tetikleyici: issue_created
• Kosul: Etiket "Engelleyici" iceriyor
• Eylem: Muhendislik liderine send_notification ile "Yeni engelleyici: {{issue.identifier}} - {{issue.title}}" mesaji

Yan etkiler

• Bildirimler alicilarin bildirim merkezinde goruntulenir.
• E-posta bildirimleri etkinse ve alici e-posta bildirimlerini actiysa e-posta gonderilir.

Hata isleme

Gecerli alici bulunamazsa (ornegin, "atananlar" secili ama is ogesinin atanani yoksa), eylem hicbir sey gondermeden tamamlanir. Bir uyari kaydedilir.

---

call_webhook

Harici bir URL'ye HTTP istegi yapar. Bu eylem, harici hizmetler, CI/CD islem hatlari, izleme araclari ve ozel arka uclarla entegrasyonu saglar.

Parametreler

Parametre	Tip	Zorunlu	Aciklama
url	String	Evet	Uc nokta URL'si
method	Enum	Evet	GET, POST, PUT, PATCH veya DELETE
headers	Anahtar-deger ciftleri	Hayir	Ozel HTTP basliklari (ornegin, Authorization)
body	String (JSON)	Hayir	Istek govdesi. Sablon degiskenlerini destekler. POST/PUT/PATCH icin zorunludur.
timeout_seconds	Integer	Hayir	Istek zaman asimi. Varsayilan: 30 saniye. Maksimum: 60 saniye.

Yapilandirma

1. Eylem duzenleyicisinde Webhook Cagir secin.
2. Hedef URL'yi girin.
3. HTTP metodunu secin.
4. Gerekli basliklari ekleyin (Authorization: Bearer <token> veya Content-Type: application/json gibi).
5. Istek govdesini JSON olarak girin. Dinamik veriler icin sablon degiskenlerini kullanin.
6. Eylemi kaydedin.

Ornek kullanim

Bir oge Acil'e ulastiginda harici bir izleme hizmetini bilgilendir:

• Tetikleyici: priority_changed
• Kosul: Yeni oncelik "Acil"
• Eylem: call_webhook POST ile https://monitoring.example.com/api/alerts

Ornek govde:

{
  "event": "urgent_escalation",
  "issue_id": "{{issue.identifier}}",
  "title": "{{issue.title}}",
  "priority": "{{issue.priority}}",
  "url": "https://app.setget.dev/{{workspace.slug}}/projects/{{issue.project_id}}/issues/{{issue.id}}"
}

Yan etkiler

• HTTP istegi SetGet API sunucusundan yapilir.
• Yanit durumu ve govdesi yurutme gecmisine kaydedilir.
• Harici hizmetler webhook yukune gore ek islemler yapabilir.

Hata isleme

Senaryo	Davranis
Baglanti zaman asimi	Eylem yapilandirilan zaman asiminda basarisiz olur. Hata kaydedilir.
HTTP 4xx yaniti	Eylem basarisiz olarak isaretlenir. Yanit govdesi kaydedilir.
HTTP 5xx yaniti	Eylem basarisiz olarak isaretlenir. 30 saniye sonra otomatik bir yeniden deneme yapilir.
Gecersiz URL	Eylem hemen basarisiz olur. Hata kaydedilir.
Ag erisilemez	Eylem basarisiz olur. Hata kaydedilir.

WARNING

Webhook URL'leri ve basliklari hassas bilgiler icerebilir (API anahtarlari, token'lar). Bu degerler veritabaninda sifrelenmis olarak saklanir ve kaydedildikten sonra arayuzde asla gosterilmez. Webhook yapilandirmalarini sir olarak degerlendirin.

---

archive

Is ogesini arsivler. Arsivlenen ogeler aktif gorunumlerden kaldirilir ancak referans icin arsivde korunur.

Parametreler

Bu eylemin parametresi yoktur.

Yapilandirma

1. Eylem duzenleyicisinde Arsivle secin.
2. Eylemi kaydedin. Ek yapilandirma gerekli degildir.

Ornek kullanim

Tamamlanan ogeleri 7 gun sonra otomatik arsivle:

• Tetikleyici: scheduled (her gun saat 02:00'de)
• Kosul: Durum grubu "completed" VE updated_at_age_days 7'den buyuk
• Eylem: archive

Yan etkiler

• Is ogesi aktif proje gorunumlerinden kaldirilir (liste, pano, tablo, takvim).
• Is ogesi projenin arsiv bolumunde goruntulenir.
• Arsiv durumu aktivite gunlugune kaydedilir.
• Is ogesi arsivden manuel olarak geri yuklenebilir.

Hata isleme

Is ogesi zaten arsivlenmisse, eylem islem yapmaz. Hata kaydedilmez.

---

Birden fazla eylemi birlestirme

Tek bir kuralda birden fazla eylem olabilir. Siraliyla yurutulurler. Yaygin coklu eylem kaliplari:

Kalip	Eylemler
Triyaj yonlendirme	change_state ile Triyaj'a, triyaj sorumlusunu assign et, add_label "Triyaj Gerekli"
Yukseltme	change_priority ile Acil'e, add_label "Yukseltildi", lidere send_notification
Tamamlama temizligi	remove_label "Devam Ediyor", add_comment "Otomasyon tarafindan tamamlandi", archive
Harici senkronizasyon	change_state, harici takipciyle senkronizasyon icin call_webhook

TIP

Sira onemlidir. Bir eylem onceki bir eylemin sonucuna bagimliysa (ornegin, yeni durum hakkinda bildirim gonderme), durum degistirme eylemini ilk siraya koyun.

Ilgili sayfalar

• Otomasyon Kurallari -- Kurallari olusturma ve yonetme
• Tetikleyiciler -- Kural yurutmesini baslatan olaylar
• Kosullar -- Hangi ogelerin eslesecegini filtreleme
• Zamanlama -- Zaman tabanli kural yurutme
• Yurutme Gecmisi -- Eylem sonuclarini inceleme
• Gelismis Kaliplar -- Zincirleme, donguler ve catismalar