Plik tablet_dpmag_wz.js w systemie Studio WMS.net służy do obsługi procesu tworzenia i edycji dokumentu wydania z magazynu na podstawie zlecenia (przekształcenie dokumentu zlecenia wydania ZWZ w dokument wydania WZ) w interfejsie dedykowanym urządzeniom tabletowym. Skrypt ten dynamicznie generuje kompletny interfejs użytkownika, który obejmuje zarówno nagłówek dokumentu, jak i szczegółowy formularz umożliwiający wprowadzanie danych niezbędnych do prawidłowego przetwarzania operacji magazynowych.
Opis
Podczas inicjalizacji za pomocą funkcji MojaOnLoad() skrypt odczytuje parametry przekazywane w URL, takie jak rodzaj dokumentu (prx) oraz typ dokumentu (typdok), ustawiając domyślne wartości, jeśli nie zostały one określone. Następnie generuje strukturę strony, która obejmuje:
- Nagłówek dokumentu - zawiera przyciski akcji (Zapisz, Bufor, Usuń) oraz pola informacyjne, takie jak typ dokumentu, rodzaj rejestru, numer referencyjny i data.
- Formularz główny - umożliwia wybór kontrahenta, numeru zlecenia, odbiorcy, przewoźnika, a także wprowadzenie daty (np. data faktury) i numeru zamówienia.
- Sekcję pozycji dokumentu - zawiera pola do wyboru asortymentu, określenia lokalizacji magazynowej, ilości wydawanych towarów oraz dodatkowych uwag.
- Panel podsumowania - prezentuje zbiorcze dane, takie jak liczba artykułów, sztuk, palet, a także wagę netto i brutto, co umożliwia kontrolę kompletności i poprawności dokumentu.
Skrypt integruje się z bazą SQL za pomocą dedykowanych zapytań, pobierając dane potrzebne do wypełnienia kontrolek, generowania list wyboru (np. kontrahentów, zleceń, asortymentu, lokalizacji) oraz wyświetlania dynamicznie aktualizowanej tabeli pozycji w komponencie jqxGrid. W tej tabeli użytkownik może na bieżąco monitorować dodane pozycje, z możliwością usuwania wybranych rekordów przed zatwierdzeniem dokumentu.
Dodatkowo, tablet_dpmag_wz.js obsługuje walidację wprowadzanych danych - przed dodaniem pozycji czy zatwierdzeniem dokumentu system sprawdza poprawność i kompletność istotnych pól, takich jak wybór kontrahenta, zlecenia oraz daty. Funkcje takie jak btnDodajPoz() czy btnDodaj() umożliwiają zarówno ręczne dodawanie pozycji, jak i automatyczne generowanie pozycji na podstawie wybranego zlecenia, co usprawnia proces i minimalizuje ryzyko błędów.
Ponadto, skrypt implementuje mechanizmy umożliwiające anulowanie zapisu, usuwanie pojedynczych pozycji oraz finalne zatwierdzanie dokumentu, po czym system wykonuje niezbędne operacje aktualizujące stan dokumentu w bazie danych. Wsparcie dla dodatkowych funkcjonalności, takich jak wywoływanie modułów obsługi usług magazynowych, notatek, plików, załączników czy zdjęć, pozwala na kompleksowe zarządzanie dokumentacją magazynową.
Podsumowanie
Podsumowując, tablet_dpmag_wz.js to integralny element systemu Studio WMS.net, który umożliwia efektywną, bezpieczną i intuicyjną obsługę procesu wydania towarów z magazynu na urządzeniach mobilnych. Dzięki dynamicznemu generowaniu interfejsu, walidacji danych oraz ścisłej integracji z bazą SQL, system zapewnia wysoką jakość przetwarzania dokumentów magazynowych, co przekłada się na usprawnienie operacji logistycznych w przedsiębiorstwie.
Obsługa Dokumentu Wydania z Magazynu (WZ) w Studio WMS.net
Plik tablet_dpmag_wz.js obsługuje proces tworzenia dokumentu wydania z magazynu (WZ) na podstawie zlecenia (ZWZ) w systemie Studio WMS.net. Skrypt umożliwia użytkownikowi dodawanie pozycji, ich edycję oraz zatwierdzanie dokumentu. Obsługuje również walidację danych i dynamiczne interakcje z bazą SQL.
Funkcja MojaOnLoad()
Podczas inicjalizacji system wykonuje kilka istotnych operacji:
- Odczytuje parametry dokumentu, takie jak prx (rodzaj dokumentu) oraz typdok (typ dokumentu).
- Generuje interfejs użytkownika, który obejmuje:
- Przyciski akcji: Zapisz, Bufor, Usuń.
- Formularz z polami dla kontrahenta, numeru referencyjnego, daty wydania oraz przewoźnika.
- Opcje dodatkowe: Usługi magazynowe, Notatki, Pliki, Zdjęcia.
- Ładuje dane z bazy SQL, jeśli użytkownik edytuje istniejący dokument.
Obsługa dodawania pozycji do dokumentu
Formularz pozwala użytkownikowi na:
- Wybór kontrahenta i odbiorcy z listy rozwijanej.
- Podanie numeru zlecenia oraz daty wydania.
- Wybór asortymentu oraz lokalizacji składowania.
Funkcja btnDodajPoz()
Obsługuje dodanie pozycji do dokumentu:
- Sprawdza, czy kontrahent i numer zlecenia zostały wybrane.
- Blokuje możliwość edycji nagłówka po pierwszym dodaniu pozycji.
- Wyświetla sekcję dodawania produktów.
Funkcja btnDodaj()
Dodaje nową pozycję do dokumentu:
- Sprawdza poprawność danych (np. dostępność w magazynie, zgodność ilości).
- Wysyła zapytanie SQL do zapisania pozycji.
- Odświeża tabelę pozycji dokumentu.
Obsługa tabeli pozycji
System generuje dynamiczną tabelę pozycji:
- Wyświetla indeks, nazwę, lokalizację, ilość oraz inne szczegóły pozycji.
- Pozwala na edycję i usunięcie pozycji przed zatwierdzeniem dokumentu.
Funkcja btnUsun()
Obsługuje usuwanie pozycji:
- Wyświetla komunikat z prośbą o potwierdzenie usunięcia.
- Jeśli użytkownik zatwierdzi, usuwa pozycję z bazy SQL.
- Aktualizuje podsumowanie dokumentu.
Funkcja Zapisz()
Obsługuje zapis dokumentu:
- Jeśli dokument nie zawiera pozycji, system wyświetla ostrzeżenie.
- Użytkownik może zapisać dokument jako zatwierdzony lub w buforze.
- Po zatwierdzeniu dokumentu system blokuje jego edycję.
Obsługa interfejsu użytkownika
Skrypt oferuje dodatkowe funkcje:
- Dodawanie usług magazynowych - przypisywanie usług do dokumentu.
- Dodawanie notatek - możliwość opisania szczegółów dokumentu.
- Dodawanie załączników - przechowywanie plików związanych z dokumentem.
- Dodawanie zdjęć - opcja dokumentacji wizualnej wydawanego towaru.
Podsumowanie
Plik tablet_dpmag_wz.js obsługuje tworzenie i edycję dokumentu wydania z magazynu (WZ) w 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 wydania towarów i kontrolować przepływ magazynowy.