Edycja wbudowanych raportów

Każdy z dostępnych w systemie raportów można modyfikować. Robimy to z poziomu listy raportów, klikając w opcję Edytuj:

Zmieniony raport można zapisać jako nowy - wtedy ten już istniejący nie będzie nadpisany. W przeciwnym wypadku nowa wersja raportu zastąpi starą. Ma to znaczenie zwłaszcza w przypadku raportów wbudowanych, ponieważ po ich modyfikacji niemożliwa jest ich aktualizacja w kolejnych wersjach programu.

Dlatego warto korzystać z bezpieczniejszej opcji i zapisywać raporty jako nowe. Jeśli jednak zdecydujemy się na nadpisanie wbudowanego raportu, będziemy mogli w każdej chwili przywrócić jego oryginalną wersję.

Struktura raportu

Zmiana wyglądu raportu

Po wybraniu elementu, który chcesz zmodyfikować, w zakładce Ustawienia panelu po prawej stronie wybierz sekcję Wygląd i wprowadź zmiany. Na przykład:

• żeby zmienić kolor tytułu raportu, w sekcji Wygląd/Czcionka ustaw pożądany kolor pierwszoplanowy,

  

• żeby zmienić kolor nagłówków tabeli, w sekcji Wygląd ustaw wybrany kolor tła.

  

Dodawanie kolumny

1. Wybierz istniejącą kolumnę, w sąsiedztwie której chcesz dodać kolejną.

2. Prawym przyciskiem myszy otwórz menu kontekstowe i wybierz z niego opcję Wstaw >> Kolumnę po prawej.

   

3. Wybierz komórkę tabeli i korzystając ze struktury danych w zakładce Dane panelu po prawej stronie, wpisz w nawiasach kwadratowych informację o tym, które dane chcesz wyświetlić (w formacie “nazwa_tabeli.nazwa_kolumny”).

   

4. Wybierz komórkę w nagłówku tabeli i w zakładce Ustawienia panelu po prawej stronie, w sekcji Komórka tablicy zadania >> Tekst, wpisz nazwę kolumny.

   

Dodawanie parametru:

Cel: do raportu Ranking urządzeń według liczby zdarzeń dodać parametr wskazujący minimalną liczbę zdarzeń, jaka została wywołana na urządzeniu, żeby urządzenie pojawiło się w wynikach.

1. W zakładce Dane panelu po prawej stronie, w sekcji Parametry, otwórz formularz nowego parametru raportu (o parametrach raportu i parametrach zapytania więcej przeczytasz w artykule o Kreatorze).

   

2. Uzupełnij formularz

   

3. W zakładce Dane panelu po prawej stronie, w sekcji źródła danych, wybierz tabelę events_logs i otwórz okno kreatora źródła danych.

   

4. Napisz nowe zapytanie SQL uwzględniające dane z parametru zapytania.

   SELECT
   l.device_id,
   max(coalesce(d.device_type_id, l.device_type_id)) AS device_type_id,
   max(t.device_name) AS device_name,
   COUNT(1) AS events_count
   FROM report.alert_event_logs l
   LEFT JOIN report.devices d ON l.device_id = d.id
   JOIN LATERAL (
     SELECT
     CASE
     WHEN d.id is NOT NULL   
     THEN d.full_name
     ELSE l.device_full_name
     END
     AS device_name
     ) t ON true
     WHERE l.start_date >= @event_date_from::timestamp
     AND l.start_date <= @event_date_to::timestamp
     AND (
       @map_id::int IS NULL OR
       @device_ids != '' OR
       EXISTS(
         SELECT 1 FROM report.maps_devices md
         WHERE md.device_id = l.device_id AND md.map_id = @map_id::int
         )
         )
         AND (
           @device_type_ids = ''
           OR @device_ids != ''
           OR l.device_type_id = ANY(string_to_array(@device_type_ids, ',')::int[])
           )
           AND (
             @device_ids = '' OR
             l.device_id = ANY(string_to_array(@device_ids, ',')::int[])
             )
             AND (
               @event_ids = ''
               OR COALESCE(l.alert_event_id, 0) = ANY(string_to_array(@event_ids, ',')::int[])
               )
               GROUP BY l.device_id
               HAVING count(1) > @events_count
               ORDER BY
               CASE WHEN @sort_direction = 'ASC' THEN count(1) END ASC,
               CASE WHEN @sort_direction = 'DESC' THEN count(1) END DESC
               LIMIT (@records_count::int)
         

