Składniki raportu
Pięć komponentów oznacza cały zestaw numerów, a nie pojedyncze numery. Są zwykłe komponenty projektanta — przeciągasz je na płótno jak każde inne — ale każdy z nich zawiera ustawienie źródła danych.
Wiązanie komponentu z danymi
Każdy z tych komponentów zadaje to samo pytanie: które problemy?
| Gdzie jesteś | Co oferuje selektor źródła |
|---|---|
| Zwykły szablon eksportu (wydanie, tablica, sprint, wydanie, zaległości, JQL) | Bieżący zestaw eksportu — eksportowane sprawy. Bez dodatkowego wyszukiwania Jira. |
| A raport | nazwane źródła danych raportu. |
Jedno i drugie nie jest wymienne. Nazwane źródło jest rozpoznawane tylko w raporcie; a komponent powiązany z komponentem, który już nie istnieje, renderuje widoczną nazwę diagnostyczną brakujące źródło, w każdym formacie. Nigdy po cichu nie staje się pusty.
Jeśli raport ma więcej niż jedno źródło, nic nie jest zgadywane. Wykres powiązany z zły filtr tworzy dokument, który wygląda poprawnie, a nie jest, co jest gorsze niż taki, który wyraźnie zawodzi.
Szereg czasowy
Wykresy przedstawiają zdarzenia datowane ze zbioru zgłoszeń jako wykres liniowy, obszarowy lub zgrupowany słupkowy. Komponent zawiera od jednej do czterech serii. Każda seria zlicza jeden z trzech typów zdarzeń:
| Zdarzenie | Co jest liczone |
|---|---|
| Utworzono | Znacznik czasu utworzenia problemu. |
| Rozwiązane | Problem to Jira resolutiondate i nic więcej. Bieżący status Gotowe nigdy nie jest traktowany jako dowód zdarzenia rozstrzygającego. |
| Data niestandardowa | Jedno skalarne pole niestandardowe, którego schemat Jira to Data lub Data/godzina. Pola dat wielowartościowych są ignorowane i wyświetla się widoczne ostrzeżenie. |
Wybierz segmenty dzienne, tygodniowe lub miesięczne oraz zakres względny lub stały. Obydwa zakresy są włącznie. Zakres względny kończy się w lokalnej dacie kalendarzowej jawnie określony czas generowania eksportu; stały zakres obejmuje zarówno datę Od, jak i Do. Puste przedziały można zachować i należy je zachować dla serii skumulowanych, szereg, aby płaskie odcinki krzywej nie znikały.
Granice kalendarza wykorzystują strefę czasową użytkownika eksportującego Jira. Jeśli Exportelier nie można go odczytać lub Jira zwraca nieprawidłową strefę, wykres powraca do czasu UTC i drukuje ostrzeżenie w dokumencie. Wiadro miesięczne to lokalny miesiąc kalendarzowy, a nie 30 dni, które upłynęły. Tygodnie rozpoczynają się w poniedziałek lub niedzielę, w zależności od komponentu wyraźne ustawienie; Ustawienia regionalne serwera nigdy nie wybierają za Ciebie.
Źródło zapisanego filtra zwraca zgłoszenia pasujące do filtra teraz. Wykres zlicza historyczne zdarzenia utworzenia, rozwiązania lub daty niestandardowej tylko dla tych zgłoszeń; nie odtwarza, które zgłoszenia pasowały do filtra wcześniej.
Z tego powodu wykres Exportelier Utworzone i rozwiązane może różnić się od własnego gadżetu Jira Utworzone i rozwiązane, gdy zostaną porównane po zaimportowaniu panelu kontrolnego, a różnica ta niekoniecznie oznacza błąd obliczeniowy.
Po zapisaniu szablonu obowiązują limity przedziałów: 366 dziennych, 104 tygodniowe lub 60 miesięcznych. Większa konfiguracja jest odrzucana zamiast cichego skrócenia krzywej.
Wykres kategorii
Grupuje problem ustawiony według jednego pola, które można grupować i rysuje rozkład jako a Wykres pie, donut lub poziomy słupek.
- Maksymalnie 20 kategorii; poza tym dodatkowe kategorie są łączone w Inny lub skrócony, w zależności od ustawień komponentu.
- Puste wartości pojawiają się jako Brak.
- W przypadku pól wielowartościowych, takich jak Etykiety, kategoria liczy się procentowo zadania, a nie problemy — jedno zadanie z trzema etykietami wnosi trzy.
- Obcięcie i nieobsługiwane wartości zawsze dają widoczną nutę.
Karta KPI
Pojedynczy numer nagłówka z etykietą. Wybierz jeden wskaźnik:
| Metryczne | Co się liczy |
|---|---|
| Liczba problemów | Problemy w źródle. |
| Licznik zakończonych problemów | Sprawy, których kategoria statusu to Gotowe. |
| Procent ukończenia | Ukończone problemy jako procent źródła. |
| Pole numeryczne | sum lub średnia pola numerycznego. |
Agregacja numeryczna akceptuje tylko liczby skończone. Wartości, które są puste lub nie a numery są ignorowane i liczone w widoczny sposób, więc karta zbudowana na w połowie zapełnionym pole nigdy po cichu nie wprowadza Cię w błąd co do własnych podstaw.
Opcjonalnie na karcie wyświetlana jest nazwa źródła danych, które odczytała — przydatne, gdy kilka kart leży obok siebie.
Tabela problemów
Jeden wiersz na wydanie, z wybranymi kolumnami.
- Wybierz dowolne standardowe lub niestandardowe pole w każdej kolumnie, z opcjonalnym niestandardowym nagłówkiem i szerokość.
- Opcjonalne sortowanie według pola, rosnąco lub malejąco.
- Do 200 wierszy. Gdy źródło ma więcej, tabela pokazuje pierwsze wiersze i podaje, ile zostało pominiętych.
- Opcjonalna linia zliczania wierszy („12 z 47 wierszy”) i opcjonalny wiersz nagłówka.
Wartości pól są renderowane i wymuszane dokładnie tak, jak w innych tabelach Exportelier, więc pole niestandardowe wygląda tak samo, gdziekolwiek się pojawi.
Macierz dwuwymiarowa
Tablica krzyżowa: jedno pole w dół wierszy, drugie w poprzek kolumn, liczenie problemy w każdej komórce.
- Obie osie są zakończone 12 łyżek. Poza tym pozostałe wartości zwiń do deterministycznego segmentu Inne — zawsze te same dane wejściowe tworzy tę samą tabelę.
- Opcjonalne sumy wierszy, sumy kolumn i suma całkowita.
- Renderowany jako prawdziwy, dostępny stół w każdym formacie, nigdy jako obraz.
Jak każdy format je renderuje
Exportelier kompiluje jeden szablon do trzech formatów. Poniższa tabela odzwierciedla co renderery faktycznie tworzą — format jest oznaczany jako ukończony tylko wtedy, gdy jest przenoszony każdą wartość, a nie wtedy, gdy po prostu wygląda podobnie.
| Komponent | Word (DOCX) | Markdown | |
|---|---|---|---|
| Seria czasowa | Osie wektorowe, linie, obszary lub słupki z legendą tekstową i opcjonalnymi wartościami/tabelą | Osadzone SVG z deterministycznym plikiem awaryjnym PNG, po którym następuje pełna tabela danych | Zlinearyzowana tabela z jednym wierszem na segment i jedną kolumną na serię; brak obrazu pseudoliniowego |
| Wykres kategorii | Wykres wektorowy z etykietami i wartościami | Osadzone SVG z zastępczym obrazem PNG, po którym następuje tabela kategorii | Tabela kategorii; poziome paski również otrzymują paski tekstowe. Ciasto i pączek nie są nie sfałszowane jako obraz. |
| Karta KPI | Kompletna | Kompletna | Kompletna |
| Tabela problemów | Kompletny | Kompletny | Kompletny |
| Matrix | Kompletny | Kompletny | Kompletny |
Nazwy i numery kategorii zawsze pozostają dostępne w postaci tekstu, więc kolor nigdy nie jest dostępny jedynym nośnikiem informacji.
Dane wyjściowe Markdown powodują ucieczkę od wszystkiego w danych Jira, co w przeciwnym razie spowodowałoby uszkodzenie strukturę tabeli, więc tekst wydania pozostaje tekstem wydania.
Limity
Raport może zawierać maksymalnie 30 komponentów opartych na danych. Razem z limity na źródło i na tabelę, ograniczają koszty pojedynczego eksportu — patrz odniesienie do ograniczeń.