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.
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.
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.
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
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.
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.
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 Tylko Registered
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.
TsgcReportEngine w IDE i wybierz Design report…, aby edytować jego raport tym samym projektantemPołą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;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.
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.
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.
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;Style, Page, GroupHeader, MasterData, GroupFooter i PageFooter czyta się jak układ, który tworząSaveToPDF, SaveToXLSX, SaveToCSV i SaveToPNG przygotowują i eksportują prosto z buildera, a warianty strumieniowe, takie jak SaveToPDFStream, obsługują odpowiedzi weboweTsgcReport, dostępny jako Report, a jego Engine łączy się z podglądemPrawdziwy układ pasmowy, więc raporty biznesowe, takie jak sprzedaż według regionu lub faktury według klienta, nie wymagają obejść.
Pasma i grupy
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ówStartNewPage, RepeatOnEveryPage i KeepTogether kontrolują przepływ stronPrintOnFirstPage i PrintOnLastPage decydują, gdzie pojawiają się pasma stronWyrażenia
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 PreviousOnGetVariable dostarcza Twoje własne zmienne w czasie działaniaHighlights stosują styl, gdy warunek jest spełniony, na przykład ujemne kwoty na czerwono, bez skryptuRaport czyta Twoje dane tam, gdzie już się znajdują: w zapytaniu, dokumencie JSON lub własnych obiektach.
Master detail
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łaTsgcReportJSONSource czyta ciąg JSON lub plik, RecordsPath wybiera tablicęTsgcReportEventSource pobiera wiersze z Twojego kodu przez OnFirst, OnNext i OnGetValuesrcInvoices.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);Silnik przygotowuje strony raz, a każdy eksport korzysta z tego samego przygotowanego wyniku, więc liczby są identyczne w każdym pliku.
Formaty wyjściowe
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.
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;Użytkownicy przeglądają raport stronami, zanim go wydrukują lub zapiszą, z tym samym renderowaniem co w PDF.
Podgląd i drukowanie
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 FitPageprocedure TfrmMain.btnPreviewClick(Sender: TObject);
begin
sgcPreview.Engine := sgcEngine;
sgcPreview.Prepare;
end;
procedure TfrmMain.btnPrintClick(Sender: TObject);
begin
sgcPreview.Print('Sales by region');
end;
Raport zmianowy z polami KPI, wykresem i kodem kreskowym.
Potwierdzenie transakcji z kodem QR.
Karta trasy z mapą i tabelą przystanków.
Nocne zestawienia, faktury po zakupie i eksporty za API działają na serwerze bez okna.
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.
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.
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.
Aplikacja przechodząca na sgcReports ma zwykle już wiele raportów. Skonwertuj je zamiast rysować od nowa.
Import raportów Tylko Registered
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.
DataSourceMap zmienia ją na Twoje własne źródłoImportResult przechowuje wynik ostatniego importu, a projektanci pokazują problemy w oknieoReport := 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.
| Cel | Co działa | Platformy |
|---|---|---|
| Delphi 7 do 13 | Model raportu, wyrażenia, dane, układ, silnik, płynny builder i eksporty | Windows, Linux64, macOS, iOS i Android |
| C++ Builder 2007 do 13 | Te same klasy | Wygenerowane nagłówki .hpp i biblioteki statyczne |
| Projektant i podgląd VCL | TsgcVCLReportDesigner, TsgcReportPreviewVCL | Windows |
| Projektant i podgląd FireMonkey | TsgcFMXReportDesigner (Delphi XE6 i nowsze), TsgcReportPreviewFMX | Podglą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.
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.