Raporty

Funkcjonalność umożliwia przeglądanie danych w formie wydruków. Dostęp do raportów posiadają operatorzy, którym nadano odpowiednie uprawnienia w Kreatorze raportów i dashboardów.

Raporty prezentowane są po kliknięciu na ikonę [Raporty i dashboardy] w menu bocznym aplikacji.

Raporty opatrzone są prefiksem „R”. Prefiks „*R” oznacza raport predefiniowany. Prefiks „R” oznacza raport utworzony przez operatora.

W wyświetlonym oknie prezentowane są raporty, dashboardy i wydruki sPrint dostępne dla zalogowanego operatora.

Istnieje możliwość drukowania oraz eksportu raportów do typów plików takich jak m.in.: pdf, xls, xlsx, csv.

 

Podgląd przykładowego raportu



Dashboardy

Funkcjonalność umożliwia przeglądanie danych w formie graficznej. Dostęp do dashboardów posiadają operatorzy, którym nadano odpowiednie uprawnienia w Kreatorze raportów i dashboardów.

Dashboardy są prezentowane po kliknięciu na ikonę [Raporty i dashboardy] w menu bocznym aplikacji.

Dashboardy opatrzone są oznaczeniem „*D” (dashboard predefiniowany) lub „D” (dashboard użytkownika).

W wyświetlonym oknie prezentowane są raporty i dashboardy dostępne dla zalogowanego operatora.

Istnieje możliwość drukowania oraz eksportu dasboardów do typów plików takich jak pdf, xls, a także do plików graficznych.

 

Wybór dashboardu z listy Raportów i dashboardów

 

Podgląd przykładowego dashboardu „Dokumenty przeterminowane”



Kreator raportów i dashboardów – informacje ogólne

Okno zbudowane jest z czterech zakładek:

  • Kreator dashboardów – do definiowania dashboardów
  • Kreator raportów– do definiowania raportów za pomocą Devexpress
  • Kreator wydruków sPrint – zakładka dodana w wersji 2023.0.0; służy do definiowania wydruków za pomocą sPrint
  • Uprawnienia – do określenia uprawnień dla pracowników, działów czy stanowisk do podglądu raportów, dashboardów i wydruków sPrint

Funkcjonalność jest dostępna dla operatorów, dla których na właściwościach operatora zostało zaznaczone uprawnienie „Kreator raportów i dashboardów”.

 

Kreator raportów i dashboardów z zakładką „Kreator wydruków sPrint”



Kreator raportów

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

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.

Przykładem raportu wykorzystującego parametry jest predefiniowany raport Pocztowa książka nadawcza.

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, wykorzystując procedurę 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.



Kreator dashboardów

W kreatorze dashboardów operator ma możliwość:

  • Utworzenia nowego dashboardu poprzez wybranie ikony „New”
  • Edycji istniejącego raportu za pomocą ikony „Open”
  • Zapisania raportu po kliknięciu na ikonę „Save” lub „Save as”.

Instrukcja obsługi kreatora raportów opisana jest na stronie producenta komponentu.

 

Przykładowy dashboard



Kreator raportów i dashboardów – uprawnienia

W oknie „Uprawnienia” określa się uprawnienia pracowników do poszczególnych raportów, dashboardów i wydruków sPrint oraz miejsca wywołania raportów i wydruków sPrint. Okno podzielono na trzy sekcje. W lewej sekcji wyświetlana jest lista raportów, dashboardów i wydruków sPrint, w środkowej nadaje się uprawnienia, prawa sekcja wyświetlana jest wyłącznie w kontekście raportów i wydruków sPrint.

Na liście prezentowane są wszystkie zdefiniowane raporty, dashboardy i wydruki sPrint. Po zaznaczeniu nazwy raportu lub wydruku sPrint wyświetlony zostaje prawy panel, w którym definiowane są uprawnienia. Możliwe jest nadanie uprawnienia typu pracownik, dział i stanowisko. Uprawnienia usuwane są za pomocą ikony kosza.

 

