Entegrasyonlar: Jira, Xray, Azure DevOps, Slack ve Telegram

Nexus Studio beş hizmete bağlanır: Jira Cloud, Xray Cloud, Azure DevOps, Slack ve Telegram. Siz açana kadar her biri kapalıdır ve her birine sunucularımız üzerinden değil, doğrudan makinenizden erişilir. Bu sayfada her birinin ne yaptığı, hangi anahtarları okuduğu ve neleri asla yapmadığı açıklanır.

Nexus Studio ekibi, Verdict System LLC tarafından. 9 Ekim 2026.

Tüm entegrasyonlar nasıl çalışır

• Siz açana kadar kapalıdır. Her hizmetin kendi anahtarı vardır: JIRA_ENABLED, XRAY_ENABLED, AZURE_BOARDS_ENABLED, SLACK_ENABLED ve TELEGRAM_ENABLED. Hepsi varsayılan olarak false değerindedir.
• Doğrudan makinenizden. Motor, testlerin çalıştığı makineden her hizmetin kendi API'sini çağırır. Hiçbir şey sunucularımız üzerinden geçmez; sorun kayıtlarınızı, uyarılarınızı veya sonuçlarınızı asla görmeyiz.
• Anahtarlar çalışma alanında kalır. Belirteçler ve anahtarlar, diskinizdeki çalışma alanının .env dosyasında satırlar halinde saklanır. Ayarlar bölümündeki Entegrasyonlar altında bunları düzenleyebilirsiniz; tüm belirteçler, anahtarlar ve webhook'lar maskelenmiş olarak gösterilir.
• Deneme ortamındaki çalıştırmalar kapsam dışıdır. Deneme ortamında yapılan bir çalıştırma, geliştirilmekte olan bir testtir, bir bulgu değildir: asla sorun kaydı açmaz, kayda yorum eklemez veya kaydı kapatmaz.

Test başarısız olmaya devam ettiği sürece test başına tek sorun kaydı

Jira ve Azure Boards aynı yaşam döngüsünü izler. Sorun kaydı çalıştırmaya değil, teste aittir; dolayısıyla her gece başarısız olan bir test için her gece yeni bir kayıt açılmaz, geçmişi olan tek bir kayıt tutulur.

1. İlk başarısızlık bir sorun kaydı açar. BREACHED, BREACHED_FLAKY, CHAOS_BREACHED veya TIMEOUT durumuyla biten bir çalıştırma, ilgili test için hata ve başarısızlığın ekran görüntüsü eklenmiş bir sorun kaydı açar.
2. Tekrarlanan başarısızlık kayda yorum ekler. Bu sorun kaydı açıkken bir sonraki başarısızlık, yeni ekran görüntüsünü ekleyerek kayda yorum bırakır. Aynı anda başarısız olan iki tarayıcı da aynı kayda ekleme yapar.
3. Sorunsuz bir başarı kaydı kapatır. Test, bir çalıştırmadaki tüm tarayıcılarda sorunsuz geçtiğinde, sorun kaydına bunu belirten bir yorum eklenir ve kayıt tamamlanmış durumuna geçirilir. İş akışında böyle bir geçiş veya durum yoksa yalnızca yorum eklenir.
4. Bundan sonraki bir başarısızlık yeni bir sorun kaydı açar. Sorun kaydı silinmiş veya taşınmış bir başarısızlık da yeni kayıt açar.

Ekler: varsayılan olarak yalnızca ekran görüntüsü. Playwright izi ve çalıştırma günlüğü de ancak Ayarlar bölümünde NEXUS_ISSUE_ATTACH_TRACE=true ile izin verirseniz eklenir; çünkü bunlar çerezler, yetkilendirme başlıkları ve yazılan parolalar gibi oturum verileri içerebilir. Her dosya en fazla 10 MB boyutundaysa eklenir.

FLAKY hiçbir zaman kayıt açmaz: başarısız olup yeniden denemede geçen bir çalıştırma, bir yazılım hatası değildir. Uygulamanızla değil ortamla ilgili olan BLOCKED, UNREACHABLE, CRASHED veya yapılandırma hataları da kayıt açmaz (sonuç kararları nasıl verilir). Hangi sorun kaydının hangi teste ait olduğu, çalışma alanındaki evidence/integrations/issue-map.json dosyasında tutulur.

Jira Cloud

• Bağlanın: Atlassian hesabınızın e-posta adresi ve id.atlassian.com adresinde oluşturulmuş bir API belirteci gerekir. Ayarlar bölümünde, Entegrasyonlar altında Jira sitenizden herhangi bir bağlantıyı yapıştırın: Studio siteyi ve proje anahtarını saklar. Site adresi olan JIRA_BASE_URL, https kullanmalıdır. Bağlantıyı kontrol et bunları sınar ve hiçbir şey oluşturmaz.
• Sorun kayıtları: yukarıdaki yaşam döngüsüne uygun olarak JIRA_PROJECT_KEY projesinde bir Bug oluşturulur. Test sorunsuz geçtiğinde, sorun kaydı JIRA_DONE_TRANSITION içinde belirtilen geçişten geçirilir; varsayılan değer Done olup ad eşleştirmesi büyük/küçük harfe duyarsızdır.
• Yinelenen kayıt yok: son 24 saat içinde aynı özetle bir Bug oluşturulduysa ikinci bir kayıt açılmaz.
• Elle: Evidence Locker, siz istediğinizde bir başarısızlığı Jira'ya gönderebilir.

Xray Cloud

