Jira Node
SkyStudio'nun Jira entegrasyonu, Jira projelerinizi workflow'larınıza doğrudan bağlamanızı sağlar. Issue yönetiminden sprint takibine, yorum ve worklog işlemlerine kadar tüm temel Jira operasyonlarını otomatikleştirebilirsiniz.
🎬 Videoyu izlemek için tıklayın →
Bağlantı Kurulumu ve Yönetimi
Jira node'larını kullanabilmek için önce bir Jira bağlantısı tanımlamanız gerekir. Bağlantılar tüm workflow'larınızda yeniden kullanılabilir; bir kez tanımladıktan sonra her node'da seçmeniz yeterlidir.
Yeni Bağlantı Oluşturma
Bağlantı oluşturmak için iki yol vardır:
Yol 1 — Node üzerinden: Herhangi bir Jira node'unu canvas'a ekleyin, Uygulama Bağlantıları açılır menüsüne tıklayın ve Bağlantıları Yönet seçeneğini seçin.
Yol 2 — Canvas toolbar'dan: Workflow düzenleyicisinin üst araç çubuğunda bulunan Uygulama Bağlantıları (🔗) simgesine tıklayın.
Her iki yöntem de aşağıdaki bağlantı formunu açar. Sağlayıcı listesinden Jira'yı seçin ve aşağıdaki bilgileri doldurun:
Bağlantı Formu Alanları
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı adı | Evet | Bağlantıya vereceğiniz isim (örn. Prod Jira, Test Ortamı) |
| Sağlayıcı | Evet | Jira seçili olmalıdır |
| Jira Cloud alan adı | Evet | Atlassian sitenizin alan adı (örn. sirketiniz.atlassian.net) |
| E-posta | Evet | Atlassian hesabınızın e-posta adresi (örn. kullanici@sirket.com) |
| API token | Evet | Atlassian hesabınızdan oluşturduğunuz API token'ı |
API Token Nasıl Alınır?
id.atlassian.com→ Güvenlik → API tokenları adımlarını izleyin, yeni bir token oluşturun ve kopyalayıp bu alana yapıştırın.
Formu doldurup Kaydet'e tıkladığınızda bağlantı kaydedilir ve tüm Jira node'larında kullanılabilir hale gelir.
Bağlantıyı Node'a Atama
Bağlantı oluşturduktan sonra, her Jira node'unda Uygulama Bağlantıları açılır menüsünden tanımlı bağlantılarınızı görebilir ve seçebilirsiniz. Bağlantıyı seçtikten sonra çalıştırma ve test süreçlerinde kimlik bilgileri otomatik olarak birleştirilir; node üzerindeki Connection alanı isteğe bağlı yedek olarak işlev görür.
Aktif Bağlantıları Görüntüleme
Canvas'ın sağ üst köşesindeki Aktif Bağlantılar düğmesine tıklayarak mevcut workflow'da kullanılan tüm araç bağlantılarını görebilirsiniz. Yayınlanan iş akışları bu bağlantılar üzerinden çalışır; dış erişim senaryolarında hangi erişim bilgisinin geçerli olacağını kurumsal politikalarınıza göre değerlendirmeniz önerilir.
İpucu: Bağlantı alanında
/yazarak workflow içindeki diğer node'lardan dinamik değerler ekleyebilirsiniz.
Operasyonlar
SkyStudio Jira node'u aşağıdaki 14 operasyonu destekler. İlk üç operasyon Öne Çıkan olarak işaretlenmiş olup en sık kullanılan senaryolar için tasarlanmıştır.
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Issue Getir | Öne Çıkan | ID veya anahtar ile tek bir issue getirir |
| Issue Ara (JQL) | Öne Çıkan | JQL sorgusuyla birden fazla issue arar |
| Jira AI Asistan | Öne Çıkan | Doğal dil sorgusuyla Jira verilerini sorgular |
| Issue Oluştur | Issue Yönetimi | Yeni bir Jira issue'su oluşturur |
| Issue Durumunu Değiştir | Issue Yönetimi | Bir issue'nun durumunu günceller |
| Issue Geçişlerini Getir | Issue Yönetimi | Mevcut durum geçişlerini listeler |
| Projeleri Listele | Proje | Erişilebilir tüm projeleri listeler |
| Proje Getir | Proje | Belirli bir projenin detaylarını getirir |
| Board'ları Listele | Board | Proje board'larını listeler |
| Sprint Issue'larını Getir | Sprint | Bir sprint'e ait tüm issue'ları getirir |
| Yorumları Getir | Yorum | Bir issue'nun yorumlarını listeler |
| Yorum Ekle | Yorum | Bir issue'ya yeni yorum ekler |
| Worklog'ları Getir | Worklog | Bir issue'nun worklog kayıtlarını getirir |
| Worklog Ekle | Worklog | Bir issue'ya yeni worklog kaydı ekler |
Öne Çıkan Operasyonlar
Issue Getir
Jira'da belirli bir issue'yu key değeri ile getirir. Tek bir issue'nun tüm detaylarına erişmek istediğinizde kullanın.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Issue Key | Evet | Issue'nun Jira anahtarı (örn. ENG-123, PROJ-456) |
| Fields | Hayır | Getirilecek alanlar, virgülle ayrılmış (örn. summary,status,assignee). Boş bırakılırsa tüm alanlar döner. |
Çıktı
Issue'nun talep edilen tüm alanlarını içeren bir JSON nesnesi döner. summary, status, assignee, priority, description, created, updated gibi standart alanları kapsar.
Örnek Kullanım
Issue Key alanına ENG-101 yazarak sadece özet ve durum bilgisi almak için Fields alanına summary,status girin.
Issue Ara (JQL)
Jira Query Language (JQL) kullanarak birden fazla issue'yu filtreler ve listeler. Belirli kriterlere uyan issue'ları toplu getirmek için idealdir.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| JQL Query | Evet | JQL sorgu ifadesi (örn. project = ENG AND status = 'In Progress') |
| Fields | Hayır | Getirilecek alanlar, virgülle ayrılmış (örn. summary,status,assignee). Boş bırakılırsa tüm alanlar döner. |
| Get All (Auto Paginate) | Hayır | Etkinleştirilirse sayfalama otomatik yapılır ve tüm sonuçlar tek seferde getirilir. |
| Limit | Hayır | Döndürülecek maksimum issue sayısı (varsayılan: 25). |
Çıktı
JQL sorgusuna uyan issue'ların listesini içeren bir dizi döner. Her eleman, talep edilen alanları içerir.
JQL Örnekleri
project = ENG AND status = "To Do"
assignee = currentUser() AND sprint in openSprints()
project = BUGS AND priority = High AND created >= -7d
labels = "backend" ORDER BY created DESC
Jira AI Asistan
Doğal dil ile Jira verilerinizi sorgulayabileceğiniz AI destekli bir asistan. JQL bilgisi gerektirmeden karmaşık sorguları çalıştırmanıza olanak tanır.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Query | Evet | Doğal dil ile yazılmış Jira sorusu veya sorgusu (örn. Bu hafta kapanan bug'ları listele) |
| System Prompt | Hayır | Asistanın davranışını özelleştirmek için sistem yönergesi. Projeye veya şirkete özel bağlam eklemek için kullanılır. |
Çıktı
Asistan, sorguyu yorumlayarak ilgili Jira verilerini getirir ve doğal dil formatında yanıt üretir.
Örnek Kullanım
Query alanına "Son 3 günde açılan kritik hataları listele" yazarak herhangi bir JQL yazmadan ilgili issue'ları getirebilirsiniz.
Issue Yönetimi
Issue Oluştur
Jira'da yeni bir issue oluşturur. Otomatik hata takibi, görev üretimi veya destek talebi akışlarında kullanılabilir.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Project Key | Evet | Issue'nun oluşturulacağı projenin anahtarı (örn. ENG, BUGS) |
| Summary | Evet | Issue başlığı / özeti |
| Issue Type | Evet | Issue türü; Bug, Task, Story, Epic gibi seçeneklerden biri |
| Description | Hayır | Issue'nun detaylı açıklaması |
| Assignee Account ID | Hayır | Atanacak kullanıcının Jira hesap ID'si |
| Priority | Hayır | Öncelik seviyesi; Highest, High, Medium, Low, Lowest |
| Labels | Hayır | Issue'ya eklenecek etiketler, virgülle ayrılmış (örn. backend,urgent) |
Çıktı
Oluşturulan issue'nun id, key ve self (URL) bilgilerini içeren bir JSON nesnesi döner.
Issue Durumunu Değiştir
Mevcut bir issue'nun durumunu günceller. Workflow geçişlerini otomatikleştirmek için kullanılır.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Issue Key | Evet | Durumu değiştirilecek issue'nun anahtarı (örn. ENG-123) |
| Transition ID | Evet | Uygulanacak geçişin ID'si. Mevcut geçiş ID'lerini öğrenmek için Issue Geçişlerini Getir operasyonunu kullanın. |
Çıktı
Başarılı işlem sonucunda boş bir yanıt döner (HTTP 204).
İpucu: Transition ID'yi bilmiyorsanız önce Issue Geçişlerini Getir operasyonunu çalıştırarak ilgili issue için mevcut geçişleri ve ID'lerini listeleyin.
Issue Geçişlerini Getir
Bir issue için mevcut durum geçişlerini ve geçiş ID'lerini listeler. Issue Durumunu Değiştir operasyonundan önce kullanılır.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Issue Key | Evet | Geçişleri sorgulanacak issue'nun anahtarı (örn. ENG-123) |
Çıktı
Her geçiş için id, name (örn. "In Progress", "Done") ve to (hedef durum) bilgilerini içeren bir dizi döner.
Proje Operasyonları
Projeleri Listele
Bağlı Jira hesabında erişilebilir tüm projeleri listeler.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Get All (Auto Paginate) | Hayır | Etkinleştirilirse tüm projeler otomatik sayfalama ile getirilir. |
| Limit | Hayır | Döndürülecek maksimum proje sayısı. |
Çıktı
Her proje için id, key, name ve projectTypeKey bilgilerini içeren bir dizi döner.
Proje Getir
Belirli bir projenin detaylarını key değeri ile getirir.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Project Key | Evet | Sorgulanacak projenin anahtarı (örn. ENG, PROJ) |
Çıktı
Projenin id, key, name, description, lead ve yapılandırma bilgilerini içeren bir JSON nesnesi döner.
Board Operasyonları
Board'ları Listele
Bir projeye ait Scrum veya Kanban board'larını listeler.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Project Key | Hayır | Filtrelenecek projenin anahtarı (örn. ENG). Boş bırakılırsa tüm board'lar listelenir. |
| Limit | Hayır | Döndürülecek maksimum board sayısı (varsayılan: 50). |
Çıktı
Her board için id, name ve type (scrum veya kanban) bilgilerini içeren bir dizi döner.
Sprint Operasyonları
Sprint Issue'larını Getir
Belirli bir sprint'e ait tüm issue'ları listeler. Sprint bazlı raporlama ve otomasyon için kullanılır.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Sprint ID | Evet | Sorgulanacak sprint'in Jira ID'si (sayısal değer, örn. 42) |
| Get All (Auto Paginate) | Hayır | Etkinleştirilirse tüm issue'lar otomatik sayfalama ile getirilir. |
| Limit | Hayır | Döndürülecek maksimum issue sayısı (varsayılan: 50). |
Çıktı
Sprint'e ait issue'ların listesini içeren bir dizi döner.
Yorum Operasyonları
Yorumları Getir
Bir issue'ya yapılmış tüm yorumları listeler.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Issue Key | Evet | Yorumları getirilecek issue'nun anahtarı (örn. ENG-123) |
| Limit | Hayır | Döndürülecek maksimum yorum sayısı. |
Çıktı
Her yorum için id, author, body (yorum içeriği) ve created (tarih) bilgilerini içeren bir dizi döner.
Yorum Ekle
Mevcut bir issue'ya yeni bir yorum ekler. Bildirim göndermek, durum güncellemek veya not bırakmak için kullanılabilir.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Issue Key | Evet | Yorum eklenecek issue'nun anahtarı (örn. ENG-123) |
| Comment | Evet | Yorum içeriği (düz metin veya Jira formatlaması desteklenir) |
Çıktı
Oluşturulan yorumun id, author, body ve created bilgilerini içeren bir JSON nesnesi döner.
Worklog Operasyonları
Worklog'ları Getir
Bir issue üzerinde kaydedilmiş tüm zaman takip (worklog) kayıtlarını listeler.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Issue Key | Evet | Worklog kayıtları getirilecek issue'nun anahtarı (örn. ENG-123) |
Çıktı
Her worklog kaydı için id, author, timeSpent, timeSpentSeconds ve started (başlangıç tarihi) bilgilerini içeren bir dizi döner.
Worklog Ekle
Bir issue'ya yeni bir zaman takip kaydı ekler. Çalışma sürelerini otomatik olarak loglamak için kullanılır.
Giriş Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Issue Key | Evet | Worklog eklenecek issue'nun anahtarı (örn. ENG-123) |
| Time Spent | Evet | Harcanan süre, Jira formatında (örn. 2h 30m, 1d, 45m) |
| Comment | Hayır | Worklog'a eklenmek istenen not veya açıklama |
| Started At | Hayır | Çalışmanın başladığı tarih ve saat (ISO 8601 formatı, örn. 2024-04-14T09:00:00.000+0000). Boş bırakılırsa mevcut zaman kullanılır. |
Çıktı
Oluşturulan worklog kaydının id, author, timeSpent, timeSpentSeconds ve started bilgilerini içeren bir JSON nesnesi döner.
Hızlı Başlangıç Örnekleri
Örnek 1: Hata Otomasyonu
Bir formdan gelen hata bilgisini otomatik olarak Jira'ya issue olarak açın:
- Metin Girişi node'u ile kullanıcıdan hata bilgisi alın
- Issue Oluştur node'una bağlayın;
Project Key: BUGS,Issue Type: Bug,Priority: Higholarak ayarlayın - Yorum Ekle node'u ile oluşturulan issue'ya kaynak bilgisi ekleyin
Örnek 2: Sprint Durum Raporu
Aktif sprint'teki tüm issue'ların durumunu raporlayın:
- Sprint Issue'larını Getir node'u ile sprint ID'sini girin
- Jira AI Asistan veya Veri Analizi node'u ile verileri özetleyin
- Metin Çıktısı ile raporu kullanıcıya iletin
Örnek 3: Otomatik Worklog
Bir görev tamamlandığında otomatik olarak zaman kaydı oluşturun:
- Issue Durumunu Değiştir node'u ile issue'yu
Donedurumuna alın - Worklog Ekle node'u ile
Time Spent: 1h,Comment: Otomatik tamamlandıdeğerlerini kaydedin
Sık Karşılaşılan Hatalar
| Hata | Olası Neden | Çözüm |
|---|---|---|
404 Issue not found | Yanlış Issue Key girildi | Issue Key'in doğru formatta olduğunu kontrol edin (örn. ENG-123) |
400 Invalid JQL | JQL sorgusu hatalı | JQL sözdizimini Jira'da test edin |
403 Forbidden | Yetersiz izin | Bağlantı hesabının ilgili proje üzerinde izni olduğunu doğrulayın |
Transition not found | Geçersiz Transition ID | Önce Issue Geçişlerini Getir ile mevcut geçişleri listeleyin |