Jira Get Issues aksiyonu, Jira üzerinde belirli kriterlere göre birden fazla issue’yu listelemek için kullanılır. Bu aksiyon sayesinde JQL sorguları, proje filtreleri veya limit değerleri kullanılarak toplu issue sorgulamaları yapılabilir. Özellikle proje yönetimi, raporlama, backlog görüntüleme ve iş yükü analizleri için kullanılabilir.

Teknik Özellikler

Toplu Issue Getirme (List Paneli): Verilen parametrelere göre birden fazla issue bilgisini döndürür ve JiraIssueDto (Many) nesnesi olarak geri iletir.

Parametreler:

• settings (Object – zorunlu): Jira API bağlantısı için gerekli ayarları içerir. Config Manager üzerinden tanımlanan Jira bağlantısı seçilmelidir.
• jql (String – opsiyonel): Jira Query Language (JQL) ifadesi kullanılarak issue filtreleme yapılabilir. (örn. status = "In Progress" AND assignee = currentUser())
• limit (Int32 – opsiyonel): Döndürülecek maksimum issue sayısı. (örn. 50)
• start_at (Int32 – opsiyonel): Listeleme için başlangıç indexi (sayfalama için kullanılır).
• projects_filter (String – opsiyonel): Belirli bir projeye göre issue filtrelemek için kullanılır (örn. DEV, QA).

Veri Kaynağı Uyumluluğu: Parametreler sabit (Fixed) değerlerle girilebileceği gibi, Symbol Picker aracılığıyla Form Input, Current, Action Result, Method Input gibi dinamik kaynaklardan da alınabilir.

Web & Mobil Destek: Jira Get Issues aksiyonu hem web hem de mobil uygulamalarda kullanılabilir.

Jira Get Issues Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika projenizi açın.
• UI Design modülünde issue listesinin görüntüleneceği ekranı seçin.
• Bir Button elementi ekleyin (ör. “Issue’ları Listele”).
• Butona tıklayın ve + ADD ACTION → Jira → Jira Get Issues aksiyonunu seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’da oluşturduğunuz Jira API ayarını seçin.
• jql: İhtiyaca göre sorgu yazın (örn. project = DEV AND status != Done).
• limit: Maksimum dönecek issue sayısını belirleyin.
• start_at: Sayfalama için başlangıç indexi girin.
• projects_filter: Belirli bir proje anahtarı girilerek liste filtrelenebilir.

Kullanım Senaryosu: Backlog Listeleme

Bir proje yönetim uygulamasında, kullanıcı “DEV” projesindeki açık görevlerin listesini görmek ister.

Adımlar:

1. “Görevleri Göster” butonunu ekleyin.
2. OnClick → Jira Get Issues aksiyonunu bağlayın.
3. jql parametresine project = DEV AND status != Done yazın.
4. Dönen sonuçları Table elementinde görüntüleyin.

Jira Get Issues İleri Seviye Özelleştirmeler

• Dinamik Filtreleme: Kullanıcıya durum, öncelik veya atanan kişi seçtirip JQL sorgusunu dinamik oluşturabilirsiniz.
• Sayfalama: Çok fazla issue olduğunda limit ve start_at parametreleri ile sayfalama yapılabilir.
• Proje Bazlı Raporlama: projects_filter parametresi kullanılarak birden fazla proje bazlı raporlama yapılabilir.
• Sonucun Kullanımı: Dönen issue listesi başka aksiyonlara (ör. Jira Update Issue, Jira Delete Issue) aktarılabilir.

Teknik Riskler ve Kontroller

• settings doğru yapılandırılmalıdır. Configuration Manager’da Jira API ayarı yapılmazsa aksiyon çalışmaz.
• jql yanlış yazılırsa Jira hata döndürür.
• limit çok yüksek olmamalıdır. Çok fazla issue çağırmak performans sorunlarına yol açabilir.
• Yetki kısıtlamaları: Kullanıcının proje veya issue’ları görüntüleme yetkisi yoksa sonuçlar eksik dönebilir.