XRAY_ENABLED=true olduğunda her nexus ci çalıştırması, JUnit XML dosyasını Xray Cloud'a bir Test Execution olarak aktarır. Aktarım XRAY_PROJECT_KEY projesine veya bu alan boşsa JIRA_PROJECT_KEY projesine yapılır; XRAY_TEST_PLAN_KEY içinde bir Test Plan belirtirseniz onun altında yer alır.

• Bağlanın: Jira'da Uygulamalar, Xray, Genel ayarlar, API anahtarları altında oluşturulmuş bir API anahtar çifti gerekir: XRAY_CLIENT_ID ve XRAY_CLIENT_SECRET.
• Dışarı gönderilenler: yalnızca o çalıştırmanın JUnit dosyası. Önceki bir çalıştırmadan kalan JUnit dosyası asla içe aktarılmaz.
• Çalıştırmayı asla başarısız kılmaz: içe aktarma başarısız olursa, nedeni çalıştırma günlüğünde tek satırda belirtilir ve gizli bilgi gizlenir.

Azure DevOps: Boards, Test Plans ve Pipelines

AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> veya https://<org>.visualstudio.com) ve AZURE_DEVOPS_PROJECT ile yapılandırılan tek bir kişisel erişim belirteci (PAT) ve tek bir proje. PAT yalnızca Azure DevOps'un kendi sunucularına gönderilir ve hiçbir günlük satırında görünmez. Ayarlar'da, Entegrasyonlar altındaki Azure DevOps'a bağlan seçeneği projeyi ve iş öğesi türünü denetler, hiçbir şey oluşturmaz.

• Azure Boards: AZURE_BOARDS_ENABLED=true olduğunda, bir başarısızlık yukarıdaki yaşam döngüsünü izleyerek AZURE_BOARDS_WORK_ITEM_TYPE türünde, varsayılan olarak Bug, bir iş öğesi açar. Sorunsuz bir başarı durumunda öğe, AZURE_BOARDS_DONE_STATE ile belirtilen duruma, varsayılan olarak Resolved durumuna geçer; bu durumu kabul etmeyen bir süreçte yalnızca yorum eklenir. PAT için Work Items (Okuma & yazma) izni gerekir. Evidence Locker üzerinden de Azure Boards'a elle bir başarısızlık gönderilebilir.
• Azure Test Plans: CI/CD ekranının oluşturduğu azure-pipelines.yml, çalıştırmanın JUnit XML dosyasını PublishTestResults@2 göreviyle yayımlar; böylece her işlem hattı çalıştırması Test Plans içindeki Çalıştırmalar altında görünür.
• Azure Pipelines: nexus ci-remote --provider=azure, AZURE_PIPELINE_ID ile belirtilen işlem hattında bir çalıştırmayı kuyruğa alır, tamamlanmasını bekler ve JUnit XML dosyasını bu makineye getirir. Bunun için PAT'nin Build (Okuma & yürütme) iznine sahip olması gerekir.

Slack

• Bağlanma: SLACK_WEBHOOK_URL içinde tek bir Gelen Webhook URL'si. Ayarlar'da Test mesajı gönder düğmesi bulunur.
• Aldıkları: Block Kit mesajları: çalıştırma özeti ve NEXUS_SLACK_NOTIFY=true olduğunda başarısız olan, tutarsız sonuç veren, kaos veya görsel regresyon testlerinin her biri için bir mesaj. Başarısızlıkla ilgili mesaj, varsa ilgili Jira kaydının bağlantısını içerir.
• Elle: Evidence Locker, bir başarısızlığın metin özetini Slack'e gönderebilir. Slack'e dosya gönderilmez.

Telegram

• Bağlanma: @BotFather ile bir kez oluşturduğunuz, size ait bir bot, TELEGRAM_TOKEN içinde tanımlanır. Ayarlar'daki QR ile bağlan seçeneği sohbetinizi eşleştirir ve TELEGRAM_CHAT_ID alanını doldurur. Ortak kullanılan bir bot yoktur.
• Aldıkları: başarısızlık uyarıları, NEXUS_TELEGRAM_NOTIFY=true olduğunda test başına bir uyarı ve Studio'dan paylaşmayı seçtiğiniz raporlar ile dosyalar.
• Etkinleştirmeden önce: Telegram, rapor ve PDF gibi dosyaları alabilir ve bu dosyalar Telegram'ın sunucularına gönderilir. Mevzuata tabi bir ortamda, önce uyumluluk ekibinize danışın.

Anahtarlar

Her anahtar, çalışma alanının .env dosyasında bir satırdır. Tümü Ayarlar'dan düzenlenebilir.

Bir işlem hattında, AZURE_PIPELINE_ID dışındaki aynı anahtarlar işlem hattının gizli değişkenleridir; bir anahtarı ayarlamazsanız ilgili hizmet kapalı kalır (CI/CD'de gizli bilgiler).

Sorular

Nexus Studio, Jira veya Azure DevOps verilerimi görüyor mu?

Hayır. Motor, sizin makinenizden, sizin anahtarlarınızla Jira, Xray, Azure DevOps, Slack ve Telegram ile iletişim kurar. Bu verilerin hiçbiri sunucularımızdan geçmez.

Kararsız bir test destek kaydı açar mı?

Hayır. FLAKY hiçbir kayıt açmaz. BREACHED_FLAKY ise açar: hatanın kendisi tutarsızdır ve yeniden deneme bunu gizlemez.

Bir test bu hafta 30 kez başarısız oldu. Bu kaç iş kaydı demek?

Bir tane; test tüm tarayıcılarda sorunsuz geçene kadar, ilkinden sonraki her başarısızlık için bir yorum ve yeni bir ekran görüntüsü eklenir.

Jira ve Azure Boards'u aynı anda kullanabilir miyim?

Evet. Her biri, her test için kendi iş kaydını tutar.