Kreator raportów
Większość eksportu Exportelier zaczyna się od czegoś, na co już patrzysz — np problem, deska, sprint. raport działa w drugą stronę: jest to zapisany obiekt, który nazywa swoje własne dane. Budujesz go raz i każdy, kto ma na to pozwolenie eksportuj, pobiera aktualne liczby.
Raport to dokładnie dwie rzeczy:
- Jeden szablon — zwykły szablon projektanta. Nie ma oddzielnego „szablon raportu” i brak drugiego projektanta.
- Jedno lub więcej nazwanych źródeł danych — każde z nich to Jira Zapisany filtr.
Komponenty wewnątrz szablonu są następnie wiązane ze źródłem według nazwy, a więc pojedynczym raport może wyświetlać „Zaległości w zakresie wsparcia” obok „Eskalacji inżynieryjnych” w tym samym miejscu dokument.
Special Reports: zapisane raporty w zakładce Panel kontrolny.
Zaczynając od pulpitu nawigacyjnego Jira
Możesz zbudować raport od zera — wybierz filtry, porzuć elementy raportu, połącz każdy z nich — lub możesz zacząć z panelu Jira, który już posiadasz.
Importuj z pulpitu nawigacyjnego Jira odczytuje dane z pulpitu nawigacyjnego konfigurację i buduje z niej zwykły raport. Importuje, czym jest gadżet skonfigurowany tak, aby był pokazywany, a nie jego obraz, przez co wynik nie jest zsynchronizowany z pulpitem nawigacyjnym później: dane filtra pozostają aktywne, ale układ i zmiana konfiguracji tylko wtedy, gdy jawnie dokonasz ponownego importu.
Gdzie znajdują się raporty
Raporty eksportowane są z zakładki Dashboard w Special Reports. Zawiera raporty utworzone ręcznie z zapisanych filtrów i raporty zaimportowane z Jira pulpity nawigacyjne. Administratorzy witryny zarządzają tymi samymi rekordami w Szablony → Raporty; lista zarządzania pokazuje nazw ę każdego raportu, opis, liczbę źródeł danych, szablon, zakres, ostatnia aktualizacja i dostępność do eksportu.
Każdy, kto może korzystać z Exportelier, widzi włączone raporty w zakładce Panel kontrolny. Co możesz zarządzać, zależy od Twojej roli.
Kto może co zrobić
| Akcja | Administrator witryny | Dowolny uwierzytelniony użytkownik Jira |
|---|---|---|
| Zobacz listę raportów | ✅ | ✅ |
| Eksportuj raport włączony | ✅ | ✅ |
| Utwórz, edytuj, zduplikuj, usuń raport | ✅ | — |
| Otwórz projektanta raportów | ✅ | — |
| Dodaj lub zmień źródła danych | ✅ | — |
Działania administracyjne są nie tylko ukryte dla osób niebędących administratorami — serwer odmawia nich, więc bezpośrednie wywołanie API nie pomaga.
Administrator witryny może utworzyć raport na podstawie dowolnego filtra, który widzi. Tak nie jest przyznaj do niego dostęp komukolwiek innemu. Przy każdym eksporcie Jira jest ponownie odczytywane jako osoba eksportowanie — zobacz wyniki według użytkownika.
Tworzenie raportu
Edytor raportów składa się z czterech części, w kolejności ich użycia:
- Szczegóły raportu — nazwa, opis, zakres i to, czy raport jest włączone do eksportu.
- Źródła danych — dodaj każdy zapisany filtr i nadaj mu sensowną nazwę w Twojej organizacji. Zobacz Zapisane źródła danych filtrów.
- Projektant — zwykły projektant wizualny. Każdy komponent danych zyskuje a selektor źródeł wyświetlający listę nazwanych źródeł.
- Podgląd i eksport — sprawdź powiązanie, a następnie eksportuj.
Nie można zapisać raportu, jeśli komponent nie ma prawidłowego źródła danych. Redaktor nazywa szkodliwe komponenty, zamiast po cichu wiązać je z czymkolwiek źródło jest pierwsze.
Źródło, z którego nie korzysta żaden komponent, nie jest dozwolone — możesz przygotować powiązanie — ale redaktor tak mówi, podobnie jak gotowy eksport.
Zacznij od dołączonego szablonu
Nowy raport z raportu Dashboard Standard to najszybszy sposób. Kopiuje dołączony szablon systemu do edytowalnego, prosi o co najmniej jeden Zapisany Filter, a następnie pyta, które źródło danych zasila każdy z trzech standardowych wykresów.
Dzięki jednemu filtrowi ta odpowiedź zostanie wypełniona za Ciebie. Przy kilku filtrach nic nie jest zgadywane: raportu nie można utworzyć, dopóki każdy wykres nie zostanie przypisany, ponieważ błędnie powiązany wykres generuje raport, który wygląda dobrze, ale tak nie jest.
Sam szablon systemu dołączonego nigdy nie jest modyfikowany.
Eksportowanie raportu
Eksport raportów zawsze działa w tle, ponieważ odczyt kilku filtrów a renderowanie dokumentu nie mieści się w żądaniu interaktywnym.
Przed rozpoczęciem zadania inspekcja wstępna sprawdza każde źródło danych i pokazuje, co znaleziony — gotowy, pusty lub niedostępny, z szacunkowym problemem i ostrzeżeniem kiedy źródło osiągnie limit na źródło. Następnie możesz wybrać PDF, Word (DOCX) lub Markdown i rozpocznij eksport.
Podczas jego działania widzisz uczciwe fazy — planowanie, czytanie filtrów Jira, renderowanie, przygotowanie pobierania — i możesz je anulować w dowolnym momencie. Pojawią się eksporty raportów w Special Reports → Historia obok zwykłego eksportu asynchronicznego, każdy oznaczony nazwą raportu, dzięki czemu można ponownie otworzyć zadanie po zamknięciu okno dialogowe.
Gotowy dokument podaje, co faktycznie zawierał: ile numerów każdy źródło wniesione, tam gdzie limit został obcięty, oraz dowolne źródło zdefiniowane w raporcie ale żaden komponent nie używa.
Jeśli jeden z zapisanych filtrów raportu nie jest dostępny, eksport nie powiedzie się i podaje nazwę tego źródła. Nie generuje po cichu mniejszego raportu — dokumentu dyskretny brak źródła danych wygląda dokładnie tak, jak źródło kompletne.
Limity
Raporty mają swoje własne ograniczenia — źródła danych na raport, problemy na źródło, wiersze na stół i tak dalej. Każdy z nich jest wymuszany na serwerze i nazwany wyjście, gdy faktycznie coś obcina. Zobacz odniesienie do ograniczeń.