Program magazynowy WMS.net

Szablony wydruków dokumentów w programie magazynowym WMS.net

Szablony wydruków WMS.net oparte na formatach RDL i RDLC pozwalają modyfikować dokumenty w Report Builder bez ingerencji w kod aplikacji.

Opublikowano · Aktualizacja
www.programmagazyn.pl/dokumentacja-wms/
Szablony wydruków dokumentów w programie magazynowym WMS.net
Szablony wydruków dokumentów w programie magazynowym WMS.net
W skrócie

Szablony wydruków WMS.net oparte na formatach RDL i RDLC pozwalają modyfikować dokumenty w Report Builder bez ingerencji w kod aplikacji.

Standardy generowania dokumentacji magazynowej

Technologia stojąca za elastycznymi wydrukami w systemach WMS

Współczesne oprogramowanie magazynowe odchodzi od sztywnych, zaszytych na stałe formularzy na rzecz elastycznych rozwiązań opartych na otwartych standardach. Wykorzystanie formatów takich jak RDL (Report Definition Language) oraz RDLC (Client Report Definition) pozwala na pełną swobodę w definiowaniu wyglądu dokumentów. Pliki te w rzeczywistości stanowią struktury XML, które precyzyjnie opisują układ elementów, źródła danych oraz logikę prezentacji informacji. Dzięki temu administratorzy systemu mogą modyfikować szablony bez konieczności ingerencji w kod źródłowy samej aplikacji. Użycie narzędzi takich jak Microsoft Report Builder w wersji 3.x umożliwia wizualne projektowanie raportów, co znacznie przyspiesza proces wdrażania zmian. Projektant otrzymuje do dyspozycji intuicyjny interfejs, w którym metodą „przeciągnij i upuść” rozmieszcza pola z bazy danych na wirtualnej kartce papieru.

Zastosowanie standardu XML w definicjach raportów otwiera drogę do zaawansowanego sterowania logiką wydruku. Systemy klasy WMS potrafią dynamicznie dobierać odpowiedni szablon w zależności od kontekstu operacji, na przykład rodzaju dokumentu czy kontrahenta. Pliki RDL przechowują nie tylko informacje o statycznym tekście, ale również skomplikowane wyrażenia sterujące widocznością poszczególnych sekcji. Oznacza to, że ten sam plik wzorcowy może służyć do generowania prostego potwierdzenia wydania, jak i szczegółowej specyfikacji z kodami kreskowymi, w zależności od przekazanych parametrów wejściowych. Takie podejście eliminuje potrzebę utrzymywania dziesiątek niemal identycznych plików, co znacząco upraszcza zarządzanie infrastrukturą IT w dużych przedsiębiorstwach logistycznych.

Personalizacja i budowanie tożsamości wizualnej firmy

Możliwość pełnej edycji szablonów wydruków ma podstawowe znaczenie dla budowania profesjonalnego wizerunku operatora logistycznego. Firmy mogą bez przeszkód implementować własne logotypy, dobierać firmową kolorystykę oraz definiować kroje czcionek zgodne z księgą znaku. Dostosowanie nagłówków i stopek dokumentów pozwala na umieszczenie w nich niezbędnych danych kontaktowych, reklamowych lub prawnych, które są wymagane w obrocie handlowym. Edytor raportów pozwala na precyzyjne określenie marginesów oraz rozmieszczenia elementów graficznych, co gwarantuje, że wydruk będzie wyglądał estetycznie niezależnie od użytej drukarki. Dbałość o detale na dokumentach takich jak WZ (Wydanie Zewnętrzne) czy etykiety logistyczne buduje zaufanie klientów i partnerów biznesowych.

Poza aspektami wizualnymi, personalizacja obejmuje również dostosowanie zawartości merytorycznej do specyficznych potrzeb procesu. Administratorzy mogą decydować, które kolumny z bazy danych mają pojawić się na wydruku, a które powinny zostać ukryte dla określonych grup użytkowników. System umożliwia definiowanie szerokości tabel, formatowania liczb, dat oraz walut, co zapewnia czytelność prezentowanych danych. Istnieje również opcja dodawania specjalnych elementów funkcjonalnych, takich jak kody kreskowe generowane dynamicznie na podstawie numerów referencyjnych towarów. Dzięki temu dokument papierowy staje się integralną częścią cyfrowego obiegu informacji, umożliwiając szybkie skanowanie i identyfikację partii towaru na kolejnych etapach łańcucha dostaw.

