# Harmonogram automatyzacji

Harmonogram automatyzacji umożliwia cykliczne, automatyczne generowanie migawek ZWE i WEE bez ręcznej interwencji użytkownika. Każdy harmonogram definiuje zadanie wykonywane w określonym rytmie czasowym, z opcjonalną wysyłką powiadomień e-mail po zakończeniu.

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi9iM2I5Y2NjNy02ODMzLTRkYmItOWMwMi0zNWEyYjRjY2NkZjYvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.0bQzJ7McKl8M4ZPFFttkcUiLs1Xk-u8ELZ5Vs4BtJKQ " =1894x509")

### Lista harmonogramów

Widok prezentuje wszystkie skonfigurowane harmonogramy w formie kart. Każda karta zawiera komplet informacji o zadaniu i jego bieżącym stanie.

**Przyciski nad listą:**

* **+ Dodaj harmonogram** - otwiera formularz tworzenia nowego harmonogramu
* **Odśwież** - odświeża stan listy bez przeładowania strony

**Informacje wyświetlane na karcie harmonogramu:**

| Pole | Opis |
|------|------|
| Status (badge) | **Aktywny** - harmonogram jest uruchomiony i działa cyklicznie |
| Nazwa | Nazwa identyfikująca harmonogram |
| Typ zadania | Rodzaj wykonywanej operacji (np. Snapshot ZWE, Snapshot WEE) |
| Źródło | Konfiguracja ZWE lub WEE, dla której generowana jest migawka |
| Okres | Zakres danych objętych migawką (np. Bieżący dzień) |
| Status | Wynik ostatniego wykonania (np. **Sukces**) |
| Następne wykonanie | Data i godzina kolejnego automatycznego uruchomienia |
| Ostatnie wykonanie | Data i godzina poprzedniego uruchomienia |

**Akcje dostępne dla każdego harmonogramu:**

* **Uruchom jednorazowo** - natychmiastowe, jednorazowe wykonanie zadania poza harmonogramem
* **Wstrzymaj harmonogram** - zatrzymanie cyklicznego wykonywania bez usuwania konfiguracji
* **Pokaż historię** - podgląd historii wszystkich wykonań z logami
* **Edytuj** - modyfikacja ustawień harmonogramu
* **Usuń** - trwałe usunięcie harmonogramu


---

### Edycja harmonogramu

Modal **Edycja harmonogramu** zawiera pełną konfigurację zadania:

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi81ZTdiNjIwNS02ODMzLTQyODktOTc1Ny1jNGI3MDhjYzMwMmMvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.1wuRt0JJGdZ2T1z910Hrj3zcrQBAbSTAJXue7c6LnQc " =439x376")

| Pole | Opis |
|------|------|
| Nazwa | Identyfikująca nazwa harmonogramu |
| Typ zadania | Wybór operacji: Snapshot ZWE lub Snapshot WEE |
| Okres | Zakres danych wejściowych (np. Bieżący dzień - dane od 00:00 do chwili wykonania) |
| Typ harmonogramu | Częstotliwość wykonywania (np. Codziennie z własną godziną) |
| Konfiguracja ZWE / WEE | Źródło danych, dla którego generowana jest migawka |
| Następne wykonanie | Data i godzina pierwszego lub kolejnego uruchomienia |
| Tryb powtórzeń | Liczba powtórzeń (np. Bez limitu - zadanie powtarza się bezterminowo) |
| Wysyłka email | Czy po wykonaniu zostanie wysłane powiadomienie (Tak / Nie) |
| Adresy email | Lista odbiorców powiadomień; adresy dodawane są ręcznie i wyświetlane jako tagi |
| Notatka | Opcjonalny komentarz |


---

## <!-- v4.4.0 -->

### Wartości podawane ręcznie (nowość w 4.4.0)

Część wskaźników WEE opiera się na danych, których system nie zmierzy sam - np. liczbie wyprodukowanych sztuk. W konfiguracji EnLB licznik lub mianownik ustawia się wtedy jako **Wartość ręczna**. Automat nie ma skąd wziąć takiej liczby za dany okres, więc teraz sam decydujesz, co ma w takiej sytuacji zrobić harmonogram.

**Kiedy pojawia się pole**

Pole **Gdy wartość podawana jest ręcznie** widoczne jest w oknach **Dodawanie harmonogramu automatyzacji** oraz **Edycja harmonogramu** - wyłącznie wtedy, gdy:

* **Typ zadania** to **Migawka WEE**, oraz
* wybrana **Konfiguracja EnLB** ma licznik lub mianownik ustawiony na **Wartość ręczna**.

Przy konfiguracjach liczonych w całości z pomiarów pole się nie pokazuje - automat ma komplet danych z liczników i nie ma na co czekać.

**Dostępne opcje**

