Report Builder dla Delphi: projektuj raporty wizualnie lub w kodzie

sgcReports to report builder dla Delphi i C++ Builder: Twoi użytkownicy projektują raporty wizualnie, a Twój kod buduje je za pomocą płynnej klasy TsgcReportBuilder.

Projektanci VCL, FireMonkey i webowy
Raporty budowane w kodzie
Pasma, grupy i master detail
Eksport do PDF, Excela i CSV

Zobacz cennik →

Podgląd raportu Delphi z gotowym raportem sprzedaży według regionu i miesiąca, polami KPI i skumulowanym wykresem przychodów, przyciskami Export PDF i Export XLSX, zbudowany z sgcReports w demie Altamira ERP

Dwa sposoby budowania raportu w Delphi

Raport to model stron, pasm, elementów, stylów i źródeł danych. Projektant i kod edytują ten sam model, a definicja JSON go przechowuje.

Twoi użytkownicy projektują raporty wizualnie w projektancie raportów VCL, FireMonkey lub webowym, a Twój kod buduje je za pomocą płynnej klasy TsgcReportBuilder. Oba tworzą ten sam model raportu, z pasmami, grupami, master detail i wyrażeniami, który możesz wyświetlić w podglądzie, wydrukować lub wyeksportować do PDF, Excela, CSV i innych formatów, na pulpicie lub w usłudze bez okna.

Wizualny projektant raportów

Upuść TsgcVCLReportDesigner lub TsgcFMXReportDesigner na formularz albo udostępnij TsgcReportHTMLDesigner w przeglądarce. Użytkownicy przeciągają pola na pasma, ustawiają właściwości w inspektorze i przełączają się na podgląd na żywo. Registered

Projektuj raporty wizualnie →

Raporty jako kod

TsgcReportBuilder opisuje style, strony, pasma i elementy jako jeden płynny łańcuch. Raport kompiluje się, porównuje i refaktoryzuje razem z resztą projektu i działa od Delphi 7, bez wymagania metod anonimowych.

Buduj raporty w kodzie →

Definicje JSON

Zapisz raport przez sgcReportSaveToJSONFile i wczytaj go w czasie działania, aby układ mógł leżeć w bazie danych lub w folderze klienta i zmieniać się bez nowej kompilacji. Projektanci otwierają i zapisują te same pliki.

O definicjach JSON →

Projektuj raporty wizualnie w VCL, FireMonkey i przeglądarce

Projektant raportów dla użytkowników końcowych, uruchamiany w Twojej aplikacji, oraz ten sam projektant w czasie projektowania w IDE.

Projektant raportów VCL z sgcReports z otwartym dowodem dostawy, konspektem pasm, powierzchnią projektu i inspektorem właściwości

Projektant raportów Tylko Registered

Projektant raportów, który mogą uruchamiać Twoi użytkownicy

TsgcVCLReportDesigner to panel z paskiem narzędzi, zakładkami Toolbox, Outline i Data, powierzchnią projektu z liniałami, inspektorem właściwości oraz zakładkami Design i Preview. Upuść go na formularz, przypisz Engine, dodaj źródła danych, a Twoi użytkownicy edytują raport, zapisują go jako definicję JSON i wyświetlają jego podgląd z danymi na żywo. TsgcFMXReportDesigner to bliźniak dla FireMonkey, zbudowany na tych samych jednostkach projektanta.

  • Pasek narzędzi z New, Open, Import, Save, Undo, Redo, wyrównywaniem, rozmieszczaniem i powiększeniem
  • Przeciągnij element z Toolbox lub pole z drzewa Data na pasmo: tekst, tekst sformatowany, obraz, linię, kształt, kod kreskowy, podraport, podział strony, tabelę krzyżową i tabelę
  • Edytory parametrów raportu, tabel i skryptu raportu
  • Zakładka Preview przygotowuje raport z danymi silnika
  • W czasie projektowania kliknij prawym przyciskiem TsgcReportEngine w IDE i wybierz Design report…, aby edytować jego raport tym samym projektantem