Automatyzacja obiegu dokumentów i procesów archiwizacji

Sterowanie formatami wyjściowymi i ścieżkami zapisu

Zaawansowane systemy magazynowe oferują szerokie możliwości parametryzacji procesu generowania plików, co pozwala na automatyzację wielu rutynowych czynności biurowych. Poprzez odpowiednie skonfigurowanie parametrów w adresie wywołującym raport, użytkownik lub automat może wymusić konkretny format pliku końcowego. Najczęściej wykorzystywanym standardem jest format PDF, który gwarantuje niezmienność wyglądu dokumentu na każdym urządzeniu, jednak system obsługuje również eksport do arkuszy kalkulacyjnych XLS. Taka funkcjonalność jest niezwykle przydatna w sytuacjach, gdy odbiorca potrzebuje danych w formie umożliwiającej dalszą edycję i analizę. Decyzja o formacie zapada w momencie wywołania funkcji drukującej, co daje dużą elastyczność w bieżącej pracy operacyjnej.

Istotnym aspektem zarządzania dokumentacją jest kontrola nad miejscem fizycznego zapisu wygenerowanych plików na serwerze. System wykorzystuje zmienne parametry do dynamicznego tworzenia struktur katalogów, co pozwala na logiczne uporządkowanie tysięcy plików powstających każdego dnia. Na przykład, dokumenty mogą być automatycznie kierowane do folderów takich jak „App_Pdf” lub „App_Xls”, w zależności od ich formatu. Co więcej, mechanizm archiwizacji potrafi tworzyć podfoldery oparte na unikalnych numerach referencyjnych (np. ID kontrahenta czy numerze sprawy), co w przyszłości ułatwia szybkie odnalezienie konkretnego pliku. Takie rozwiązanie eliminuje chaos w plikach i zapewnia porządek w cyfrowym archiwum bez konieczności ręcznego segregowania dokumentów przez pracowników.

Mechanizmy automatycznej dystrybucji i obsługi załączników

Oprogramowanie magazynowe idzie o krok dalej, integrując proces generowania wydruku z jego natychmiastową dystrybucją do zainteresowanych stron. Wykorzystanie specjalnych parametrów sterujących pozwala na automatyczne zapisanie kopii wydruku w tabelach systemowych jako załącznika do konkretnej transakcji. Funkcja ta sprawia, że plik PDF nie tylko ląduje na dysku serwera, ale zostaje trwale powiązany z rekordem w bazie danych, na przykład z konkretnym wydaniem magazynowym. Dzięki temu każdy uprawniony użytkownik systemu, przeglądając historię operacji, ma natychmiastowy dostęp do cyfrowej wersji dokumentu. Eliminuje to konieczność przeszukiwania zewnętrznych dysków sieciowych czy segregatorów w poszukiwaniu papierowych kopii.

Integracja z modułami zadaniowymi, takimi jak usługi typu ssJOB, pozwala na automatyczne wysyłanie wygenerowanych dokumentów drogą mailową. Po utworzeniu pliku system może samodzielnie zainicjować wysyłkę wiadomości na zdefiniowany adres e-mail, dołączając do niej gotowy dokument PDF. Konfiguracja tego procesu odbywa się poprzez proste parametry, które wskazują systemowi, jaki kod szablonu wiadomości ma zostać użyty. W efekcie kontrahent otrzymuje powiadomienie o wysyłce towaru wraz z kompletem dokumentów w kilka sekund po zatwierdzeniu operacji przez magazyniera. Rozwiązanie to znacząco przyspiesza przepływ informacji w łańcuchu dostaw, redukuje koszty związane z tradycyjną pocztą i minimalizuje ryzyko zagubienia dokumentacji w transporcie.

Różny szablon może być wykorzystany w zależności do oddziału, magazynu, kontrahenta itp

