Konfiguracja raportów Crystal Reports

Niniejszy artykuł opisuje konfigurację Crystal Reports w celu umożliwienia tworzenia raportów zgodnych z Comarch ERP Enterprise oraz zapewniających wysoką wydajność.
Jeżeli nie wskazano inaczej, opisane ustawienia obowiązują dla zatwierdzonych wersji Crystal Reports. Informacje dotyczące wersji Crystal Reports dopuszczonej do tworzenia raportów lub dokumentów końcowych są dostępne w artykule dotyczącym wymagań systemowych.

Grupa docelowa

Artykuł jest przeznaczony dla deweloperów aplikacji oraz konsultantów tworzących raporty w Crystal Reports służące do odczytu danych z baz Comarch ERP Enterprise.

Konfiguracja drukarki

Konfiguracja drukarki w Crystal Reports odbywa się:

  • w Crystal Reports 9 oraz 10

    • menu Plik

    • pozycja Ustawienia drukarki

  • w Crystal Reports XI

    • menu Plik

    • pozycja Ustawienia strony

Należy aktywować opcję Brak drukarki.

Ustawienia globalne

Opcje globalne są dostępne w Crystal Reports poprzez:

  • menu Plik

  • pozycję Opcje

Ustawienia te obowiązują dla wszystkich raportów lub stanowią szablon konfiguracji dla ustawień raportu podczas tworzenia nowego dokumentu raportu.

Zakładka Baza danych

Zakładka Baza danych zawiera opcje wpływające na sposób dostępu do bazy danych.
Ustawienia należy skonfigurować dokładnie w sposób opisany poniżej. Odmienne konfiguracje mogą utrudniać tworzenie raportów lub powodować błędy podczas ich generowania.

Opcje niewymienione w dalszej części należy ustawić w taki sposób, aby zapytanie było realizowane przy użyciu możliwie minimalnego zapytania SQL, a jednocześnie maksymalnie po stronie serwera ODBC lub bazy danych.
Filtrowanie i sortowanie danych realizowane wyłącznie w Crystal Reports powoduje zwiększone obciążenie sieci oraz zużycie pamięci w Crystal Reports lub w Semiramis Output Manager, co negatywnie wpływa na wydajność całego systemu Comarch ERP Enterprise.

Obszar Konfiguracji Tabele i pola

W poniższym zestawieniu przedstawiono status opcji, który określa, czy dana opcja jest włączona (aktywna) lub wyłączona (nieaktywna) w konfiguracji Crystal Reports.

  • Wyświetl nazwy i opisy — status aktywna — oprócz nazw tabel i kolumn wyświetlane są również opisy zawierające informacje objaśniające dotyczące tabeli lub kolumny

  • Sortuj tabele alfabetycznie — status aktywna — tabele bazy danych są wyświetlane w kolejności alfabetycznej

  • Sortuj pola alfabetycznie — status aktywna — kolumny tabel są wyświetlane w kolejności alfabetycznej

Obszar Konfiguracji Eksplorator danych

W poniższym zestawieniu przedstawiono status opcji, który określa stan ich ustawienia w Crystal Reports.

  • Tabele — status aktywna — wyświetlane są tabele powiązane z obiektami biznesowymi

  • Widoki — status aktywna — wyświetlane są tabele widoków oraz widoków OQL

  • Tabele systemowe — status aktywna — opcja widoczna w konfiguracji; aktualnie brak wpływu na działanie

  • Synonimy — status aktywna — opcja widoczna w konfiguracji; aktualnie brak wpływu na działanie

  • Procedury składowane — status aktywna — opcja widoczna w konfiguracji; aktualnie brak wpływu na działanie

  • Nazwa tabeli LIKE — status pusta wartość — filtr nazwy tabeli umożliwiający ograniczenie listy wyświetlanych tabel

Przykład:
warunek %Item% — wyświetlane są tabele zawierające ciąg Item w nazwie

  • Właściciel LIKE — status pusta wartość — filtr nazwy schematu; symbole wieloznaczne nie są obsługiwane

