# Automatyczne usuwanie dedykowanych okien czasowych

Funkcjonalność pozwala na ustawienie automatycznego usuwania dedykowanych, nieobsadzonych i obsadzonych okien czasowych. Usuwanie odbywa się na X czasu przed lub po (w zależności od ustawień) dacie startu dedykowanego okna czasowego.

## Włączenie funkcjonalności

Włączenie funkcjonalności wymaga uzupełnienia dwóch pól dla firmy pryncypała oraz dodatkowo włączenia funkcjonalności dla poszczególnych ramp:

1. włączenie funkcjonalności dla firmy pryncypała (zakładka `Ustawienia`):

   ![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/dedicated-time-window-automatic-removal/setting-switch.png>)
2. ustawienie interwału czasu:

   ![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/dedicated-time-window-automatic-removal/setting-interval.png>)
3. włączenie funkcjonalności dla poszczególnych ramp (zakładka `Ustawienia` -\> edycja magazynu -\> edycja rampy):

   ![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/dedicated-time-window-automatic-removal/ramp.png>)

   ---

   **Ustawienia w bazie danych dotyczące tego ficzerka:**

- mamy parametr, że job (`DeleteDedicatedTimeWindowsJob`) wykonuje się co godzinę (na cały system)
- mamy settings (per pryncypał), z jakim wyprzedzeniem usuwać te okna dedykowane,
- mamy oznaczenie w rampie, czy usuwać z niej okna czy nie

### tabela: SETTING

- nazwa ustawienia: **AUTOMATIC\_DELETING\_UNUSED\_DEDICATED\_WINDOWS\_ENABLED**
- nazwa ustawienia: **AUTOMATIC\_DELETING\_USED\_DEDICATED\_WINDOWS\_ENABLED**
- nazwa ustawienia: **AUTOMATIC\_DELETING\_DEDICATED\_WINDOWS\_INTERVAL**

### tabela : PARAMETER

- nazwa ustawienia: **DELETE\_DEDICATED\_TIME\_WINDOWS\_JOB\_INTERVAL**

## Działanie funkcjonalności

Po prawidłowym włączeniu funkcjonalności dla firmy kontrahenta dedykowane okna czasowe powinny usuwać się automatycznie w czasie zgodnym z ustawieniami.

Okna usuwane są z przedziału : \* start później niż:  \-  \-  \* start wcześniej niż:  \-  \+

### Przykład

Parametr interwału czasowego można ustawić:

- na usuwanie **przed** czasem startu okna -\> parameter pryncypała X np.: `-4h`, parametr jobu `1h`, mamy 12:00 wyszukamy okna:

  ```
      - okno ustawione na godzinę 10:00 zostanie usunięte o godzinie 6:00
  ```

  start później niż: 12:00 → -4h - 1h = 7:00 start wcześniej niż: 12:00 → -4h + 1h = 9:00

Czyli takie, które zaczynają się pomiędzy 7 a 9, a potem będziemy dla nich sprawdzać, czy są spełnione pozostałe warunki.

- na usuwanie **po** czasie startu okna -\> parameter pryncypała X np.: `4h`, parametr jobu `1h`, mamy 12:00  
  start później niż: 12:00 → +4h - 1h = 15:00 start wcześniej niż: 12:00 → +4h + 1h = 17:00

  ```
   - okno ustawione na godzinę 10:00 zostanie usunięte o godzinie 14:00
  ```

  czyli takie, które zaczynają się pomiędzy 15 a 17, a potem będziemy dla nich sprawdzać, czy są spełnione pozostałe warunki.

#### Pozostałe warunki, czyli:

- czy naprawdę do ich początku jest już mniej czasu niż wskazuje interwał per pryncypał (AUTOMATIC\_DELETING\_DEDICATED\_WINDOWS\_INTERVAL),
- czy są/nie są obsadzone i czy spełnia to warunki ustawione przez settingsy AUTOMATIC\_DELETING\_UNUSED\_DEDICATED\_WINDOWS\_ENABLED i AUTOMATIC\_DELETING\_USED\_DEDICATED\_WINDOWS\_ENABLED

> Dostępne wartości interwału czasowego to: (opcjonalny znak "-") (liczba) (znacznik s|m|h|d)  
> np.: 30s, 0m, -2h, -1d, 1d

Parametr interwału czasowego ustawiony w następujący sposób (1h):

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/dedicated-time-window-automatic-removal/setting-interval.png>)

dla okna czasowego ustawionego na np.: godzinę 20:00:

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/dedicated-time-window-automatic-removal/time-window.png>)

będzie skutkowało usunięciem okna o godzinie 21:00.

## Edycja settingsu per pryncypał - `AUTOMATIC_DELETING_DEDICATED_WINDOWS_INTERVAL`

W momencie zmiany tego parametru sprawdzamy, czy aktualna wartość obejmuje jakieś okna dedykowane i usuwamy je ad hoc.
