## Czym jest harmonogram raportu

Harmonogram to reguła cyklicznego generowania raportu: system sam uruchamia raport w ustalonym rytmie (codziennie, co tydzień lub co miesiąc), tworzy plik w wybranym formacie i wysyła go e-mailem do wskazanych odbiorców. Nikt nie musi logować się do aplikacji, żeby zestawienie zostało przygotowane.

Typowe zastosowania:

- poranne zestawienie zgłoszeń otwartych i przeterminowanych dla kierownika działu,
- cotygodniowy raport reklamacji dla dostawcy lub sieci handlowej,
- miesięczne podsumowanie kosztów napraw dla zarządu.

## Tworzenie harmonogramu

Harmonogram tworzy się **na podstawie aktualnie wykonanego raportu**:

1. Uruchom raport i ustaw filtry, które mają obowiązywać w cyklicznym zestawieniu.
2. Kliknij **Wygeneruj raport**, aby zobaczyć wyniki i upewnić się, że filtry są poprawne.
3. Na ekranie wyników kliknij **Ustaw harmonogram**.
4. Uzupełnij ustawienia i zapisz.

Filtry z ekranu wyników zostają zapisane w harmonogramie — każde cykliczne uruchomienie użyje dokładnie tego samego zestawu warunków.

### Ustawienia harmonogramu

| Pole | Opis |
| --- | --- |
| **Nazwa harmonogramu** | Nazwa własna, po której rozpoznasz harmonogram na liście raportów |
| **Generowany** | Częstotliwość: każdego dnia, każdego tygodnia lub każdego miesiąca |
| **Format raportu** | PDF, CSV lub XLS |
| **Język raportu** | Język nagłówków kolumn i tłumaczonych wartości w pliku |
| **Odbiorca raportu** | Adres e-mail odbiorcy; można podać kilka adresów rozdzielonych przecinkiem |

{% callout type="note" title="Odbiorca nie musi mieć konta" %}
Raport możesz wysyłać na dowolny adres e-mail — także osobie, która nie korzysta z Reklamatora. Pamiętaj jednak, że plik zawiera dane zgłoszeń, więc listę odbiorców warto dobierać ostrożnie.
{% /callout %}

## Kiedy raporty są generowane

System sprawdza harmonogramy co godzinę i uruchamia je **o godzinie 7:00** według strefy czasowej ustawionej w koncie:

- **Każdego dnia** — codziennie o 7:00
- **Każdego tygodnia** — w poniedziałki o 7:00
- **Każdego miesiąca** — pierwszego dnia miesiąca o 7:00

Wygenerowany plik trafia do odbiorców jako **załącznik wiadomości e-mail**. Raporty z harmonogramu nie pojawiają się na liście *Pobieranie raportów* — są dostarczane wyłącznie pocztą.

{% callout type="warning" title="Daty w filtrach a cykliczność" %}
Filtr z konkretną datą (np. `2026-07-01`) będzie taki sam przy każdym uruchomieniu i po pewnym czasie przestanie mieć sens. W harmonogramach używaj **wartości dynamicznych** dat — np. „pierwszy dzień poprzedniego miesiąca” i „ostatni dzień poprzedniego miesiąca” — wyliczane są przy każdym uruchomieniu.
{% /callout %}

## Zakres danych w raporcie cyklicznym

Raport z harmonogramu wykonywany jest w kontekście **osoby, która utworzyła harmonogram** — obejmuje zgłoszenia z organizacji, do których ta osoba ma dostęp. Odbiorca wiadomości otrzymuje gotowy plik, niezależnie od tego, czy sam ma konto i jakie ma uprawnienia.

W praktyce oznacza to, że jeśli twórca harmonogramu utraci dostęp do części organizacji, zawartość cyklicznego raportu odpowiednio się zawęzi.

## Zarządzanie harmonogramami

Harmonogramy są widoczne pod nazwą raportu w **Konfiguracja → Typy zgłoszeń → [typ] → Raporty**. Z tego poziomu można:

- **edytować** harmonogram (kliknięcie nazwy) — zmienić nazwę, częstotliwość, format, język i odbiorców,
- **usunąć** harmonogram (ikona kosza) — po potwierdzeniu przestaje działać natychmiast.

Do jednego raportu można przypisać wiele harmonogramów — np. wersję dzienną dla zespołu i miesięczną dla zarządu.

---

## FAQ

### Czy mogę utworzyć harmonogram bez uruchamiania raportu?
Nie. Harmonogram zapisuje filtry z ekranu wyników, więc najpierw trzeba wykonać raport z docelowym zestawem filtrów.

### Czy mogę zmienić godzinę wysyłki?
Nie. Raporty cykliczne generowane są o 7:00 czasu ustawionego w koncie. Zmienić można częstotliwość, ale nie porę dnia.

### Czy mogę zmienić filtry istniejącego harmonogramu?
Edycja obejmuje nazwę, częstotliwość, format, język i odbiorców. Aby zmienić filtry, utwórz nowy harmonogram na podstawie raportu z nowymi filtrami i usuń poprzedni.

### Co się stanie, jeśli raport nie zwróci żadnych danych?
Plik i tak zostanie wygenerowany oraz wysłany — z samymi nagłówkami kolumn i bez wierszy.

### Czy harmonogram działa, gdy nikt nie jest zalogowany?
Tak. Generowanie odbywa się po stronie serwera, niezależnie od aktywności użytkowników.

### Co się stanie z harmonogramem po usunięciu raportu?
Harmonogramy i wersje przypisane do raportu są usuwane razem z nim i przestają być wykonywane.
