JIRA

Jira, Atlassian firması tarafından geliştirilmiş bir İş/Proje geliştirme ve takip platformudur.  Tabi doğrudan yazılım dünyası ile ilgili görünse de iş akış aracı olarak kullanılabilir ve diğer sektörlere de uygun hale getirilebilir. Bir çok büyük proje de olduğu gibi Jira ‘da, ekosisteminde bulunan eklentiler sayesinde daha güçlü bir platform haline geliyor.Jira, iş süreçlerinin yönetimi için kendi içerisinde bir takım hazır araçlar ile gelir. Fakat Jira üzerinde çalışabilecek farklı  amaçlara uygun eklentiler de yazmak mümkün. 

Yazının geri kalanında, Jira ‘nın yazılımsal tarafı ele alınacak olup, Jira üzerinde çalışan bir eklentinin örnek geliştirme sürecini bulabilirisiniz. 

Jira hakkında ayrıntılı bilgileri, yazının kaynakça kısmındaki linklerden elde edebilirsiniz.

JIRA Üzerinde Eklenti Geliştirmek

Atlassian JIRA üzerinde eklenti geliştirmek için bir kaç araç gereklidir. Bunlar;

• Atlassian SDK

Şu an 4.2.20 sürümünde olan SDK içinde, Atlassian ‘ın özelleştirmiş olduğu Maven araçları ve geliştirme ortamı kütüphaneleri vardır.

• IDE

Atlassian yerleşik olarak bir IDE sunmuyor. Herhangi bir IDE için geliştirme sürecini kolaylaştıracak bir eklentisi de yok. Terminal ortamında çalışan bir komut var ve bu komut projenizi Eclipse IDE ‘si için hazırlıyor. Zaten projenizi, IDE içerisinden değil, komut satırından oluşturacaksınız. Bu nedenle debuging gibi işlemler için fazladan enerji sarfedeceğimizi söylemem gerekiyor. Aslında bir çok şey de terminal ortamında kolayca yapılabiliyor, bu kadar kötülemeden sonra bunu da söylemek zorundayım :) Burada son olarak şunu da eklemekte fayda var; Maven tabanlı projeler üzerinde çalıştığımız için kod yazmak için hangi IDE ‘yi kullandığınızın bir önemi yok. Ama eklentiyi çalıştırmak ve kurmak için muhakkak terminale döneceğiz.

JIRA Eklentileri

JIRA eklentileri tekil bir jar dosyası, xml tabanlı bir eklenti tanımlayıcısı ve önyüzlerin oluşturulması için de Apache Velocity dosyalarında oluşur.

Burada eklentinin gerçek anlamda gerekli tek noktası eklenti tanımlayıcısıdır. Eklenti jar dosyasının kök dizininde bulunur ve adı atlassian-plugin.xml ‘dir. Eklenti tanımlayıcısının genel görüntüsü aşağıdaki gibidir.

<!-- eklenti anahtarı(key) eşsiz bir değerde olmalıdır. Eklentinin paket ismi gibi düşünülebilir. -->
<atlassian-plugin key="com.atlassian.plugin.sample" name="Sample Plugin" plugins-version="2">
    <!-- Eklentinin tanımlarının yapıldığı kısa blok -->
    <plugin-info>
        <description>Eklenti açıklaması</description>
        <!-- Eklenti versiyon numarası -->
        <version>1.1</version>
        <!-- Eklenti sağlayıcısı hakkında detaylı bilgiler -->
        <vendor name="Atlassian Software Systems Pty Ltd" url="http://www.atlassian.com"/>
    </plugin-info>
</atlassian-plugin>

Her eklenti kendine has(eşsiz) bir anahtara ada sahiptir(key). Bu anahtar ad semantik olarak java paket ismine benzetilebilir. Zaten varsayılan olarak ta paket ismi ile aynı olur. 

Eklentiler de kendi içerisinde modüllerden oluşur. Bu modüller de birer eşsiz anahtara sahiptiler. Modüllere ait bu eşsiz anahtarlar da java sınıf isimleri ile aynı yapıdadırlar. 

Bu iki eşsiz anahtar birleştirilerek eklenti modülünün tam anahtarı oluşturulur. Örneğin eklenti anahtarımız “com.atlassian.plugin.sample” ve modül anahtarımızda “MyReport” olsun. Bu durumda modülün tam anahtarı “com.atlassian.plugin.sample:MyReport” şeklinde olacaktır.

Her eklenti -JIRA jargonuna göre- Plugin1 ya da Plugin2 tiplerinden birine tabiidir.