Do tworzenia raportów służy kreator, w którym krok po kroku można wskazać tabele, z których zostaną pobrane dane lub wkleić gotowe zapytanie SQL.
Aby utworzyć nowy raport należy wybrać ikonę:
Przycisk dodania nowego raportu w kreatorze raportów
W kolejnych krokach w kreatorze raportu należy:
- Wskazać typ kreowanego raportu.
- Wskazać typ źródła danych.
- Ustawić połączenie do źródła danych – w przypadku, gdy źródłem danych jest baza Comarch DMS, należy wskazać serwer, użytkownika i hasło oraz bazę Comarch DMS.
- Kolejnym krokiem jest przejście do konstruktora zapytań, w którym krok po kroku można wskazać tabele, z których zostaną pobrane dane, lub wkleić przygotowane zapytanie SQL.
- Po dodaniu zapytania, w kolejnym kroku kreatora użytkownik ma możliwość dodania parametrów do tworzonego zapytania.
- W następnym kroku należy wskazać kolumny, które będą wyświetlane w raporcie.
- Kolejnym krokiem jest wprowadzenie grupowania danych w raporcie.
- Kończąc kreowanie raportu należy wskazać sposób prezentacji danych (wybór orientacji strony, wybór jednego z 5 predefiniowanych layoutów).
- W ostatnim kroku należy określić styl tekstu wyświetlanego w raporcie
Po przejściu wszystkich kroków kreatora zostaje wyświetlony designer raportu, w którym można skorzystać z nadanej przez program, częściowo skonfigurowanej formy raportu lub wprowadzić własne modyfikacje za pomocą dostępnych narzędzi.
Instrukcja obsługi kreatora raportów dostępna jest na stronie producenta komponentu Raporty
Kreator raportów – przykładowy raport
Parametry umożliwiające definicję raportu dla określonego miejsca wywołania
Raport można wywołać zarówno z poziomu listy dokumentów, jak i z poziomu szczegółów dokumentu.
Możliwość wywołania raportu z listy dokumentów oraz ze szczegółów dokumentów związana jest z parametrami, którymi należy się posłużyć, aby do raportu zostały przekazane informacje o numerze dokumentu, typie obiegu dokumentu czy operatorze.
Comarch DMS na szczegółach i liście dokumentów automatycznie uzupełnia parametry:
- WorkflowTypeId (int) – informacja o aktualnie wyświetlanym typie obiegu dokumentów,
- DocumentId (long) – informacja o aktualnie wyświetlanym dokumencie,
- OperatorId (int) – informacja o operatorze,
- DateSince – informacja o wartości w filtrze Data przekazania – od,
- DateTo – informacja o wartości w filtrze Data przekazania – do,
Powiązanie powyższych parametrów z parametrami raportu spowoduje, że raport będzie wyświetlany dla aktualnie wyświetlonego dokumentu czy listy dokumentów.
Parametry DateSince i DateTo przekazują informacje o datach ustawionych w filtrze ‘Data przekazania’, wykorzystanie parametrów w raporcie pozwoli na wygenerowanie raportu z listą dokumentów, których data przekazania zawiera się w zakresie dat określonych w filtrze.
Uwaga
Aktualnie zawężenie listy dokumentów za pomocą filtrów dodanych w „Filtrach użytkownika” nie wpływa na zawartość wywoływanego raportu.
Ustawianie filtrów „Data przekazania – od” i „Data przekazania – do” – przy takim ustawieniu w raporcie przedstawione będą jedynie pozycje dodane do wybranego typu obiegu pomiędzy 6 lipca 2024 a 30 sierpnia 2024
Przykładem raportu wykorzystującego parametry jest predefiniowany raport Pocztowa książka nadawcza.
Uwaga
W celu poprawnego generowania raportu „Pocztowa książka nadawcza” konieczne jest zaznaczenie parametru „Wydruk książki nadawczej” i wybór kontrolek do zmapowania na odpowiednie pola wydruku w sekcji „Lista dokumentów jako książka nadawcza” na zakładce „Ustawienia obiegu” na definicji danego typu obiegu (zob. Wydruk listy dokumentów w formie książki nadawczej).
Wywoływanie raportu z poziomu szczegółów dokumentu
Raport „Pocztowa ksiązka nadawcza” wywołany z poziomu szczegółów dokumentu
Wywoływanie raportu z poziomu listy dokumentów
Raport „Pocztowa ksiązka nadawcza” wywołany z poziomu listy dokumentów
Konfiguracja raportów z wykorzystaniem parametru
Podczas kreowania raportu po wskazaniu typu raportu, określeniu źródła (baza danych), połączeniu do serwera i wskazaniu bazy Comarch DMS wyświetlane jest okno, w którym można wskazać procedurę z bazy lub wprowadzić własne zapytanie. Istotne jest, aby zapytanie dostarczające dane do raportu przekazywało parametr.
Przykładowo, z wykorzystaniem procedury do.ROGetHistory tworzona będzie historia zmian na dokumencie. Procedura przekazuje do raportu parametr @DwdId. Parametr z procedury należy powiązać z parametrem raportu. W tym celu w Report Wizard należy zaznaczyć ‘Expression’ i dodać nowy parametr.
Okno kreatora raportu, definiowanie parametrów
Podczas definicji parametru raportu należy pamiętać, aby typ parametru raportu był zgodny z typem parametru z zapytania SQL.
Definiowanie nowego parametru raportu
Następnie należy powiązać zdefiniowany parametr raportu z parametrem z zapytania SQL.
Kreator raportu, wiązanie parametru zapytania z parametrem raportu
W kolejnych krokach należy zdecydować o tym które informacje zostaną wyświetlone w raporcie i jeżeli jest taka potrzeba, ustawić grupowanie wartości.
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?