Raportowanie

Podsumowanie:

Akcje raportów służą do generowania raportów zdefiniowanych w module firmy Telerik w wybranym formacie wyjściowym. W akcji można przekazać do raportu wartości parametrów zdefiniowanych w szablonie raportu

☛ Menu back-office > NARZĘDZIA > Akcje > Raportowanie

Oprócz właściwości wspólnych dla wszystkich akcji, w akcji raportów należy określić następujące właściwości:

• Raport: lista rozwijana, z której należy wybrać nazwę zdefiniowanego raportu.
• Nazwa pliku: nazwa pliku wynikowego; może to być ustalona nazwa lub wartość zwrócona przez zapytanie SQL (wymaga przełączenia typu pola wprowadzania przez kliknięcie przycisku z prawej strony pola); niedozwolone znaki w zwróconej wartości zostaną zastąpione łącznikami (-).
• Format wyjściowy: format pliku wygenerowanego raportu; dostępne wartości to: PDF, CSV, TIFF, RTF, Excel (.xlsx), Word (.docx) i HTML.

W przypadku eksportu do formatu HTML obsługiwane są tylko następujące obiekty w szablonie raportu: TextBox, HTMLTextBox, Barcode, Table, CrossTab. Próba wygenerowania raportu zawierającego inne rodzaje obiektów zakończy się błędem.

• Pobierz wygenerowany plik: (domyślnie włączone) powoduje pobranie przez przeglądarkę wygenerowanego pliku.
• Zapisz wygenerowany plik do załączników: powoduje zapisanie wygenerowanego pliku jako załącznika do bieżącego dokumentu; w przypadku lokalnej edycji akcji w definicji formularza dostępne są dodatkowo ustawienia:
• Kategoria załączników: kategoria, do której ma zostać dodany załącznik; domyślnie Domyślna kategoria.
• Typ zapisu: tryb dodawania załącznika do dokumentu biznesowego; dostępne wartości:
  • Zawsze jako nowy plik lub nowa wersja: jest to jedyne obsługiwane ustawienie, ponieważ obecnie mail monitor obsługuje tylko utworzenie nowego dokumentu biznesowego;
  • Zawsze jako update poprzedniego pliku lub wersji: (nieobsługiwane) jeśli dokument ma już załącznik o takiej samej nazwie, nadpisuje go lub nadpisuje wersję, jeśli jest włączona kontrola wersji.
  • Blokada podczas zapisu: (nieobsługiwane) jeśli dokument ma już załącznik o takiej samej nazwie, nowy załącznik nie zostanie zapisany.
• Zapytanie SQL zwracające parametry: zapytanie zwracające wartości parametrów zdefiniowanych w raporcie; aliasy poszczególnych wartości muszą odpowiadać nazwom parametrów w raporcie, np. jeśli w projekcie raportu zdefiniowano parametr rpt_param1, zapytanie:

  SELECT {@PoleFormularza} AS rpt_param1
  

  przekaże do raportu wartość tego parametru ustawioną na formularzu w polu PoleFormularza. W raporcie automatycznie dostępne są wartości parametrów:

  • _Id: identyfikator bieżącego dokumentu, w kontekście którego jest wykonywana akcja
  • _LangId: identyfikator języka dla zalogowanego użytkownika
  • _UserId: identyfikator zalogowanego użytkownika

Zapytanie może zwrócić dowolną liczbę kolumn, ale tylko jeden rekord danych.

Powiązane tematy:

• Projektowanie raportów

---