android_dpmag_rw

Obsługa Dokumentów RW w Aplikacji Mobilnej dla Magazyniera

Plik android_dpmag_rw.js obsługuje proces rejestracji rozchodu wewnętrznego (RW) w aplikacji mobilnej Studio WMS.net. Skrypt umożliwia magazynierowi skanowanie kodów EAN, wybór lokalizacji pobrania, określanie ilości oraz zapis operacji w systemie.

Funkcja MojaOnLoad()

Główna funkcja odpowiedzialna za inicjalizację interfejsu użytkownika:

1. Ładuje parametry operacji, takie jak typ dokumentu (RW – rozchód wewnętrzny).
2. Tworzy dynamiczny formularz dla użytkownika.
3. Inicjalizuje pola do skanowania kodów EAN i wyboru lokalizacji.
4. Dodaje obsługę kodów QR do automatycznego wypełniania pól.

Obsługa dokumentów RW

Formularz podzielony jest na etapy:

STEP0 – Skanowanie kodu EAN

• Użytkownik skanuje kod EAN artykułu.
• System pobiera indeks, nazwę oraz dostępne ilości produktu.

STEP1 – Wybór lokalizacji pobrania

• Użytkownik wpisuje lokalizację, z której pobierze towar.
• System sprawdza, czy w wybranej lokalizacji znajduje się dany asortyment.

STEP2 – Wprowadzenie ilości

• System weryfikuje poprawność ilości i czy mieści się w dopuszczalnym zakresie.

Obsługa walidacji danych

Skrypt monitoruje interakcje użytkownika i reaguje na:

• Wpisanie kodu EAN – pobiera informacje o produkcie.
• Wprowadzenie lokalizacji – aktywuje kolejne pola.
• Wprowadzenie ilości – sprawdza, czy wartość nie przekracza dostępnej ilości.

Funkcja saveDocument()

Obsługuje zapis danych do bazy SQL:

1. Tworzy zapytanie SQL do rejestracji operacji RW.
2. Po poprawnym zapisie usuwa wprowadzone dane i resetuje formularz.

Funkcja endFunc()

Odpowiada za zakończenie operacji:

• Jeśli dokument RW został zapisany, prosi użytkownika o potwierdzenie jego zamknięcia.
• W przeciwnym razie zamyka okno i odświeża aplikację.

Obsługa kodów QR

Skrypt wspiera:

• Skanowanie kodów QR do automatycznego wypełniania pól.
• Obsługę skanera kodów kreskowych do wprowadzania EAN i lokalizacji.

Podsumowanie

Plik android_dpmag_rw.js to kluczowe narzędzie dla magazynierów realizujących rozchody wewnętrzne w aplikacji Studio WMS.net. Automatyzuje proces skanowania kodów EAN, wyboru lokalizacji i rejestracji operacji. Dzięki dynamicznej walidacji system zwiększa efektywność operacji magazynowych.

Skrypt android_dpmag_rw.js

Skrypt android_dpmag_rw.js to moduł mobilnego interfejsu w systemie Studio WMS.net, dedykowany obsłudze operacji związanych z dokumentami typu RW. Jego głównym celem jest umożliwienie magazynierowi szybkiego i precyzyjnego wprowadzania danych dotyczących przyjęcia lub rozliczenia towaru – operacji, w której kluczowe jest potwierdzenie kodu EAN produktu, weryfikacja jego danych oraz określenie ilości towaru do operacji. Poniżej przedstawiono szczegółowy opis funkcjonalności i sposobu działania skryptu.

1. Inicjalizacja i generowanie formularza

Ustawienia wstępne

Na początku działania funkcji MojaOnLoad() następuje pobranie parametrów przekazywanych w adresie URL, takich jak prefiks dokumentu oraz typ dokumentu (zmienne gcPRX i gcTYPDOK). Jeśli te parametry nie zostaną przekazane, domyślnie ustawiane są wartości „RW”, co wskazuje, że operacja dotyczy dokumentów RW.

Budowa interfejsu

Dynamicznie tworzony jest formularz, którego struktura jest podzielona na kilka sekcji:

• Wiersz kodu EAN (rowEANASN):
  Użytkownik wprowadza kod EAN produktu. Formularz zawiera pole tekstowe do wpisania kodu oraz ukryte pole przechowujące identyfikator asortymentu (NRIDASN), który zostanie ustawiony po weryfikacji.
• Sekcja STEP1 – Dane asortymentu:
  Po zatwierdzeniu kodu EAN, wyświetlane są pola z danymi asortymentu – nazwa produktu (NAZWAAS) oraz indeks (INDEKS). Oba pola są ustawione jako tylko do odczytu, dzięki czemu użytkownik nie może ich modyfikować, a dane te są pobierane z bazy danych.
• Sekcja STEP2 – Ilość towaru:
  Umożliwia wprowadzenie ilości towaru przy użyciu kontrolki numerycznej (WebNumber). Kontrolka ta jest skonfigurowana tak, aby przyjmować wartość co najmniej równą 1 oraz nie przekraczać określonego maksymalnego limitu (ustalanego dynamicznie na podstawie danych pobranych z bazy).
