## Opis funkcjonalności

Podczas tworzenia okna czasowego w harmonogramie można otrzymać rzucony przez serwer wyjątek określonego typu. Niektóre typy wyjątków pozwalają na dalsze uruchomienie wyszukiwania kolejnych dostępnych miejsc na tworzone okno czasowe.

Typy wyjątków, które aktualnie pozwalają na uruchomienie wyszukiwania wolnych miejsc na okno czasowe:  
\- WindowsOverlapException - wyjątek rzucany w przypadku, gdy stawiane okno czasowe nie mieści się w wybranym miejscu

> Wyszukiwanie wolnych miejsc w harmonogramie na tworzone okno działa w zakresie 24 godzin od wybranego pierwotnie miejsca.
>
> Ilość podpowiedzi uzależniona jest od ilości ramp w wybranym magazynie - gdy w magazynie mamy 4 rampy to maksymalna ilość podpowiedzi wynosić będzie właśnie 4 (istnieje możliwość, że zostanie wyświetlonych mniej miejsc gdy w zakresie 24 godzin system nie znajdzie wolnego miejsca na którejś z ramp).

Komunikat oraz podpowiedzi miejsc pojawią się w:  
\- formularzu transportu w typach transportu z jednoetapową awizacją  
\- formularzu awizacji w typach transportu z dwuetapową awizacją

## Przykład na podstawie wyjątku `WindowsOverlapException`

- okna czasowe w harmonogramie ustawione są w następujący sposób:

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/suggesting-free-spots-for-time-window/prepared-schedule.png>)

- okno czasowe stawiane jest w zaznaczonym miejscu:

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/suggesting-free-spots-for-time-window/prepared-schedule-spot.png>)

- dostajemy komunikat wyjątku oraz pojawia się klawisz `Pokaż wolne miejsca w harmonogramie`

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/suggesting-free-spots-for-time-window/exception-message.png>)

- po kliknięciu w klawisz `Pokaż wolne miejsca w harmonogramie` w formularzu pojawią się kolejne najwcześniejsze propozycje na okno czasowe

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

- po wybraniu miejsca i kliknięciu w `Dodaj awizację` okno czasowe stworzy się o określonej godzinie na określonej rampie, dodatkowo system przeniesie nas do wybranego dnia w harmonogramie

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/suggesting-free-spots-for-time-window/saved-time-window.png>)

### Wyjaśnienie propozycji miejsc na okno czasowe:

Poniżej wyjaśnienie każdej propozycji z przykładu z załączonych obrazków:

![](<https://docs.logintegra.com/apollo-backend/static/Schedule &amp; Time windows/special-features/suggesting-free-spots-for-time-window/prepared-schedule-spot.png>)

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

- Rampa: R1/Techniczna - Godzina: 00:00 28.10 - pierwotnie wybrane miejsce na okno czasowe przez użytkownika to godzina 04:00 dnia 27.10 jednak w tym dniu do końca czasu pracy magazynu rampa jest zablokowana dlatego propozycja to pierwsze wolne miejsce dnia kolejnego.
- Rampa: Rampa 5 - Godzina: 06:00 27.10 - jest to pierwsze wolne miejsce niezablokowane przez szare okno blokady tego dnia na tej rampie.
- Rampa: Rampa 6 - Godzina: 04:00 27.10 - pomimo że rampa w danym dniu jest wolna we wcześniejszych godzinach, to rozważana propozycja jest najwcześniejszym wolnym miejscem z uwzględnieniem godziny, na którą pierwotnie chciał postawić okno użytkownik.
- Rampa: Rampa 8 - Godzina: 04:00 27.10 - pomimo że rampa w danym dniu jest wolna we wcześniejszych godzinach, to rozważana propozycja jest najwcześniejszym wolnym miejscem z uwzględnieniem godziny, na którą pierwotnie chciał postawić okno użytkownik.