Lista raportów, dashboardów i wydruków sPrint z uprawnieniami[/caption]

 

W sekcji „Miejsce wywołania raportu” udostępniono parametry:

  • Pokaż na liście raportów – parametr odpowiada za możliwość wyświetlania raportu/wydruku sPrint w oknie Raporty i dashboardy. Parametr domyślnie jest zaznaczony dla każdego nowododanego raportu/wydruku sPrint. Gdy parametr jest odznaczony, raport/wydruk sPrint nie jest widoczny na liście raportów/wydruków sPrint możliwych do wywołania w oknie Raporty i dashboardy.
  • Typ obiegu – w kolumnie należy wybrać z listy typ obiegu dokumentów, dla którego definiowane jest miejsce wywołania.
  • Miejsce wywołania – parametr może przyjmować trzy wartości:
    • Lista dokumentów – raport będzie możliwy do wywołania z listy dokumentów ograniczonej do jednego typu obiegu;
    • Szczegóły dokumentu – raport będzie możliwy do wywołania z poziomu szczegółów dokumentu
    • Lista i szczegóły dokumentu – łączy powyższe funkcje.

 

Wywoływanie raportów na szczegółach dokumentu

 

Wywoływanie raportów na liście dokumentów dla wybranego typu dokumentów



Uprawnienia w kreatorze raportów i dashboardów – tryb wielofirmowy

Podczas wyboru operatorów uprawnionych do wyświetlenia raportu, dashboardu lub wydruku sPrint należy wskazać spółkę.

 

Wybór spółki na zakładce „Uprawnienia” w kreatorze raportów i dashboardów



Raporty, dashboardy i wydruki sPrint

Od wersji 2018.2.1 wprowadzono zmiany w zakresie nazewnictwa funkcjonalności uruchamianych przyciskami:

 

– nowa nazwa: Raporty i dashboardy

 

– nowa nazwa: Kreator raportów i dashboardów

 

W wersji 2023.0.0 umożliwiono integrację Comarch DMS z aplikacją Comarch sPrint, która służy do tworzenia wydruków.

Oprócz możliwości tworzenia raportów za pomocą Devexpress, tak jak miało to miejsce do tej pory, umożliwiono opcję tworzenia i wyświetlania wydruków z zastosowaniem aplikacji Comarch sPrint.

W aktualnej wersji Comarch sPrint obsługuje jedynie wydruki z bazy Comarch DMS.

W wersji 2023.0.0 w oknie dodano też nową zakładkę „Kreator wydruków sPrint” dedykowaną wydrukom Comarch sPrint.

 

Widok zakładki „Kreator wydruków sPrint” w ramach okna „Kreator raportów i dashboardów”

 

W wersji 2023.0.0. w ramach zakładki [Raporty i dashboardy] wprowadzono oznaczenie (sPrint*) dla predefiniowanych wydruków sPrint

 

Oznaczenia predefiniowanych raportów i dashboardów wraz z nowym rodzajem oznaczenia (sPrint*)



Wydruki sPrint

Uwaga
Aby możliwa była integracja Comarch DMS z aplikacją Comarch sPrint należy pobrać wersję Comarch sPrint 2023.0.1. Wersja ta jest dostępna w folderze Instalator sPrint, który znajduje się w pobranym pliku instalacyjnym

Comarch sPrint to aplikacja zewnętrzna, która jest uruchamiana z poziomu aplikacji Comarch DMS za pomocą przycisków/linków. Kiedy operator naciśnie przycisk/link, otwarta zostanie aplikacja Comarch sPrint. W aplikacji możliwe jest wykonanie wybranej akcji.

W aplikacji Comarch sPrint znajdują się 2 predefinowane wydruki, które nie podlegają edycji:

  • Pocztowa książka nadawcza
  • Historia zmian dokumentu

 

Wydruki opatrzone są oznaczeniem „sPrint*” (wydruki predefiniowane) lub „sPrint” (wydruki użytkownika).



Kreator wydruków sPrint

