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.
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.
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
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ę:
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.
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.
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.
Podczas definicji parametru raportu należy pamiętać, aby typ parametru raportu był zgodny z typem parametru z zapytania SQL.
Następnie należy powiązać zdefiniowany parametr raportu z parametrem z zapytania SQL.
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”.
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ę.
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.
W wersji 2023.0.0. w ramach zakładki [Raporty i dashboardy] wprowadzono oznaczenie (sPrint*) dla predefiniowanych wydruków 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
Natomiast obok kolejnych pozycji na liście szablonów wydrukówuż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”.
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:
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.
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):
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].
Następnie należy uzupełnić pola „Opis tabeli” i „Opis pola” dla każdej wybranej kolumny, a następnie nacisnąć przycisk [Utwórz].
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”
Później użytkownik kliknął znak „+” w ramach pola „Parametry 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].
Następnie użytkownik nacisnął przycisk „ Wyślij do Comarch ERP”, aby przesłać szablon do Comarch DMS.
Wówczas okno sPrint zostało zamknięte, a nowoutworzony szablon pojawił się 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].
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].
Wtedy zostaje wyświetlony wydruk sPrint „Dokumenty przesłane za pomocą wiadomości email”, który może zostać wydrukowany lub zapisany na dysku.
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.
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.
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.
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.