Testowanie i rozwiązywanie problemów - Jira Cloud

Test integracji

Weź błąd o niskim znaczeniu z projektu testowego i utwórz z niego zadanie. Sprawdź w Jirze typ zgłoszenia (powinien być zbliżony do „Bug", nie epikiem ani podzadaniem), treść opisu i to, czy osoba przypisana i status początkowy zgadzają się z konfiguracją projektu. Żeby sprawdzić synchronizację zwrotną, przełącz to zadanie ręcznie w Jirze na status z kategorii Done i odczekaj do pięciu minut - status błędu w DockRay powinien zmienić się na rozwiązany bez żadnej akcji z Twojej strony.

Typowe problemy

Zadanie ma nieoczekiwany typ zgłoszenia

DockRay musi rozpoznać typ „błąd" niezależnie od języka Jiry - Jira Cloud tłumaczy nazwy typów na język konta, a lista typów zaczyna się od epiku. Dlatego integracja najpierw odrzuca podzadania i wszystko na poziomie epiku i inicjatywy, a dopiero wśród tego, co zostało, szuka nazwy zbliżonej do „Bug", a w drugiej kolejności do „Task". Jeśli w schemacie typów projektu Jira nie ma żadnego z nich, zadanie i tak nie powstanie jako epik - dostanie pierwszy dostępny typ na poziomie zwykłej pracy, czyli czasem coś w rodzaju „Story". Rozwiązanie: dodaj do projektu Jira typ zgłoszenia odpowiadający błędowi.

Klucz projektu Jira jest odrzucany

Klucz musi zaczynać się od wielkiej litery i składać się wyłącznie z wielkich liter, cyfr i podkreślenia. Klucz wpisany małymi literami albo ze spacją, myślnikiem czy innym znakiem specjalnym zostanie odrzucony - to nie nadgorliwość walidacji, tylko ochrona przed wyprowadzeniem żądania poza właściwy endpoint API.

Status błędu nie wraca do panelu od razu

Tak ma działać. Synchronizacja statusu jest okresowa, nie w czasie rzeczywistym - dynamiczne webhooki Jira Cloud wymagają zarejestrowanej aplikacji OAuth/Connect, której nie da się uruchomić samym tokenem API klienta. Komenda thor:sync-jira odpytuje powiązane zadania co pięć minut, więc opóźnienie do tych pięciu minut jest normalne, nie awarią.

Połączenie kończy się błędem uwierzytelniania

Sprawdź, czy adres e-mail i token API należą do tego samego konta Atlassian, czy token nie został odwołany w ustawieniach Atlassiana i czy adres instancji rzeczywiście jest w domenie *.atlassian.net - inny adres integracja odrzuci, zanim jeszcze spróbuje się połączyć.

Integracja przestaje działać po zmianie ustawień projektu

Zdarza się to po przełączeniu projektu z własnych poświadczeń na dziedziczone po koncie, jeśli w międzyczasie zniknęło też połączenie na poziomie konta. Sprawdź kolejno oba poziomy: konfigurację projektu i konfigurację konta - projekt bez żadnej z nich nie ma skąd wziąć poświadczeń.

Nadal nie działa

Przejdź przez listę kontrolną braku danych w panelu, a jeśli to nie pomoże - napisz do nas. Podaj nazwę projektu, wersję integracji i przybliżoną godzinę testu: to skraca drogę do odpowiedzi.