Raport: Dokumenty raportów

Raporty tworzone w aplikacji Obiekty deweloperskie lub w aplikacji Raporty definiują układ i zestaw parametrów.

Do generowania raportów typu dokument raportu oraz tworzenia dokumentów raportu służy aplikacja Raport: Dokumenty raportu. Dzięki wykorzystaniu raportów oraz aplikacji Raport: Dokumenty raportu użytkownikom systemu Comarch ERP Enterprise umożliwiono tworzenie sparametryzowanych, listopodobnych wyników w oparciu o definicje raportów Crystal Reports – bez konieczności bezpośredniego używania samego narzędzia Crystal Reports.

Opcja przypisywania uprawnień do wykonywania raportów typu dokument raportu pozwala na kontrolowanie, które raporty, a tym samym dane, mogą być używane przez użytkowników. Jest to prostsze i bardziej efektywne niż byłoby to możliwe w przypadku interaktywnego korzystania z Crystal Report i źródeł danych ODBC.

Grupa docelowa

Użytkownicy Comarch ERP Enterprise

Definicja pojęć

Dokumenty końcowe

Wydruk raportu na urządzenie wyjściowe, takie jak drukarka, lub zapis do pliku, skutkuje utworzeniem dokumentu raportu lub dokumentu końcowego. Dokument raportu zawiera listę obiektów, na przykład listę adresów. Dokument końcowy obejmuje zawsze jeden obiekt, na przykład zlecenie sprzedaży. Dokumenty mogą zostać zarchiwizowane lub przekazane partnerowi, na przykład faksem lub e-mailem.

Raporty

Raporty służą do wydruku danych za pomocą ERP Output Manager lub Crystal Reports. Wyróżnia się raporty typu dokument końcowy i dokument raportu. Raporty dla dokumentów końcowych bazują na danych pojedynczego dokumentu. Przykład: raport dla dokumentu końcowego Potwierdzenie zamówienia sprzedaży bazuje na danych z dokumentu Zamówienia sprzedaży. Raporty dla dokumentów raportu bazują na różnych danych uzyskanych na podstawie kryteriów wyszukiwania. Dane prezentowane są zazwyczaj w formie listy, np. lista adresowa. Raporty zawierają jeden lub więcej plików raportu określających parametry, zestaw pól oraz wygląd raportu. Mogą być zapisane jako obiekt systemowy lub obiekt deweloperski.

Plik raportu

Plik raportu służy do definiowania wyglądu dokumentu raportu. W tym celu pliki raportów są edytowane w Crystal Reports. Pliki raportów mogą być zależne lub niezależne od języka.

Dokument raportu

Wyjście raportu do urządzenia wyjściowego, takiego jak drukarka, lub do pliku tworzy dokument raportu lub dokument końcowy. Dokument raportu zawiera listę obiektów, np. listę adresów. Dokument końcowy zawsze zawiera obiekt, np. zamówienie sprzedaży. Dokumenty mogą być archiwizowane lub wysyłane do partnera, np. faksem lub pocztą elektroniczną.

Opis aplikacji

Za pomocą aplikacji Raport: Dokumenty raportu możliwe jest generowanie raportów typu dokument raportu. Wydruk raportu może zostać wykonany na drukarce, wysłany faksem lub e-mailem. Istnieje również możliwość zapisania pliku w Knowledge Store zamiast jego wydruku.

W obszarze identyfikacji aplikacji znajduje się zakładka Raporty. Pod tą zakładką wyświetlane są wszystkie dostępne w systemie raporty typu dokument raportu, do których użytkownik posiada uprawnienia. Raporty są prezentowane w grupach według obszarów. Możliwe jest również wyszukiwanie raportów, wpisując oznaczenie raportu w polu tekstowym obok nagłówka Raporty i naciskając klawisz Enter lub przycisk [Wyszukaj].

W momencie generowania raportu, zapisuje się jego wykonanie wraz z parametrami w historii aplikacji. W przypadku tworzenia wzorca zapytania dla aktualnie załadowanego raportu, oprócz samego raportu zapisywane są również bieżące wartości parametrów. Ustawienia wydruku nie są zapisywane – są one każdorazowo pobierane z bieżących ustawień użytkownika.

Obszar identyfikacji

