Jak określić definicje raportów?

Użytkownicy Wapro Best mają możliwość korzystania z dodatkowego, niezależnego narzędzia do tworzenia własnych zestawień - generatora raportów Crystal Reports. Jest to jest uniwersalny program współpracujący z bazami danych różnych standardów, między innymi z serwerami SQL, w tym Microsoft SQL Server.

W Wapro Best dostępny jest interfejs do podłączenia raportów stworzonych za pomocą Crystal Reports. Dzięki temu będą się one pojawiały w wybranych przez użytkownika miejscach programu i będzie można z nich korzystać jak ze standardowych funkcji programu.

Aby zdefiniować raporty, należy przejść do menu Administrator | Definiowanie i zarządzanie raportami. W lewej części okna - Lista raportów należy wybrać raport i sprecyzować parametry jego wywołania. W prawej części okna - Lista wywołań, należy podać miejsca w programie Wapro Best, w których raport ma być dostępny.

Jak dodać raport i określić miejsce jego wywołania?

Dodawanie nowego raportu i sposób jego wywołania określa się z lewej strony okna, w sekcji Lista raportów. Aby dodać nowy raport, należy kliknąć przycisk Dopisz (klawisz Ins), a następnie wprowadzić dane w wymaganych polach.

1. Na zakładce Podstawowe należy wprowadzić dane w polach:

• Nazwa raportu - nazw, pod którą raport będzie występował w programie,
• Rodzaj raportu - sekcja określająca w jakiej technologii został przygotowany raport:
  • Raport utworzony za pomocą programu Crystal Reports - raport jest przygotowany jako plik *.rpt w programie Crystal Reports. Daje duże możliwości formatowania i filtrowania danych,
  • Raport utworzony za pomocą kreatora raportów - raport tworzony bezpośrednio w programie Wapro,
  • Raport utworzony za pomocą innego narzędzia - używany w nietypowych integracjach lub rozwiązaniach zewnętrznych.
• Definicja raportu - sekcja techniczna powiązana z raportem. Kliknięcie przycisku uruchamia konfigurację lub podgląd definicji raportu (np. edycję parametrów lub struktury),
• Plik definicji - określa sposób, według którego generator tworzy raport (treść i sposób prezentacji wyników). Definicja raportu Crystal Reports zapisywana jest na dysku jako osobny plik z rozszerzeniem *.rpt. Z tego powodu przy pracy wielostanowiskowej w sieci bardzo istotne jest, aby pliki definicji były zapisane w miejscu dostępnym dla wszystkich użytkowników systemu. Domyślnie program proponuje nazwę pliku identyczną z nazwą raportu, lecz użytkownik może wpisać inną (krótszą). Po kliknięciu ikony folderu otwiera się okno dialogowe umożliwiające odszukanie pliku definicji na dysku komputera,
• Twórca raportu - określa użytkownika, który utworzył raport i jest jego właścicielem. Informacja ta może mieć znaczenie przy zarządzaniu uprawnieniami i edycją,
• Raport nieaktywny - checkbox umożliwiający wyłączenie raportu bez jego usuwania. Raport nie jest dostępny dla użytkowników, ale pozostaje zapisany w systemie.

2. Na zakładce Parametry raportu Crystal Reports należy wypełnić dane zgromadzone na wewnętrznych zakładkach.

Na zakładce Przekazywanie parametrów określa się sposób przekazywania niektórych parametrów z Wapro Best do generatora Crystal Reports przy tworzeniu raportu. Lista przekazywanych parametrów obejmuje:

• Identyfikator firmy. W definicji raportu musi zostać wprowadzone pole (Formula field) o nazwie [id_firmy],
• Identyfikator obiektu - w zależności od kontekstu obiektem może być:
  • Identyfikator dokumentu,
  • Identyfikator kontrahenta - w definicji raportu musi zostać wprowadzone pole (Formula field) o nazwie [id_obiektu].
• Zakres od/ Zakres do/ Opis zakresu - raport obejmuje okres wyznaczony przez parametr Zakres wyświetlania, zdefiniowany w menu Administrator | Konfiguracja użytkownika. W definicji raportu musi zostać wprowadzone pole (Formula field) o nazwie [zakres_od], [zakres_do] lub [opis_zakresu],
• Data - możliwość umieszczenia daty na wydruku. W definicji raportu musi zostać wprowadzone pole (Formula field) o nazwie [data],
• Filtr listy obiektów - możliwość przekazywania do generatora Crystal Reports ustawień filtrów Wapro Best. Włączenie pola spowoduje, że w raporcie zostanie użyty taki sam warunek filtrujący, jak aktualnie obowiązujący dla listy Wapro Best. Aby funkcja zadziałała, należy w polu Identyfikator rekordu w raporcie umieścić nazwę pola, która jest identyfikatorem rekordu w raporcie Crystal Reports, np.: Widok_DokumentHandlowy.IdDokumentu.

Zakładka Formuły zawiera tabelę z nazwami formuł zdefiniowanych przez użytkownika. Formuła jest nazwanym zadaniem SQL wykonywanym przed uruchomieniem raportu w celu przekazania do niego zwracanej przez zadanie SQL wartości. Wartość ta może być typu liczbowego, tekstowego lub w formie daty. W raporcie Crystal Reports musi być zdefiniowana formuła o takiej samej nazwie, aby możliwe było przekazanie od niej wartości. Podczas definiowania formuły można skorzystać z listy zmiennych znajdujących się pod przyciskiem Wstaw.

Na zakładce Filtr SQL można zdefiniować dodatkowe zapytanie SQL, które będzie miało za zadanie dodatkowe filtrowanie danych przed uruchomieniem wykonania właściwego raportu. Podczas definiowania zapytania można skorzystać z listy zmiennych znajdujących się pod przyciskiem Wstaw.

3. Na zakładce Uprawnienia dostęny jest mechanizm przydzielania prawa dostępu do raportów poszczególnym użytkownikom. Użytkownik może zmienić uprawnienia korzystając z opcji:

• Dostęp (klawisze Ctrl+D) - dostęp do konkretnego raportu,
• Brak dostępu (klawisze Ctrl+B) - użytkownik nie będzie miał dostępu do konkretnego raportu,
• Przydziel dla wszystkich (klawisze Ctrl+P) - użytkownik będzie miał dostęp do wszystkich raportów,
• Odbierz wszystkim (klawisze Ctrl+O) - użytkownik nie będzie miał dostępu do żadnego z raportów.

4. Na zakładce Opis użytkownik może wprowadzić dowolną treść opisu.

Jak wprowadzić miejsce wywołania raportu w programie?

Z prawej strony ekranu wyświetlana jest informacja o miejscu w programie, w którym raport będzie dostępny. Aby dodać nowe miejsce, należy zaznaczyć raport na liście i w sekcji Lista wywołań wybrać opcję Dodaj (klawisz Ins). Następnie należy kliknąć ikonę folderu i wybrać miejsce z listy miejsc, w których dostępna jest funkcja drukowania danych i dokumentów.