Przykład:
warunek ENTITY — wyświetlane są tabele ze schematu ENTITY

Obszar Konfiguracji Pozostałe opcje

Skonfigurowane opcje są przejmowane do ustawień raportu podczas jego tworzenia.
W poniższym zestawieniu przedstawiono status ustawień opcji.

  • Użyj indeksów serwera by przyspieszyć — status aktywna — podczas wyboru danych wykorzystywane są informacje o indeksach

  • Wykonuj grupowanie na serwerze — status aktywna — grupowanie wykonywane jest po stronie bazy danych

  • Serwer bazy danych ignoruj wielkość liter — status nieaktywna — wielkość liter jest rozróżniana w nazwach tabel, kolumn oraz danych

  • Wybieraj unikalne dane do wyszukiwania — status nieaktywna — wyszukiwanie nie jest ograniczone do unikalnych wartości pierwszych rekordów

  • Wykonuj zapytania asynchroniczne — status nieaktywna — zapytania do bazy danych są wykonywane synchronicznie

  • Weryfikuj bazę danych przy pierwszym odświeżeniu — status aktywna — wykonywane jest porównanie metadanych tabel i kolumn z bazą danych

  • Weryfikuj procedury składowane przy pierwszym odświeżeniu — status aktywna — wykonywane jest porównanie procedur składowanych z bazą danych

  • Weryfikuj po aktualizacji sterownika bazy danych — status aktywna — wykonywane jest porównanie sterownika bazy danych z bazą danych

  • Automatyczne łączenie tabel — status nieaktywna — opcja odpowiada za automatyczne tworzenie powiązań tabel

Zakładka Tworzenie raportu

Konfiguracja wykonana w tej zakładce jest przejmowana do ustawień raportu podczas jego tworzenia.

Obszar Konfiguracji Odczyt danych

  • Konwertuj wartości NULL z bazy danych na domyślne — status nieaktywna — wartości NULL nie są zamieniane na zera lub puste znaki

  • Konwertuj inne wartości NULL na domyślne — status nieaktywna — wartości NULL spoza bazy danych nie są konwertowane

  • Zawsze sortuj lokalnie — status nieaktywna — sortowanie nie jest wymuszane po stronie aplikacji

    Wskazówka
    Podawanie milisekund nie jest obsługiwane przez Crystal Reports.
Nienazwany obszar Konfiguracji

  • Zapisuj dane z raportem — status nieaktywna — dane pobierane podczas tworzenia raportu nie są zapisywane w pliku raportu podczas uruchamiania przez Semiramis Output Manager

Zakładka Pola

Zakładka umożliwia definiowanie standardowych formatów wyjściowych dla typów danych.
Formaty są stosowane w przypadku braku formatowania indywidualnego oraz podczas użycia funkcji Wyświetl dane lub Przeglądaj.

Dla typu danych DataCzas stosowany format zawiera sekundy.
Brak sekund powoduje ich pominięcie podczas wyboru wartości i brak zgodności przy porównaniu jest równe.

Wskazówka
Obsługa milisekund nie jest dostępna w Crystal Reports.

Zakładka Czcionki

Zakładka umożliwia definiowanie czcionek dla nowo dodawanych pól raportu.
W raportach standardowych oraz w szablonie EmptyReport.rpt w Comarch ERP Enterprise stosowana jest czcionka Arial o rozmiarze 9.

Ustawienia specyficzne dla raportu

Ustawienia specyficzne dotyczą pojedynczego raportu.
Są one zapisywane w pliku raportu i zazwyczaj nadpisują globalne opcje Crystal Reports.
Odmienne konfiguracje wpływają na proces tworzenia raportów lub na poprawność ich generowania.

Okno Konfiguracji Opcje raportu

Okno Opcje raportu jest dostępne w menu Plik pod pozycją Opcje raportu.
W poniższym zestawieniu przedstawiono opcje mające wpływ na zachowanie raportu oraz na zapytania do bazy danych.