Obszar identyfikacyjny zawiera pola umożliwiające jednoznaczną identyfikację raportu oraz inne ogólne właściwości raportu, przedstawione w następujących pozycjach:

Raport – raport, który ma zostać wygenerowany. Należy wprowadzić raport typu dokument raportu.

Oznaczenie raportu – wyświetlane jest między innymi na liście raportów w zakładce aplikacji Raport: Dokumenty raportu. Oznaczenie powinno być jednoznaczne w obrębie jednej wersji językowej. Maksymalna długość oznaczenia to 80 znaków. Może ono podlegać tłumaczeniu.

Obszar – obszar, do którego przypisano raport. Raporty są przypisywane do obszarów w celu tematycznego pogrupowania. Przypisanie raportu do konkretnego obszaru wpływa na nadawanie i weryfikację uprawnień. Dodatkowo raport jest wyświetlany w zakładce aplikacji Raport: Dokumenty raportu pod odpowiednim obszarem.

Język oryginalny – język używany do wygenerowania raportu w sytuacji, gdy plik raportu lub tekst nie jest dostępny w żądanym języku. W takim przypadku wykorzystywany jest plik raportu lub tekst w języku oryginalnym.

Obszar roboczy

W obszarze roboczym, pod zakładką Parametry i ustawienia, można wprowadzać wszystkie niezbędne dane do wygenerowania raportu. Zakładka Pomoc bezpośrednia wyświetla pomoc kontekstową powiązaną z danym raportem.

Zakładka Parametry i ustawienia

Sekcja parametrów

W sekcji Parametr wyświetlane są pola umożliwiające wprowadzenie wartości parametrów dla raportu. Dla każdego zdefiniowanego parametru pojawia się odpowiednie pole wprowadzania. Zakres dostępnych parametrów zależy od konkretnego raportu.

Sekcja ustawień wydania

W tej sekcji definiowane są ustawienia dotyczące sposobu wygenerowania dokumentu raportu, na przykład język, medium wyjściowe czy typ pliku.

Język – język, w którym ma zostać wygenerowany dokument raportu. Określa wybór pliku raportu oraz tłumaczenia stałych tekstowych. Ma również wpływ na język tłumaczonych treści, takich jak oznaczenia jednostek biznesowych. Wartość domyślna to język oryginalny raportu.

Zabarwienie tła – określa, czy podczas generowania raportu ma być zastosowane naprzemienne kolorowanie tła wierszy. Ustawienie to ma zastosowanie tylko wtedy, gdy raport obsługuje taką funkcję. Używana barwa pochodzi z bieżącego motywu użytkownika.

Sposób wydania – medium, poprzez które ma zostać wygenerowany dokument.
Wartość domyślna dla sposobu wydania oraz wszystkich opisanych poniżej pól pochodzi z ustawień użytkownika aktualnie zalogowanej osoby. Szczegółowe informacje dotyczące ustawień użytkownika znajdują się w dokumentacji Ustawienia użytkownika. Za pomocą akcji [Cofnij ustawienia raportu] można w dowolnym momencie zresetować wszystkie pola dla aktualnie wybranego medium wyjściowego do wartości domyślnych.

Ustawienia drukarki

Jeśli jako sposób wydania wybrano drukarkę, dostępne są dodatkowe ustawienia, które zależą od konkretnego urządzenia:

Drukarka – urządzenie wyjściowe o typie drukarka, używane do wydruku

Podajnik papieru – zasobnik papieru używany do drukowania

Podajnik papieru 1 strona – osobny podajnik dla pierwszej strony wydruku

Format – rozmiar papieru, np. A4.

Dwustronnie – ustawienia dotyczące wydruku dwustronnego. W tym polu można wybrać czy wydruk ma być jednostronny (wartość podpowiadana domyślnie) czy dwustronny. Przy wydruku dwustronnym można zlecić wydruk wzdłuż dłuższej lub krótszej krawędzi. Jeśli pole nie jest aktywne przyjmuje wartość Jednostronnie bez możliwości zmiany.

Orientacja wydruku — pole umożliwia wybór orientacji wydruku. Dostępne są następujące opcje:

Format poziomy
Format pionowy
Format poziomy obrócony o 180°
Fortmat pionowy obrócony o 180°

Liczba kopii – liczba kopii do wydrukowania

Sortowanie – sposób sortowania stron w przypadku wielu kopii:

