Jira Entegrasyonu
Ne İşe Yarar?
- Portal ile Jira arasında REST bağlantısını (URL, kullanıcı, API token) yönetir
- Klasik Jira talep formunun (
/jira-issue) proje, issue tipi, label ve custom field eşlemesini sağlar - Destek sağlayıcısı Jira seçildiğinde Features bayrağıyla birlikte çalışır
- Destek Paketleri’nden bağımsızdır
Kimler Kullanır?
- Portal Yöneticileri: Jira bağlantısını kurmak ve test etmek için
- Destek / ITSM Ekipleri: Taleplerin doğru Jira projesine düşmesini sağlamak için
Ekrana Erişim
- Portal → Settings → Jira Integration (
/admin/portal-jira-config) - Bağlantı kaydı
JiraConfigkoleksiyonundadır (aktif portal kapsamında) - Save and Deploy ile kaydedilir
bilgi
Bu sayfa bağlantı ve klasik Jira form ayarlarıdır. Destek modülü aç/kapa, Built-in vs Jira sağlayıcı seçimi ve Built-in SLA/kategori alanları Portal → Settings → Portal → Destek sekmesindedir. Operasyon: Destek Talepleri.
Built-in ve Jira birlikte nasıl çalışır?
Features → enableJiraIntegration ──► Support sağlayıcı olarak JIRA seçilebilir
└──► Portal’da jira-issue (Support Request) sayfası seed edilebilir
Jira Integration (bu sayfa) ──► URL / auth / project / type / labels / custom fields
└──► Portal /jira-issue oluşturma + liste
Destek sekmesi (supportEnabled) ──► Portal “Support” menüsü görünür
supportProvider ──► Support menü hedefi: /support-ticket (Built-in) veya /jira-issue (Jira)
| Ayar | Rolü |
|---|---|
Features → Jira Integration (enableJiraIntegration) | Jira sağlayıcının seçilebilmesi için zorunlu; kapanınca provider Built-in’e düşer |
| Destek → Enable + Provider | Support menüsünü açar; hedef route’u belirler |
| Bu sayfa (JiraConfig) | Klasik /jira-issue formunun kullandığı bağlantı |
uyarı
İki farklı akış vardır:
- Built-in Support (
/support-ticket): Talepler Apinizer’da saklanır; Manager Support Tickets ile yönetilir. - Portal Support menüsü → Jira (
/jira-issue): Kullanıcı klasik Jira formunu kullanır; issue doğrudan Jira’da açılır. Bu yolda ApinizerSupportTicketkaydı oluşturulmaz.
“Her talep her zaman Apinizer’da tutulur” ifadesi Jira menü yönlendirmesi için geçerli değildir.
Entegrasyon Alanları
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Status | — | Active/Passive. UI “Connected” rozeti için status === true ve URL dolu olması kullanılır; klasik create yolu status’ü REST gate olarak zorunlu kılmaz |
| Jira API Url | Evet | Örn. https://your-org.atlassian.net (sonunda / olmadan). Cloud’ta description ADF formatına gidebilir |
| Description | UI’da required sınıfı olabilir | Yalnızca yönetici notu; Jira’ya gitmez |
| Username | Evet | Atlassian e-posta |
| API Token | Evet | Basic Auth şifresi |
| Project Key | Evet | Klasik /jira-issue create’te kullanılır |
| Issue Type | Evet | Örn. Task |
| Category Custom Field ID | Hayır | Portal kategori → Jira custom field |
| API Product Custom Field ID | Hayır | |
| API Product Endpoint Custom Field ID | Hayır | |
Jira Label (labelList) | Hayır | Enter ile ekle; tablo ile sil |
Destek sekmesindeki Support project key / Issue type / Status mapping alanları bu tablodan ayrıdır; Support Ticket API / mapping için kullanılır. Navbar Jira’ya /jira-issue yönlendirdiğinde pratikte bu sayfadaki Project Key / Issue Type geçerlidir.
Kurulum Özeti
- Atlassian’da API token üretin.
- Features → Jira Integration’ı açın.
- Bu sayfada URL, kullanıcı, token, Project Key, Issue Type’ı kaydedin (Save and Deploy).
- Destek sekmesinde modülü açın ve sağlayıcıyı Jira Integration seçin (veya Built-in’de kalın).
- Portal’da Support menüsünden akışı doğrulayın.
Custom field ID bulma: Atlassian Custom Fields.
Eski İsimler
| Eski ifade | Güncel |
|---|---|
| Portal Jira Config | Settings → Jira Integration |
| Portal menü “Support Requests” | Support ve/veya seed Support Request (jira-issue) |
İlgili Sayfalar
- Destek Talepleri
- API Portal Ayarları (Features + Destek)