W wersji 2023.0.0 w ramach zakładki [Kreator raportów i dashboardów] dodano zakładkę „Kreator wydruków sPrint”.

Zakładka „Kreator wydruków sPrint” jest podzielona na dwie części:

  • Szablony wydruków
  • Pole edycji wydruków
Szablony wydruków

W lewej części pod etykietą „Szablony wydruków” znajduje się lista wszystkich szablonów wydruków sPrint, w następującej kolejności: na początku predefiniowane wydruki w kolejności alfabetycznej, później zaś wydruki utworzone przez użytkownika, również uporządkowane w kolejności alfabetycznej.

Obok kolejnych pozycji na liście szablonów predefiniowanych wydruków dostępne są następujące ikony:

  • [Kopiuj] – po kliknięciu w tę ikonę następuje skopiowanie szablonu – otwiera się okno Comarch sPrint, w ramach którego możliwa jest edycja kopii szablonu. Następnie po  naciśnięciu przycisku „ Wyślij do Comarch ERP” okno Comarch sPrint zostaje zamknięte, a na liście szablonów zostaje dodany szablon wydruku użytkownika o takiej samej nazwie jak ten, który został skopiowany, ale z kolejnym numerem w nawiasie, np. (1).
  • [Pokaż] – po wyborze tej opcji wywołany zostaje podgląd wydruku – jeśli wydruk ma parametry, najpierw zostaje otwarte okno „Wprowadź parametry”, w ramach którego należy wpisać wartości parametrów

 

Okno „Wprowadź parametry” dla wydruku predefiniowanego

 

Natomiast obok kolejnych pozycji na liście szablonów wydruków użytkownika dostępne są następujące ikony:

  • [Kopiuj] – po kliknięciu w tę ikonę następuje skopiowanie szablonu – otwiera się okno Comarch sPrint, w ramach którego możliwa jest edycja kopii szablonu. Następnie po  naciśnięciu przycisku „ Wyślij do Comarch ERP” okno Comarch sPrint zostaje zamknięte, a na liście szablonów zostaje dodany szablon wydruku użytkownika o takiej samej nazwie jak ten, który został skopiowany, ale z kolejnym numerem w nawiasie, np. (1).
  • [Więcej opcji] – menu, w ramach którego dostępne są opcje:

Pokaż – po wyborze tej opcji prezentowany jest podgląd szablonu wydruku

Edytuj – po wyborze tej opcji możliwa jest edycja wydruku użytkownika albo kopii szablonu predefiniowanego wydruku

Usuń – opcja pozwala na trwałe usunięcie szablonu wydruku użytkownika

 

Dodawanie nowego szablonu wydruku

Pod listą wydruków znajduje się link [Dodaj], za pomocą którego można dodać nowy szablon wydruku.

Kiedy użytkownik kliknie w link [Dodaj], zostanie otwarte okno „Utwórz nowy szablon wydruku”.

 

Okno „Utwórz nowy szablon wydruku”

 

W ramach okna „Utwórz nowy szablon wydruku” dostępne są dwa pola:

  • Nazwa – w ramach tego pola należy uzupełnić nazwę szablonu wydruku – pole jest obowiązkowe
  • Opis – w ramach tego pola opcjonalnie można zamieścić opis szablonu wydruku

 

W oknie „Utwórz nowy szablon wydruku” znajdują się także dwa przyciski:

  • [Dodaj] – przycisk aktywny po uzupełnieniu pola „Nazwa”; po kliknięciu na ten przycisk nazwa szablonu wydruku zostaje zapisana i zostaje otwarte okno designera sPrint. Jeżeli nazwa wprowadzona przez użytkownika jest taka sama jak jednego z szablonów, wyświetlany jest następujący komunikat:

 

Komunikat wyświetlany przy próbie zapisu szablonu o powtarzającej się nazwie

 