Wg kopii – każda kopia drukowana w całości, jedna po drugiej
Wg strony – drukowane kolejno wszystkie kopie każdej strony

Rozdzielczość – rozdzielczość używana podczas drukowania. Dostępne wartości zależą od drukarki. Przy przekierowaniu do pliku ma wpływ na jakość pliku.

Kolor – określa, czy dokument ma być drukowany w kolorze czy w czerni i bieli

Priorytet – określa priorytet przetwarzania zadania wydruku. Dostępne wartości od 1 (najwyższy) do 9 (najniższy).

Przekierowanie raportu – umożliwia zapisanie wydruku jako plik w Knowledge Store zamiast fizycznego wydruku. Dostępne opcje:

Nie
Do pliku
Do pliku i na drukarkę klienta

Opcja do pliku i na drukarkę klienta jest dostępna, lecz w wersji Semiramis 4 nie została jeszcze zaimplementowana.

Folder – folder w Knowledge Store, w którym plik zostanie zapisany. Jeśli folder nie istnieje, zostanie utworzony. W nazwie folderu można używać zmiennych, np.:

{report} – oznaczenie raportu
{user} – nazwa użytkownika
{timestamp} – data i czas z milisekundami
{datetime} – data i czas
{date} – data
{time} – czas
{week} – tydzień kalendarzowy
{year} – rok
{month} – miesiąc
{day} – dzień

Dla dokumentów końcowych dostępne są dodatkowe zmienne:

{document} – oznaczenie dokumentu
{number} – pełny numer zamówienia (rodzaj i numer)

Nazwa pliku – nazwa pliku bez rozszerzenia. W przypadku istnienia pliku o tej nazwie zostanie automatycznie dodany numer kolejny. Można używać tych samych zmiennych co w nazwie folderu.

Typ pliku – format, w jakim ma być zapisany plik

Okno dialogowe wydruku klienta – pole określa, czy podczas przekierowania wydruku do pliku i na drukarkę klienta ma zostać wyświetlony dialog wydruku po stronie klienta

Drukarka klienta – ścieżka UNC do drukarki klienckiej, np. \printers\laserprinter

Ustawienia faksu

Jeśli jako sposób wydania wybrano faks, dostępne są następujące ustawienia:

Faks – urządzenie faksowe, za pośrednictwem którego dokument ma zostać wysłany

Identyfikator nadawcy – numer nadawcy pojawiający się na wydruku faksu

Sekwencja znaków kontrolnych – ciąg znaków przekazywany bezpośrednio do ERP Output Manager, a następnie do zainstalowanego oprogramowania faksowego. Umożliwia sterowanie tym oprogramowaniem (o ile obsługuje tę funkcję) i działa analogicznie do komend AT w modemach.

Nr faksu – numer, na który ma zostać wysłany faks

Dotyczy – temat, który pojawi się w nagłówku faksu

Format – rozmiar papieru (np. A4).

Priorytet – priorytet przypisany do zadania. Zadania o wyższym priorytecie są przetwarzane w pierwszej kolejności. Możliwe wartości od 1 (najwyższy priorytet) do 9 (najniższy priorytet).

Rozdzielczość – rozdzielczość używana podczas wysyłania faksu. Dostępne rozdzielczości zależą od konkretnego urządzenia faksowego.

Dwustronnie– ustawienia dotyczące wydruku dwustronnego. W tym polu można wybrać czy wydruk ma być jednostronny (wartość podpowiadana domyślnie) czy dwustronny. Przy wydruku dwustronnym można zlecić wydruk wzdłuż dłuższej lub krótszej krawędzi. Jeśli pole nie jest aktywne przyjmuje wartość Jednostronnie bez możliwości zmiany.

Orientacja wydruku – pole umożliwia wybór orientacji wydruku. Dostępne są następujące opcje:

Format poziomy
Format pionowy
Format poziomy obrócony o 180°
Fortmat pionowy obrócony o 180°

Wysyłanie — określa, czy faks ma zostać wysłany natychmiast, czy z opóźnieniem. W ustawieniu natychmiast faks jest wysyłany od razu. W ustawieniu Nie wcześniej niż można określić moment, od którego wysyłka jest możliwa. W ustawieniu w czasie ulgowym faks zostanie wysłany w godzinach o niższych stawkach.

Czas wysłania – moment, w którym faks ma zostać wysłany

