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.

Designer VCL, FireMonkey e web
Report costruiti in codice
Bande, gruppi e master detail
Esportazione in PDF, Excel e CSV

Vedi i prezzi →

Anteprima di un report Delphi con un report finito di vendite per regione e mese, riquadri KPI e un grafico a barre impilate dei ricavi, pulsanti Export PDF e Export XLSX, creato con sgcReports nella demo Altamira ERP

Due modi per costruire un report in Delphi

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.

Designer di report visuale

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

Progetta i report visualmente →

Report come codice

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.

Costruisci i report in codice →

Definizioni JSON

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.

Informazioni sulle definizioni JSON →

Progetta i report visualmente in VCL, FireMonkey e nel browser

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.

Il designer di report VCL di sgcReports con una bolla di consegna aperta, il profilo delle bande, la superficie di progettazione e l'inspector delle proprietà

Designer di report Solo Registered

Un designer di report che i tuoi utenti possono eseguire

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.

  • Barra degli strumenti con New, Open, Import, Save, Undo, Redo, allineamento, distribuzione e zoom
  • Trascina un elemento dalla Toolbox o un campo dall'albero Data su una banda: testo, rich text, immagine, linea, forma, codice a barre, subreport, interruzione di pagina, crosstab e tabella
  • Editor per i parametri del report, le tabelle e lo script del report
  • La scheda Preview prepara il report con i dati dell'engine
  • In fase di progettazione, fai clic con il pulsante destro su un TsgcReportEngine nell'IDE e scegli Design report… per modificare il suo report con lo stesso designer
Leggi l'argomento della guida

Collega 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;

Designer FireMonkey

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.

Designer di report web

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.

Informazioni sul designer web →

Designer .NET

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.

Costruisci report in codice con TsgcReportBuilder

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;

Leggi l'argomento della guida su TsgcReportBuilder

Bande, gruppi ed espressioni

Un vero layout a bande, così i report aziendali come le vendite per regione o le fatture per cliente non richiedono soluzioni di ripiego.

Un report Delphi raggruppato con un'intestazione per gruppo, subtotali e numeri di pagina

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ù livelli
  • StartNewPage, RepeatOnEveryPage e KeepTogether controllano il flusso delle pagine
  • PrintOnFirstPage e PrintOnLastPage decidono dove compaiono le bande di pagina
  • Tabelle, crosstab, rich text, codici a barre, caselle di controllo e immagini SVG come elementi del report
Leggi l'argomento della guida

Espressioni

Totali, formati e condizioni tra parentesi quadre

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 Previous
  • OnGetVariable fornisce le tue variabili a runtime
  • Highlights applicano uno stile quando una condizione è vera, per esempio importi negativi in rosso, senza script
Leggi l'argomento della guida

Dati da TDataSet, master detail incluso

Il report legge i tuoi dati dove si trovano già: una query, un documento JSON o i tuoi oggetti.

Un report di fattura costruito da dataset master e detail, con le sue righe, i totali e un codice QR

Master detail

Fatture e relative righe da due dataset

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 origini
  • TsgcReportJSONSource legge una stringa o un file JSON, RecordsPath sceglie l'array
  • TsgcReportEventSource preleva righe dal tuo codice tramite OnFirst, OnNext e OnGetValue
  • I parametri del report vengono passati ai parametri della query con lo stesso nome prima dell'esecuzione
Leggi l'argomento della guida
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);

Esporta un report Delphi in PDF, Excel, CSV e altro

L'engine prepara le pagine una sola volta, e ogni esportazione parte dallo stesso risultato preparato, quindi i numeri sono identici in ogni file.

Lo stesso report esportato in PDF, in una cartella di lavoro Excel e in un file CSV

Formati di output

Un report preparato, ogni formato

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.

  • Ogni edizione: PDF, PDF/A, PDF/UA, XLSX, CSV, PNG, HTML, ODS, SVG e testo semplice
  • Edizione Registered: DOCX, ODT e RTF
  • Output PDF tramite la libreria PDF per Delphi sgcPDF, con font incorporati e codici a barre vettoriali
Leggi l'argomento della guida
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;

Anteprima e stampa dei report in VCL e FireMonkey

Gli utenti sfogliano il report prima di stamparlo o salvarlo, con lo stesso rendering del PDF.

La finestra di anteprima di sgcReports in un'applicazione Delphi con una pagina di fattura e un codice QR

Anteprima e stampa

Un controllo di anteprima con stampa ed esportazione

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 FitPage
  • Parametri del report tipizzati con una richiesta prima della preparazione del report
  • Conteggi di pagine e record mentre viene preparato un report lungo, con un pulsante Annulla
Leggi l'argomento della guida
procedure TfrmMain.btnPreviewClick(Sender: TObject);
begin
  sgcPreview.Engine := sgcEngine;
  sgcPreview.Prepare;
end;

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

Genera report headless in servizi e daemon

Estratti conto notturni, fatture dopo il checkout ed esportazioni dietro un'API vengono eseguiti su un server senza finestra.

Niente VCL, niente DLL, niente driver di stampa

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.

Un engine per thread

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.

Layout dal designer

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.

Argomento della guida sul daemon Linux →

Porta i tuoi modelli di report esistenti

Un'applicazione che passa a sgcReports ha di solito già molti report. Convertili invece di ridisegnarli.

Importazione dei report Solo Registered

Importa modelli .rtm di ReportBuilder e form QuickReport

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.

  • Il formato viene rilevato automaticamente, quindi una sola chiamata gestisce entrambi i tipi di file
  • Una pipeline di ReportBuilder o un data set di QuickReport diventa il nome di un'origine dati; DataSourceMap lo rinomina con la tua origine
  • ImportResult contiene il risultato dell'ultima importazione, e i designer mostrano i problemi in una finestra
Leggi l'argomento della guida
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;

Stai migrando un'intera applicazione? Il kit di migrazione da QuickReport associa bande e controlli ai loro equivalenti di sgcReports con passaggi numerati.

Versioni di Delphi, piattaforme ed edizioni

TargetCosa funzionaPiattaforme
Da Delphi 7 a 13Modello di report, espressioni, dati, layout, engine, builder fluent ed esportazioniWindows, Linux64, macOS, iOS e Android
Da C++ Builder 2007 a 13Le stesse classiHeader .hpp e librerie statiche generati
Designer e anteprima VCLTsgcVCLReportDesigner, TsgcReportPreviewVCLWindows
Designer e anteprima FireMonkeyTsgcFMXReportDesigner (Delphi XE6 e successivi), TsgcReportPreviewFMXAnteprima 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.

Vedi i prezzi Matrice delle funzionalità

Domande sul report builder

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.

La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Prova il Report Builder

La versione di prova di sgcUI include sgcReports, i suoi designer e sgcPDF, con ogni funzionalità sbloccata.