Personalizacja Formularza Kartotek Kontrahentów
Plik knkon_insert.js to skrypt JavaScript odpowiedzialny za formatowanie i personalizację formularza transakcji j_insert_update.aspx do dopisywania i edycji kartotek kontrahentów, takich jak dostawcy, przewoźnicy i firmy spedycyjne. Skrypt automatyzuje proces normalizacji danych, weryfikacji poprawności wpisów oraz dynamicznego formatowania interfejsu użytkownika.
Funkcja MojaOnLoad()
Jest to funkcja inicjalizująca, odpowiedzialna za konfigurację formularza. W ramach tej funkcji wykonywane są następujące operacje:
- Sprawdzenie, czy użytkownik wykonuje operację dodawania (insert) czy edycji.
- Jeśli to dodawanie - aktywacja pola skróconej nazwy kontrahenta (SKROCO).
- W przypadku edycji - ustawienie koloru tła dla pola ResourceColor.
- Dodanie kontrolki wyboru koloru jqxMaterialColorPicker umożliwiającej wizualne oznaczenie kontrahenta.
- Automatyczne usuwanie znaków diakrytycznych i normalizacja adresów e-mail.
Funkcja skrocoChange()
Automatycznie aktualizuje wartość pola SKROCO (skrócona nazwa kontrahenta):
- Pobiera dane na podstawie unikalnego identyfikatora (PRX).
- Jeśli znaleziono odpowiedni rekord w bazie - aktualizuje wartość pola.
Personalizacja kolorystyczna
Skrypt dodaje kontrolkę do wyboru koloru (ResourceColor), dzięki czemu użytkownik może wizualnie oznaczyć kontrahenta:
- Kolor jest zapisywany w polu w formacie HEX.
- Wybrana barwa automatycznie aktualizuje tło pola.
Normalizacja adresów e-mail
Skrypt usuwa polskie znaki diakrytyczne i inne nietypowe znaki w polach:
- EMAILAUTO
Podczas wpisywania adresu skrypt:
- Usuwa znaki diakrytyczne (np. ł → l, ß → ss).
- Automatycznie aktualizuje pole formularza.
- Dodaje dynamiczną walidację poprawności adresu e-mail.
Funkcja validateEmail()
Weryfikuje poprawność wprowadzonego adresu e-mail:
- Sprawdza zgodność ze wzorcem nazwa@domena.com.
- W przypadku błędu - wyświetla komunikat ostrzegawczy.
- Poprawny adres powoduje zapis formularza.
Podsumowanie
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.
Skrypt formatujący i personalizujący transakcję j_insert_update.aspx
Skrypt j_insert_update.aspx umożliwia dopisywanie i edycję kartotek kontrahentów takich jak dostawcy, przewoźnicy czy firmy spedycyjne. Jego działanie opiera się na dynamicznym zarządzaniu formularzami, pozwalając użytkownikowi na wprowadzanie danych w sposób intuicyjny i zgodny z założeniami systemu. Dzięki zastosowaniu funkcji takich jak walidacja danych czy automatyczne formatowanie pól tekstowych, proces edycji jest zarówno szybki, jak i precyzyjny. Warto zauważyć, że skrypt wspiera różnorodne formaty danych, co czyni go uniwersalnym narzędziem w zarządzaniu bazą kontrahentów.
Jednym z istotnych elementów skryptu jest funkcja `MojaOnLoad`, która inicjuje odpowiednie akcje w zależności od trybu pracy formularza. Na przykład w trybie „insert” aktywowane są zdarzenia takie jak automatyczna zmiana wartości pola `SKROCO` po jego opuszczeniu. Dodatkowo zaimplementowano mechanizm umożliwiający wybór koloru zasobu za pomocą kontrolki kolorów, co ułatwia wizualne rozróżnianie kontrahentów. Funkcja ta integruje również walidację adresów e-mail, co minimalizuje ryzyko błędnych danych w systemie.
Skrypt zawiera także funkcję `normalizeEmail`, która zajmuje się normalizacją tekstu w polach e-mailowych poprzez usuwanie znaków diakrytycznych oraz zastępowanie specyficznych znaków. Proces ten odbywa się w czasie rzeczywistym podczas wpisywania danych przez użytkownika, co znacząco poprawia jakość wprowadzanych informacji. Funkcja ta działa na kilku polach jednocześnie, takich jak `EMAIL`, `EMAILAUTO` oraz `MAIL`, co zwiększa jej uniwersalność.
Ostatnim istotnym elementem jest walidacja adresów e-mail realizowana przez funkcję `validateEmail`. Funkcja ta sprawdza poprawność formatu adresu e-mail na podstawie wyrażenia regularnego i wyświetla stosowny komunikat w przypadku błędu. Dzięki temu użytkownik jest natychmiast informowany o konieczności poprawienia danych, co przyspiesza proces zapisu formularza. Walidacja ta jest istotna dla zapewnienia spójności i poprawności danych w systemie.