Przeczytaj temat pomocy

Połącz projektanta z silnikiem i źródłami danych podczas tworzenia formularza i wczytaj ostatnio zapisany układ:

procedure TfrmMain.FormCreate(Sender: TObject);
begin
  sgcDesigner.Engine := sgcEngine;
  sgcDesigner.AddDataSource(sgcOrders);
  if FileExists('orders.json') then
    sgcDesigner.LoadFromFile('orders.json')
  else
    sgcDesigner.NewReport;
end;

procedure TfrmMain.FormCloseQuery(Sender: TObject; var CanClose: Boolean);
begin
  if sgcDesigner.Modified then
    sgcDesigner.SaveToFile('orders.json');
end;

Aby edytować raport z menu bez dedykowanego formularza, sgcShowReportDesigner (VCL) lub sgcShowReportDesignerFMX (FireMonkey, Windows i macOS) pokazuje projektanta modalnie z przyciskami OK i Cancel i przywraca raport, gdy użytkownik anuluje:

procedure TfrmMain.mnuEditReportClick(Sender: TObject);
begin
  if sgcShowReportDesigner(sgcEngine) then
    sgcReportSaveToJSONFile(sgcEngine.Report, 'orders.json');
end;

Projektant FireMonkey

TsgcFMXReportDesigner (Delphi XE6 i nowsze) ma ten sam pasek narzędzi, drzewa, powierzchnię, inspektor i zakładkę podglądu, hostując TsgcReportPreviewFMX. ToolbarButtonSize ułatwia dotykanie przycisków na ekranie dotykowym. Formularz modalny i okna dialogowe plików są dostępne w systemach Windows i macOS.

Webowy projektant raportów

TsgcReportHTMLDesigner edytuje definicję JSON w przeglądarce z kanwą pasm, inspektorem właściwości i podglądem na żywo, udostępniany przez ten sam punkt końcowy HTTP co gotowy raport. Wymaga sgcWebSockets Professional lub wyższej edycji i sgcHTML. Zostaw DesignerEnabled wyłączone na produkcyjnych punktach końcowych i umieść go za własnym uwierzytelnianiem.

O projektancie webowym →

Projektanci .NET

sgcReports dla .NET zawiera projektantów dla użytkowników końcowych dla WinForms, WPF i Avalonia, odpowiedniki TsgcVCLReportDesigner, z tym samym paskiem narzędzi, drzewami, inspektorem i podglądem. Wczytują i zapisują również definicje JSON.

Buduj raporty w kodzie z TsgcReportBuilder

Zgrupowany raport sprzedaży na dowolnym TDataSet: nagłówek dla każdego regionu, wiersz dla każdej sprzedaży, suma częściowa dla każdego regionu i stopka strony, zapisany jako PDF i Excel.

uses
  Classes, SysUtils, DB,
  sgcReports_Types, sgcReports_Model, sgcReports_Data, sgcReports_Fluent;

const
  CS_TOTAL = '[FormatFloat(''#,0.00'', Sum(Sales.Amount))]';

procedure ExportSalesReport(aSales: TDataSet; const aFolder: string);
var
  oSales: TsgcReportDataSetSource;
  oBuilder: TsgcReportBuilder;
