Importuj z pulpitu nawigacyjnego Jira
Exportelier może odczytać panel kontrolny Jira i zbudować raport z co znajdzie. Wybierasz pulpit nawigacyjny, Exportelier informuje Cię, gadżet po gadżecie, co zrozumiał, wypełniasz wszystko, czego Jira nie przekazałeś i otrzymujesz zwykły edytowalny raport.
Zanim zaczniesz, warto wiedzieć dwie rzeczy, bo one kształtują wszystko jeszcze na tej stronie.
Exportelier importuje konfigurację dashboardu — który filtr, który pole, jaki typ wykresu — i odbudowuje go z własnych komponentów. Rezultatem jest nie zrzut ekranu, nie kopia wierna pikselom, ani osadzona strona Jira. Szerokości kolumn, chromowanie gadżetu i dokładne odstępy nie są odtwarzane, ponieważ Jirapubliczne API ich nie ujawnia.
Atlassian nie gwarantuje, że ustawienia wbudowanego gadżetu będą czytelne za pośrednictwem publicznego API. Jeśli ustawienie nie jest czytelne, Exportelier poprosi Cię o to wybierz to. Nigdy nie zgadnie, który filtr lub które pole miałeś na myśli.
Co można importować
| Jira gadżet | Staje się | Notatki |
|---|---|---|
| Wyniki filtrowania | Tabela problemów | Zachowuje wybrane kolumny gadżetu i ich kolejność |
| Wykres kołowy | Wykres kategorii (kołowy) | Używa typu statystyki gadżetu |
| Statystyka elementu pracy | Wykres kategorii (pasek) | Używa typu statystyki gadżetu |
| Statystyka filtra dwuwymiarowego | Macierz | Używa obu pól osi |
| Wykres utworzony a wykres rozwiązany | Wykres szeregów czasowych | Przechowuje okres raportowania gadżetu i jego przeszłość — zobacz limity poniżej |
| Spalanie sprintu | — | Wymaga historycznych danych sprintu, które Exportelier jeszcze nie są wysyłane |
| Wszystko inne | — | Nazwane i wykluczone, nigdy po cichu usunięte |
Każdy gadżet na pulpicie nawigacyjnym ma dokładnie jeden status:
- Gotowe — rozpoznano i wszystko, co potrzebne, było czytelne.
- Wymaga naprawy — rozpoznano, ale należy podać brakujące ustawienie.
- Dostępne później — rozpoznane, ale pasujące komponenty Exportelier jeszcze nie istnieje. Sprint Burndown jest tutaj.
- Nieobsługiwane — gadżet innej firmy lub nieznany. Został wskazany z nazwy, a nie ukryty.
- Błąd — Jira nie pozwoliła Exportelier go odczytać lub odczytane dane były sprzeczne. Ten blokuje import, dopóki nie naprawisz tego w Jira.
Rozpoznawanie następuje po technicznej tożsamości gadżetu, nigdy po jego tytule. Zmiana nazwy gadżet w Jira lub tłumaczenie Jira na inny język nie ulega zmianie co z tego wynika Exportelier — a nazwanie niestandardowego gadżetu „Wykres kołowy” nie zrób to jedno.
Co pokazuje wykres Utworzone i Rozwiązane
Zaimportowany wykres Utworzone i Rozwiązane zawiera daty utworzenia i rozwiązania ** elementów pracy, które pasuje dzisiaj do zapisanego filtra**. Nie rekonstruuje które elementy pracy zostały dopasowane w przeszłości przez filtr.Ma to znaczenie w przypadku zmiany członkostwa filtra. Jeśli element pracy został przeniesiony poza projektem, który zakrywa filtr, znika z każdego wiadra w wykres — uwzględniający segmenty sprzed ruchu. Własny gadżet Jira zachowuje się jak w ten sam sposób z tego samego powodu, ale warto wiedzieć, zanim porównasz dwa eksportu w odstępie kilku miesięcy.
Możliwe są jeszcze trzy dalsze różnice i każda z nich została wymieniona w raporcie informacja o kompletności, jeśli ma zastosowanie:
- Okres raportowania. Dane dzienne, tygodniowe i miesięczne są dokładnie odtwarzane. Stawka godzinowa staje się codzienna, a kwartalna i roczna staje się miesięczna – suma wynosi niezmieniona, różni się tylko szerokość każdego wiadra.
- Nierozwiązana linia trendu. Jira może nałożyć trzecią linię w przypadku pracy otwartej przedmioty w czasie. Wykres Exportelier pokazuje utworzone i rozwiązane serie tylko.
- Lookback. Okres dłuższy niż 366 dni jest skracany do 366 dni.
Wszystko inne – filtr, tryb kumulacyjny, same liczby – niesie ze sobą w poprzek bez zmian i możesz edytować każde z tych ustawień w projektancie potem.
Importowanie
- Otwórz Reports i wybierz Importuj z Jira dashboardu.
- Wybierz dashboard. Tylko pulpity nawigacyjne Jira już pokazują, że się tu pojawiasz – będąc administrator witryny Exportelier nie poszerza listy.
- Przeczytaj analizę. Każdy gadżet jest wyświetlany wraz ze swoim statusem.
- Napraw to, co wymaga naprawy. Wybierasz zapisany filtr i pola z zwykli zbieracze; zgodnie z projektem nie ma surowego pudełka JQL.
- Sprawdź kompletność. Wszystko, co zostanie pominięte, jest wymienione według nazwy i przed utworzeniem raportu należy wyraźnie potwierdzić wykluczenia.
- Utwórz raport. Otwiera się w normalnym projektancie, w pełni edytowalny.
Wszystko, co jest nadal oznaczone jako Wymaga naprawy lub Błąd, blokuje tworzenie. Exportelier wolałby odmówić, niż sporządzić raport, który po cichu pomija połowę pulpitu nawigacyjnego.
Informacja o kompletności
Każdy importowany raport zaczyna się od powiadomienia o kompletności — prawdziwego elementu dokumentu, a nie podpowiedzi w interfejsie użytkownika. Nazywa źródłowy pulpit nawigacyjny, kiedy to było zaimportowanych, ile gadżetów pulpitu nawigacyjnego jest uwzględnionych i każdy gadżet, który nie jest, według tytułu.
Jest to notatka informacyjna kiedy wszystko zostało zaimportowane i ostrzeżenie kiedy cokolwiek zostało pominięte. Występuje podobnie w PDF, Word i Markdown.
Chociaż raport jest nadal powiązany z jego importem, zawiadomieniem zarządza Exportelier: Resztę układu możesz dowolnie przesuwać, ale nie możesz usunąć lub napisać ponownie powiadomienie. Jeśli mimo to zostanie usunięty lub zmieniony, **raport nie wyeksportuje ** — dokumentu rzekomo reprezentującego pulpit nawigacyjny w trybie cichym brakująca część jest gorsza niż żaden dokument.
Jeśli chcesz otrzymać raport bez powiadomienia, zduplikuj go. Duplikat to zwykły raport, bez żadnego znaczenia i bez zarządzanego powiadomienia.
Bądź na bieżąco z pulpitem nawigacyjnym
Import jest migawką konfiguracji pulpitu nawigacyjnego. data pozostaje live: raport zawsze odczytuje zapisane filtry w czasie eksportu, więc liczby są aktualne nawet kilka miesięcy po imporcie.
To, czego nie aktualizuje samo w sobie, to układ i konfiguracja. Jeśli ktoś doda gadżet w Jira lub wskaże inny filtr, raport będzie nadal działać dokładnie tak jak poprzednio, dopóki nie powiesz inaczej.Otwórz raport i użyj Sprawdź zmiany. Exportelier ponownie odczytuje deskę rozdzielczą i klasyfikuje każdy gadżet jako dodany, usunięty, przeniesiony, zmieniony w konfiguracji lub niezmienione. Re-import następnie zastosuj:
- niezmienione i przeniesione gadżety zachowują to, co posiadają;
- wszystko, co dodałeś do raportu ręcznie, zostaje pozostawione bez zmian;
- zmienione i dodane gadżety otrzymują nową zawartość;
- gadżet, którego nowej konfiguracji nie można ustalić, automatycznie zatrzymuje zaimportuj ponownie i idź do naprawy, zamiast nadpisywać swoją pracę zgadywaniem;
- gadżet, który został wykluczony jako „dostępny później” i który jest nowszy Exportelier wydanie może teraz importować, pojawia się jako zmienione, a ponowny import dodaje go na końcu raportu. Istniejące raporty nigdy nie zyskują komponentu tylko z powodu wydania wysłane – musisz o to poprosić.
Wersja szablonu jest zapisywana automatycznie przed ponownym importem, więc Restore wersja cofa tę czynność.
Nie ma harmonogramu ani synchronizacji w tle. Ponowny import ma miejsce, gdy o to prosisz.
Uprawnienia
Importowanie, ponowne importowanie i usuwanie importu to czynności administratora witryny.
Każdy odczyt pulpitu nawigacyjnego, gadżetu i filtra jest uruchamiany przez osobę wykonującą import — administrator witryny nie może zaimportować dashboardu. Jira ich nie wyświetla. Później eksporter ponownie odczytuje filtry raportu tak, jak ktokolwiek go eksportuje, więc import to robi nie poszerzać nikomu dostępu do Jira danych. Zobacz Uprawnienia i role.
Limity
| Limit | Wartość |
|---|---|
| Gadżety analizowane według importu | 12 |
| Gadżety oferowane do wyboru powyżej tego limitu | 60 |
Deska rozdzielcza zawierająca więcej niż dwanaście gadżetów nie jest obcięta. Jesteś o to proszony wybierz, które gadżety chcesz zaimportować, a te, które pominiesz, zostaną nazwane w pliku powiadomienie o kompletności, jak każde inne wyłączenie.
Zaimportowany raport jest zwykłym raportem i dziedziczy wszystkie limity raportów — dane źródła, komponenty, problemy według źródła. Zobacz odniesienie do ograniczeń.
Informacje o Jira API, którego używa
Exportelier odczytuje dashboardy tylko poprzez udokumentowane Atlassian Jira Cloud deska rozdzielcza REST API. Nie analizuje stron internetowych Jira, nie czyta ramek iframe gadżetów, nie robi zrzutów ekranu ani nie używa nieudokumentowane punkty końcowe.
Jedna z tych operacji — Pobierz gadżety, która wyświetla listę gadżetów pulpitu nawigacyjnego — polega na oznaczony jako Eksperymentalny przez Atlassian. Oznacza to, że Atlassian może to zmienić bez stabilność gwarantuje resztę nośników API. Jeśli to się w jakiś sposób zmieni Exportelier nie rozpoznaje, import dashboardu sam się wyłącza i mówi tak, zamiast importować coś, co błędnie przeczytał. Twoje istniejące raporty, szablony i eksport nie mają wtedy wpływu.