Podano status opcji, który określa, czy dana opcja jest włączona (aktywna) lub wyłączona (nieaktywna).

  • Konwertuj wartości NULL z bazy danych na domyślne — status nieaktywna — wartości NULL pochodzące z bazy danych nie są zamieniane na zera ani puste znaki

  • Zapisuj dane z raportem — status nieaktywna — dane pobierane podczas tworzenia raportu nie są zapisywane w pliku raportu podczas uruchamiania przez Semiramis Output Manager

  • Konwertuj inne wartości NULL na domyślne — status nieaktywna — wartości NULL niepochodzące z bazy danych nie są zamieniane na zera ani puste znaki

  • Zawsze sortuj lokalnie — status nieaktywna — sortowanie danych nie jest wymuszane po stronie aplikacji

  • Serwer bazy danych ignoruj wielkość liter — status nieaktywna — wielkość liter jest rozróżniana w nazwach tabel, kolumn oraz w danych

  • Wykonuj zapytania asynchroniczne — status nieaktywna — zapytania do bazy danych są wykonywane synchronicznie

  • Wykonuj grupowanie na serwerze — status aktywna — grupowanie danych jest wykonywane po stronie bazy danych

  • Wybieraj unikalne rekordy — status nieaktywna — rekordy wynikowe nie są automatycznie deduplikowane

  • Użyj indeksów serwera by przyspieszyć — status aktywna — podczas wyboru danych wykorzystywane są informacje o indeksach

  • Weryfikuj bazę danych przy pierwszym odświeżeniu — status aktywna — wykonywane jest porównanie metadanych tabel i kolumn z bazą danych

  • Wybieraj unikalne dane do wyszukiwania — status nieaktywna — wyszukiwanie wartości w kolumnach nie jest ograniczane do unikalnych danych

  • Weryfikuj procedury składowane przy pierwszym odświeżeniu — status aktywna — wykonywane jest porównanie procedur składowanych z bazą danych

Wskazówka
Nie wszystkie dostępne opcje są ujęte w zestawieniu.

Zakładka Powiązania asystenta bazy danych

Crystal Reports wykorzystuje informacje o indeksach tabel oraz relacjach między nimi zapisane w repozytorium obiektów biznesowych. W obszarze Powiązanie wybierana jest opcja Według klucza, a następnie generowane są powiązania tabel. Istniejące powiązania są usuwane za pomocą opcji Usuń powiązania.

Wyłączenie automatycznego łączenia tabel

Automatyczne tworzenie powiązań tabel może prowadzić do generowania nadmiarowych relacji.

W Crystal Reports XI ustawienie Automatyczne łączenie tabel jest dostępne w opcjach programu.
W Crystal Reports 10 ustawienie to jest kontrolowane poprzez wpis w rejestrze systemu Windows.

  • nazwa wpisu: DoAutoSmartLinking

  • typ: wartość ciągu znaków

  • ścieżka: HKEY_CURRENT_USERSoftwareCrystal Decisions100Crystal ReportsDatabaseOptions

  • wartość No — automatyczne łączenie wyłączone

  • wartość Yes — automatyczne łączenie włączone

W przypadku braku wpisu możliwe jest jego dodanie w celu określenia stanu ustawienia.

Wskazówka
Zmiana dotyczy wyłącznie aktualnie zalogowanego użytkownika.

Wyrównywanie elementów

Wyrównywanie pól do siatki oraz do linii pomocniczych może wzajemnie na siebie oddziaływać, co wpływa na końcowy układ elementów raportu. Opcja Wyrównuj do siatki jest dostępna w menu kontekstowym zakładki Projekt lub w menu kontekstowym linijek. Nowa linia pomocnicza jest tworzona poprzez kliknięcie linijki. Przeciągnięcie linii poza obszar linijki powoduje jej usunięcie. Połączenie elementu z linią pomocniczą następuje poprzez przeciągnięcie odpowiedniej krawędzi elementu do linii.
Krawędzie połączone z liniami pomocniczymi są oznaczone kolorem.