begin
  oSales := TsgcReportDataSetSource.Create(nil);
  oBuilder := TsgcReportBuilder.Create;
  try
    // any TDataSet: FireDAC, TClientDataSet, dbExpress...
    oSales.SourceName := 'Sales';
    oSales.DataSet := aSales;
    oBuilder.Title('Sales by region').Units(ruMillimeters)
      .Style('Base').Font('Arial', 10).EndStyle
      .Style('Group').Font('Arial', 11).Bold.BackColor($EEEEEE).EndStyle
      .Page.Paper(rpsA4).Margins(15)
      .GroupHeader('Sales.Region', 9).Style('Group')
      .Text('Region: [Sales.Region]', 0, 1, 180, 7).TagRole(rtrHeading2).EndBand
      .MasterData('Sales', 6).Style('Base')
      .Text('[Sales.Customer]', 2, 0, 120, 6)
      .Text('[Sales.Amount]', 130, 0, 50, 6).AlignRight.Format('#,0.00').EndBand
      .GroupFooter(9).Style('Base')
      .Text('Region total ' + CS_TOTAL, 80, 1, 100, 6).AlignRight.Bold.EndBand
      .PageFooter(8).Style('Base')
      .Text('Page [Page] of [TotalPages]', 0, 1, 180, 6).AlignCenter.EndBand
      .EndPage.Data(oSales);
    oBuilder.SaveToPDF(IncludeTrailingPathDelimiter(aFolder) + 'sales.pdf');
    oBuilder.SaveToXLSX(IncludeTrailingPathDelimiter(aFolder) + 'sales.xlsx');
  finally
    oBuilder.Free;
    oSales.Free;
  end;
end;

Przeczytaj temat pomocy o TsgcReportBuilder

Pasma, grupy i wyrażenia

Prawdziwy układ pasmowy, więc raporty biznesowe, takie jak sprzedaż według regionu lub faktury według klienta, nie wymagają obejść.

Zgrupowany raport Delphi z nagłówkiem dla każdej grupy, sumami częściowymi i numerami stron

Pasma i grupy

Tytuł raportu, nagłówki, dane, stopki i podsumowanie

Raport ma pasma tytułu raportu, nagłówka strony, nagłówka grupy, danych, stopki grupy, stopki strony i podsumowania, a także nagłówki i stopki kolumn. Grupa kończy się, gdy zmienia się jej wyrażenie, drukuje własne sumy i może zaczynać nową stronę lub powtarzać nagłówek na każdej stronie. Podraporty pozwalają jednej stronie zawierać układ innej.

  • GroupExpression w paśmie nagłówka grupy oraz zagnieżdżone grupy dla dwóch lub więcej poziomów
  • StartNewPage, RepeatOnEveryPage i KeepTogether kontrolują przepływ stron
  • PrintOnFirstPage i PrintOnLastPage decydują, gdzie pojawiają się pasma stron
  • Tabele, tabele krzyżowe, tekst sformatowany, kody kreskowe, pola wyboru i obrazy SVG jako elementy raportu
Przeczytaj temat pomocy

Wyrażenia

Sumy, formaty i warunki w nawiasach

Każdy element tekstowy zawiera wyrażenia w nawiasach, obliczane przez silnik dla każdego wiersza, więc suma w stopce zawsze zgadza się z wierszami wydrukowanymi powyżej. Dostępnych jest 68 funkcji i 10 agregatów, w tym arytmetyka dat, dopełnianie i formatowanie, ToWords w 12 językach, agregaty warunkowe i wartości narastające, które zaczynają się od nowa w każdej grupie.

'[Sum(Lines.Qty * Lines.Price)]'
'[FormatDateTime(''dd/mm/yyyy'', Invoices.Date)]'
'Page [Page] of [TotalPages]'
  • Sum, FormatFloat, FormatDateTime, Upper, Round, IsNull, SumIf, CountIf, RunningSum i Previous
  • OnGetVariable dostarcza Twoje własne zmienne w czasie działania
  • Highlights stosują styl, gdy warunek jest spełniony, na przykład ujemne kwoty na czerwono, bez skryptu
Przeczytaj temat pomocy

Dane z TDataSet, w tym master detail

Raport czyta Twoje dane tam, gdzie już się znajdują: w zapytaniu, dokumencie JSON lub własnych obiektach.

Raport faktury zbudowany ze zbiorów danych master i detail, z jego pozycjami, sumami i kodem QR

Master detail

Faktury i ich pozycje z dwóch zbiorów danych

