Skrypt zaczyna działanie od funkcji SSReady(), która pobiera parametr URL o nazwie „_nridodn” i przypisuje jego wartość do kontrolki o identyfikatorze NRIDODN. Następnie skrypt wywołuje funkcję normalizeEmail(), aby zadbać o poprawność wprowadzanych adresów e-mail. Skrypt realizuje pierwszy etap działań, gdy pobiera dane z adresu URL, co umożliwia ustawienie odpowiedniego kontekstu dla przetwarzania danych. Dodatkowo, zastosowanie funkcji SSReady() upraszcza integrację z innymi fragmentami kodu, co sprawia, że skrypt staje się bardziej modularny.
Opis
Funkcja getParamValue() służy do wyodrębnienia wartości przekazanego parametru z ciągu znaków URL. Najpierw skrypt dzieli ciąg wyszukiwania pod kątem zadanego parametru, co umożliwia rozdzielenie wartości od reszty adresu. Następnie, funkcja sprawdza czy parametr istnieje, a jeśli nie, zwraca pusty ciąg znaków. Ta metoda pozwala na dynamiczne pobieranie danych bez konieczności ręcznego odczytywania adresu URL, co jest bardzo pomocne przy przetwarzaniu formularzy.
Funkcja normalizeEmail() odpowiada za standaryzację wprowadzanych adresów e-mail w trzech różnych polach: EMAIL, EMAILAUTO oraz MAIL. Skrypt wiąże zdarzenie keyup z każdym z tych pól, co oznacza, że na każdą zmianę wprowadzanych znaków skrypt wywołuje procedurę normalizacji. Dzięki zastosowaniu metody normalize(„NFD”) oraz odpowiednich wyrażeń regularnych, skrypt usuwa znaki diakrytyczne, zastępuje literę „ł” literą „l” oraz znak „ß” ciągiem „ss”. Ponadto, skrypt ustawia atrybut onclick dla przycisku zapisu, aby wywołać walidację e-maila, co zwiększa interaktywność formularza.
Funkcja validateEmail() sprawdza poprawność formatu e-maila przy użyciu wyrażenia regularnego. Skrypt pobiera wartość z konkretnego pola na podstawie przekazanego identyfikatora i testuje ją względem schematu określonego w regex. Jeśli format e-maila nie spełnia oczekiwanych kryteriów, skrypt wyświetla komunikat o błędzie przy pomocy JqxTooltip. W przeciwnym razie skrypt wywołuje funkcję SendForm(’1′), co pozwala na dalsze przetwarzanie danych, a tym samym umożliwia wysłanie formularza do serwera.
Normalizacja i Walidacja Adresów E-mail w Studio WMS.net
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.
Funkcja SSReady()
Główna funkcja inicjalizacyjna, uruchamiana podczas ładowania strony:
- Odczytuje parametr _nridodn z adresu URL i przypisuje go do pola NRIDODN.
- Wywołuje funkcję normalizeEmail(), która odpowiada za automatyczne przekształcenie adresów e-mail w poprawny format.
Funkcja getParamValue(param)
Odpowiada za pobranie wartości konkretnego parametru z adresu URL:
- Rozdziela ciąg zapytania na części.
- Jeśli parametr istnieje, zwraca jego wartość.
- W przeciwnym razie zwraca pusty ciąg.
Funkcja normalizeEmail()
Automatycznie normalizuje wpisane adresy e-mail w polach formularza:
- Nasłuchuje zdarzeń keyup oraz focus w polach EMAIL, EMAILAUTO i MAIL.
- Usuwa znaki diakrytyczne z wpisanego tekstu.
- Podmienia polskie znaki na ich podstawowe odpowiedniki (np. ł → l, ß → ss).
- Automatycznie aktualizuje pole wejściowe po każdej zmianie.
- Po wprowadzeniu adresu przypisuje funkcję validateEmail() do przycisku zapisu formularza.
Funkcja validateEmail(idMail)
Sprawdza poprawność wpisanego adresu e-mail:
- Weryfikuje, czy adres spełnia format: nazwa@domena.tld.
- Jeśli format jest niepoprawny, wyświetla komunikat ostrzegawczy.
- W przypadku poprawnego formatu wywołuje funkcję SendForm(’1′), co inicjalizuje zapis formularza.
Obsługa walidacji
System dynamicznie kontroluje poprawność wpisanych adresów e-mail:
- Usuwa zbędne znaki diakrytyczne podczas wprowadzania danych.
- Zapewnia jednolity format e-mail, eliminując błędy użytkownika.
- Blokuje możliwość zapisania formularza, jeśli adres nie spełnia standardowych wymagań.
Podsumowanie
Plik przekaz_nridodn.js odpowiada za automatyczną normalizację i walidację adresów e-mail w systemie Studio WMS.net. Skrypt dynamicznie usuwa znaki diakrytyczne i sprawdza poprawność formatu przed zapisaniem formularza. Dzięki temu użytkownicy mogą wprowadzać adresy e-mail w poprawnej postaci bez dodatkowej ręcznej korekty.
Czytaj więcej:
Dopisanie cennika – wms_koszty.js
Transakcja zawiera funkcje pomocnicze dotyczące dopisania cennika usług klienta. Cennik jest dopisywany dla klienta. Przy dopisaniu pozycji cennika wybierane są kartoteki usług. Funkcje CennikOnLoad() i CennikOnReady() są używane jako parametry transakcji j_insert_update.aspx. Przykład parametru: script=../role_wms/wms_koszty& scriptonload=CennikOnLoad()& scriptonready=CennikOnReady()& kodtransakcji=WMS_INS_KNUSL_CEN& return=ZamknijOkno&leftpanelwidth=0& nridusl= CennikOnLoad(): Odczytuje i zapamiętuje identyfikator kontrahenta zapisywane w pozycji cennika. Dla przycisku ZAPISZ definiuje wykonanie funkcji ZapiszCennik() po potwierdzeniu przycisku. CennikOnReady() Odczytuje i
j_kalendarz_maw
Skrypt JavaScript zarządza kalendarzem wydarzeń poprzez obsługę formularza z polami daty oraz innymi informacjami o wydarzeniu. Umożliwia dodawanie nowych wydarzeń do kalendarza wraz z walidacją poprawności dat oraz zapisem danych do bazy poprzez wywołanie procedury składowanej SQL.
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_users
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.