Entegrasyonlar: Jira, Azure DevOps, GitHub Issues, Slack, Teams ve Telegram
Nexus StudioQA altı hizmete bağlanır: Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams ve Telegram. Her biri siz etkinleştirene kadar kapalıdır ve her birine doğrudan makinenizden erişilir, asla sunucularımız üzerinden değil. Bu sayfa her birinin ne yaptığını, hangi anahtarları okuduğunu ve neleri asla yapmadığını açıklar.
Son güncelleme:
Nexus StudioQA 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,AZURE_BOARDS_ENABLED,GITHUB_ISSUES_ENABLED,SLACK_ENABLED,TEAMS_ENABLEDveTELEGRAM_ENABLED. Hepsinin varsayılan değerifalseolarak ayarlanmıştır. - 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
.envdosyası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, Azure Boards ve GitHub Issues aynı yaşam döngüsünü izler ve Kayıtlar ayarları her adımı değiştirebilir. Sorun kaydı çalıştırmaya değil teste aittir; dolayısıyla her gece başarısız olan bir test, her gece yeni bir kayıt oluşturmak yerine geçmişi olan tek bir kayıt olarak tutulur.
- İ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.
- 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.
- 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.
- 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.
Adım adım kılavuzlar
Her kılavuzda nelere ihtiyacınız olduğu, kimlik bilgilerinin nasıl alınacağı ve bağlantının çalıştığının nasıl kontrol edileceği açıklanır; yaygın hatalar, nedenleri ve çözümleriyle birlikte listelenir.
- Jira Cloud'u bağlayın
- Azure Boards'u bağlayın
- GitHub Issues'a bağlan
- Slack'i bağlayın
- Microsoft Teams'i bağlayın
- Telegram'ı bağlayın
Başarısızlık bildirimleri için daha fazla hedef
Beş ek hedef de yukarıdaki hizmetlerle aynı kuralları izler. Her biri siz etkinleştirene kadar kapalıdır ve her birine kendi anahtarınızla doğrudan makinenizden erişilir.
- Linear: seçtiğiniz ekipte başarısız olan her test için bir kayıt açılır; başarısızlık tekrarlanırsa kayda yorum eklenir, test sorunsuz geçerse kayıt ilk tamamlanmış durumuna taşınır. Anahtarlar:
LINEAR_ENABLED,LINEAR_API_KEYveLINEAR_TEAM_ID. - GitLab Issues: aynı yaşam döngüsü bir GitLab projesinde uygulanır; test sorunsuz geçerse kayıt kapatılır, başarısızlık tekrarlanırsa yeniden açılır. Anahtarlar:
GITLAB_ISSUES_ENABLED,GITLAB_ISSUES_TOKENveGITLAB_ISSUES_PROJECT. Belirteç yalnızca https üzerinden iletilir. - PagerDuty: bir başarısızlık olay kaydı oluşturur; başarısızlık tekrarlanırsa aynı kayda eklenir, test sorunsuz geçerse olay çözümlenir. Anahtarlar:
PAGERDUTY_ENABLEDvePAGERDUTY_ROUTING_KEY. - Opsgenie: aynı yaşam döngüsü bir uyarı olarak uygulanır; test sorunsuz geçerse uyarı kapatılır. Anahtarlar:
OPSGENIE_ENABLEDveOPSGENIE_API_KEY. - TestRail: her çalıştırmanın sonucunu, testin
// nexus:testrail C123yorumuyla belirttiği test senaryosuna işler. Anahtarlar:TESTRAIL_ENABLED,TESTRAIL_URL,TESTRAIL_USER,TESTRAIL_API_KEYveTESTRAIL_PROJECT_ID.
Kök nedene göre grupla, Talep ayarlarındaki bir kuraldır ve varsayılan olarak kapalıdır. Açıkken, zaten açık kaydı bulunan bir testle aynı hatayı veren bir başarısızlık, ikinci bir kayıt açmak yerine mevcut kayda yorum ekler. Gruplanan testin sorunsuz geçmesi ise ilk testin kaydını hiçbir zaman kapatmaz.
Bir yapay zekâ asistanından size yol göstermesini isteyin
Herhangi bir yapay zekâ asistanı bu kılavuzlarda size adım adım yol gösterebilir. Asistana bir kılavuzun adresini veya tüm anahtarları, geçerli biçimlerini, nasıl kontrol edileceklerini ve her hatayı nedeni ve çözümüyle birlikte listeleyen integrations-guide.json dosyasının adresini verin.
- Sohbete asla erişim belirteci, anahtar, parola veya webhook URL'si yapıştırmayın. Kimlik bilgilerinizi yalnızca Studio'da, Ayarlar, Entegrasyonlar bölümüne girin. Bir asistan bunlara hiçbir zaman ihtiyaç duymaz.
- Yalnızca gizli olmayan bilgileri paylaşın: site adresi, proje adı ve Studio'nun gösterdiği hata satırının aynısı.
- Kanıt, Studio'nun kendi kontrolüdür. Bağlantının çalışıp çalışmadığını asistan değil; Bağlantıyı kontrol et, Test mesajı gönder ve Test kaydı oluştur işlemleri gösterir.
- Bir sohbete kimlik bilgisi yapıştırdıysanız, ilgili hizmette bu bilgiyi iptal edip yenisini oluşturun.
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_KEYprojesinde bir Bug oluşturulur. Test sorunsuz geçtiğinde, sorun kaydıJIRA_DONE_TRANSITIONiç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.
- Birden fazla Jira sitesi: Kayıtlar altında Başka bir Jira sitesi ekle, kendi sitesi, proje anahtarı ve sorun türü olan bir hedef ekler. Etkinleştirilen her hedef için ayrı bir kayıt oluşturulur. Site, https://<name>.atlassian.net biçiminde bir Atlassian Cloud adresi olmalıdır ve tek bir Atlassian e-posta adresi ile API belirteci, o hesabın tüm siteleri için kullanılır. Belirteç yalnızca listelediğiniz sitelere gönderilir.
- Elle: Evidence Locker, siz istediğinizde bir başarısızlığı Jira'ya gönderebilir.
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=trueolduğunda, bir başarısızlık yukarıdaki yaşam döngüsünü izleyerekAZURE_BOARDS_WORK_ITEM_TYPEtüründe, varsayılan olarak Bug, bir iş öğesi açar. Sorunsuz bir başarı durumunda öğe,AZURE_BOARDS_DONE_STATEile 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@2gö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_IDile 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.
GitHub Issues
- Bağlanın:
GITHUB_ISSUES_TOKENalanına, tek bir depoda Issues (Okuma ve yazma) iznine sahip, ayrıntılı yetkilendirilmiş bir kişisel erişim belirteci;GITHUB_ISSUES_REPOalanına ise sahip/depo biçiminde depoyu girin. Ayarlar'da, Entegrasyonlar altındaki GitHub Issues'a bağlan, belirtecin kime ait olduğunu gösterir ve yalnızca belirtecin erişebildiği, Issues özelliği açık olan depoları sunar (adım adım kılavuz). - Sorunlar:
GITHUB_ISSUES_ENABLED=trueolduğunda, bir başarısızlık, yukarıdaki yaşam döngüsünü izleyerek kaydın etiketleriyle bir sorun açar. Testler sorunsuz geçtiğinde soruna bir yorum eklenir ve sorun tamamlandı olarak kapatılır. - Başka bir depo: Kayıtlar altında bir GitHub hedefi,
.enviçindekinden farklı bir sahip/depo belirtebilir.
Slack
- Bağlanma:
SLACK_WEBHOOK_URLiç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=trueolduğ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.
Microsoft Teams
- Bağlanın:
TEAMS_WEBHOOK_URLalanına bir kanal için tek bir Workflows webhook URL'si girin. Teams Workflows, bir Microsoft 365 iş veya okul hesabı gerektirir. Ayarlar'da Kaydet & test gönder seçeneği bulunur (adım adım kılavuz). - Aldığı içerik: Slack'e gönderilen mesajların aynısı, Adaptive Cards biçiminde: çalıştırma özeti ve
NEXUS_TEAMS_NOTIFY=trueolduğunda başarısız, kararsız, kaos veya görsel regresyon testlerinin her biri için bir mesaj. - URL'nin gönderildiği yer: yalnızca Microsoft'un kendi webhook sunucularındaki bir https adresi (logic.azure.com, webhook.office.com, api.powerplatform.com). Diğer tüm URL'ler reddedilir ve hiçbir şey gönderilmez.
Telegram
- Bağlanma: @BotFather ile bir kez oluşturduğunuz, size ait bir bot,
TELEGRAM_TOKENiçinde tanımlanır. Ayarlar'daki QR ile bağlan seçeneği sohbetinizi eşleştirir veTELEGRAM_CHAT_IDalanını doldurur. Ortak kullanılan bir bot yoktur. - Aldıkları: başarısızlık uyarıları,
NEXUS_TELEGRAM_NOTIFY=trueolduğ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.
Kayıtlar: ne zaman açılırlar, ne içerirler, nereye gönderilirler
Ayarlar'da, Entegrasyonlar altındaki İş Kayıtları ekranı, bir test başarısız olduğunda Jira, Azure Boards veya GitHub Issues üzerinde hangi bilgilerin kaydedileceğini belirler. Evidence Locker'daki Paylaş özelliği de aynı şablonu kullanır. Ayarlar, çalışma alanındaki nexus-tickets.config.json dosyasına kaydedilir; bu dosya gizli bilgi içermez ve kod deponuzda tutulabilir. Dosya yoksa iş kayıtları yukarıda açıklandığı gibi çalışır. Dosya geçersizse varsayılanlar uygulanır ve nedeni günlükte belirtilir.
- Ne zaman: hangi sonuçların iş kaydı açacağı (varsayılan olarak BREACHED ve TIMEOUT), kayıt açılmadan önce art arda kaç başarısızlık gerektiği, çalıştırma başına üst sınır, yerel çalıştırmalar mı, CI çalıştırmaları mı yoksa her ikisi mi, dahil edilecek veya hariç tutulacak test kimlikleri, sorunsuz bir geçişte ne yapılacağı (kapatma, yalnızca yorum ekleme veya hiçbir şey yapmama) ve tekrarlayan bir başarısızlıkta yeni kayıt açmak yerine kapalı kaydın yeniden açılıp açılmayacağı.
- Ne:
{type},{testId},{browser}ve{error.firstLine}içeren başlık şablonu. Başlık, 24 saat boyunca yinelenen kayıtları belirleyen anahtar olduğundan{testId}zorunludur. Ayrıca hangi açıklama bölümlerinin hangi sırayla gönderileceği, hata metninin ne kadarının gönderileceği, etiketler, sonuca göre öncelik, atanan kişi, bileşen, özel alanlar ve ekip notu. - Ekler: varsayılan olarak ekran görüntüsü. İz kaydı, video ve rapor ise yalnızca işaretlerseniz eklenir; her biri boyut sınırına tabidir.
- Nereye: her takip sistemi için ayrı ayrı açılıp kapatılabilen bir hedef. Bir hedef, Jira sitesini, projesini ve kayıt türünü, GitHub deposunu veya Azure iş öğesi türünü geçersiz kılabilir.
- Önizleme ve test: ekran, kaydetmeden önce her hedef için en son başarısızlığınızın oluşturacağı iş kaydını gösterir. Test kaydı oluştur, bu önizlemeden
nexus-testetiketli gerçek bir iş kaydı oluşturur.
Bir kaydın asla içermediği bilgiler
- Yalnızca işaretledikleriniz. Seçmediğiniz bölümler veya ekler makinenizde kalır.
- Önce gizli bilgiler maskelenir. Her metin satırı kaydedilmeden önce bir gizleme adımından geçer: yetkilendirme ve çerez başlıkları, bearer ve basic belirteçleri, JWT'ler, bilinen sağlayıcı anahtarı biçimleri, URL'lerdeki parolalar ve adı gizli bilgiye işaret eden alanların değerleri. Bu işlem, günlüklerde ve hatalarda gizli bilgilerin genellikle aldığı biçimleri yakalar; serbest metindeki her gizli bilgiyi yakalayamaz, bu nedenle ihtiyacınız olmadıkça iz kaydını kapalı tutun.
- Dosyada belirteç bulunmaz.
nexus-tickets.config.json, adı gizli bilgiye işaret eden tüm alanları ve kullanıcı adı ile parola içeren tüm URL'leri reddeder. Belirteçler.envdosyasında kalır.
Anahtarlar
Her anahtar, çalışma alanının .env dosyasında bir satırdır. Tümü Ayarlar'dan düzenlenebilir.
| Hizmet | Anahtarlar | Varsayılanlar |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | Kapalı; proje QA; geçiş Done |
| Azure DevOps | AZURE_BOARDS_ENABLED, AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PAT, AZURE_BOARDS_WORK_ITEM_TYPE, AZURE_BOARDS_DONE_STATE, AZURE_PIPELINE_ID | Kapalı; tür Hata; durum Çözüldü |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | Kapalı |
| İş kaydı ekleri | NEXUS_ISSUE_ATTACH_TRACE | Kapalı: yalnızca ekran görüntüsü |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | Kapalı |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | Kapalı |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | Kapalı |
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 StudioQA, Jira veya Azure DevOps verilerimi görüyor mu?
Hayır. Motor, Jira Cloud, Azure DevOps, GitHub Issues, Slack, Teams ve Telegram ile makinenizden, sizin anahtarlarınızla iletişim kurar. Bu iletişimin 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, Azure Boards ve GitHub Issues'ı aynı anda kullanabilir miyim?
Evet. Her biri, her test için kendi iş kaydını tutar; eklenen her Jira sitesi de aynı şekilde çalışır.