Jak program wybiera szablon wydruku dla konkretnego dokumentu Schemat czytany od lewej do prawej. Pierwsze pole to wywołanie transakcji wydruku z czterema parametrami: typdok, refno, kolumna i tabela. Drugie pole opisuje odczyt z bazy: program odnajduje dokument o podanym numerze referencyjnym we wskazanej tabeli, pobiera z niego identyfikator kontrahenta i odczytuje wartość wskazanej kolumny z kartoteki kontrahentów, na przykład symbol oddziału. Trzecie pole to sprawdzenie, czy istnieje podfolder o nazwie odpowiadającej tej wartości. Jeżeli tak, użyty zostaje szablon z podfolderu oddziału. Jeżeli nie, program sięga po szablon z folderu głównego, więc brak pliku dla oddziału nie przerywa wydruku. WYWOŁANIE wydruk_refno.aspx typdok, refno, kolumna, tabela ODCZYT Z BAZY dokument o danym refno we wskazanej tabeli, stąd wartość kolumny z KNKON CZY ISTNIEJE PODFOLDER? np. WAW albo POZ tak nie SZABLON ODDZIAŁU /WAW/szablon SZABLON GŁÓWNY /szablon
Zejście do folderu głównego przy braku pliku dla oddziału jest tu najważniejsze: nowy oddział zaczyna pracę na wzorze wspólnym, a własny szablon dokłada się później, bez zmiany przycisku w programie.

Program uruchamiając transakcję wydruku dokumentu (rdlc\wydruk_refno.aspx) musi przekazać jako parametry symbol typdok (nazwę) szablonu jaki ma być wykorzystany do wydruku oraz refno czyli numer referencyjny dokumentu do wydruku. Przykładowo wywołanie szablonu wydruku dpzle_dok:

typdok=dpzle_dok&refno=

Można tworzyć odpowiednio wiele przycisków i każdy oddzielnie projektować w zależności od potrzeb zmieniając szablon wydruku np. per rola (oddział). W celu wyeliminowania takiej pracy można jako parametr transakcji dodać informacje które posłużą do spersonalizowania wyboru szablonu. Rekord wskazany identyfikatorem pokazuje też transakcja x_details.aspx, opisana na stronie o projektowaniu podglądu rekordu w StudioSystem.

Należy podać 2 dodatkowe parametry:

  • kolumna - wartość wskazuje jaka kolumna z tabeli KNKON ma zostać użyta jako identyfikator folderu z szablonem, np. oddzial, skroco, analityka, rejon, nip
  • tabela - nazwa tabeli SQL w bazie w której należy szukać dokumentu, którego refno jest przekazywane do drukowania np. dpzle, dpmag.
Parametry transakcji wydruku - co oznaczają i kiedy trzeba je podać
ParametrZnaczeniePrzykładowa wartośćKiedy jest potrzebny
typdokSymbol szablonu, który ma zostać użyty do wydrukudpzle_dokZawsze
refnoNumer referencyjny drukowanego dokumentuwartość z listy dokumentówZawsze
kolumnaKolumna kartoteki KNKON, z której pochodzi nazwa podfolderuoddzial, skroco, rejon, nipPrzy szablonie zależnym od kontrahenta albo oddziału
tabelaTabela, w której program szuka dokumentu o podanym numerzedpzle, dpmagRazem z parametrem kolumna

Przykładowa lista parametrów dla transakcji rdlc/wydruk_refno.aspx

typdok=dpzle_dok&kolumna=oddzial&tabela=dpzle&refno=

W takim wypadku program szuka podfolderu z symbolem oddziału kontrahenta, którego identyfikator NRIDODN jest odczytywany z tabeli dpzle.

Jeżeli klient dla którego drukujemy dokument jest przypisany do oddziału WAW to prorgam będzie szukał szablonu wydruku w folder_główny/WAW/szablon

Klient z oddziału POZ będzie korzystał z folderu zainstalowanego: folder_główny/POZ/szablon

UWAGA:

  • jeżeli nie zostanie odnaleziony szablon w folderze specjalnym to zostanie użyty szablon w głównym folderze.
  • System wymaga zapisu w pliku konfiguracyjnym web.config połączenia do bazy raportów (SQL Reporting Services) o nazwie raportyConnectionString np.<add name=”raportyConnectionString” connectionString=”Data Source=Server;Initial Catalog=ReportServer;User Id=User;Password=haslo” providerName=”System.Data.SqlClient” />

Składnię samego pliku definicji raportu oraz zakres elementów dopuszczonych w szablonie opisuje dokumentacja producenta: Report Definition Language oraz Report Builder.

Podsumowanie