• Przycisk kończący operację:
  Na dole interfejsu umieszczony jest przycisk „Zakończ”, który wywołuje funkcję endFunc(). Po jego aktywacji użytkownik ma możliwość zatwierdzenia dokumentu lub zakończenia operacji, w zależności od tego, czy dokument został już prawidłowo zapisany.

2. Obsługa zdarzeń i walidacja danych

Weryfikacja kodu EAN

• Po wpisaniu kodu EAN i naciśnięciu klawisza Enter (wywołanie zdarzenia keyup), wywoływana jest procedura, która:
  • Wykonuje zapytanie do bazy danych (przy użyciu funkcji ssDataSQL) na podstawie wprowadzonego kodu EAN.
  • Jeżeli zapytanie zwróci dokładnie jeden rekord, system uzupełnia pola z identyfikatorem asortymentu (NRIDASN), indeksem (INDEKS) oraz nazwą produktu (NAZWAAS).
  • Następnie wyświetlana jest sekcja STEP1, a inne sekcje (np. dotyczące ilości) są ukrywane lub resetowane, aby użytkownik mógł przejść do kolejnego etapu – wprowadzenia lokalizacji pobrania.

W przypadku braku danych dla podanego kodu EAN, system wyświetla komunikat (przy użyciu funkcji JqxTooltip) informujący, że kod EAN nie istnieje, a pole zostaje zresetowane, umożliwiając ponowne wprowadzenie poprawnych danych.

Wprowadzanie lokalizacji i ilości

• Pole ADRES:
  Po przejściu do kolejnego etapu (STEP1) użytkownik zostaje poproszony o wprowadzenie lokalizacji pobrania. Wartość ta jest weryfikowana – jeżeli jest podana w formie numerycznej (np. jako identyfikator), system dokonuje konwersji do czytelnego adresu poprzez zapytanie do bazy. W razie poprawnej weryfikacji wyświetlana jest sekcja STEP2, a kontrolka ilości zostaje odpowiednio skonfigurowana (ustalany jest maksymalny limit ilości dostępny na lokalizacji).
• Pole ILOSC:
  Po zatwierdzeniu lokalizacji, użytkownik wprowadza ilość towaru do operacji. Wartość ta jest walidowana – musi być większa od zera oraz nie może przekraczać maksymalnej ilości dostępnej na danej lokalizacji. Jeśli wprowadzona ilość jest prawidłowa, następuje wywołanie funkcji saveDocument().

Automatyczne przewijanie formularza

Funkcja scrollToEndOfPage() zapewnia, że formularz automatycznie przewija się do ostatniej widocznej części, co umożliwia użytkownikowi łatwy dostęp do kolejnych pól, szczególnie w warunkach mobilnych.

3. Zapis dokumentu i finalizacja operacji

Zapis danych

• Funkcja saveDocument():
  Po poprawnej walidacji wprowadzonych danych (sprawdzanej przy użyciu funkcji JqxTestWypelnienia) wyświetlany jest preloader informujący o trwającym zapisie. Skrypt buduje ciąg parametrów, łącząc:
  • Prefiks operacji (gcPRX),
  • Numer referencyjny dokumentu (gcRefno, pobierany przy użyciu funkcji PobierzRefno()),
  • Identyfikator asortymentu (NRIDASN),
  • Numer palety pobrania (PALETANUMER),
  • Wprowadzoną ilość towaru,
  • Wprowadzony adres (ADRES).
    Przed przesłaniem parametrów do bazy dokonywana jest sanitacja danych (zamiana pojedynczych cudzysłowów). Następnie wykonywane jest zapytanie SQL (funkcja ssDataSQL) na podstawie określonego identyfikatora zapytania.
    Jeśli operacja przebiegnie pomyślnie (tj. zwrócony zostanie numer dokumentu – REFNODOKUMENTU > 0), zmienna kontrolna isInsertedDocument zostaje ustawiona na wartość true, a formularz zostaje zresetowany poprzez wywołanie funkcji clearPage(„all”). W przeciwnym razie użytkownik otrzymuje komunikat o błędzie.

Finalizacja dokumentu

• Funkcja endFunc():
  Po zakończeniu wprowadzania danych użytkownik może zatwierdzić dokument. Funkcja ta sprawdza, czy dokument został poprawnie zapisany (isInsertedDocument jest true). W takim przypadku wywoływana jest procedura potwierdzająca finalizację dokumentu – użytkownik zostaje zapytany, czy chce zatwierdzić dokument (funkcja setDocumentNumber()).
• Funkcja setDocumentNumber():
  Odpowiada za generowanie unikalnego numeru dokumentu na podstawie mechanizmu liczników (wywoływana funkcja PobierzLicznikMiesiac()) oraz przesyła finalne dane do bazy za pomocą funkcji ssExSQL. Po zatwierdzeniu dokumentu system wyświetla komunikat potwierdzający lub – w razie błędu – informuje o problemie, a następnie interfejs zostaje odświeżony (funkcja closeWindow()).

