Jira Get Worklog aksiyonu, belirli bir Jira issue (task, story, bug vb.) için girilmiş olan çalışma sürelerini (worklogs) getirir. Bu sayede bir göreve kim, ne kadar zaman harcamış kolayca takip edilebilir.

Teknik Özellikler

Çalışma Loglarını Getirme: Belirtilen issue_key için tüm worklog kayıtlarını döndürür. Dönen veri tipi JiraWorklogsResult (One)’dır.

Parametreler:

• settings (Object – zorunlu): Jira bağlantı ayarlarını içerir. Config Manager üzerinden tanımlanan Jira API ayarı seçilmelidir.
• issue_key (String – zorunlu): Hangi issue için worklog bilgisi alınacaksa, o issue’nun anahtarı girilmelidir (örn. PROJ-101).

Veri Kaynağı Uyumluluğu:

• Sabit değer (Fixed Value) girilebilir (örn. TASK-12).
• Dinamik kaynaklardan (Current, Action Result, Method Input) bağlanabilir.

Jira Get Worklog Uygulama Adımları

1. UI Design’da Aksiyon Ekleme

• Worklog bilgisini göstermek istediğiniz ekrana gidin.
• Örn. “Çalışma Sürelerini Görüntüle” butonu ekleyin.
• Butona tıklayın → + ADD ACTION → Jira→ Jira Get Worklog seçin.

2. Parametreleri Tanımlama

• settings: Configuration Manager’dan Jira bağlantınızı seçin.
• issue_key: Worklog bilgisini almak istediğiniz issue’nun key bilgisini girin (örn. SUP-234).

3. Dönen Veriyi Kullanma

• Dönen sonuç JiraWorklogsResult tipinde olur. İçerisinde:
  
  • author: Worklog’u giren kullanıcı,
  • timeSpent / timeSpentSeconds: Harcanan süre,
  • started: Çalışmanın başladığı tarih/saat,
  • updated: Güncellenme zamanı gibi bilgiler bulunur.

Bu veriler tabloya, listeye veya detay kartına bağlanabilir.

Kullanım Senaryosu: Task için Worklog Takibi

Bir proje yöneticisi SUP-234 numaralı task için harcanan süreleri görmek istiyor.

Adımlar:

1. “Worklog’u Görüntüle” butonuna tıklanır.
2. Jira Get Worklog aksiyonu tetiklenir.
3. Dönen sonuç ekranda tablo şeklinde gösterilir:
   
   • Kullanıcı: mary.watson
   • Harcanan Süre: 3h
   • Başlangıç: 2025-09-16 09:00
   • Güncelleme: 2025-09-16 12:15

Jira Get Worklog İleri Seviye Özelleştirmeler

• Filtreleme: Dönen worklog listesi tarihe veya kullanıcıya göre filtrelenebilir.
• Raporlama: Worklog’lar toplam süreye çevrilip grafik veya özet rapor olarak sunulabilir.
• Kombinasyon: Jira Get Issues → Jira Get Worklog zinciriyle önce proje task’ları listelenir, ardından her bir task için çalışma süreleri çekilir.

Teknik Riskler ve Kontroller

• issue_key doğru girilmelidir. Yanlış girilirse Jira’dan sonuç dönmez.
• Yetki kısıtlamaları olabilir. Kullanıcının tüm worklog bilgilerini görme yetkisi olmayabilir.
• Büyük data riski: Çok fazla worklog varsa performans için limit/offset gerekebilir.