Dzięki narzędziu SSDT BI i możliwościom tworzenia raportów w różnych formatach, proces raportowania staje się bardziej efektywny i dostosowany do indywidualnych potrzeb biznesowych. Warto wykorzystać te możliwości, aby usprawnić przetwarzanie danych i prezentację informacji w firmie.

Program magazynowy WMS.net

Szablony wydruków dokumentów w programie magazynowym WMS.net

Program magazynowy WMS.net

Szablony wydruków dokumentów w programie magazynowym WMS.net

Słownik pojęć

Pojęcia z konfiguracji wydruków w WMS.net

Nazwy parametrów i skróty użyte na tej stronie, wyjaśnione w kontekście pracy administratora.

RDLReport Definition Language
Plik XML opisujący układ raportu, źródła danych i wyrażenia sterujące widocznością sekcji. Przetwarzany przez serwer raportów, który sam wykonuje zapytanie do bazy.
RDLCClient Report Definition
Odmiana tego samego formatu przetwarzana po stronie aplikacji. Dane dostarcza program, więc wydruk działa bez uruchomionej usługi raportowej.
SSRSUsługa raportowa serwera
Składnik SQL Server odpowiedzialny za przechowywanie i wykonywanie raportów. Połączenie do jego bazy zapisuje się w pliku web.config.
REFNONumer referencyjny dokumentu
Wartość wskazująca konkretny dokument do wydruku, przekazywana jako parametr transakcji. Pochodzi z wiersza zaznaczonego na liście dokumentów.
TYPDOKSymbol szablonu wydruku
Nazwa pliku wzorcowego używanego przy druku, na przykład dpzle_dok. Ten sam dokument może mieć kilka szablonów o różnym zakresie danych.
KNKONKartoteka kontrahentów
Tabela, z której program odczytuje wartość wskazaną parametrem kolumna. To ona rozstrzyga, który podfolder z szablonem zostanie użyty.
ssJOBUsługa zadań cyklicznych
Składnik uruchamiający operacje w tle, między innymi wysyłkę gotowych dokumentów pocztą elektroniczną. Działa niezależnie od tego, czy użytkownik jest zalogowany.
FAQ

Szablony wydruków dokumentów - najczęstsze pytania i odpowiedzi

01

Czym różni się plik RDL od RDLC?

Oba opisują ten sam układ raportu w postaci pliku XML. RDL przeznaczony jest dla serwera raportów i to on wykonuje zapytanie oraz składa wydruk. RDLC przetwarzany jest po stronie aplikacji, która sama dostarcza dane do raportu, więc nie wymaga działającej usługi raportowej.

02

Jak program wybiera szablon dla konkretnego oddziału?

Parametr kolumna wskazuje pole kartoteki kontrahentów, na przykład symbol oddziału, a parametr tabela - miejsce, w którym szukany jest dokument o podanym numerze referencyjnym. Odczytana wartość staje się nazwą podfolderu z szablonem. Kontrahent z oddziału WAW dostanie wydruk z podfolderu WAW.

03

Co dzieje się, gdy w podfolderze oddziału brakuje szablonu?

Program sięga po plik z folderu głównego i wydruk powstaje mimo braku wersji dla oddziału. Dzięki temu nowy oddział nie wymaga żadnego przygotowania, żeby zacząć drukować dokumenty. Własny szablon dokłada się później, bez zmiany przycisku w programie.

04

W jakich formatach można zapisać gotowy dokument?

Podstawowym formatem jest PDF, który zachowuje układ strony niezależnie od urządzenia. Obsługiwany jest także eksport do arkusza kalkulacyjnego, gdy odbiorca ma dalej przetwarzać dane. Format wskazuje się parametrem w momencie wywołania wydruku, a pliki trafiają do odrębnych katalogów serwera.

05

Co trzeba ustawić w pliku konfiguracyjnym przed pierwszym wydrukiem?

W pliku web.config musi znaleźć się połączenie do bazy raportów zapisane pod nazwą raportyConnectionString. Wskazuje ono serwer, bazę ReportServer oraz konto, na którym aplikacja łączy się z usługą. Bez tego wpisu transakcja wydruku nie odnajdzie definicji raportu.

Chcesz dowiedzieć się więcej o programie magazynowym WMS.net?

Uruchom bezpłatne demo programu magazynowego WMS.net lub zapytaj o szczegóły wdrożenia.