4. Funkcje pomocnicze

Skrypt zawiera również szereg funkcji wspomagających poprawne działanie interfejsu:

• clearPage(type):
  Funkcja ta umożliwia resetowanie poszczególnych sekcji formularza lub całego interfejsu, w zależności od przekazanego parametru (np. „all”, „EANASN”, „ILOSC” lub „ADRES”). Dzięki temu użytkownik może łatwo wyczyścić błędnie wprowadzone dane i rozpocząć operację od nowa.
• ustawNumerPalety():
  Automatycznie generuje nowy, unikalny numer palety na podstawie mechanizmu ciągłej numeracji, co gwarantuje spójność numeracji w systemie.
• scrollToEndOfPage():
  Zapewnia automatyczne przewijanie formularza do jego dolnej części, co ułatwia pracę na urządzeniach mobilnych.
• addEvents():
  Funkcja ta konfiguruje wszystkie zdarzenia (np. keyup i focus) dla poszczególnych pól formularza, dzięki czemu interfejs jest responsywny i intuicyjny w obsłudze.

Podsumowanie

Skrypt android_dpmag_rw.js w systemie Studio WMS.net stanowi nowoczesne narzędzie mobilne dedykowane obsłudze operacji RW. Dzięki wieloetapowemu, dynamicznie generowanemu formularzowi oraz zaawansowanym mechanizmom walidacji i integracji z bazą danych, system umożliwia:

• Precyzyjne wprowadzanie danych dotyczących identyfikacji produktu (poprzez kod EAN) oraz wyświetlanie powiązanych danych asortymentowych (nazwa, indeks),
• Określenie ilości towaru do operacji, z uwzględnieniem limitów wynikających z dostępnych danych,
• Szybkie przełączanie między kolejnymi etapami formularza oraz automatyczne przewijanie interfejsu, co usprawnia pracę magazyniera w warunkach mobilnych,
• Finalizację dokumentu poprzez zatwierdzenie operacji i wygenerowanie unikalnego numeru dokumentu, co zapewnia spójność i kontrolę nad operacjami magazynowymi.

Dzięki zastosowanym rozwiązaniom, system Studio WMS.net podnosi efektywność procesów magazynowych, minimalizując ryzyko błędów i umożliwiając szybką realizację operacji RW.

Czytaj więcej:

• android_dpmag_mm_aso

  Skrypt android_dpmag_mm_aso.js stanowi kluczowy element mobilnego interfejsu użytkownika w systemie Studio WMS.net, dedykowanym obsłudze dokumentów MM (magazynowych). Jego głównym zadaniem jest zarządzanie procesem przyjęcia lub wydania towaru w ramach operacji magazynowych, przy czym uwzględnia zarówno tryb przyjęcia, jak i wydania. Poniżej przedstawiono szczegółowy opis funkcjonalności oraz mechanizmów, jakie zostały zaimplementowane w tym module.

  Transakcje WMS javascript jqs WMS

• android_dpmag_mm_pal

  Skrypt android_dpmag_mm_pal.js jest zaawansowanym modułem mobilnego interfejsu systemu Studio WMS.net, przeznaczonym do obsługi dokumentów magazynowych MM w operacjach związanych z przyjęciem i wydaniem towaru.

  Transakcje WMS javascript jqs WMS

• android_dpmag_pzb

  Skrypt android_dpmag_pzb.js stanowi zaawansowany moduł mobilnego interfejsu w systemie Studio WMS.net, dedykowany operacjom przyjęcia towaru (PZB). Jego zadaniem jest umożliwienie magazynierowi kompleksowej obsługi dokumentu przyjęcia, począwszy od wprowadzenia numeru dokumentu, poprzez identyfikację asortymentu za pomocą kodu EAN

  Transakcje WMS javascript jqs WMS

• android_dpmag_zl_as

  Skrypt android_dpmag_wzb.js to zaawansowany moduł mobilnego interfejsu w systemie Studio WMS.net, dedykowany obsłudze operacji wydania towaru w ramach dokumentów typu „WZB”. Jego głównym celem jest przeprowadzenie magazyniera przez proces realizacji dokumentu – od wprowadzenia numeru dokumentu, poprzez identyfikację pozycji przy użyciu kodu EAN, aż do zatwierdzenia operacji wraz z rejestracją szczegółowych danych dotyczących partii, palet

  Transakcje WMS javascript jqs WMS

• android_dpmag_zl_pal

  android_dpmag_wzb.js umożliwia szybkie i przejrzyste wydanie towaru. System łączy w sobie dynamiczne wprowadzanie danych, aktywną walidację oraz intuicyjną nawigację. Dzięki temu magazynier pracuje sprawnie, a operacje wydania realizuje z minimalnym ryzykiem pomyłek.

  Transakcje WMS Android javascript jqs WMS