Ustawienia e-mail

W przypadku wyboru e-maila jako sposób wydania dostępne są następujące pola:

Bramka e-mail – urządzenie wyjściowe typu e-mail, za pomocą którego wysyłany jest dokument.

Od – adres e-mail nadawcy. Domyślnie jest to adres e-mail przypisany użytkownikowi w konfiguracji systemu. W przypadku posiadania odpowiednich uprawnień możliwe jest wysyłanie wiadomości z innego adresu.

Uwaga

Jeśli ten adres został zmodyfikowany w ustawieniach użytkownika, np. przez administratora, a użytkownik nie posiada wymaganych uprawnień do korzystania z tej funkcji, zostanie użyta wartość z konfiguracji systemowej.

Odpowiedź do – adres e-mail, na który mają trafiać odpowiedzi, jeśli nie mają być wysyłane na adres nadawcy

Odbiorca – adres e-mail odbiorców wiadomości. W przypadku wielu adresów należy je oddzielić przecinkami.

DW – adresy e-mail, które otrzymają kopię wiadomości. Adresy te są widoczne dla wszystkich odbiorców. W przypadku wielu adresów należy je oddzielić przecinkami.

UDW – adresy e-mail, które otrzymają kopię wiadomości w sposób ukryty. Ukrycie oznacza, że jedynie odbiorca UDW widzi ten wpis.

Temat – temat wiadomości e-mail. W polu tematu można używać zmiennych, które zostaną zastąpione rzeczywistymi wartościami podczas generowania wydruku. Dostępne zmienne:

{report} – oznaczenie raportu
{user} – nazwa użytkownika
{timestamp} – data i czas z milisekundami (yyyyMMdd_HHmmss_SSS)
{datetime} – data i czas (yyyyMMdd_HHmmss)
{date} – data (yyyyMMdd)
{time} – czas (HHmmss)
{week} – tydzień kalendarzowy (ww)
{year} – rok (yyyy)
{month} – miesiąc (MM)
{day} – dzień (dd)

Dla dokumentów końcowych dodatkowo dostępne są:

{document} – oznaczenie dokumentu
{number} – pełna identyfikacja zlecenia (rodzaj i numer)

Treść – treść wiadomości e-mail. Można stosować te same zmienne co w polu Temat.

Załącznik – określa, czy dokument ma być dołączony jako załącznik, czy wprowadzony bezpośrednio w treści wiadomości. Możliwość wyboru zależy od konfiguracji ERP Output Manager oraz serwera e-mail.

Typ pliku – format pliku, w którym dokument zostanie przesłany e-mailem

Priorytet – priorytet realizacji zadania wysyłki. Zadania o wyższym priorytecie przetwarzane są w pierwszej kolejności. Zakres wartości: od 1 (najwyższy priorytet) do 9 (najniższy priorytet).

Zakładka Pomoc kontekstowa

Na zakładce Pomoc kontekstowa wyświetlana jest pomoc dotycząca danego raportu.

Konfiguracja kontynucja

Dla aplikacji Raport: Dokumenty raportów w aplikacji Konfiguracja istotne są następujące ustawienia w dla funkcji Ustawienia użytkownika dla systemu oraz Ustawienia użytkownika dla bazy danych OLTP:

Zakładka Ogólne, sekcja Ustawienia przetwarzanie w tle – wartości domyślne dla przetwarzania w tle. Ustawienia te mają zastosowanie przy wydruku dokumentów raportu w trybie przetwarzania w tle.

Zakładka Eksport danych – wartości domyślne dla ustawień wydruku w obszarze roboczym. Ustawienia te mają zastosowanie podczas wydruku dokumentów raportu.

Wskazówka

W aplikacji Konfiguracja po instalacji systemu należy wprowadzić odpowiednie ustawienia dla powyższych sekcji, np. określić używaną kolejkę przetwarzania. Jeśli kolejka przetwarzania nie została określona ani w Konfiguracji, ani w Ustawieniach użytkownika, to podczas każdego uruchomienia raportu w tle konieczne będzie jej ponowne wskazanie.

Uprawnienia

Comarch ERP Enterprise wykorzystuje wielopoziomowy model zarządzania uprawnieniami. Prawa dostępu oraz uprawnienia mogą być przyznawane na różnych poziomach:

