Kalendarze – konfiguracja widoków awizacji w kartotekach VSS.net

Pozycja Kalendarze w sekcji Kartoteki (między pozycjami Bramy a Skorowidze) umożliwia przeglądanie i konfigurowanie wszystkich definicji kalendarzy awizacyjnych dostępnych w systemie. Każdy kalendarz definiuje, w jaki sposób awizacje są wyświetlane w widoku kalendarzowym, jakie operacje są dozwolone (dodawanie, edycja, usuwanie zdarzeń) oraz dla jakich ról i magazynów kalendarz jest przeznaczony. Moduł Kalendarze w Kartotekach pełni rolę słownika konfiguracyjnego — to tutaj administrator zarządza dostępnymi widokami kalendarzy, które następnie pojawiają się w menu Awizacje → Kalendarze.

Zestawienie tabelaryczne – lista kalendarzy

Po wejściu w Kartoteki → Kalendarze system wyświetla zestawienie „Kalendarze awizacji" z pełną listą zdefiniowanych kalendarzy. Wiersz bezpośrednio pod nagłówkami zawiera pola filtrów. W systemie demonstracyjnym zdefiniowanych jest 31 kalendarzy; widok domyślny pokazuje 50 rekordów na stronę.

Ekran przedstawia zestawienie kalendarzy dostępnych w sekcji Kartoteki systemu Studio VSS.net. Tabela zawiera kolumny: Aktywne, Kod (AWMK2, AWMBA, AWMT, AWKT, AWKO), Nazwa kalendarza (Kalendarz bramy MAGAZYN, Kalendarz wg TABELA dzisiaj, Kalendarz wg bramy MAGAZYN VERTICAL, Kalendarz wg ACH dziś), Domyślny sposób prezentacji danych, flagi Dodawanie, Usuwanie oraz Edycja daty. Każdy kalendarz jest niezależną konfiguracją definiującą dane źródłowe (zapytanie SQL do RESOURCES), sposób filtrowania, widok domyślny oraz uprawnienia użytkowników dla poszczególnych ról w systemie WMS/TMS.

Konfiguracja kalendarza – polecenie Ustawienia

Polecenie Ustawienia to formularz edycji definicji kalendarza. Dostępne jest dla administratora po zaznaczeniu wiersza kalendarza na liście i kliknięciu przycisku ✏ Ustawienia w toolbarze (lub wybraniu Ustawienia z menu kontekstowego prawym przyciskiem myszy). Okno zawiera trzy zakładki: Dane podstawowe, Uprawnienia i Zdarzenia. Przycisk Zamknij jest widoczny w każdej zakładce.

Zakładka Dane podstawowe

Zakładka zawiera pola identyfikujące kalendarz, konfigurację źródła danych SQL, ustawienia widoku oraz parametry harmonogramu. Pola Zapytanie–RESOURCES, Warunek filtrowania danych i PodZapytanie wymagają znajomości struktury bazy danych i są przeznaczone wyłącznie dla administratora.

Ekran przedstawia okno Ustawienia kalendarza w systemie Studio VSS.net, zakładka Dane podstawowe. Widoczne pola: Kod (AWKT2), Nazwa kalendarza (Kalendarz wg TABELA dzisiaj 2), Zapytanie-RESOURCES (SELECT TOP(1) OPIS FROM x_skorowidze z warunkami PRX, KOD i ROLASYS), Warunek filtrowania danych (ROLASYS, magazyn, TABELA, DATE_FROM), PodZapytanie, Lista możliwych widoków (timelineDayView), Kolorystyka obiektów (schema04), Sposób prezentacji danych (timelineDayView), Pierwszy dzień tygodnia (1), Godzina rozpoczęcia (6), Godzina zakończenia (22), Czas pracy od (8), Czas pracy do (22).

Zakładka Uprawnienia

Zakładka steruje tym, jakie operacje na zdarzeniach są dostępne dla użytkowników korzystających z tego kalendarza. Typowa konfiguracja dla pracownika logistyki: włączone Edycja wydarzeń, Menu kontekstowe, Wyświetl ToolTip, Wyświetl toolbar, Wyświetl legendę — wyłączone Dodawanie, Usuwanie, Przesuwanie, Rozciąganie (zmiany terminów i tworzenie awizacji odbywa się przez dedykowane formularze).

Ekran przedstawia zakładkę Uprawnienia w oknie Ustawień kalendarza systemu Studio VSS.net. Checkboxy operacyjne: Dodawanie wydarzeń, Usuwanie wydarzeń, Edycja wydarzeń, Edycja daty – przesuwanie, Edycja daty – rozciąganie. Ustawienia interfejsu: Menu kontekstowe (zaznaczone), Wyświetl ToolTip (zaznaczone), Wyświetl toolbar (zaznaczone), Wyświetl legendę, Pozycja legendy (bottom). Konfiguracja pozwala administratorowi ograniczyć możliwości edycji dla użytkowników bez uprawnień administracyjnych, zachowując podgląd awizacji w widoku harmonogramu.

Zakładka Zdarzenia

Zakładka Zdarzenia zawiera zaawansowaną konfigurację techniczną definiującą wygląd kafelków zdarzeń, zachowanie przy interakcjach oraz skrypty JavaScript. Jest przeznaczona wyłącznie dla administratorów systemu — błędna modyfikacja pól SQL lub JavaScript może spowodować nieprawidłowe działanie kalendarza.

Ekran przedstawia zakładkę Zdarzenia w oknie Ustawień kalendarza systemu Studio VSS.net. Pola: Treść ToolTip (SQL SELECT TOP(1) replace z tabelą KNKON i polem NRAWIZO), Treść pozycji 1 (SQL CASE WHEN AGENCJA_CELNA=1 z obrazkiem i polami SKROCO, NRAUTA), Treść pozycji 2, ScriptOnLoad (JavaScript: jqxScheduler z zakresem min/max ±90 dni), ScriptOnChange (ssDataSQL z GUID), RENDERAPPOINTMENT. Zakładka umożliwia zaawansowaną personalizację wyglądu i zachowania każdego wpisu w kalendarzu – od treści tooltipa po skrypty JavaScript reagujące na zmianę zakresu dat.

Wskazówki dla administratora

Jeśli użytkownicy skarżą się, że kalendarz otwiera się w nieodpowiednim widoku — zmień pole Sposób prezentacji danych na właściwy tryb (np. z weekView na timelineDayView). Nowy widok musi być obecny w polu Lista możliwych widoków. Pola Zapytanie–RESOURCES i Warunek filtrowania danych mają ikonę lupy — kliknięcie jej otwiera podgląd wyników bez zapisywania, co pozwala sprawdzić poprawność zapytania przed wdrożeniem.

Aby przeciąganie awizacji (drag & drop) działało poprawnie, wymagane są jednocześnie trzy ustawienia: checkbox Edycja daty – przesuwanie zaznaczony w zakładce Uprawnienia, wypełnione pole Update drag&drop w zakładce Zdarzenia oraz poprawny URL obsługujący aktualizację dat w bazie. Odznaczenie pola Aktywne w zakładce Dane podstawowe ukrywa kalendarz w menu użytkownika bez usuwania konfiguracji — można go przywrócić ponownie zaznaczając to pole. Schematy kolorów schema01–schema23 wpływają na paletę zdarzeń — dla kalendarzy wyświetlających te same bramy lub magazyny warto używać tego samego schematu, aby zachować spójność wizualną.