Jira Cloud

Kayıt için Jira issue açar ve iki tarafı eşitler: kayıt yorumları ve durum değişiklikleri issue'ya, Jira yorumları ve durum değişiklikleri kayda gider. Issue anahtarı kaydın Bağlantılar sekmesinde görünür.

Kurulum

1. Jira'da issue açacak hesap için bir API token oluşturun (Atlassian hesabı → Security → API tokens → Create API token).

   Düz Create API token seçeneğini kullanın, Create API token with scopes değil. Kapsamlı jeton yalnız api.atlassian.com üzerinde kimlik doğrular; site adresiniz onu reddeder ve e-posta ile jeton doğru olsa bile kurulum kimlik hatası verir.

2. Stoneity'da Ayarlar → Uygulamalar → Marketplace → Jira Cloud → Kur yolunu izleyip şunları doldurun:

   • Site adresi — örn. https://acme.atlassian.net
   • Jira kullanıcısının e-postası ve API token'ı
   • Proje anahtarı — örn. SUP
   • Konu türü — projenizde göründüğü gibi yazın. Jira bu adları çeviriyor; Türkçe projede Task yoktur, Görev vardır. Sayısal konu türü kimliği de kabul edilir ve dile göre değişmez. Yanlış değer kurulum sırasında yakalanır, geçerli olanlar listelenir.
   • Olaylar ve isteğe bağlı panolar

3. Kaydedin. Kurulum etkinleşmeden önce Stoneity GET /rest/api/3/myself ile kimlik bilgilerini doğrular.

4. Kurulu uygulamalar altında Test ile bağlantıyı sınayın.

Jira değişikliklerini geri getirmek

1. Kurulu uygulamalar → Jira Cloud → Ayarlar altındaki gelen istek adresini kopyalayın.
2. Jira'da Ayarlar → Sistem → Webhooks → Create a WebHook ile adresi yapıştırın ve Comment: created, Issue: updated, Issue: deleted olaylarını seçin. project = SUP gibi bir JQL filtresi trafiği azaltır.

Atanan ve öncelik

Yorum ve durumun ötesini aktaran iki isteğe bağlı ayar var:

• Jira'daki atananı yansıt, Jira kullanıcısını e-posta adresiyle eşleştirir. Jira gizlilik ayarı adresi gizleyebilir; öyleyse değişiklik atlanır ve sebebi teslimat geçmişine yazılır, sessizce kaybolmaz.

• Öncelik eşlemesi, öncelik başına bir satır alır: Jira önceliği = kayıt önceliği

  Highest = Kritik
  High = Yüksek
  Medium = Normal
  Low = Düşük

  Sağ taraf hem saklanan değeri hem panoda görünen etiketi kabul eder. Satırı olmayan Jira önceliği değiştirilmez. Kutuyu boş bırakırsanız öncelik hiç aktarılmaz.

3. İsterseniz Jira'da bir secret tanımlayıp aynı değeri kurulum ayarlarına girin. Stoneity o zaman her istekte eşleşen bir X-Hub-Signature arar.

Davranış

Değişiklik	Sonuç
Kayıt açıldı	POST /rest/api/3/issue — özet [#numara] başlık, açıklamada kayıt gövdesi ve dönüş bağlantısı
Kayda yorum eklendi	Bağlı issue'ya yorum
Kayıt durumu değişti	Bağlı issue'ya yorum
Jira'da yorum eklendi	Kayda iç not
Jira'da durum değişti	Kayda iç not, bağlantıda yeni durum görünür
Jira'da atanan değişti	Açtıysanız kayıt, eşleşen Stoneity kullanıcısına atanır
Jira'da öncelik değişti	Eşleme tanımladıysanız kaydın önceliği ona göre değişir
Issue Done grubuna geçti	Not, ya da seçtiyseniz kaydı çözer
Issue silindi	Bağlantı silinmiş olarak işaretlenir

Bir kayıt için issue açıldığında dış bağlantı olarak saklanır; aynı kayıt için sonraki oluşturma olayları atlanır.

Notlar

• Jira'dan gelen notlar uygulamanın kendi servis hesabıyla yazılır ve o hesabın yazdığı yorumlar Jira'ya geri gönderilmez; böylece iki sistem birbirini tekrarlamaz.
• Kimlik bilgileri şifreli saklanır. Token yenilemek için kurulumu düzenlemek yeterlidir.
• Jira'dan dönen 4xx yanıtı (yanlış proje anahtarı, yetki eksikliği) kalıcı sayılır, yeniden denenmez; nedeni teslimat geçmişinde görünür.