Optymalizacja raportu tabelarycznego – diagnostyka
Optymalizacja raportu tabelarycznego przygotowuje pola procesu do szybszej pracy raportowej. W niektórych konfiguracjach raport może po takiej zmianie zacząć pokazywać błąd pobierania danych. Ten artykuł pomaga sprawdzić, czy problem dotyczy użycia danych indeksowanych i kiedy warto tymczasowo wyłączyć ten tryb dla raportu.
Materiał jest przeznaczony dla administratorów, SLA i osób utrzymujących raporty.
Zanim zaczniesz diagnozować
- Sprawdź, czy błąd pojawia się w konkretnym raporcie, czy w wielu raportach opartych o ten sam proces.
- Sprawdź, czy problem pojawia się po dodaniu konkretnego pola, filtra albo sortowania.
- Zanotuj ID błędu z komunikatu albo z logu systemowego. Ułatwi to serwisowi sprawdzenie, które zapytanie nie wykonało się poprawnie.
- Jeżeli raport długo czeka na optymalizację albo status optymalizacji przechodzi na błąd, sprawdź także artykuł Jak działa optymalizacja raportu tabelarycznego od strony administracyjnej?.
Objawy
Raport pokazuje błąd pobierania danych po optymalizacji
Typowe przyczyny
- Raport korzysta z danych indeksowanych procesu, ale wybrane pole nie jest poprawnie obsłużone w tej ścieżce pobierania danych.
- Problem dotyczy konkretnego pola, na przykład pola referencyjnego albo pola używanego w kolumnie, filtrze lub sortowaniu.
- Konfiguracja danych indeksowanych procesu została przygotowana, ale dla danej definicji raportu standardowa ścieżka pobierania danych działa poprawniej.
Kroki diagnostyczne
-
Otwórz raport w edycji i przejdź do zakładki Widok.
Sprawdź, czy błąd pojawia się po dodaniu konkretnego pola albo po odświeżeniu podglądu z tym polem. -
Jeżeli możesz, usuń podejrzane pole z podglądu i sprawdź raport ponownie.
Jeżeli raport zaczyna działać, problem prawdopodobnie dotyczy tego pola w ścieżce danych indeksowanych. -
Przejdź do zakładki Źródło danych i znajdź sekcję Optymalizacja.
-
Zaznacz opcję Nie używaj eksperymentalnego indeksowania pól na sprawach.
-
Zapisz raport i ponownie sprawdź podgląd albo gotowy raport.
Jeżeli dane wracają, problem dotyczy użycia danych indeksowanych dla tej konfiguracji raportu.
Rozwiązanie
Pozostaw zaznaczoną opcję Nie używaj eksperymentalnego indeksowania pól na sprawach dla tego raportu, jeżeli raport musi działać od razu. Raport będzie pobierał dane standardową ścieżką. Może działać wolniej przy dużej liczbie spraw, ale omija problem występujący w ścieżce indeksowanej.
Jeżeli raport jest krytyczny albo problem dotyczy kilku raportów, zgłoś temat do SLA. Do zgłoszenia dołącz:
- ID raportu,
- nazwę procesu użytego jako źródło danych,
- nazwę pola, po którym błąd się ujawnia,
- ID błędu z logu systemowego,
- informację, czy wyłączenie eksperymentalnego indeksowania pól rozwiązało problem.
Kiedy eskalować
Eskaluj problem do SLA, gdy wyłączenie eksperymentalnego indeksowania pomaga, ale raport powinien korzystać z optymalizacji ze względu na dużą liczbę spraw albo wymagania wydajnościowe.
Raport działa, ale po optymalizacji działa inaczej niż wcześniej
Typowe przyczyny
- Raport zaczął korzystać z danych przygotowanych w tle, a administrator porównuje wynik z wcześniejszym odczytem standardowym.
- Optymalizacja procesu nie została jeszcze zakończona.
- Raport korzysta z pól, filtrów albo sortowania, które wymagają ponownego przeliczenia danych indeksowanych.
Kroki diagnostyczne
-
Sprawdź status optymalizacji w górnym pasku raportu.
Jeżeli status wskazuje oczekiwanie albo trwającą optymalizację, poczekaj na zakończenie przeliczenia. -
Sprawdź w artykule technicznym, czy optymalizacja procesu została poprawnie zakończona.
Ten wariant dotyczy sytuacji, w której raport czeka na przygotowanie danych albo pokazuje błąd statusu optymalizacji. -
Jeżeli status optymalizacji jest zakończony, a raport nadal zwraca podejrzane wyniki, w zakładce Źródło danych zaznacz Nie używaj eksperymentalnego indeksowania pól na sprawach i porównaj wynik.
Rozwiązanie
Jeżeli standardowa ścieżka pobierania danych pokazuje poprawny wynik, a ścieżka indeksowana pokazuje błąd albo nieoczekiwany rezultat, zostaw wyłączone eksperymentalne indeksowanie dla tego raportu i przekaż sprawę do weryfikacji technicznej.
Co oznacza wyłączenie tej opcji
Opcja Nie używaj eksperymentalnego indeksowania pól na sprawach dotyczy sposobu pobierania danych przez raport. Po jej zaznaczeniu raport korzysta ze standardowego odczytu danych z procesu.
To ustawienie:
- nie usuwa optymalizacji z procesu,
- nie usuwa pól z konfiguracji danych indeksowanych,
- nie zmienia formularza procesu,
- nie zmienia danych w sprawach,
- wpływa na sposób działania konkretnego raportu.
Dzięki temu administrator może szybko przywrócić działanie raportu, a zespół techniczny może osobno sprawdzić przyczynę problemu z danymi indeksowanymi.