Report Builder per Delphi: progetta i report visualmente o in codice
sgcReports è un report builder per Delphi e C++ Builder: i tuoi utenti progettano i report visualmente, e il tuo codice li costruisce con la classe fluent TsgcReportBuilder.
sgcReports è un report builder per Delphi e C++ Builder: i tuoi utenti progettano i report visualmente, e il tuo codice li costruisce con la classe fluent TsgcReportBuilder.
Un report è un modello di pagine, bande, elementi, stili e origini dati. Il designer e il codice modificano entrambi quel modello, e una definizione JSON lo memorizza.
I tuoi utenti progettano i report visualmente nel designer di report VCL, FireMonkey o web, e il tuo codice li costruisce con la classe fluent TsgcReportBuilder. Entrambi producono lo stesso modello di report, con bande, gruppi, master detail ed espressioni, che puoi visualizzare in anteprima, stampare o esportare in PDF, Excel, CSV e altro, sul desktop o in un servizio senza finestra.
Inserisci un TsgcVCLReportDesigner o un TsgcFMXReportDesigner in un form, oppure pubblica TsgcReportHTMLDesigner nel browser. Gli utenti trascinano i campi sulle bande, impostano le proprietà in un inspector e passano a un'anteprima in tempo reale. Registered
TsgcReportBuilder descrive stili, pagine, bande ed elementi come un'unica catena fluent. Il report viene compilato, confrontato e rifattorizzato insieme al resto del progetto, e funziona da Delphi 7, senza richiedere metodi anonimi.
Salva un report con sgcReportSaveToJSONFile e caricalo a runtime, così un layout può stare in un database o in una cartella del cliente e cambiare senza una nuova build. I designer aprono e salvano gli stessi file.
Un designer di report per l'utente finale che i tuoi utenti eseguono dentro la tua applicazione, e lo stesso designer in fase di progettazione nell'IDE.
Designer di report Solo Registered
TsgcVCLReportDesigner è un pannello con una barra degli strumenti, le schede Toolbox, Outline e Data, una superficie di progettazione con righelli, un property inspector e le schede Design e Preview. Inseriscilo in un form, assegna Engine, aggiungi le origini dati, e i tuoi utenti modificano il report, lo salvano come definizione JSON e ne vedono l'anteprima con dati reali. TsgcFMXReportDesigner è il gemello FireMonkey, costruito sulle stesse unit del designer.
TsgcReportEngine nell'IDE e scegli Design report… per modificare il suo report con lo stesso designerCollega il designer all'engine e alle origini dati quando il form viene creato, e carica l'ultimo layout salvato:
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;Per modificare un report da un menu senza un form dedicato, sgcShowReportDesigner (VCL) o sgcShowReportDesignerFMX (FireMonkey, Windows e macOS) mostra il designer in modo modale con i pulsanti OK e Annulla, e ripristina il report quando l'utente annulla:
procedure TfrmMain.mnuEditReportClick(Sender: TObject);
begin
if sgcShowReportDesigner(sgcEngine) then
sgcReportSaveToJSONFile(sgcEngine.Report, 'orders.json');
end;TsgcFMXReportDesigner (Delphi XE6 e successivi) ha la stessa barra degli strumenti, gli stessi alberi, la stessa superficie, lo stesso inspector e la stessa scheda di anteprima, e ospita un TsgcReportPreviewFMX. ToolbarButtonSize rende i pulsanti facili da toccare su un touch screen. Il form modale e le finestre di dialogo dei file sono disponibili su Windows e macOS.
TsgcReportHTMLDesigner modifica la definizione JSON nel browser con un canvas delle bande, un property inspector e un'anteprima in tempo reale, servito dallo stesso endpoint HTTP del report finito. Richiede sgcWebSockets Professional o superiore e sgcHTML. Lascia DesignerEnabled disattivato sugli endpoint di produzione e mettilo dietro la tua autenticazione.
sgcReports per .NET include designer per l'utente finale per WinForms, WPF e Avalonia, gli equivalenti di TsgcVCLReportDesigner, con la stessa barra degli strumenti, gli stessi alberi, lo stesso inspector e la stessa anteprima. Caricano e salvano anch'essi definizioni JSON.
Un report di vendite raggruppato su qualsiasi TDataSet: un'intestazione per regione, una riga per vendita, un subtotale per regione e un piè di pagina, salvato come PDF ed 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 e PageFooter si leggono come il layout che produconoSaveToPDF, SaveToXLSX, SaveToCSV e SaveToPNG preparano ed esportano direttamente dal builder, e le varianti per stream come SaveToPDFStream servono le risposte webTsgcReport, disponibile come Report, e il suo Engine si collega a un'anteprimaUn vero layout a bande, così i report aziendali come le vendite per regione o le fatture per cliente non richiedono soluzioni di ripiego.
Bande e gruppi
Un report ha le bande titolo del report, intestazione di pagina, intestazione di gruppo, dati, piè di gruppo, piè di pagina e riepilogo, più intestazioni e piè di colonna. Un gruppo si interrompe quando cambia la sua espressione, stampa i propri totali e può iniziare una nuova pagina o ripetere la propria intestazione su ogni pagina. I subreport permettono a una pagina di includere il layout di un'altra.
GroupExpression su una banda di intestazione di gruppo, e gruppi annidati per due o più livelliStartNewPage, RepeatOnEveryPage e KeepTogether controllano il flusso delle paginePrintOnFirstPage e PrintOnLastPage decidono dove compaiono le bande di paginaEspressioni
Qualsiasi elemento di testo contiene espressioni tra parentesi quadre, valutate dall'engine per ogni riga, così un totale nel piè di pagina corrisponde sempre alle righe stampate sopra. Ci sono 68 funzioni e 10 aggregati, tra cui aritmetica delle date, riempimento e formattazione, ToWords in 12 lingue, aggregati condizionali e valori progressivi che ripartono a ogni gruppo.
'[Sum(Lines.Qty * Lines.Price)]'
'[FormatDateTime(''dd/mm/yyyy'', Invoices.Date)]'
'Page [Page] of [TotalPages]'Sum, FormatFloat, FormatDateTime, Upper, Round, IsNull, SumIf, CountIf, RunningSum e PreviousOnGetVariable fornisce le tue variabili a runtimeHighlights applicano uno stile quando una condizione è vera, per esempio importi negativi in rosso, senza scriptIl report legge i tuoi dati dove si trovano già: una query, un documento JSON o i tuoi oggetti.
Master detail
TsgcReportDataSetSource legge qualsiasi TDataSet, come TClientDataSet, FireDAC o dbExpress. Un'origine di dettaglio si collega al suo master tramite campi chiave, così ogni fattura stampa le proprie righe e il piè di gruppo le somma. Se non è aperto, il dataset viene aperto e chiuso intorno all'esecuzione; se è già aperto, lo stato e la posizione vengono ripristinati dopo.
MasterSource, MasterFields e DetailFields collegano le originiTsgcReportJSONSource legge una stringa o un file JSON, RecordsPath sceglie l'arrayTsgcReportEventSource preleva righe dal tuo codice tramite OnFirst, OnNext e 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);L'engine prepara le pagine una sola volta, e ogni esportazione parte dallo stesso risultato preparato, quindi i numeri sono identici in ogni file.
Formati di output
L'esportazione PDF scrive per impostazione predefinita PDF/UA-1 con tag, e PDF/A-3 per gli archivi a lungo termine. L'output XLSX mantiene i numeri come numeri, così il foglio di calcolo li somma senza pulizia. Ogni esportazione può scrivere su file o su stream.
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;Gli utenti sfogliano il report prima di stamparlo o salvarlo, con lo stesso rendering del PDF.
Anteprima e stampa
TsgcReportPreviewVCL mostra le pagine preparate con navigazione, zoom e modalità di adattamento, le stampa e le salva in PDF. Le anteprime cercano il testo evidenziando le corrispondenze, mostrano le miniature delle pagine ed esportano in PDF, Excel, CSV, PNG, HTML, Word, ODT, ODS, RTF, SVG e testo semplice da un menu Export. TsgcReportPreviewFMX è l'anteprima FireMonkey su Windows, macOS, iOS e Android.
FirstPage, NextPage, PriorPage e LastPage, ZoomIn, ZoomOut, FitWidth e FitPageprocedure TfrmMain.btnPreviewClick(Sender: TObject);
begin
sgcPreview.Engine := sgcEngine;
sgcPreview.Prepare;
end;
procedure TfrmMain.btnPrintClick(Sender: TObject);
begin
sgcPreview.Print('Sales by region');
end;
Un report di turno con riquadri KPI, un grafico e un codice a barre.
Una conferma di operazione con un codice QR.
Un foglio di percorso con una mappa e una tabella delle fermate.
Estratti conto notturni, fatture dopo il checkout ed esportazioni dietro un'API vengono eseguiti su un server senza finestra.
Il core di sgcReports non ha dipendenze da VCL o FireMonkey e non richiede DLL esterne né driver di stampa. TsgcReportEngine prepara i report senza finestra, in un servizio Windows o in un daemon Linux64.
Ogni worker crea il proprio report, engine, origini dati ed esportazioni, mentre un TsgcReportFontManager di sola lettura serve ogni thread. sgcReportsConfigureForServer ottimizza il gestore di memoria per molti thread su Windows.
Una definizione salvata dal designer è un normale file JSON, quindi un server la carica con sgcReportLoadFromJSONFile e la esegue headless. La demo ReportLinuxDaemon controlla una cartella di lavori e genera PDF, XLSX, CSV o PNG con 4 thread di lavoro.
Un'applicazione che passa a sgcReports ha di solito già molti report. Convertili invece di ridisegnarli.
Importazione dei report Solo Registered
TsgcReportImporter converte form QuickReport (.dfm con un TQuickRep) e modelli ReportBuilder (.rtm), in formato testo o binario, in definizioni di report ed elenca ogni oggetto, proprietà, espressione e script che non ha potuto mappare. I designer VCL, FireMonkey, WinForms, WPF e Avalonia hanno un comando Import. Controlli l'elenco, aggiungi le origini dati, correggi il resto nel designer e salvi il risultato come definizione JSON.
DataSourceMap lo rinomina con la tua origineImportResult contiene il risultato dell'ultima importazione, e i designer mostrano i problemi in una finestraoReport := 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;Stai migrando un'intera applicazione? Il kit di migrazione da QuickReport associa bande e controlli ai loro equivalenti di sgcReports con passaggi numerati.
| Target | Cosa funziona | Piattaforme |
|---|---|---|
| Da Delphi 7 a 13 | Modello di report, espressioni, dati, layout, engine, builder fluent ed esportazioni | Windows, Linux64, macOS, iOS e Android |
| Da C++ Builder 2007 a 13 | Le stesse classi | Header .hpp e librerie statiche generati |
| Designer e anteprima VCL | TsgcVCLReportDesigner, TsgcReportPreviewVCL | Windows |
| Designer e anteprima FireMonkey | TsgcFMXReportDesigner (Delphi XE6 e successivi), TsgcReportPreviewFMX | Anteprima su Windows, macOS, iOS e Android |
sgcReports si vende da solo a partire da €199 per sviluppatore, con codice sorgente completo e 1 anno di aggiornamenti, ed è incluso in sgcUI Enterprise e nel bundle All-Access. Scrive PDF tramite sgcPDF, necessario in ogni configurazione. I designer per l'utente finale, l'importazione dei report, l'esportazione DOCX, ODT e RTF e il designer web sono nell'edizione Registered; la versione di prova ha ogni funzionalità sbloccata.
Collega i tuoi dati con un TsgcReportDataSetSource su un TDataSet, descrivi le bande con TsgcReportBuilder e chiama SaveToPDF, come nell'esempio di codice qui sopra. Se preferisci disegnare il layout, inserisci in un form un TsgcReport, un TsgcReportEngine e un TsgcVCLReportDesigner, progetta il report e salvalo come definizione JSON. Entrambi i modi producono lo stesso modello di report.
Sì, nell'edizione Registered. TsgcVCLReportDesigner e TsgcFMXReportDesigner sono designer per l'utente finale che incorpori nei tuoi form, e sgcShowReportDesigner ne apre uno in modo modale da un menu. Per le applicazioni web, TsgcReportHTMLDesigner funziona nel browser. Ogni designer salva definizioni JSON che si caricano ovunque in sgcReports.
Sì, nell'edizione Registered. TsgcReportImporter converte i modelli ReportBuilder (.rtm), in formato testo o binario, e i form QuickReport (.dfm con un TQuickRep) in definizioni di report, ed elenca ogni oggetto, proprietà, espressione e script che non ha potuto mappare. I designer hanno un comando Import che fa lo stesso. Vedi Porta i tuoi modelli di report esistenti.
Sì. SaveToPDF e SaveToXLSX sul builder, oppure TsgcReportPDFExport e TsgcReportXLSXExport sulle pagine preparate, scrivono PDF/UA-1 con tag (PDF/A-3 su richiesta) e cartelle di lavoro Excel che mantengono i numeri come numeri. CSV, PNG, HTML, ODS, SVG e testo semplice sono in ogni edizione, e DOCX, ODT e RTF nell'edizione Registered.
Assegna l'engine a un TsgcReportPreviewVCL e chiama Prepare. L'anteprima sfoglia le pagine, applica lo zoom, cerca il testo ed esporta, e Print stampa il documento mostrato. Le applicazioni FireMonkey usano TsgcReportPreviewFMX su Windows, macOS, iOS e Android.
Sì. Il core non ha dipendenze da VCL o FireMonkey né DLL esterne, quindi TsgcReportEngine e le esportazioni funzionano in servizi Windows e daemon Linux64, con un engine per thread. La demo ReportLinuxDaemon genera i lavori da una cartella con 4 thread di lavoro.
Da Delphi 7 a 13 e da C++ Builder 2007 a 13. TsgcReportBuilder è una classe semplice che funziona in Delphi 7, senza richiedere metodi anonimi. Il designer FireMonkey richiede Delphi XE6 o successivo. Le stesse classi sono disponibili per .NET.
Sì, sempre. sgcReports scrive PDF e disegna codici a barre con l'engine sgcPDF, e le anteprime disegnano tramite il controllo visualizzatore di sgcPDF. sgcUI Enterprise include entrambi.