Po kliknięciu „Ok” nazwa nie zostaje zapisana, a użytkownik wraca do pola „Nazwa”.

  • [Anuluj] – po kliknięciu w ten przycisk następuje wycofanie się użytkownika z tworzenia nowego szablonu wydruku – okno „Utwórz nowy szablon wydruku” zostaje zamknięte bez zapisania szablonu, a użytkownik powraca do okna „Kreator raportów i wydruków”. Analogicznie dzieje się w przypadku naciśnięcia w ramach okna „Utwórz nowy szablon wydruku” znaku x.

 

Po kliknięciu na przycisk [Dodaj] zostaje otwarte okno designera sPrint.

 

Uruchamianie Comarch sPrint

 

Następnie zostaje otwarte okno konfiguratora danych szablonu, w ramach którego można wybrać jedną z trzech opcji (po kliknięciu w nazwę danej opcji na poniższej liście zostanie otwarta przeglądarka z odpowiednim artykułem):

 

Opis dalszego postępowania jest dostępny na stronie:

https://pomoc.comarch.pl/sprint/index.php/dokumentacja/nowy-szablon/

 

Okno konfiguratora danych szablonu

 

Okno konfiguratora danych szablonu po wyborze opcji „Wpisz własne zapytanie SQL” – aby w polu pojawiły się nazwy tabeli i wybranych kolumn wystarczy wybrać daną tabelę oraz wybrane kolumny i przeciągnąć je kolejno do okna „Zapytanie SQL”

 

Przykład tworzenia szablonu w sPrint

 

Tworzenie szablonu po wyborze opcji „Zdefiniuj samodzielnie” (przykład)

Użytkownik w ramach okna „Konfigurator danych szablonu” wybrał opcję „Zdefiniuj samodzielnie” i kliknął przycisk [Dalej].

Następnie zostało wyświetlone okno, po którego prawej stronie wyświetliła się lista tabel z bazy Comarch DMS. Użytkownik za pomocą metody drag&drop przeciągnął tabelę do.OC_Documents na środek okna. W dalszej kolejności zaznaczył checkboxy obok trzech pozycji: OCD_Number, OCD_IssueDate i OCD_ContractorName, a potem kliknął przycisk [Dalej].

 

Wybór kolumn „OCD_Number” i „OCD_IssueDate” z tabeli do.OC_Documents, z których będą pochodzić dane prezentowane na wydruku

 

Wybór kolumny „OCD_ContractorName” z tabeli do.OC_Documents, z której również będą pochodzić dane prezentowane na wydruku

 

Następnie należy uzupełnić pola „Opis tabeli” i „Opis pola” dla każdej wybranej kolumny, a następnie nacisnąć przycisk [Utwórz].

 

Dodawanie opisu tabeli i pól z danymi pochodzącymi z kolumn OCD_Number, OCD_IssueDate i OCD_ContractorName

 

Następnie użytkownik wstawił dwuwersową tabelę w ramach szablonu, wpisał jako nagłówki kolumn nazwy: „Numer dokumentu”, „Data wystawienia” i „Kontrahent”, a następnie rozwinął zakładkę „Połączenie zewnętrzne”, zaś potem „QueryBuilderGenerated” i przeciągnął metodą drag&drop:

  • Pole „OCD_Number” do pustego wersu pod nagłówkiem kolumny „Numer dokumentu”
  • Pole „OCD_IssueDate” do pustego wersu pod nagłówkiem kolumny „Data wystawienia”
  • Pole „OCD_ContractorName” do pustego wersu pod nagłówkiem kolumny „Kontrahent”

 

Przeciąganie pola „OCD_Number” do tabelki utworzonej w ramach szablonu wydruku

 

Później użytkownik kliknął znak „+” w ramach pola „Parametry szablonu”.

 

Przejście do parametrów szablonu

 

Później użytkownik przeciągnął i upuścił na środek wyświetlanego okna dwa domyślnie dostępne parametry: „Autor” i „Data wydruku”, a następnie kliknął [Dodaj].

 

Wybór parametrów szablonu

 

Następnie użytkownik nacisnął przycisk „ Wyślij do Comarch ERP”, aby przesłać szablon do Comarch DMS.

 

