Integracje: Jira, Azure DevOps, GitHub Issues, Slack, Teams i Telegram
Nexus StudioQA łączy się z sześcioma usługami: Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams i Telegram. Każda z nich jest wyłączona, dopóki jej nie włączysz, a połączenie z każdą odbywa się bezpośrednio z Twojego komputera, nigdy przez nasze serwery. Ta strona wyjaśnia, co robi każda z nich, jakie klucze odczytuje i czego nigdy nie robi.
Ostatnia aktualizacja:
Autor: zespół Nexus StudioQA, Verdict System LLC. 9 października 2026.
Jak działa każda integracja
- Wyłączone, dopóki ich nie włączysz. Każda usługa ma własny przełącznik:
JIRA_ENABLED,AZURE_BOARDS_ENABLED,GITHUB_ISSUES_ENABLED,SLACK_ENABLED,TEAMS_ENABLEDiTELEGRAM_ENABLED. Każdy ma domyślnie wartośćfalse. - Bezpośrednio z Twojego komputera. Silnik wywołuje API każdej usługi z komputera, na którym uruchamiane są testy. Nic nie przechodzi przez nasze serwery i nigdy nie widzimy Twoich zgłoszeń, alertów ani wyników.
- Klucze pozostają w obszarze roboczym. Tokeny i klucze są zapisane jako wiersze w pliku
.envobszaru roboczego, na Twoim dysku. W Ustawieniach, w sekcji Integracje, możesz je edytować, a wszystkie tokeny, klucze i webhooki są wyświetlane w zamaskowanej postaci. - Uruchomienia w piaskownicy są pomijane. Uruchomienie w piaskownicy to test w trakcie tworzenia, a nie wykryty problem: nigdy nie tworzy zgłoszeń, nie komentuje ich ani nie zamyka.
Jedno zgłoszenie na test, dopóki test się nie powiedzie
Jira, Azure Boards i GitHub Issues stosują ten sam cykl życia, a ustawienia Zgłoszenia pozwalają zmienić każdy jego etap. Zgłoszenie jest przypisane do testu, nie do przebiegu, więc test kończący się niepowodzeniem co noc to jedno zgłoszenie z historią, a nie nowe zgłoszenie każdej nocy.
- Pierwsze niepowodzenie otwiera jedno zgłoszenie. Uruchomienie zakończone statusem BREACHED, BREACHED_FLAKY, CHAOS_BREACHED lub TIMEOUT otwiera jedno zgłoszenie dla danego testu, z opisem błędu i załączonym zrzutem ekranu z momentu niepowodzenia.
- Kolejne niepowodzenie dodaje do niego komentarz. Dopóki zgłoszenie jest otwarte, następne niepowodzenie dodaje do niego komentarz z nowym zrzutem ekranu w załączniku. Niepowodzenia w dwóch przeglądarkach jednocześnie trafiają do tego samego zgłoszenia.
- Pełne powodzenie zamyka zgłoszenie. Gdy test przejdzie bez problemów we wszystkich przeglądarkach w danym uruchomieniu, do zgłoszenia trafia odpowiedni komentarz i zostaje ono przeniesione do stanu zakończonego. Jeśli przepływ pracy nie ma takiego przejścia lub stanu, dodawany jest tylko komentarz.
- Późniejsze niepowodzenie otwiera nowe zgłoszenie. Tak samo dzieje się w przypadku niepowodzenia, którego zgłoszenie zostało usunięte lub przeniesione.
Załączniki: domyślnie tylko zrzut ekranu. Ślad Playwright i dziennik uruchomienia są dołączane wyłącznie po wyrażeniu zgody przez ustawienie NEXUS_ISSUE_ATTACH_TRACE=true w Ustawieniach, ponieważ mogą zawierać dane sesji: pliki cookie, nagłówki autoryzacji i wpisane hasła. Każdy plik jest dołączany, jeśli nie przekracza 10 MB.
FLAKY nigdy nie tworzy zgłoszeń: uruchomienie, które zakończyło się niepowodzeniem, a następnie powiodło się przy ponownej próbie, nie oznacza błędu. Zgłoszeń nie tworzą też statusy BLOCKED, UNREACHABLE, CRASHED ani błąd konfiguracji, ponieważ dotyczą środowiska, a nie Twojej aplikacji (jak ustalane są werdykty). Powiązania zgłoszeń z testami są przechowywane w pliku evidence/integrations/issue-map.json w obszarze roboczym.
Poradniki krok po kroku
Każdy poradnik opisuje wymagania, sposób uzyskania danych uwierzytelniających i sprawdzenia działania oraz typowe błędy wraz z ich przyczynami i rozwiązaniami.
- Połącz z Jira Cloud
- Połącz z Azure Boards
- Połącz z GitHub Issues
- Połącz ze Slack
- Połącz z Microsoft Teams
- Połącz z Telegram
Więcej miejsc na zgłoszenia błędów
Pięć kolejnych miejsc docelowych działa na tych samych zasadach co powyższe usługi. Każde jest domyślnie wyłączone, a po włączeniu łączysz się z nim bezpośrednio ze swojego komputera przy użyciu własnego klucza.
- Linear: jedno zgłoszenie na każdy nieudany test w wybranym zespole. Kolejne niepowodzenie dodaje komentarz, a pomyślne przejście testu przenosi zgłoszenie do pierwszego stanu oznaczającego ukończenie. Klucze:
LINEAR_ENABLED,LINEAR_API_KEYiLINEAR_TEAM_ID. - GitLab Issues: ten sam cykl obsługi w projekcie GitLab — zgłoszenie jest zamykane po pomyślnym przejściu testu i otwierane ponownie, gdy błąd powróci. Klucze:
GITLAB_ISSUES_ENABLED,GITLAB_ISSUES_TOKENiGITLAB_ISSUES_PROJECT. Token jest przesyłany wyłącznie przez https. - PagerDuty: niepowodzenie wywołuje incydent, kolejne niepowodzenie uzupełnia ten sam incydent, a pomyślne przejście testu oznacza go jako rozwiązany. Klucze:
PAGERDUTY_ENABLEDiPAGERDUTY_ROUTING_KEY. - Opsgenie: ten sam cykl obsługi w formie alertu, zamykanego po pomyślnym przejściu testu. Klucze:
OPSGENIE_ENABLEDiOPSGENIE_API_KEY. - TestRail: zapisuje wynik każdego uruchomienia dla przypadku testowego wskazanego w teście komentarzem
// nexus:testrail C123. Klucze:TESTRAIL_ENABLED,TESTRAIL_URL,TESTRAIL_USER,TESTRAIL_API_KEYiTESTRAIL_PROJECT_ID.
Grupuj według przyczyny źródłowej to reguła w ustawieniach zgłoszeń, domyślnie wyłączona. Gdy jest włączona, niepowodzenie z takim samym błędem jak w teście, który ma już otwarte zgłoszenie, dodaje do niego komentarz zamiast tworzyć kolejne zgłoszenie. Pomyślne przejście zgrupowanego testu nigdy nie zamyka zgłoszenia pierwszego testu.
Poproś asystenta AI o pomoc krok po kroku
Dowolny asystent AI może przeprowadzić Cię przez te poradniki. Podaj mu adres poradnika lub pliku integrations-guide.json, który zawiera wszystkie klucze, ich prawidłowe formaty, sposoby sprawdzania oraz poszczególne błędy wraz z przyczynami i rozwiązaniami.
- Nigdy nie wklejaj do czatu tokena, klucza, hasła ani adresu URL webhooka. Dane uwierzytelniające wpisuj wyłącznie w Studio, w sekcji Ustawienia, Integracje. Asystent nigdy ich nie potrzebuje.
- Podawaj mu wyłącznie informacje, które nie są poufne: adres witryny, nazwę projektu i dokładny komunikat błędu wyświetlany w Studio.
- Potwierdzeniem jest wynik sprawdzenia w samym Studio. To opcje Sprawdź połączenie, Wyślij wiadomość testową i Utwórz zgłoszenie testowe pokazują, czy połączenie działa, a nie asystent.
- Jeśli dane uwierzytelniające zostały już wklejone do czatu, unieważnij je w danej usłudze i utwórz nowe.
Jira Cloud
- Połączenie: adres e-mail Twojego konta Atlassian i token API utworzony na id.atlassian.com. W Ustawieniach, w sekcji Integracje, wklej dowolny link ze swojej witryny Jira: Studio zachowa adres witryny i klucz projektu. Adres witryny,
JIRA_BASE_URL, musi używać https. Opcja Sprawdź połączenie weryfikuje te dane i niczego nie tworzy. - Zgłoszenia: zgłoszenie typu Bug w projekcie
JIRA_PROJECT_KEY, zgodnie z opisanym powyżej cyklem. Po przejściu testu bez problemów zgłoszenie przechodzi przez przejście o nazwie określonej wJIRA_DONE_TRANSITION, domyślnie Done, dopasowywanej bez rozróżniania wielkości liter. - Bez duplikatów: jeśli w ciągu ostatnich 24 godzin utworzono zgłoszenie typu Bug o tym samym podsumowaniu, drugie nie zostanie utworzone.
- Więcej niż jedna witryna Jira: w sekcji Zgłoszenia opcja Dodaj kolejną witrynę Jira dodaje miejsce docelowe z własną witryną, kluczem projektu i typem zgłoszenia. Każde włączone miejsce docelowe otrzymuje osobne zgłoszenie. Witryna musi mieć adres Atlassian Cloud, https://<name>.atlassian.net, a jeden adres e-mail Atlassian i token API obsługują wszystkie witryny tego konta. Token jest wysyłany tylko do witryn podanych na liście.
- Ręcznie: Evidence Locker może przesłać niepowodzenie do Jira, gdy tak zdecydujesz.
Azure DevOps: Boards, Test Plans i Pipelines
Jeden osobisty token dostępu (PAT) i jeden projekt, w AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> lub https://<org>.visualstudio.com) i AZURE_DEVOPS_PROJECT. Token PAT jest wysyłany wyłącznie do hostów należących do Azure DevOps i nigdy nie pojawia się w dzienniku. W Ustawieniach, w sekcji Integracje, opcja Połącz z Azure DevOps sprawdza projekt i typ elementu roboczego, ale niczego nie tworzy.
- Azure Boards: przy ustawieniu
AZURE_BOARDS_ENABLED=trueniepowodzenie powoduje otwarcie elementu roboczego typuAZURE_BOARDS_WORK_ITEM_TYPE, domyślnie Bug, zgodnie z opisanym powyżej cyklem życia. Gdy test zakończy się pomyślnie bez zastrzeżeń, element przechodzi do stanu określonego wAZURE_BOARDS_DONE_STATE, domyślnie Resolved; jeśli proces nie dopuszcza tego stanu, dodawany jest tylko komentarz. Token PAT wymaga uprawnienia Work Items (Read & write). Z Evidence Locker można też ręcznie wysłać informację o niepowodzeniu do Azure Boards. - Azure Test Plans: plik
azure-pipelines.ymlgenerowany na ekranie CI/CD publikuje plik JUnit XML z uruchomienia za pomocą zadaniaPublishTestResults@2, dzięki czemu każde uruchomienie potoku pojawia się w Test Plans, w sekcji Runs. - Azure Pipelines: polecenie
nexus ci-remote --provider=azurekolejkuje uruchomienie potoku wskazanego wAZURE_PIPELINE_ID, czeka na jego zakończenie i pobiera jego plik JUnit XML na ten komputer. Token PAT wymaga do tego uprawnienia Build (Read & execute).
GitHub Issues
- Połączenie: osobisty token dostępu z precyzyjnymi uprawnieniami Issues (odczyt i zapis) do jednego repozytorium, w
GITHUB_ISSUES_TOKEN, oraz repozytorium w formacie właściciel/repozytorium wGITHUB_ISSUES_REPO. W Ustawieniach, w sekcji Integracje, opcja Połącz GitHub Issues pokazuje, do kogo należy token, i udostępnia tylko repozytoria, do których ma on dostęp i w których włączono Issues (przewodnik krok po kroku). - Zgłoszenia: przy ustawieniu
GITHUB_ISSUES_ENABLED=trueniepowodzenie otwiera zgłoszenie z etykietami zgłoszenia źródłowego, zgodnie z opisanym powyżej cyklem życia. Po przebiegu bez błędów do zgłoszenia dodawany jest komentarz, a samo zgłoszenie jest zamykane jako ukończone. - Inne repozytorium: w sekcji Zgłoszenia miejsce docelowe GitHub może wskazywać inną parę właściciel/repozytorium niż podana w
.env.
Slack
- Połączenie: jeden adres URL przychodzącego webhooka, w
SLACK_WEBHOOK_URL. W Ustawieniach znajduje się przycisk Wyślij wiadomość testową. - Co otrzymuje: wiadomości Block Kit: podsumowanie uruchomienia, a przy ustawieniu
NEXUS_SLACK_NOTIFY=truetakże osobną wiadomość dla każdego testu zakończonego niepowodzeniem, niestabilnego, testu chaosu lub regresji wizualnej. Wiadomość o niepowodzeniu zawiera odnośnik do zgłoszenia w Jira, jeśli takie istnieje. - Ręcznie: z Evidence Locker można opublikować w Slack tekstowe podsumowanie niepowodzenia. Do Slack nie są wysyłane żadne pliki.
Microsoft Teams
- Połączenie: jeden adres URL elementu webhook Workflows dla kanału, w
TEAMS_WEBHOOK_URL. Teams Workflows wymaga służbowego lub szkolnego konta Microsoft 365. W Ustawieniach dostępna jest opcja Zapisz & wyślij test (przewodnik krok po kroku). - Co otrzymuje: te same wiadomości co Slack, w postaci kart adaptacyjnych: podsumowanie przebiegu oraz, przy ustawieniu
NEXUS_TEAMS_NOTIFY=true, jedną wiadomość na każdy test zakończony niepowodzeniem, niestabilny, chaosu lub regresji wizualnej. - Dokąd prowadzi adres URL: tylko do adresu https na własnych hostach elementów webhook firmy Microsoft (logic.azure.com, webhook.office.com, api.powerplatform.com). Każdy inny adres URL jest odrzucany i nic nie jest wysyłane.
Telegram
- Połączenie: własny bot, utworzony jednorazowo za pomocą @BotFather, w
TELEGRAM_TOKEN. W Ustawieniach opcja Połącz za pomocą kodu QR łączy czat i uzupełniaTELEGRAM_CHAT_ID. Nie ma wspólnego bota. - Co otrzymuje: alerty o niepowodzeniach, po jednym na test przy ustawieniu
NEXUS_TELEGRAM_NOTIFY=true, oraz raporty i pliki wybrane do udostępnienia ze Studio. - Przed włączeniem: Telegram może otrzymywać pliki, takie jak raporty i pliki PDF, które trafiają na serwery Telegram. W środowisku objętym regulacjami najpierw skonsultuj się z zespołem ds. zgodności.
Zgłoszenia: kiedy są otwierane, co zawierają, dokąd trafiają
W Ustawieniach, w sekcji Integracje, ekran Zgłoszenia określa, co trafia do Jira, Azure Boards lub GitHub Issues, gdy test zakończy się niepowodzeniem. Funkcja udostępniania w Evidence Locker korzysta z tego samego szablonu. Konfiguracja jest zapisywana w pliku nexus-tickets.config.json w obszarze roboczym. Plik nie zawiera sekretów i można go przechowywać w repozytorium. Bez tego pliku zgłoszenia działają tak, jak opisano powyżej. Jeśli plik jest nieprawidłowy, stosowane są ustawienia domyślne, a przyczyna jest podana w dzienniku.
- Kiedy: które wyniki powodują utworzenie zgłoszenia (domyślnie BREACHED i TIMEOUT), ile kolejnych niepowodzeń musi wystąpić przed jego utworzeniem, limit na uruchomienie, uruchomienia lokalne, w CI lub oba rodzaje, identyfikatory testów do uwzględnienia lub pominięcia, działanie po pomyślnym przejściu testu (zamknięcie, tylko komentarz lub brak działania) oraz to, czy nawrót niepowodzenia ponownie otwiera zamknięte zgłoszenie zamiast tworzyć nowe.
- Co: szablon tytułu ze zmiennymi
{type},{testId},{browser}i{error.firstLine}. Zmienna{testId}jest wymagana, ponieważ tytuł służy do wykrywania duplikatów w ciągu 24 godzin. Ponadto sekcje opisu do wysłania i ich kolejność, zakres treści błędu, etykiety, priorytet dla poszczególnych wyników, osoba przypisana, komponent, pola niestandardowe i notatka dla zespołu. - Załączniki: domyślnie zrzut ekranu. Ślad wykonania, nagranie wideo i raport tylko po ich zaznaczeniu, każdy do ustalonego limitu rozmiaru.
- Gdzie: jedno miejsce docelowe na system śledzenia zgłoszeń, każde z własnym przełącznikiem. Miejsce docelowe może nadpisywać witrynę Jira, projekt i typ zgłoszenia, repozytorium GitHub lub typ elementu roboczego Azure.
- Podgląd i test: przed zapisaniem ekran pokazuje dla każdego miejsca docelowego zgłoszenie, które powstałoby na podstawie ostatniego niepowodzenia. Opcja Utwórz zgłoszenie testowe tworzy na tej podstawie jedno rzeczywiste zgłoszenie z etykietą
nexus-test.
Czego zgłoszenie nigdy nie zawiera
- Tylko to, co zaznaczysz. Niezaznaczone sekcje i załączniki pozostają na Twoim komputerze.
- Sekrety są najpierw maskowane. Każdy wiersz tekstu przed wysłaniem do zgłoszenia przechodzi etap usuwania danych poufnych: nagłówków autoryzacji i plików cookie, tokenów bearer i basic, tokenów JWT, znanych formatów kluczy dostawców, haseł w adresach URL oraz wartości pól o nazwach wskazujących na sekrety. Mechanizm wykrywa typowe postacie sekretów w dziennikach i błędach, ale nie każdy sekret, jaki może zawierać dowolny tekst, więc nie włączaj dołączania śladu wykonania, jeśli go nie potrzebujesz.
- Żadnych tokenów w pliku. Plik
nexus-tickets.config.jsonnie dopuszcza pól o nazwach wskazujących na sekrety ani adresów URL zawierających nazwę użytkownika i hasło. Tokeny pozostają w.env.
Klucze
Każdy klucz to osobny wiersz w pliku .env obszaru roboczego. Wszystkie można edytować w Ustawieniach.
| Usługa | Klucze | Wartości domyślne |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | Wyłączone; projekt QA; przejście 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 | Wyłączone; typ Błąd; stan Rozwiązane |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | Wyłączone |
| Załączniki zgłoszenia | NEXUS_ISSUE_ATTACH_TRACE | Wyłączone: tylko zrzut ekranu |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | Wyłączone |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | Wyłączone |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | Wyłączone |
W potoku te same klucze, z wyjątkiem AZURE_PIPELINE_ID, są jego tajnymi zmiennymi, a pozostawienie klucza bez wartości powoduje, że odpowiadająca mu usługa pozostaje wyłączona (sekrety w CI/CD).
Pytania
Czy Nexus StudioQA widzi moje dane z Jira lub Azure DevOps?
Nie. Silnik komunikuje się z Jira, Azure DevOps, GitHub Issues, Slack, Teams i Telegram z Twojego komputera, przy użyciu Twoich kluczy. Żadne z tych danych nie przechodzą przez nasze serwery.
Czy niestabilny test utworzy zgłoszenie?
Nie. FLAKY nie tworzy zgłoszeń. BREACHED_FLAKY je tworzy: samo niepowodzenie występowało nieregularnie, a ponowienie próby go nie ukrywa.
Test nie powiódł się 30 razy w tym tygodniu. Ile to zgłoszeń?
Jedno, z komentarzem i nowym zrzutem ekranu dla każdego niepowodzenia po pierwszym, aż test przejdzie bez problemów we wszystkich przeglądarkach.
Czy mogę jednocześnie korzystać z Jira, Azure Boards i GitHub Issues?
Tak. Każdy z tych systemów utrzymuje własne zgłoszenie dla każdego testu, podobnie jak każda dodatkowa witryna Jira.