Skrypt wykorzystywany w roli Klient WMS.net umożliwiający użytkownikowi dodanie asortymentu do koszyka (bufora), w celu późniejszej edycji dokumentu.
Opis działania
Transakcja dostępna jest w kartotece asortymentowej w tabeli, pod ikoną wózka.
Aby wywołać transakcję należy przy wybranym asotymencie wybrać ikonę wózka sklepowego. Po tym działaniu ukazuje się okno:
W oknie należy podać ilość jaką chcemy zamówić, a następnie wybrać przycisk Do koszyka.
Asortyment dodany w ten sposób widoczny jest w rejetrze Koszyk. W rejestrze tym możliwa jest modyfikacja wybranego towaru oraz zapisanie skompletowanego zamówienia w postaci dokumentu zlecenia wydania.
Uruchomienie
Aby transakcja była widoczna w programie pierwszym krokiem jest dodanie skryptu do skorowidza JQS, gdzie należy podać kod oraz w kontrolce Uwagi parametry script (ścieżka, gdzie znajduje się skrypt) oraz scriptonload (funkcja, która ma zostać uruchomiona po włączeniu formularza).
Kolejnym krokiem jest wywołanie transakcji. Transakcja ta wywoływana jest z poziomu grida z dwoma parametrami:
- kod – gdzie podawany jest kod transakcji ze skorowidza,
- refno – identyfikator obiektu.
Przykład wywołania transakcji z parametrami:…//role_sys/jqs.aspx?kod=5EF9078B4B3646C699F8&refno=@REFNO
Poprawnie skonfigurowana transakcja pozwoli zapisać dokumenty do tabeli dpzle z ACH=’0′.
Dodawanie Pozycji do Zamówienia w Studio WMS.net
Plik wms_dpzle_zwz_0.js obsługuje proces dodawania pozycji do zamówienia w systemie Studio WMS.net. Skrypt umożliwia użytkownikowi wybór indeksu, wprowadzenie ilości oraz finalizację dodania produktu do koszyka zamówień.
Inicjalizacja i wczytywanie parametrów
Skrypt rozpoczyna działanie poprzez pobranie identyfikatora obiektu z adresu URL, wykorzystując funkcję getParameterFromUrl("refno", "a"). Dzięki temu system aktywnie przypisuje wartość do zmiennej gcRefno, która służy jako odniesienie dla dalszych operacji. Następnie funkcja MojaOnLoad() sprawdza, czy parametr gcRefno został poprawnie przekazany. Jeśli parametr nie jest dostępny, skrypt wyświetla komunikat o braku danych; w przeciwnym przypadku wywołuje funkcję ThisUstawOkno() w celu wygenerowania interfejsu.
Generowanie interfejsu dodawania do koszyka
Funkcja ThisUstawOkno(cTekst) aktywnie pobiera szczegóły asortymentu za pomocą funkcji ssDataSQL, przekazując jako parametry identyfikator użytkownika (cZrodloUser[0].KTRHID) oraz gcRefno. Jeśli zapytanie zwróci poprawne dane, skrypt dynamicznie generuje strukturę HTML z tabelą, która wyświetla indeks oraz nazwę asortymentu. Dodatkowo system tworzy pole do wprowadzenia ilości zamawianej oraz przycisk „Do koszyka”. W ten sposób użytkownik otrzymuje przejrzysty interfejs umożliwiający dodanie pozycji do koszyka.
Skrypt aktywnie sprawdza również uprawnienia użytkownika – jeśli długość identyfikatora KTRHID wynosi 0, system wyświetla komunikat „Brak uprawnień”. Po wygenerowaniu interfejsu, skrypt ustawia zawartość elementu #formularz oraz wywołuje funkcje formatujące, takie jak JQS_ustawStrone(75) i ssTlumaczenie(), które dostosowują wygląd interfejsu do ustawionych standardów.
Obsługa operacji dodawania pozycji do koszyka
Gdy użytkownik kliknie przycisk „Do koszyka”, funkcja btnDodaj() zostaje wywołana. Na początku skrypt ukrywa przycisk, aby zapobiec wielokrotnemu kliknięciu, a następnie sprawdza, czy istnieje już zamówienie, do którego można dodać nowe pozycje. W tym celu system wykonuje zapytanie za pomocą ssDataSQL z określonym identyfikatorem zapytania.
Jeśli wynik zapytania wskazuje na istnienie istniejącego zamówienia, system buduje ciąg parametrów zawierający identyfikator gcRefno, wprowadzoną ilość, identyfikator pozycji z zamówienia oraz nowy numer referencyjny, a następnie wywołuje funkcję AddSuccessEnd() z odpowiednim zapytaniem SQL (ssExSQL). W przeciwnym przypadku system traktuje operację jako tworzenie nowego zamówienia, budując ciąg parametrów z wartością „0” jako identyfikatorem pozycji oraz dwoma numerami referencyjnymi – jednym dla nowego zamówienia i drugim jako unikalny identyfikator.
Obsługa wyniku operacji dodawania
Funkcja AddSuccessEnd(wynik) aktywnie analizuje wynik operacji dodawania. Jeśli zwrócony wynik zawiera jakikolwiek komunikat (np. błąd), skrypt wyświetla alert z tą informacją. W przeciwnym przypadku, po pomyślnym wykonaniu operacji, skrypt zamyka okno transakcji, wywołując metodę jqxWindow('close') na oknie rodzica. Dzięki temu użytkownik zostaje natychmiast poinformowany o zakończeniu operacji i może kontynuować pracę w systemie.
Funkcja MojaOnLoad()
Skrypt rozpoczyna działanie poprzez pobranie identyfikatora obiektu z adresu URL, wykorzystując funkcję getParameterFromUrl("refno", "a"). Dzięki temu system aktywnie przypisuje wartość do zmiennej gcRefno, która służy jako odniesienie dla dalszych operacji. Następnie funkcja MojaOnLoad() sprawdza, czy parametr gcRefno został poprawnie przekazany. Jeśli parametr nie jest dostępny, skrypt wyświetla komunikat o braku danych; w przeciwnym przypadku wywołuje funkcję ThisUstawOkno() w celu wygenerowania interfejsu.
Podczas ładowania strony system wykonuje kilka kluczowych operacji:
- Sprawdza, czy dostępny jest numer referencyjny (gcRefno) zamówienia.
- Jeśli parametr REFNO nie został przekazany, wyświetla komunikat o błędzie.
- Ładuje dane użytkownika i sprawdza jego uprawnienia.
- Generuje dynamiczny interfejs z tabelą szczegółów zamawianej pozycji.
- Ustawia domyślne formatowanie strony i wywołuje funkcję tłumaczenia interfejsu.
Funkcja ThisUstawOkno()
Obsługuje ładowanie danych pozycji na podstawie numeru referencyjnego:
- Wykonuje zapytanie SQL w celu pobrania informacji o produkcie.
- Jeśli system znajdzie jedną pasującą pozycję, generuje tabelę zawierającą:
- Indeks – kod produktu.
- Nazwa – pełna nazwa towaru.
- Ilość zamawiana – dynamiczne pole umożliwiające wpisanie ilości.
- Dodaje przycisk Do koszyka, który umożliwia dodanie pozycji do zamówienia.
Funkcja btnDodaj()
Obsługuje dodanie pozycji do zamówienia:
- Ukrywa przycisk Do koszyka, aby zapobiec wielokrotnemu dodawaniu.
- Sprawdza, czy istnieje aktywne zamówienie, do którego można dodać pozycję.
- Jeśli zamówienie istnieje, wysyła zapytanie SQL z parametrami:
- Numer referencyjny produktu (gcRefno).
- Wprowadzona ilość.
- Numer referencyjny pozycji.
- Jeśli nie ma aktywnego zamówienia, tworzy nowe zamówienie i dodaje pozycję.
Funkcja AddSuccessEnd()
Obsługuje zakończenie operacji:
- Jeśli zapytanie SQL zwróciło wynik, system wyświetla komunikat o błędzie.
- Jeśli operacja się powiodła, zamyka okno dialogowe.
Obsługa walidacji
System dynamicznie weryfikuje poprawność operacji:
- Sprawdza, czy użytkownik ma wymagane uprawnienia.
- Nie pozwala na dodanie pozycji bez określenia ilości.
- Zapobiega wielokrotnemu dodaniu tej samej pozycji.
Podsumowanie
Plik wms_dpzle_zwz_0.js umożliwia dodawanie pozycji do zamówienia w Studio WMS.net. Skrypt automatycznie pobiera dane produktu, umożliwia wprowadzenie ilości oraz zapisuje pozycję w systemie. Dzięki dynamicznej walidacji i kontroli użytkownik może efektywnie zarządzać zamówieniami.
Skrypt wms_dpzle_zwz_0.js realizuje proces dodawania asortymentu do koszyka (bufora) w systemie WMS.net. System aktywnie pobiera parametry z URL, generuje dynamiczny interfejs wyświetlający szczegóły asortymentu, umożliwia użytkownikowi określenie ilości oraz dodanie pozycji do koszyka. Po wprowadzeniu danych system weryfikuje, czy istnieje już zamówienie, i na tej podstawie tworzy nowy dokument lub modyfikuje istniejący. Na koniec system komunikuje wynik operacji i zamyka okno, zapewniając przejrzystość i bezpieczeństwo operacji w systemie WMS.net.
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
jqs_dpinw_insert
Skrypt jqs_dpinw_insert.js realizuje kompleksowy proces dopisywania inwentaryzacji. Na początku inicjuje i konfiguruje interfejs, pobiera dane użytkownika oraz generuje dynamiczny formularz na podstawie wybranego rodzaju inwentaryzacji. Następnie system aktywnie waliduje dane, sprawdza istnienie dokumentów w buforze oraz weryfikuje, czy dana inwentaryzacja nie została już wcześniej dopisana.
jqs_dpinw_zamknij
Skrypt jqs_dpinw_zamknij.js realizuje kompleksowy proces zamykania inwentaryzacji. Na początku dynamicznie generuje interfejs, wyświetlając dane inwentaryzacji, takie jak numer i data. Następnie skrypt sprawdza, czy inwentaryzacja zawiera pozycje bez bilansu otwarcia, co może blokować zamknięcie.
tablet_dpmag_pw
Plik tablet_dpmag_pw.js obsługuje proces tworzenia i edycji dokumentu przyjęcia wewnętrznego (PW) w systemie Studio WMS.net. Skrypt umożliwia dynamiczne dodawanie pozycji, walidację danych oraz zapis dokumentu w bazie SQL. Dzięki temu użytkownik może efektywnie zarządzać procesem przyjęcia wewnętrznego towarów w magazynie.
tablet_dpmag_rw
Plik tablet_dpmag_rw.js obsługuje proces tworzenia dokumentu rozchodu wewnętrznego (RW) w systemie Studio WMS.net. Skrypt umożliwia użytkownikowi dodawanie, edytowanie oraz zatwierdzanie dokumentu RW, a także obsługuje walidację danych oraz dynamiczne interakcje z bazą SQL.