Na poziomie obszarów i aplikacji można przypisać uprawnienie umożliwiające otwarcie aplikacji.
Na poziomie obszarów i raportów można przypisać uprawnienie pozwalające na wykonanie raportu w aplikacji Raport: Dokumenty raportu.
Na poziomie jednostek biznesowych można przypisać uprawnienie pozwalające na utworzenie lub wygenerowanie raportu. Uprawnienia przypisane do jednostek biznesowych obowiązują niezależnie od aplikacji.
W niektórych aplikacjach dostępne są specjalne prawa dostępu odnoszące się do konkretnych akcji lub funkcji. Takie prawa również mogą podlegać nadawaniu. Przykład: dla specjalnego prawa dostępu umożliwiającego wygenerowanie zamówienia można przypisać konkretne uprawnienie.

Model uprawnień oraz ogólne i jednostkowe uprawnienia aplikacyjne są opisane w dokumentacji technicznej, w dokumencie Uprawnienia.

Do wygenerowania dokumentu raportu wymagane jest przypisanie uprawnienia do danego raportu wraz z prawem dostępu Wykonaj.

Specjalne uprawnienia i prawa dostępu istotne dla tej aplikacji:

Użycie innego numeru faksu jako nadawcy
To prawo dostępu umożliwia użycie innego numeru faksu jako numeru nadawcy zamiast domyślnego. Dotyczy wyłącznie własnych ustawień użytkownika.
Techniczna nazwa prawa dostępu: cisag.sys.services.output.UseDifferentFaxSender

Użycie innego adresu e-mail jako nadawcy
To prawo dostępu umożliwia użycie innego adresu e-mail jako adresu nadawcy wiadomości zamiast adresu z konfiguracji systemowej. Jeżeli użytkownik nie posiada tego prawa, używany jest adres z konfiguracji, niezależnie od wpisu w ustawieniach użytkownika.
Techniczna nazwa prawa dostępu: cisag.sys.services.output.UseDifferentMailFrom

Tworzenie zleceń przetwarzania w imieniu innego użytkownika
To prawo dostępu umożliwia tworzenie zleceń przetwarzania przypisanych do innego użytkownika.
Techniczna nazwa prawa dostępu: cisag.sys.services.batch.SubmitOtherUsersJobs

Procedura: Wydruk dokumentu raportu

Otworzyć aplikację Raport: Dokumenty raportu.
Wprowadzić oznaczenie raportu w polu Raport w obszarze identyfikacyjnym, a następnie kliknąć przycisk [Aktualizuj].
- Alternatywnie możliwe jest wybranie raportu z zakładki Raporty w obszarze nawigacyjnym.
Przejść do zakładki Parametry i ustawienia.
W sekcji Parametr wprowadzić wymagane parametry raportu.
W sekcji Ustawienia wydania zdefiniować sposób wydania raportu.
Kliknąć przycisk [Drukuj dokument raportu natychmiast i pokaż w pliku].
Raport zostaje wygenerowany. W przypadku przekierowania wyniku do pliku, plik ten zostaje wyświetlony.

Akcje związane z aplikacją

W aplikacji Raport: Dokumenty raportu dostępne są następujące akcje kontekstowe:

Akcja [Drukuj dokumentu raportu w tle]

Akcja umożliwia wygenerowanie dokumentu raportu w tle. Po kliknięciu przycisku [Wydruk dokumentu raportu w tle] pojawia się okno dialogowe, w którym można określić ustawienia przetwarzania w tle.

Akcja [Drukuj dokument raportu natychmiast i pokaż w pliku]

Po kliknięciu przycisku [Drukuj dokument raportu natychmiast i pokaż w pliku] raport zostaje wygenerowany bezpośrednio, a utworzony plik zostaje otwarty. Funkcja ta podlega takim samym ograniczeniom jak natychmiastowe wykonywanie zleceń przetwarzania. Jeśli ustawienia użytkownika zabraniają takiego działania, przycisk jest nieaktywny. Jeżeli liczba jednoczesnych wykonań została przekroczona i natychmiastowe uruchomienie nie jest możliwe w rozsądnym czasie, zostaje wyświetlony odpowiedni komunikat.

Akcja [Cofnij ustawienia raportu]

Po kliknięciu przycisku [Cofnij ustawienia raportu] wszystkie wprowadzone wartości parametrów raportu zostają usunięte.