TsgcReportDataSetSource czyta dowolny TDataSet, na przykład TClientDataSet, FireDAC lub dbExpress. Źródło detail łączy się ze swoim master przez pola klucza, więc każda faktura drukuje własne pozycje, a stopka grupy je sumuje. Nieotwarty zbiór danych jest otwierany i zamykany wokół uruchomienia; już otwarty ma potem przywrócony stan i pozycję.

  • MasterSource, MasterFields i DetailFields łączą źródła
  • TsgcReportJSONSource czyta ciąg JSON lub plik, RecordsPath wybiera tablicę
  • TsgcReportEventSource pobiera wiersze z Twojego kodu przez OnFirst, OnNext i OnGetValue
  • Parametry raportu są przekazywane parametrom zapytania o tej samej nazwie przed uruchomieniem
Przeczytaj temat pomocy
srcInvoices.SourceName := 'Invoices';
srcInvoices.DataSet := cdsInvoices;
srcLines.SourceName := 'Lines';
srcLines.DataSet := cdsLines;
srcLines.MasterSource := srcInvoices;
srcLines.MasterFields := 'Number';
srcLines.DetailFields := 'Invoice';
sgcEngine.AddDataSource(srcInvoices);
sgcEngine.AddDataSource(srcLines);

Eksportuj raport Delphi do PDF, Excela, CSV i innych formatów

Silnik przygotowuje strony raz, a każdy eksport korzysta z tego samego przygotowanego wyniku, więc liczby są identyczne w każdym pliku.

Ten sam raport wyeksportowany do PDF, skoroszytu Excela i pliku CSV

Formaty wyjściowe

Jeden przygotowany raport, każdy format

Eksport do PDF domyślnie zapisuje tagowany PDF/UA-1, a do archiwów długoterminowych PDF/A-3. Wyjście XLSX zachowuje liczby jako liczby, więc arkusz sumuje je bez porządkowania. Każdy eksport może zapisywać do pliku lub do strumienia.

  • Każda edycja: PDF, PDF/A, PDF/UA, XLSX, CSV, PNG, HTML, ODS, SVG i zwykły tekst
  • Edycja Registered: DOCX, ODT i RTF
  • Wyjście PDF przez bibliotekę PDF dla Delphi sgcPDF, z osadzonymi czcionkami i wektorowymi kodami kreskowymi
Przeczytaj temat pomocy
FPages := sgcEngine.Prepare;
try
  pdfExport.SaveToFile(FPages, OutputFolder + 'orders.pdf');
  xlsxExport.SaveToFile(FPages, OutputFolder + 'orders.xlsx');
  csvExport.SaveToFile(FPages, OutputFolder + 'orders.csv');
  imageExport.SaveToFiles(FPages, OutputFolder + 'orders_%d.png');
finally
  FPages.Free;
end;

Podgląd i drukowanie raportów w VCL i FireMonkey

Użytkownicy przeglądają raport stronami, zanim go wydrukują lub zapiszą, z tym samym renderowaniem co w PDF.

Okno podglądu sgcReports w aplikacji Delphi ze stroną faktury i kodem QR

Podgląd i drukowanie

Kontrolka podglądu z drukowaniem i eksportem

TsgcReportPreviewVCL pokazuje przygotowane strony z nawigacją, powiększeniem i trybami dopasowania, drukuje je i zapisuje do PDF. Podglądy wyszukują tekst z podświetlonymi trafieniami, pokazują miniatury stron i eksportują do PDF, Excela, CSV, PNG, HTML, Worda, ODT, ODS, RTF, SVG i zwykłego tekstu z menu Export. TsgcReportPreviewFMX to podgląd FireMonkey w systemach Windows, macOS, iOS i Android.

  • FirstPage, NextPage, PriorPage i LastPage, ZoomIn, ZoomOut, FitWidth i FitPage
  • Typowane parametry raportu z monitem przed przygotowaniem raportu
  • Liczniki stron i rekordów podczas przygotowywania długiego raportu, z przyciskiem Cancel
