Wydruk etykiet i raporty

Aplikacja AMAGE posiada bogaty zasób wewnętrznych szablonów raportów oraz mechanizmów automatycznie generujących etykiety. Niemniej szablony etykiet nie zawierają wszystkich wariantów etykiet dostępnych na rynku. Każdy klient posiada własne możliwości wdrażania systemu oraz zastosowania własnych metod oznaczania elementów i urządzeń. W związku z powyższym aplikacja AMAGE udostępnia możliwość tworzenia własnych formatów etykiet, które zostaną wykorzystane przez aplikację do generacji i wydruku etykiet z danymi.

Niniejszy dokument opisuje sposób projektowania etykiet, wymagane/dostępne dane dla klienta oraz sposób integracji w aplikacji AMAGE.

Do projektowania nowych formatów etykiet służy oprogramowania Jaspersoft Studio. Oprogramowanie jest oprogramowaniem darmowym do użytku komercyjnego. Oprogramowanie można pobrać z witryny producenta:

Po pobraniu, instalacji i uruchomieniu aplikacji pojawia się okno projektanta raportów/etykiet.

Etykiety do wydruku na elementy wymagające identyfikacji mogą posiadać następujące parametry:

Pola w projekcie etykiet oznaczane są poprzez zmienne FIELD i umieszczane w obszarze projektowym za pomocą zmiennych $F{<nazwa_pola>}.

Dla etykiet 3x1 i 4x1 dostępne są następujące parametry, które uwarunkowane są numerem etykiety w rzędzie. Opis parametru jest identyczny z opisem z pojedynczej etykiety.

Aby wykorzystać własny projekt etykiet należy w momencie wyboru formatu etykiety do wydruku (Kreator drukowania identyfikatorów) wybrać Szablon etykiet: „Własna etykieta” oraz we włączonym polu wyboru wybrać zaprojektowany plik *.jasper.

Następnie można przejść do generacji etykiet i ich wydruku.

Aplikacja posiada wbudowane własne domyślne szablony wszystkich raportów. Użytkownik z odpowiednią wiedzą może dowolnie modyfikować wygląd raportów zgodnie ze swoimi wymaganiami. Pozwala na to możliwość zmiany wyglądu domyślnego raportu oraz zmiany wyglądu poszczególnych zakładek (konfiguracji) raportów. Pozwala to na posiadanie kilku wyglądów (własne, wewnętrzne, dla klienta itp.) każdego z raportów.

Aby zaprojektować dowolny raport należy otrzymać paczkę początkową (inicjalną) raportów dla aktualnej wersji aplikacji. Dla poszczególnych klientów zwykle działy IT posiadają dostęp do zasobów na serwerach AMAGE, które przechowują aktualną paczkę raportów. Na jej bazie można tworzyć dowolne raporty.

Po pobraniu paczki, należy wybrać raport, który jest wymagany do zmiany wyglądu/treści. Następnie przeglądnąć dokumentację raportów dostępną w sekcji "Dla programisty" w portalu pomocy. W niej znajdują się informacje o dostępnych polach i parametrach, które można wykorzystać we własnych raportach.

Po rozpakowaniu wybranego raportu np. ''ReportProduct.jrxml''. Należy go otworzyć w projektancie raportów. Następnie wystarczy dowolnie go zmodyfikować zgodnie z oczekiwaniami (kolory, wygląd, tabele, obrazy itp.). Po poprawnej modyfikacji raportu należy go skompilować do formatu ''jasper''. Następnie wszystkie raporty (główny oraz ewentualnie pomocnicze podraporty) w oryginalnych nazwach (WAŻNE!) należy skompresować do pliku ZIP. Ten plik wgrywamy w głównej aplikacji AMAGE do konfiguracji raportu lub konfiguracji zakładki.

Aby to zrobić, włączamy główną aplikację. Wyświetlamy w eksplorerze listę raportów. Domyślnie wyświetlane są wszystkie raporty, które mają możliwość wyświetlania ich bezpośrednio z eksplorera. Część raportów jest domyślnie niewidoczna, gdyż nie posiadają możliwości wyświetlania samodzielnego np. raporty wyglądu dokumentu zamówienia - generowany jest tylko w kontekście danego zamówienia.

Aby wyświetlić wszystkie szablony raportów dostępne w aplikacji, osoba z odpowiednimi uprawnieniami zaznacza ikonę w dolnej części panelu (pokaż wszystkie) i odświeża widok. W tym przypadku zostaną pokazane wszystkie dostępne szablony raportów.

Wygląd raportu można zmienić na dwa sposoby. Zmiana globalna szablonu raportu - dostępny będzie zawsze w nowym wyglądzie lub dodanie zakładki raportu ze zmianą wyglądu.

Globalną zmiana wyglądu raportu wykonujemy, przez akcję kontekstową na raporcie i wyświetlenie jego właściwości. W tym oknie możemy zaznaczyć nadpisywanie wyglądu raportu oraz wybrać opracowany przez nas zestaw wyglądu w postaci pliku ZIP (patrz wyżej jego opracowanie). Od tego momentu wszystkie raporty generowane z tego typu raportu będą miały zaprojektowany przez nas wygląd.

Jeśli chcemy posiadać kilka wyglądów raportu i/lub dodatkowo określać parametry raportu z panelu filtrów możemy utworzyć zakładkę raportu. Okno dodawania/edycji takiej zakładki posiada możliwość definicji wyglądu dodatkowego tak jak dla globalnego raportu. Jedyną zmianą jest możliwość określenia czy plik ZIP z nowym wyglądem szablonu będzie zapisywany w bazie danych (dostępny dla wszystkich użytkowników), czy będzie odniesieniem do pliku lokalnego na systemie plików.

Serwer AMAGE Sync od wersji 1.12 posiada możliwość generowania raportów bezpośrednio z poziomu serwera i wykorzystać to do np. przesyłania raportów mailowych z wygenerowanym raportem.