Wysyłanie szablonu wydruku do Comarch DMS

 

Wówczas okno sPrint zostało zamknięte, a nowoutworzony szablon pojawił się na liście szablonów wydruków.

 

Nowododany szablon „Dokumenty przesłane za pomocą wiadomości email” na liście szablonów wydruków

 

Użytkownikowi nadano następnie odpowiednie uprawnienia do szablonu wydruku (zob. Uprawnienia w kreatorze raportów i dashboardów), dlatego szablon jest dla niego widoczny w ramach pola [Raporty i dashboardy].

 

Wybór szablonu sPrint „Dokumenty przesłane za pomocą wiadomości email”

 

Po wyborze szablonu zostało wyświetlone okno, w którym należy uzupełnić określone przedtem parametry (jeśli są edytowalne) i nacisnąć [Zapisz].

 

Okno „Wprowadź parametry”

 

Wtedy zostaje wyświetlony wydruk sPrint „Dokumenty przesłane za pomocą wiadomości email”, który może zostać wydrukowany lub zapisany na dysku.

 

Wydruk sPrint „Dokumenty przesłane za pomocą wiadomości email”

 

Pole edycji wydruków

W prawej części zakładki wyświetlane są informacje o danym szablonie wydruku, który wybrano w lewej części okna, a mianowicie:

  • Nazwa szablonu wydruku (max 100 znaków)
  • Opis wydruku (max 200 znaków)

 

Operator może modyfikować zarówno nazwy, jak i opisy szablonów wydruków utworzonych przez użytkowników. Wprowadzone zmiany należy zapisać, klikając na ikonę [Zapisz], znajdującą się po prawej stronie okna.

 

Uwaga
Dla predefiniowanych szablonów wydruków nie jest możliwe wprowadzenie modyfikacji – przycisk [Zapisz] nie jest aktywny.

 

Widok pól „Nazwa wydruku” i „Opis” dla predefiniowanego szablonu wydruków

 

 

Jeżeli użytkownik zmienił nazwę wydruku na taką, która już istnieje i próbuje zapisać, klikając w przycisk [Zapisz], wówczas zostaje wyświetlony komunikat informujący o istnieniu szablonu wydruku o takiej samej nazwie.

 

Komunikat wyświetlany przy próbie zapisania zmiany nazwy szablonu wydruku na taką, która już istnieje

 

Jeżeli w ramach komunikatu operator wybierze:

  • Przycisk „OK” – operator wraca do okna edycji nazwy szablonu wydruku
  • X – operator wraca do okna edycji nazwy szablonu wydruku, a w polu Nazwa wydruku przywracana jest do nazwy sprzed próby zapisu

 

Jeśli operator nie wybrał żadnego wydruku w lewej części zakładki „Kreator wydruków sPrint”, wówczas w prawej części zakładki widoczna jest informacja Wybierz szablon, aby edytować jego nazwę i opis.

 

Zakładka „Kreator wydruków sPrint”, na której nie został zaznaczony żaden szablon wydruku

 

Zakładka „Kreator wydruków sPrint” – pola „Nazwa wydruku” i „Opis” po wyborze szablonu wydruku użytkownika

 

Wydruki predefiniowane

Od wersji 2023.0.0 w ramach Comarch DMS są dostępne następujące wydruki predefiniowane, przygotowane w aplikacji sPrint:

(sPrint*) Historia zmian dokumentu

  • Prezentuje historię zmian, które miały miejsce w kontrolkach na danym dokumencie
  • Wydruk dostępny, jeśli zaznaczono parametr „ Historia zmian” w zakładce „Ustawienia obiegu” na definicji obiegu (zob. Ustawienia typu obiegu )

 

(*sPrint) Pocztowa książka nadawcza

  • Wydruk w formie tabeli
  • Przedstawia listę dokumentów, które będą wysłane pocztą

 

Uwaga
Edycja nazw i opisów predefiniowanych wydruków nie jest możliwa.