wms/dpmag_cd_view to wariant szablonu wms/dpmag_cd wyświetlający dokument cross-dockingowy CDP lub CDW jako stronę html z podglądem, zamiast od razu generować gotowy plik. Uruchamia się go transakcją wydruk_refno.aspx z parametrem view, dedykowanym z założenia rozbudowanym, kaskadowym raportom w całej platformie.
Czym jest raport wms/dpmag_cd_view
Standardowy wydruk dokumentu - opisany przy okazji szablonu wms/dpmag_cd - od razu generuje gotowy plik PDF albo XLS. Dla prostego, jednostronicowego dokumentu to zwykle wystarczające podejście. Dla większego, rozbudowanego dokumentu cross-dockingowego z wieloma pozycjami czasem dużo wygodniej jest najpierw zobaczyć wynik na ekranie, zanim w ogóle padnie decyzja o druku - i do tego właśnie służy wms/dpmag_cd_view.
Format pliku pozostaje taki sam jak w pozostałych raportach platformy - RDL edytowalny w Microsoft Report Builder 3.x. Różnica leży wyłącznie w sposobie, w jaki transakcja wydruk_refno.aspx prezentuje wynik użytkownikowi.
Ten sam wzorzec - wariant standardowy plus wariant z podglądem - nie jest unikalny dla dokumentów cross-dockingowych. Standardowy wydruk wms/dpmag, opisujący klasyczne dokumenty magazynowe zebrane w menu transakcji WMS, mógłby teoretycznie zostać rozszerzony o analogiczny wariant podglądowy - w praktyce jednak potrzeba taka pojawiła się akurat przy dokumentach cross-dockingowych, ze względu na ich większą złożoność i liczbę pozycji.
Tryb podglądu - parametr view
Mechanizm podglądu opiera się na parametrze view transakcji wydruk_refno.aspx. Dodanie tego parametru wymusza sposób działania polegający na wyświetleniu strony html z podglądem raportu, z poziomu którego można drukować i eksportować dokument do różnych formatów - zamiast automatycznego przesłania gotowego pliku od razu do przeglądarki.
Rozwiązanie to zostało zaprojektowane z myślą o raportach rozbudowanych, kaskadowych - takich, które składają się z wielu powiązanych sekcji albo dużej liczby pozycji. Dokument cross-dockingowy, zwłaszcza CDW obejmujący wiele pozycji przyjętych wcześniej dokumentem CDP, dobrze wpisuje się w tę kategorię.
Techniczne działanie parametru view jest przy tym niezależne od typu dokumentu - to ta sama funkcjonalność transakcji wydruk_refno.aspx, która działa identycznie niezależnie od tego, czy stoi za nią raport diagnostyczny, standardowy dokument magazynowy czy właśnie wariant cross-dockingowy. Programista dodający obsługę podglądu do nowego szablonu nie musi więc uczyć się nowego mechanizmu - wystarczy odwołać się do tego samego parametru, który działa już we wszystkich pozostałych miejscach platformy.
Kiedy używać podglądu
Wybór między bezpośrednim wydrukiem a podglądem nie jest przypadkowy - warto go dopasować do charakteru dokumentu i etapu pracy:
- Dokument z wieloma pozycjami - łatwiej wychwycić błąd na ekranie niż po wydrukowaniu na papierze.
- Weryfikacja przed wysyłką do kontrahenta - podgląd pozwala sprawdzić poprawność danych przed nieodwracalnym wydrukiem dokumentu towarzyszącego przesyłce.
- Praca szkoleniowa - nowy, dopiero uczący się operator może obejrzeć wynik swojej pracy bez zużywania papieru na każdą kolejną próbę.
- Dokumenty kaskadowe - raporty złożone z wielu sekcji, gdzie błąd w jednej części łatwiej zauważyć na pełnym podglądzie niż na fragmencie wydruku.
Tam, gdzie dokument jest prosty i rutynowo drukowany w tej samej postaci - na przykład standardowe potwierdzenie odbioru - bezpośredni wydruk szablonem wms/dpmag_cd pozostaje szybszym rozwiązaniem, bez dodatkowego kroku podglądu.
Decyzję tę warto podejmować na poziomie konfiguracji przycisku w interfejsie, a nie zostawiać jej każdorazowo operatorowi. Jeśli dany typ dokumentu w praktyce zawsze wymaga weryfikacji przed wydrukiem, przycisk uruchamiający go w menu powinien od razu wskazywać transakcję z parametrem view - eliminuje to ryzyko, że ktoś w pośpiechu pominie krok podglądu tam, gdzie jest on faktycznie potrzebny. Odwrotnie: dla dokumentów rutynowych warto pozostawić bezpośredni wydruk jako domyślną ścieżkę, żeby nie dokładać zbędnego kliknięcia tam, gdzie nikt i tak nie weryfikuje wyniku.
Zobacz, zanim wydrukujesz
Podgląd pozwala zweryfikować kompletność i poprawność dokumentu na ekranie, zanim zużyty zostanie choć jeden arkusz papieru.
Różnice względem bezpośredniego wydruku
| Cecha | wms/dpmag_cd | wms/dpmag_cd_view |
|---|---|---|
| Wynik domyślny | Gotowy plik PDF lub XLS | Strona html z podglądem |
| Parametr wywołania | save (opcjonalnie) | view |
| Dalsze działania | Plik gotowy do pobrania | Druk lub eksport z poziomu podglądu |
| Zalecane dla | Prostych, rutynowych dokumentów | Rozbudowanych, kaskadowych dokumentów |
Jak uruchomić podgląd
Podgląd uruchamia się transakcją wydruk_refno.aspx z parametrem view oraz typdok=WMS/dpmag_cd_view, wskazując numer referencyjny konkretnego dokumentu CDP lub CDW parametrem refno:
wydruk_refno.aspx?view=1&typdok=WMS/dpmag_cd_view&refno=6365821587516811W odróżnieniu od standardowego wywołania z parametrem save, tutaj wynikiem nie jest jakikolwiek zapisany plik, tylko strona wyświetlona od razu bezpośrednio w przeglądarce - w pełni gotowa do dalszej weryfikacji przed podjęciem ostatecznej decyzji o wydruku.
Z podglądu do wydruku lub eksportu
Strona podglądu nie jest ślepym zaułkiem - udostępnia opcje druku i eksportu do różnych formatów bezpośrednio z poziomu przeglądarki, bez potrzeby ponownego uruchamiania transakcji z innymi parametrami. Operator, który zweryfikował dane na ekranie, jednym kliknięciem przechodzi do finalizacji dokumentu.
To rozwiązanie eliminuje typowy problem dwuetapowej weryfikacji - zamiast wydrukować dokument, sprawdzić go na papierze i ewentualnie wydrukować ponownie po poprawkach, cała weryfikacja odbywa się przed pierwszym i jedynym wydrukiem.
Warto przy tym pamiętać, że przejście z podglądu do eksportu nie wymaga ponownego wskazywania numeru dokumentu ani typu szablonu - te dane zostały już przekazane przy pierwszym wywołaniu transakcji i pozostają aktywne przez cały czas przeglądania podglądu. Operator nie musi więc pamiętać ani przepisywać numeru referencyjnego drugi raz, co przy pracy na wielu dokumentach dziennie realnie oszczędza czas i ogranicza ryzyko pomyłkowego wydrukowania niewłaściwego dokumentu.
Praktyczne zastosowania
Podgląd dokumentu cross-dockingowego sprawdza się przede wszystkim tam, gdzie koszt błędu na wydruku jest wyższy niż koszt dodatkowego kroku weryfikacji:
- Duże dostawy konsolidowane - dokument CDW obejmujący dziesiątki pozycji z wielu dokumentów CDP, gdzie błąd łatwo przeoczyć bez podglądu całości.
- Dokumenty dla ważnych kontrahentów - dodatkowa weryfikacja przed wysłaniem dokumentu, który trafi bezpośrednio do klienta.
- Testowanie zmian w szablonie - po modyfikacji układu w Report Builder podgląd pozwala szybko sprawdzić efekt bez drukowania testowych kopii.
Ostatni z tych scenariuszy zasługuje na dodatkowy komentarz. Gdy administrator wprowadza zmianę w Report Builder - na przykład dodaje kolumnę z numerem partii towaru do szablonu wms/dpmag_cd - naturalnym krokiem przed publikacją zmiany jest sprawdzenie, jak wygląda ona w praktyce, na rzeczywistych danych. Bez trybu podglądu jedyną drogą weryfikacji byłoby wydrukowanie próbnej kopii na papierze, co przy kilku iteracjach poprawek generuje niepotrzebne koszty i marnuje czas. Z parametrem view ta sama weryfikacja odbywa się na ekranie, a papier zużywa się dopiero przy ostatecznym, zaakceptowanym wydruku.
Podobna logika dotyczy zresztą także sytuacji, w której dokument trzeba pokazać osobie decyzyjnej przed jego formalnym zamknięciem - na przykład kierownikowi zmiany na hali, który ma zatwierdzić duże i stosunkowo nietypowe wydanie cross-dockingowe. Zamiast drukować dokument, nieść go osobiście do biura kierownika i czekać tam na akceptację, wystarczy przesłać link do podglądu albo po prostu otworzyć go na wspólnym ekranie - decyzja zapada wyraźnie szybciej, a dokument trafia na papier dopiero po faktycznym, ostatecznym zatwierdzeniu.
Podsumowanie
wms/dpmag_cd_view to wariant podglądu dla dokumentów cross-dockingowych, oparty na parametrze view transakcji wydruk_refno.aspx. Zamiast od razu generować gotowy plik, wyświetla dokument jako stronę html, z której można przejść do druku albo eksportu dopiero po weryfikacji danych.
Mechanizm ten sprawdza się najlepiej przy rozbudowanych, kaskadowych dokumentach - w tym dużych dokumentach CDW, opisanych szerzej w materiale o szablonie wms/dpmag_cd oraz transakcjach jqs_dpmag_cdp.js i jqs_dpmag_cdw.js.
Dla zespołu wdrożeniowego oznacza to jedną dodatkową decyzję konfiguracyjną przy każdym nowym typie dokumentu: czy przycisk w menu ma prowadzić bezpośrednio do wydruku, czy najpierw do podglądu. Decyzja ta, raz podjęta i zapisana w konfiguracji pozycji menu, obowiązuje potem dla wszystkich użytkowników korzystających z danej roli, bez konieczności powtarzania jej przy każdym kolejnym dokumencie tego samego typu.