Strona może być nieaktualna
Nikt jej nie zmieniał od 62 miesięcy (ostatni commit: 2021-09-15, kaatarzyna). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.
Awizacje okresowe¶
Aby można było utworzyć awizację okresową:
- typ transportu musi mieć ustawioną flagę
allowsPeriodicTransportnatrue, - co najmniej jedna firma będąca kontrahentem w zleceniu (przewoźnik, dostawca) musi mieć ustawioną w partnerstwie z pryncypałem flagę
allowsPeriodicTransportnatrue.
UWAGA! Flaga w szczegółach kontrahenta będzie możliwa do edycji tylko jeśli w jakimś typie transportu u danego pryncypała flaga
allowsPeriodicTransportma wartośćtrue.
Jeśli powyższe warunki będą spełnione, podczas tworzenia transportu pod danymi awizacji pojawi się checkbox umożliwiający utworzenie awizacji okresowej:

Po zaznaczeniu go, widoczna będzie sekcja z danymi awizacji okresowej:

W przypadku poprawnego uzupełnienia formularza awizacji okresowej, zapisywany transport zostanie powielony zgodnie z ustawionym interwałem. Możliwe interwały są następujące:
Codziennie- powieli zapisywany transport każdego dnia w okresie zdefiniowanym datamiodidoCo tydzień- powieli zapisywany transport w okresie zdefiniowanym datamiodidow wybranych dniach tygodniaCo miesiąc- powieli zapisywany transport w okresie zdefiniowanym datamiodidow miesięcznych odstępach
Walidacje¶
- pierwsze okno czasowe musi być w terminie wybranym jako pierwszy dzień awizacji okresowej (data
od), - dodatkowo:
codziennie- maksymalny możliwy zakres czasu to 31 dni (31 awizacji okresowych)
co tydzień- maksymalny możliwy zakres czasu to 61 dni (61 awizacji - w przypadku wybrania wszystkich dni tygodnia)
- wśród dni tygodnia musi być wybrany dzień, w który przypada początek awizacji okresowej (data
od)
co miesiąc- maksymalny możliwy zakres czasu to 13 miesięcy (13 awizacji)
Oznaczenie awizacji okresowych w tabeli transportów¶
Po włączeniu dla typu transportu i roli kolumny PERIODIC_TRANSPORT_INTERNAL_INDEX w tabeli transportów widoczna jest kolumna wyświetlająca numer awizacji okresowej:

Edycja awizacji okresowej¶
Po zapisaniu transportu z awizacją okresową formularz awizacji okresowej nie jest możliwy do edycji:

Nie da się zatem edytować raz zapisanych interwałów, w których zlecenie jest powielane.
W przypadku edycji danych zlecenia, które jest awizacją okresową:
- w formularzu zlecenia,
- poprzez przeciągnięcie okna w harmonogramie,
- poprzez edycję awizacji za pomocą ołówka
i pod warunkiem, że użytkownik posiada uprawnienie ROLE_EDIT_MULTIPLE_PERIODIC_TRANSPORTS pytamy użytkownika, czy wprowadzone zmiany mają zostać zapisane we wszystkich przyszłych awizacjach okresowych:

W przypadku wyboru "OK" - wprowadzone zmiany powinny zostać zapisane we wszystkich przyszłych awizacjach okresowych.
W przypadku wyboru "Anuluj" - zmiany zapisujemy tylko w aktualnie edytowanym zleceniu.
Jeśli użytkownik nie posiada uprawnienia ROLE_EDIT_MULTIPLE_PERIODIC_TRANSPORTS zmiany zapisywane są tylko w aktualnie edytowanym zleceniu.
Wysyłanie mejli o edycji zlecenia¶
W przypadku edycji zlecenia będącego awizacją okresową mejle o edycji danych wysyłamy tylko dla aktualnie edytowanego transportu i kilku kolejnych. O tym, dla których zleceń wyjdzie informacja o edycji decyduje ustawienie SEND_FUTURE_PERIODIC_TRANSPORTS_EDIT_MAIL_INTERVAL_IN_DAYS - informacja mejlowa zostanie wysłana dla zleceń z oknami czasowymi w odstępie mniejszym niż określona tam liczba dni od okna czasowego aktualnie edytowanego zlecenia.
Usuwanie awizacji okresowej¶
W przypadku, gdy użytkownik posiada uprawnienie ROLE_DELETE_MULTIPLE_PERIODIC_TRANSPORTS i próbuje usunąć zlecenie będące awizacją okresową pytamy go, czy usunąć również wszystkie przyszłe awizacje okresowe:

W przypadku wyboru "OK" - usuwamy wszystkie przyszłe awizacje okresowe.
W przypadku wyboru "Anuluj" - usuwamy tylko aktualne zlecenie.
Jeśli użytkownik nie posiada uprawnienia ROLE_DELETE_MULTIPLE_PERIODIC_TRANSPORTS usuwamy tylko aktualne zlecenie.
Edycja firm w zleceniu / usuwanie stepów¶
Nie powinniśmy pozwolić zedytować zlecenia z awizacją okresową w taki sposób, że nie pozostanie w nim żadna firma z włączoną funkcjonalnością awizacji okresowych. W takiej sytuacji powinniśmy wyświetlić użytkownikowi komunikat:

i cofnąć wprowadzone zmiany.
UWAGA - przypadek, kiedy da się "wprowadzić zlecenie w niepoprawny stan":
- mamy zlecenie, w którym jedna firma ma włączoną flagę
allowsPeriodicTransport- w szczegółach firmy wyłączamy flagę
- w zleceniu nagle nie będzie żadnej firmy z włączoną flagą
Ostatnia zmiana: 2021-09-15 · kaatarzyna
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e