5. Zmień istniejące zapytanie na nowe.

   

6. Dodaj parametr przywołany w zapytaniu. Będzie bazował on na wyrażeniu zwracającym wartość liczbową podaną w parametrze raportu.

   

7. Dodaj parametr do listy wyświetlanej w nagłówku i dostosuj stylowanie.

   

8. Ustaw wartość parametru.

   

9. Sprawdź podgląd raportu - konieczne jest dodanie tłumaczenia etykiety. Pełne informacje o warstwie językowej raportów i tłumaczeniach znajdziesz tutaj.

   

10. W menu bocznym wybierz sekcję Lokalizacji i w niej ustaw język polski.

    

11. Uzupełnij polską wersję etykiety i opisu parametru.

    

12. Ponownie sprawdź podgląd raportu - wszystko wygląda i działa poprawnie.

    

Dodawanie wykresu:

Cel: do raportu Ranking urządzeń według liczby zdarzeń dodać wykres słupkowy ilustrujący liczbę zdarzeń przypadającą na urządzenie.

1. Dodaj nagłówek grupy, w którym pojawi się wykres.

   

2. Przeciągnij ikonkę wykresu słupkowego do nagłówka i rozciągnij pole raportu na szerokość strony.

   

3. Uruchom kreator wykresów.

   

4. Wypełnij kolejne kroki w kreatorze.

   

5. Zatwierdź wprowadzone dane i sprawdź Podgląd.

   

Dodawanie spisu treści:

Cel: do raportu Szczegóły zasobów dodać spis treści.

1. Stwórz zakładkę w polu z nazwą zasobu - otwórz edytor wyrażeń i uzupełnij stosowne pole.

   

2. Do nagłówka raportu przeciągnij ikonkę spisu treści.

   

3. Wybierz pole spisu treści i dostosuj styl.

   

4. Ustaw tytuł.

   

5. Dostosuj wersję językową. Pełne informacje o warstwie językowej raportów i tłumaczeniach znajdziesz tutaj.

   • kliknij w obszar główny (wokół projektu raportu) - pojawi się panel z otwartą sekcją Ustawień:

     

   • wybierz język, w którym chcesz wyświetlać raport:

     

   • dostosuj ogólne właściwości raportu dla danego języka korzystając z dostępnych ustawień:

     

   • kliknij w obszar spisu treści w projekcie raportu i podaj tytuł, który ma wyświetlać się w wersji dla wybranego języka:

     

   • wyjdź z trybu edycji językowej - kliknij w obszar główny i w ustawieniach zmień język z powrotem na domyślny:

     

6. Sprawdź podgląd

   

Dodawanie nagłówka strony:

Cel: do raportu dodać sekcję, która będzie powtarzała się na każdej stronie. Sekcja ma zawierać obrazek, tekst główny i poboczny oraz pola możliwe do uzupełnienia ręcznie, widoczne w wygenerowanym pliku PDF.

1. Kliknij w dowolny element wybranego raportu i z menu dostępnego pod prawym przyciskiem myszy znajdź Wybierz grupę > Nagłówek strony.

   

2. Do utworzonego obszaru przeciągnij ikonkę pola obrazu.

   

3. W ustawieniach pola obrazu wybierz plik albo podaj jego adres URL.

   

4. W razie potrzeby dostosuj rozmiar wstawionego obrazu.

5. Przeciągnij ikonę Etykiety, by użyć jej do wstawienia tekstu głównego. Przeciągnij ikonę Tekstu formatowanego, by wstawić tekst poboczny. Dostosuj teksty, pamiętając o dodaniu ewentualnych wersji językowych. Pełne informacje o warstwie językowej raportów i tłumaczeniach znajdziesz tutaj.

   

6. Przeciągnij ikonę Łączenia znaków, by wstawić pole z wydzielonymi komórkami. Dostosuj szczegóły wyglądu.

   

7. Włącz możliwość edycji pola, by móc uzupełniać je z poziomu szczegółów raportu.

   

8. Przejdź do trybu Podglądu. Użyj opcji Podświetl pola edycji z górnego menu - podświetlą się dodane kratki.

   

9. Jeśli klikniesz w edytowalne pole i uzupełnisz je na pierwszej stronie, to również po eksporcie raportu do pliku PDF uzupełnione dane będą tylko na pierwszej stronie, a na kolejnych widoczne będą puste kratki.