Plik: maw_users.js – Zarządzanie Użytkownikami w Systemie VSS
Plik maw_users.js odpowiada za zarządzanie użytkownikami systemu VSS, w tym ich rolami, firmami, danymi kontaktowymi oraz walidacją adresów e-mail. Skrypt automatyzuje proces przypisywania ról i firm na podstawie wprowadzonych danych oraz zapewnia dynamiczną konfigurację formularza użytkownika.
Funkcja MojaOnLoad()
Główna funkcja inicjalizująca interfejs zarządzania użytkownikami. W jej ramach:
- Automatycznie normalizuje adres e-mail użytkownika (normalizeEmail()).
- Ustawia domyślny język użytkownika na Polski, jeśli pole jest puste (setLanguageLabel()).
- Pobiera numer użytkownika (nriduser) z parametrów URL.
- Wyszukuje firmę powiązaną z użytkownikiem na podstawie numeru (ktrhid).
- Jeśli użytkownik nie ma przypisanej roli, ukrywa pole wyboru firmy.
- Obsługuje dynamiczną zmianę firm w zależności od wybranej roli.
Obsługa ról użytkownika
Skrypt obsługuje mechanizm przypisywania ról, co umożliwia określenie uprawnień użytkownika w systemie. Po wyborze roli:
- Pobierana jest lista firm powiązanych z daną rolą.
- W przypadku ról VSSspd (spedycja) i VSSkontr (kontrahenci), system przypisuje inne źródła danych.
- Użytkownik może wybrać firmę przypisaną do jego roli.
Funkcja editComboByRole()
Obsługuje dynamiczne przypisywanie listy firm w zależności od roli:
- VSSspd – użytkownik może wybierać firmy transportowe.
- VSSkontr – użytkownik ma dostęp do listy kontrahentów.
Funkcja normalizeEmail()
Odpowiada za normalizację adresów e-mail w formularzu:
- Usuwa polskie znaki diakrytyczne i inne nieprawidłowe znaki.
- Automatycznie aktualizuje pole e-mail po wprowadzeniu tekstu.
- Obsługuje pola EMAIL, EMAILAUTO i MAIL.
Funkcja validateEmail()
Waliduje poprawność wprowadzonego adresu e-mail:
- Sprawdza, czy adres ma poprawny format (nazwa@domena.com).
- Jeśli format jest błędny, wyświetla komunikat ostrzegawczy.
- W przypadku poprawnego adresu wysyła formularz do zapisania zmian.
Podsumowanie
Plik maw_users.js zapewnia dynamiczną konfigurację użytkowników systemu VSS. Obsługuje zarządzanie rolami, przypisywanie firm, normalizację adresów e-mail oraz walidację danych wejściowych. Dzięki temu system automatycznie dostosowuje uprawnienia użytkownika i zapewnia poprawność danych wprowadzanych do systemu.
Mechanizm normalizacji adresów e-mail
Funkcja normalizeEmail() odpowiada za automatyczne czyszczenie znaków specjalnych w polach mailowych. W trakcie wpisywania tekstu usuwa znaki diakrytyczne, zastępując polskie litery ich podstawowymi odpowiednikami. Na przykład litera „ł” jest konwertowana na standardowe „l”. Proces ten uruchamia się zarówno podczas wpisywania treści, jak i przy próbie zaznaczenia pola, co zapobiega błędom formatowania.
Dynamiczne zarządzanie widocznością firm
Skrypt wykorzystuje parametr nriduser z adresu URL do pobrania danych użytkownika. W zależności od wybranej roli w polu ROLA system pokazuje lub ukrywa sekcję wyboru firmy. Gdy wartość roli jest pusta, cały wiersz KTRHID pozostaje niewidoczny. Wybranie konkretnej opcji w comboboxie powoduje zmianę źródła danych dla listy firm, co realizuje funkcja editComboByRole().
Walidacja formatu poczty elektronicznej
Moduł validateEmail() sprawdza poprawność struktury adresu za pomocą wyrażenia regularnego. W przypadku wykrycia nieprawidłowości wyświetla dynamiczną podpowiedź z komunikatem błędu. Po udanej weryfikacji automatycznie inicjuje procedurę zapisu formularza. Mechanizm obsługuje równocześnie trzy różne pola mailowe, przypisując odpowiednie zdarzenia do każdego z nich.
Automatyczne ustawienia językowe
Funkcja setLanguageLabel() zapewnia domyślną wartość „Polski” w polu języka gdy pozostaje puste. Rozwiązanie to eliminuje konieczność ręcznego wyboru przez użytkownika w typowych scenariuszach. Skrypt działa natychmiast po załadowaniu strony, korzystając z metody initializacji w MojaOnLoad().
Podsumowanie działania skryptu
Plik maw_users.js realizuje kompleksową obsługę formularza użytkownika z dynamiczną zmianą interfejsu. Łączy walidację danych z adaptacyjnym zachowaniem elementów strony w oparciu o role i parametry URL. Kluczowe funkcje współpracują ze sobą poprzez mechanizmy zdarzeniowe, zapewniając płynność interakcji. Całość stanowi przykład modułowego podejścia do zarządzania formularzami w aplikacjach webowych.
Czytaj więcej:
jqs_maw_operacje
Skrypt implementuje kompleksowy formularz do rejestracji przyjęć magazynowych z dynamicznym interfejsem. Zapewnia integrację z systemem WMS poprzez zarządzanie lokalizacjami i nośnikami. Modułowa budowa pozwala na rozszerzanie funkcjonalności o dodatkowe załączniki i notatki. Mechanizmy walidacji i potwierdzeń chronią przed błędami wprowadzania danych.
Transakcje YMS integracja z bazą danych interfejs użytkownika javascript jqs system magazynowy zarządzanie dokumentami
knkon_insert
Plik knkon_insert.js wprowadza dynamiczne ulepszenia w formularzu kartotek kontrahentów. Umożliwia personalizację poprzez wybór koloru, automatycznie normalizuje dane i waliduje adresy e-mail. Dzięki temu użytkownicy mogą szybciej i wygodniej dodawać lub edytować dane dostawców, przewoźników i firm spedycyjnych, minimalizując ryzyko błędów.
maw_events_dyspozycja
Plik maw_events_dyspozycja.js obsługuje przydzielanie miejsc oraz zarządzanie dyspozycjami w procesie awizacji. Umożliwia dynamiczną konfigurację transportu, automatyczne wysyłanie powiadomień SMS oraz zapis do bazy danych, co poprawia organizację ruchu transportowego.
maw_sko_mam
Plik maw_sko_mam.js to moduł systemu VSS pozwalający logistykom efektywnie zarządzać dokami magazynowymi. Umożliwia dynamiczne przeglądanie dostępnych doków, dodawanie nowych oraz organizowanie ich kolejności. Dzięki wbudowanej walidacji danych i integracji z bazą SQL system zapewnia płynne zarządzanie przestrzenią załadunkową i rozładunkową magazynów.
przekaz_nridodn
Plik przekaz_nridodn.js obsługuje proces normalizacji i walidacji adresów e-mail w systemie Studio WMS.net. Skrypt automatycznie normalizuje wprowadzane adresy e-mail, usuwając znaki diakrytyczne, oraz zapewnia walidację formatu e-mail przed zapisaniem formularza.