Przeczytaj temat pomocy
procedure TfrmMain.btnPreviewClick(Sender: TObject);
begin
  sgcPreview.Engine := sgcEngine;
  sgcPreview.Prepare;
end;

procedure TfrmMain.btnPrintClick(Sender: TObject);
begin
  sgcPreview.Print('Sales by region');
end;

Generuj raporty bez okna w usługach i demonach

Nocne zestawienia, faktury po zakupie i eksporty za API działają na serwerze bez okna.

Bez VCL, bez DLL, bez sterownika drukarki

Rdzeń sgcReports nie zależy od VCL ani FireMonkey i nie wymaga zewnętrznej DLL ani sterownika drukarki. TsgcReportEngine przygotowuje raporty bez okna, w usłudze Windows lub demonie Linux64.

Jeden silnik na wątek

Każdy wątek roboczy tworzy własny raport, silnik, źródła danych i eksporty, a TsgcReportFontManager tylko do odczytu obsługuje wszystkie wątki. sgcReportsConfigureForServer dostraja menedżer pamięci do wielu wątków w systemie Windows.

Układy z projektanta

Definicja zapisana przez projektanta to zwykły plik JSON, więc serwer wczytuje ją przez sgcReportLoadFromJSONFile i uruchamia bez okna. Demo ReportLinuxDaemon obserwuje folder zadań i renderuje PDF, XLSX, CSV lub PNG z 4 wątkami roboczymi.

Temat pomocy o demonie Linux →

Przenieś swoje istniejące szablony raportów

Aplikacja przechodząca na sgcReports ma zwykle już wiele raportów. Skonwertuj je zamiast rysować od nowa.

Import raportów Tylko Registered

Importuj szablony ReportBuilder .rtm i formularze QuickReport

TsgcReportImporter konwertuje formularze QuickReport (.dfm z TQuickRep) i szablony ReportBuilder (.rtm), tekstowe lub binarne, na definicje raportów i wylicza każdy obiekt, właściwość, wyrażenie i skrypt, których nie udało się zmapować. Projektanci VCL, FireMonkey, WinForms, WPF i Avalonia mają polecenie Import. Przeglądasz listę, dodajesz źródła danych, poprawiasz resztę w projektancie i zapisujesz wynik jako definicję JSON.

  • Format jest wykrywany automatycznie, więc jedno wywołanie obsługuje oba rodzaje plików
  • Potok ReportBuilder lub zbiór danych QuickReport staje się nazwą źródła danych; DataSourceMap zmienia ją na Twoje własne źródło
  • ImportResult przechowuje wynik ostatniego importu, a projektanci pokazują problemy w oknie
Przeczytaj temat pomocy
oReport := TsgcReport.Create(nil);
oImporter := TsgcReportImporter.Create;
try
  // the old pipeline Orders is the data source Sales here
  oImporter.DataSourceMap.Values['Orders'] := 'Sales';
  try
    oImporter.ImportFromFile(oReport, 'orders.rtm');
    sgcReportSaveToJSONFile(oReport, 'orders.json');
  except
    on E: ESgcReportImportError do
      WriteLn('Not imported: ', E.Message);
  end;
finally
  oImporter.Free;
  oReport.Free;
end;

Przenosisz całą aplikację? Zestaw migracyjny QuickReport mapuje pasma i kontrolki na ich odpowiedniki w sgcReports w ponumerowanych krokach.

Wersje Delphi, platformy i edycje

CelCo działaPlatformy
Delphi 7 do 13Model raportu, wyrażenia, dane, układ, silnik, płynny builder i eksportyWindows, Linux64, macOS, iOS i Android
C++ Builder 2007 do 13Te same klasyWygenerowane nagłówki .hpp i biblioteki statyczne
Projektant i podgląd VCLTsgcVCLReportDesigner, TsgcReportPreviewVCLWindows
Projektant i podgląd FireMonkeyTsgcFMXReportDesigner (Delphi XE6 i nowsze), TsgcReportPreviewFMXPodgląd w systemach Windows, macOS, iOS i Android