| Opcja | Co robi harmonogram | Kiedy wybrać |
|-------|---------------------|--------------|
| **Użyj wartości z konfiguracji** (domyślna) | Do obliczeń podstawia stałą zapisaną w konfiguracji EnLB. Wskaźnik jest liczony przy każdym wykonaniu - tak jak dotychczas. | Gdy wartość ręczna jest w praktyce stała i nie zmienia się między okresami. |
| **Czekaj na wpisanie wartości** | Tworzy migawkę i zbiera zużycie energii z liczników, ale **nie liczy wskaźnika** - czeka na wartość podaną przez człowieka za ten konkretny okres. | Gdy wartość zmienia się z okresu na okres (np. liczba wyprodukowanych sztuk, przerobiony wsad). |

**Jak wygląda praca z opcją Czekaj na wpisanie wartości**


1. Harmonogram wykonuje się o zaplanowanej porze i zapisuje migawkę za wybrany okres.
2. Na liście **Migawki WEE** migawka otrzymuje oznaczenie **Czeka na dane**, a nad listą pojawia się podsumowanie, ile migawek czeka na uzupełnienie.
3. Uzupełniasz brakującą wartość przyciskiem **Uzupełnij** przy migawce.
4. Wskaźnik zostaje policzony, a migawka trafia na wykres trendu WEE.


:::info
Wykonanie harmonogramu kończy się statusem **Sukces**, nawet jeśli wskaźnik nie został policzony. Brak danej, której nikt jeszcze nie podał, nie jest błędem automatu - zadanie zebrało wszystko, co mogło zebrać. Każde takie uruchomienie jest odnotowane w **Historii logów**.

:::


:::warning
Migawka ze stanem **Czeka na dane** nie jest uwzględniana na wykresie trendu WEE, dopóki nie uzupełnisz wartości. Dzięki temu na wykresie nie pojawi się punkt policzony ze starej stałej - taki wynik wyglądałby wiarygodnie, a byłby nieprawdziwy.

:::

Jeżeli dla harmonogramu włączono **Wysyłka email**, wiadomość za taki okres nie zawiera liczb, tylko jasną informację, jakiej wartości brakuje i gdzie ją uzupełnić. Odbiorca raportu nie dostanie wskaźnika, któremu nie można ufać.


---

### Ponowne uruchomienie za ten sam okres

Uruchomienie harmonogramu (cykliczne albo przyciskiem **Uruchom jednorazowo**) za okres, dla którego migawka już istnieje, **odświeża tę migawkę** zamiast tworzyć drugą. Koniec z duplikatami o różnych wartościach, przy których nie było wiadomo, która jest ta właściwa.

Wartości podane wcześniej ręcznie zostają zachowane - przeliczenie ich nie kasuje. Możesz więc bezpiecznie uruchomić zadanie ponownie, np. po uzupełnieniu danych albo po korekcie konfiguracji.


---

### Termin wykonania i częstotliwość migawki

Pola dat w formularzu harmonogramu korzystają z kalendarza z wyborem daty **i godziny** (format 24-godzinny):

* **Następne wykonanie** - moment kolejnego uruchomienia,
* **Zakres danych od** / **Zakres danych do** - widoczne po wybraniu okresu **Własny zakres dat**.

Wybór godziny działa jednakowo we wszystkich przeglądarkach - wcześniej w przeglądarce Firefox ustawienie godziny nie było możliwe.

Częstotliwość zapisywanej migawki wynika teraz wprost z pola **Okres**:

| Okres | Częstotliwość migawki |
|-------|-----------------------|
| Bieżący dzień, Ostatnie 24h | Dzienne               |
| Bieżący tydzień, Ostatnie 7 dni | Tygodniowe            |
| Bieżący miesiąc, Ostatnie 30 dni | Miesięczne            |
| Własny zakres dat | Własny zakres         |

Migawki tworzone automatycznie są dzięki temu opisane tak samo jak te wykonywane ręcznie - łatwiej je filtrować i porównywać na liście **Migawki WEE**.

### Historia logów

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi82NGUxM2MwNi1mMGQ4LTQxY2QtODBjZS03MmM5MmU1NTkyZWEvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.TcKHM9rnhU10HGF0m81Kht4OcU8HTs1qS8cbhjU3wew " =516x271.5")

Modal **Historia logów** prezentuje chronologiczny rejestr wszystkich wykonań danego harmonogramu.

Każdy wpis zawiera:

* **Status** - wynik wykonania (Sukces / Błąd)
* **Typ raportu** - rodzaj wygenerowanego zadania (np. `seu`)
* **Uruchomiono** - dokładny czas startu zadania
* **Zakończono** - dokładny czas zakończenia zadania
* **Email** - status wysyłki powiadomienia (**Wysłano** wraz z listą odbiorców)

Lista logów jest stronicowana z możliwością sortowania (Najnowsze / Najstarsze) i ręcznego odświeżania.

---

**Documents**

- [Omnimes](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omnimes-k1PbFf5XE7)
- [Omnienergy](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omnienergy-BWrsbBiH1j)
- [Omniplatform](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omniplatform-jARFxkuLdt)
- [FAQ](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/faq-XN4QKuFPZL)
- [Cyberbezpieczeństwo i zgodność (CRA)](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/cyberbezpieczenstwo-i-zgodnosc-cra-6dbPWZS59e)