Zapisano źródła danych filtra
Dane raportu pochodzą z Jira Zapisane filtry. Każdy filtr dodajesz raz, dawaj to nazwa i powiąż komponenty z tą nazwą.
Zapisane filtry są jedynym źródłem danych w tej wersji. Nie ma wolnego tekstu JQL, brak źródła REST, SQL lub CSV i brak łącznika innej firmy.
Dodawanie źródła
W edytorze raportów Dodaj źródło danych wyświetla listę zapisanych filtrów Jira ty. Wybierz jeden i nadaj mu lokalną nazwę wyświetlaną — „Zaległości wsparcia”, „Eskalacje inżynieryjne” — oto co zobaczycie w źródle projektanta selektor.
Możesz także bezpośrednio wpisać numeryczny identyfikator zapisanego filtra. Jeśli nie można osiągnąć Jira, picker mówi to zamiast blokować edytora.
Raport może zawierać do 8 źródeł danych. Nazwy muszą być unikalne.
Exportelier przechowuje identyfikator filtra, a nie zapytanie
To najważniejsza rzecz, którą należy zrozumieć w przypadku raportów.
Kiedy dodasz zapisany filtr, Exportelier przechowuje jego identyfikator numeryczny i wyświetlacz nazwa. To wszystko. Nie przechowuje:
- filtr JQL — nigdy nie jest czytany, kopiowany, rejestrowany ani łączony;
- wyniki filtra — nigdzie nie jest przechowywana żadna migawka problemów.
W czasie eksportu Exportelier buduje jeden ściśle numeryczny predykat,
filter = 12345 i pyta Jira o odpowiedź teraz.
Następują trzy konsekwencje i wszystkie są zamierzone:
- Raport następuje po filtrze. Edytuj zapisany filtr w Jira i następnym eksport to odzwierciedla. W Exportelier nie ma nic do ponownej synchronizacji.
- Reguły udostępniania filtra Jira obowiązują automatycznie. Exportelier nigdy staje się wokół nich bocznym kanałem.
- Nie ma nieaktualnej kopii, która mogłaby wyciekać. Raport zawiera odniesienie, a nie dane.
Ponieważ odniesienie jest aktywne, edytowanie powszechnie udostępnianego zapisanego filtra powoduje zmiany każdy raport z nim powiązany — łącznie z raportami utworzonymi przez innych administratorów.
Każdy eksport przebiega tak, jak Ty
Exportelier brzmi Jira jako osoba, która rozpoczęła eksport, nigdy jako aplikacji, a nigdy jako osoba, która stworzyła raport.
Dzięki temu dwie osoby mogą wyeksportować ten sam raport tego samego dnia i zgodnie z prawem otrzymać różne dokumenty. Każdy widzi dokładnie problemy według własnego uznania Jira pozwalają na to uprawnienia — nie więcej i nie mniej. To jest prawidłowe zachowanie, a nie błąd: alternatywą byłaby aplikacja pokazująca dane osób, Jira je odrzuca.
Administrator witryny tworzący raport widzi filtry, które on widzi. To nigdy poszerza to, co dostaje ktokolwiek inny.
Dwa źródła, jeden filtr, jedno wyszukiwanie
Jeśli dwa źródła danych wskazują na ten sam zapisany filtr, zapytanie Jira zostanie wysłane jednorazowo i wynik jest przekazywany obu. Pola, których faktycznie potrzebują komponenty, to zbierane w całym raporcie i żądane łącznie, a nie pobierane „wszystko” lub pobieranie według komponentu.
Można zatem dodać ten sam filtr dwa razy pod różnymi nazwami — dla różnych komponentów – bez płacenia za to dwa razy.
Preflight: co znajdzie eksport
Przed rozpoczęciem eksportu Exportelier sprawdza każde źródło i zgłasza jeden z poniższych statusów:
| Status | Co to znaczy | Blokuje eksport? |
|---|---|---|
| Ready | Filtr został odczytany i dopasowane problemy. | Nie |
| Empty | Filtr obecnie nie spełnia żadnych problemów. | Nie — pusty raport jest odpowiedzią zgodną z prawdą. |
| Niedostępny | Filtr nie jest dla Ciebie dostępny. | Tak |
| Ograniczona prędkość | Jira ogranicza żądania; spróbuj ponownie wkrótce. | Tymczasowo |
| Błąd | Nie można sprawdzić filtra. | Tymczasowo |
Inspekcja wstępna pokazuje także przybliżoną liczbę wydań dla każdego źródła i ostrzega, gdy a źródło zostanie odcięte w ramach limitu na źródło.
Dlaczego „niedostępny” nie oznacza „usunięty”
Jira odpowiada 404 zarówno dla filtra, który już nie istnieje i dla filtra, który
istnieje, ale nie jest Ci udostępniany. Nie można ich rozróżnić poprzez API,
więc Exportelier nie zgaduje. Żądanie usunięcia, którego nie można udowodnić, zostanie wysłane
ludzie szukający niewłaściwego problemu; wiadomość wymienia obie możliwości i
sugeruje poproszenie administratora witryny o udostępnienie filtra.
Niedostępne źródło powoduje zatrzymanie eksportu
Raport, którego brakuje źródła, nie jest eksportowany. Zadanie kończy się niepowodzeniem i wywołuje źródło. Jest to celowy wybór: w raporcie po cichu brakuje jednego z danych źródła są materialnie fałszywe i nie do odróżnienia od pełnych.
Ograniczenia dotyczące źródeł
- 8 źródeł danych na raport i maksymalnie 8 odrębne wyszukiwania filtrów.
- 500 problemów na źródło i 2 000 unikalnych problemów w całym raporcie.
- Wyszukiwania 2 Jira działają jednocześnie — raporty są zadaniami w tle, a nie interaktywnymi czyta i udostępnij budżet stawek Jira witryny.
Kiedy limit obcina dane, gotowy dokument jest o tym informowany, według źródła. Zobacz odniesienie do ograniczeń.