sgcReports jest sprzedawany osobno od €199 za programistę, z pełnym kodem źródłowym i 1 rokiem aktualizacji, i jest zawarty w sgcUI Enterprise oraz w pakiecie All-Access. Zapisuje PDF przez sgcPDF, który jest wymagany w każdej konfiguracji. Projektanci dla użytkowników końcowych, import raportów, eksport DOCX, ODT i RTF oraz projektant webowy są w edycji Registered; wersja próbna ma odblokowane wszystkie funkcje.

Zobacz cennik Macierz funkcji

Pytania o Report Builder

Powiąż dane za pomocą TsgcReportDataSetSource nad TDataSet, opisz pasma przez TsgcReportBuilder i wywołaj SaveToPDF, jak w przykładzie kodu powyżej. Jeśli wolisz narysować układ, upuść na formularz TsgcReport, TsgcReportEngine i TsgcVCLReportDesigner, zaprojektuj raport i zapisz go jako definicję JSON. Oba sposoby dają ten sam model raportu.

Tak, w edycji Registered. TsgcVCLReportDesigner i TsgcFMXReportDesigner to projektanci dla użytkowników końcowych, które osadzasz w swoich formularzach, a sgcShowReportDesigner otwiera jednego modalnie z menu. Dla aplikacji webowych TsgcReportHTMLDesigner działa w przeglądarce. Każdy projektant zapisuje definicje JSON, które wczytasz w dowolnym miejscu sgcReports.

Tak, w edycji Registered. TsgcReportImporter konwertuje szablony ReportBuilder (.rtm), tekstowe lub binarne, oraz formularze QuickReport (.dfm z TQuickRep) na definicje raportów i wylicza każdy obiekt, właściwość, wyrażenie i skrypt, których nie udało się zmapować. Projektanci mają polecenie Import, które robi to samo. Zobacz Przenieś swoje istniejące szablony raportów.

Tak. SaveToPDF i SaveToXLSX w builderze lub TsgcReportPDFExport i TsgcReportXLSXExport na przygotowanych stronach zapisują tagowany PDF/UA-1 (PDF/A-3 na żądanie) oraz skoroszyty Excela, które zachowują liczby jako liczby. CSV, PNG, HTML, ODS, SVG i zwykły tekst są w każdej edycji, a DOCX, ODT i RTF w edycji Registered.

Przypisz silnik do TsgcReportPreviewVCL i wywołaj Prepare. Podgląd przegląda strony, powiększa, wyszukuje tekst i eksportuje, a Print drukuje wyświetlany dokument. Aplikacje FireMonkey używają TsgcReportPreviewFMX w systemach Windows, macOS, iOS i Android.

Tak. Rdzeń nie zależy od VCL ani FireMonkey i nie wymaga zewnętrznej DLL, więc TsgcReportEngine i eksporty działają w usługach Windows i demonach Linux64, z jednym silnikiem na wątek. Demo ReportLinuxDaemon renderuje zadania z folderu z 4 wątkami roboczymi.

Delphi 7 do 13 i C++ Builder 2007 do 13. TsgcReportBuilder to zwykła klasa, która działa w Delphi 7, bez wymagania metod anonimowych. Projektant FireMonkey wymaga Delphi XE6 lub nowszego. Te same klasy są dostępne dla .NET.

Tak, zawsze. sgcReports zapisuje PDF i rysuje kody kreskowe silnikiem sgcPDF, a podglądy rysują przez kontrolkę przeglądarki sgcPDF. sgcUI Enterprise zawiera oba.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Wypróbuj Report Builder

Wersja próbna sgcUI zawiera sgcReports, jego projektantów i sgcPDF, z odblokowanymi wszystkimi funkcjami.