Report Builder pour Delphi : conçois des états visuellement ou en code

sgcReports est un report builder pour Delphi et C++ Builder : tes utilisateurs conçoivent les états visuellement, et ton code les construit avec la classe fluent TsgcReportBuilder.

Concepteurs VCL, FireMonkey et web
États construits en code
Bandes, groupes et maître-détail
Export en PDF, Excel et CSV

Voir les tarifs →

Aperçu d'un état Delphi terminé des ventes par région et par mois, avec des cartes KPI et un graphique empilé des revenus, boutons Export PDF et Export XLSX, construit avec sgcReports dans la démo Altamira ERP

Deux façons de construire un état dans Delphi

Un état est un modèle de pages, de bandes, d'éléments, de styles et de sources de données. Le concepteur et le code éditent tous deux ce modèle, et une définition JSON le stocke.

Tes utilisateurs conçoivent les états visuellement dans le concepteur d'états VCL, FireMonkey ou web, et ton code les construit avec la classe fluent TsgcReportBuilder. Les deux produisent le même modèle d'état, avec bandes, groupes, maître-détail et expressions, que tu prévisualises, imprimes ou exportes en PDF, Excel, CSV et plus, sur le poste de travail ou dans un service sans fenêtre.

Concepteur d'états visuel

Dépose un TsgcVCLReportDesigner ou un TsgcFMXReportDesigner sur une fiche, ou sers TsgcReportHTMLDesigner dans le navigateur. Les utilisateurs font glisser des champs sur les bandes, règlent les propriétés dans un inspecteur et passent à un aperçu en direct. Registered

Concevoir des états visuellement →

Des états en code

TsgcReportBuilder décrit les styles, les pages, les bandes et les éléments dans une seule chaîne fluent. L'état se compile, se compare et se refactorise avec le reste de ton projet, et fonctionne dès Delphi 7, sans méthodes anonymes requises.

Construire des états en code →

Définitions JSON

Enregistre un état avec sgcReportSaveToJSONFile et charge-le à l'exécution, pour qu'une mise en page puisse vivre dans une base de données ou un dossier client et changer sans nouvelle compilation. Les concepteurs ouvrent et enregistrent les mêmes fichiers.

À propos des définitions JSON →

Conçois des états visuellement en VCL, FireMonkey et dans le navigateur

Un concepteur d'états pour utilisateurs finaux que tes utilisateurs lancent dans ton application, et le même concepteur à la conception dans l'IDE.

Le concepteur d'états VCL de sgcReports avec un bon de livraison ouvert, le plan des bandes, la surface de conception et l'inspecteur de propriétés

Concepteur d'états Registered uniquement

Un concepteur d'états que tes utilisateurs peuvent lancer

TsgcVCLReportDesigner est un panneau avec une barre d'outils, les onglets Toolbox, Outline et Data, une surface de conception avec règles, un inspecteur de propriétés, et des onglets Design et Preview. Dépose-le sur une fiche, assigne Engine, ajoute les sources de données, et tes utilisateurs modifient l'état, l'enregistrent comme définition JSON et le prévisualisent avec des données réelles. TsgcFMXReportDesigner est son jumeau FireMonkey, construit sur les mêmes unités de conception.

  • Barre d'outils avec New, Open, Import, Save, Undo, Redo, alignement, distribution et zoom
  • Fais glisser un élément de la Toolbox ou un champ de l'arbre Data sur une bande : texte, texte enrichi, image, ligne, forme, code-barres, sous-état, saut de page, tableau croisé et tableau
  • Éditeurs pour les paramètres de l'état, les tables et le script de l'état
  • L'onglet Preview prépare l'état avec les données du moteur
  • À la conception, fais un clic droit sur un TsgcReportEngine dans l'IDE et choisis Design report… pour modifier son état avec le même concepteur
Lire la rubrique d'aide

Connecte le concepteur au moteur et aux sources de données à la création de la fiche, et charge la dernière disposition enregistrée :

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;

Pour modifier un état depuis un menu sans fiche dédiée, sgcShowReportDesigner (VCL) ou sgcShowReportDesignerFMX (FireMonkey, Windows et macOS) affiche le concepteur en modal avec des boutons OK et Cancel, et restaure l'état quand l'utilisateur annule :

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

Concepteur FireMonkey

TsgcFMXReportDesigner (Delphi XE6 et ultérieur) a la même barre d'outils, les mêmes arbres, la même surface, le même inspecteur et le même onglet d'aperçu, et héberge un TsgcReportPreviewFMX. ToolbarButtonSize rend les boutons faciles à toucher sur un écran tactile. La fiche modale et les boîtes de dialogue de fichiers sont disponibles sous Windows et macOS.

Concepteur d'états web

TsgcReportHTMLDesigner modifie la définition JSON dans le navigateur avec un canevas de bandes, un inspecteur de propriétés et un aperçu en direct, servi par le même point de terminaison HTTP que l'état terminé. Il nécessite sgcWebSockets Professional ou supérieur et sgcHTML. Laisse DesignerEnabled désactivé sur les points de terminaison de production et place-le derrière ta propre authentification.

À propos du concepteur web →

Concepteurs .NET

sgcReports pour .NET inclut des concepteurs pour utilisateurs finaux pour WinForms, WPF et Avalonia, les équivalents de TsgcVCLReportDesigner, avec la même barre d'outils, les mêmes arbres, le même inspecteur et le même aperçu. Ils chargent et enregistrent eux aussi des définitions JSON.

Construis des états en code avec TsgcReportBuilder

Un état de ventes regroupé sur n'importe quel TDataSet : un en-tête par région, une ligne par vente, un sous-total par région et un pied de page, enregistré en PDF et en 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;

Lire la rubrique d'aide TsgcReportBuilder

Bandes, groupes et expressions

Une vraie mise en page par bandes, pour que les états métier comme les ventes par région ou les factures par client n'aient besoin d'aucun contournement.

Un état Delphi regroupé avec un en-tête par groupe, des sous-totaux et des numéros de page

Bandes et groupes

Titre de l'état, en-têtes, données, pieds de page et synthèse

Un état comporte des bandes de titre d'état, d'en-tête de page, d'en-tête de groupe, de données, de pied de groupe, de pied de page et de synthèse, plus des en-têtes et des pieds de colonne. Un groupe se rompt quand son expression change, imprime ses propres totaux et peut commencer une nouvelle page ou répéter son en-tête sur chaque page. Les sous-états permettent à une page d'inclure la mise en page d'une autre.

  • GroupExpression sur une bande d'en-tête de groupe, et des groupes imbriqués pour deux niveaux ou plus
  • StartNewPage, RepeatOnEveryPage et KeepTogether contrôlent l'enchaînement des pages
  • PrintOnFirstPage et PrintOnLastPage décident où apparaissent les bandes de page
  • Tableaux, tableaux croisés, texte enrichi, codes-barres, cases à cocher et images SVG comme éléments d'état
Lire la rubrique d'aide

Expressions

Totaux, formats et conditions entre crochets

Tout élément de texte contient des expressions entre crochets, évaluées par le moteur pour chaque ligne, donc le total d'un pied de page correspond toujours aux lignes imprimées au-dessus. Il y a 68 fonctions et 10 agrégats, dont l'arithmétique de dates, le remplissage et la mise en forme, ToWords en 12 langues, des agrégats conditionnels et des valeurs cumulées qui repartent à zéro à chaque groupe.

'[Sum(Lines.Qty * Lines.Price)]'
'[FormatDateTime(''dd/mm/yyyy'', Invoices.Date)]'
'Page [Page] of [TotalPages]'
  • Sum, FormatFloat, FormatDateTime, Upper, Round, IsNull, SumIf, CountIf, RunningSum et Previous
  • OnGetVariable fournit tes propres variables à l'exécution
  • Les Highlights appliquent un style quand une condition est vraie, par exemple les montants négatifs en rouge, sans script
Lire la rubrique d'aide

Des données de TDataSet, maître-détail inclus

L'état lit tes données là où elles se trouvent déjà : une requête, un document JSON ou tes propres objets.

Un état de facture construit à partir de datasets maître et détail, avec ses lignes, ses totaux et un code QR

Maître-détail

Des factures et leurs lignes à partir de deux datasets

TsgcReportDataSetSource lit n'importe quel TDataSet, comme TClientDataSet, FireDAC ou dbExpress. Une source de détail se lie à son maître par des champs clés, donc chaque facture imprime ses propres lignes, et le pied de groupe les additionne. Si le dataset n'est pas ouvert, il est ouvert et fermé autour de l'exécution ; s'il est déjà ouvert, son état et sa position sont restaurés ensuite.

  • MasterSource, MasterFields et DetailFields relient les sources
  • TsgcReportJSONSource lit une chaîne ou un fichier JSON, RecordsPath choisit le tableau
  • TsgcReportEventSource tire des lignes de ton code via OnFirst, OnNext et OnGetValue
  • Les paramètres de l'état sont transmis aux paramètres de requête du même nom avant l'exécution
Lire la rubrique d'aide
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);

Exporte un état Delphi en PDF, Excel, CSV et plus

Le moteur prépare les pages une seule fois, et chaque export part du même résultat préparé, donc les chiffres sont identiques dans chaque fichier.

Le même état exporté en PDF, en classeur Excel et en fichier CSV

Formats de sortie

Un seul état préparé, tous les formats

L'export PDF écrit par défaut du PDF/UA-1 balisé, et du PDF/A-3 pour les archives à long terme. La sortie XLSX garde les nombres comme des nombres, donc le tableur les additionne sans nettoyage. Chaque export peut écrire dans un fichier ou dans un flux.

  • Toutes les éditions : PDF, PDF/A, PDF/UA, XLSX, CSV, PNG, HTML, ODS, SVG et texte brut
  • Édition Registered : DOCX, ODT et RTF
  • Sortie PDF via la bibliothèque PDF Delphi sgcPDF, avec polices intégrées et codes-barres vectoriels
Lire la rubrique d'aide
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;

Prévisualise et imprime des états en VCL et FireMonkey

Les utilisateurs parcourent l'état page par page avant de l'imprimer ou de l'enregistrer, avec le même rendu que le PDF.

La fenêtre d'aperçu de sgcReports dans une application Delphi avec une page de facture et un code QR

Aperçu et impression

Un contrôle d'aperçu avec impression et export

TsgcReportPreviewVCL affiche les pages préparées avec navigation, zoom et modes d'ajustement, les imprime et les enregistre en PDF. Les aperçus recherchent du texte avec surlignage des correspondances, affichent des miniatures de pages et exportent en PDF, Excel, CSV, PNG, HTML, Word, ODT, ODS, RTF, SVG et texte brut depuis un menu Export. TsgcReportPreviewFMX est l'aperçu FireMonkey sur Windows, macOS, iOS et Android.

  • FirstPage, NextPage, PriorPage et LastPage, ZoomIn, ZoomOut, FitWidth et FitPage
  • Paramètres d'état typés avec une invite avant la préparation de l'état
  • Nombre de pages et d'enregistrements pendant la préparation d'un long état, avec un bouton Cancel
Lire la rubrique d'aide
procedure TfrmMain.btnPreviewClick(Sender: TObject);
begin
  sgcPreview.Engine := sgcEngine;
  sgcPreview.Prepare;
end;

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

Génère des états en mode headless dans des services et des daemons

Les relevés de nuit, les factures après paiement et les exports derrière une API s'exécutent sur un serveur sans fenêtre.

Pas de VCL, pas de DLL, pas de pilote d'imprimante

Le noyau de sgcReports n'a aucune dépendance à VCL ou FireMonkey et n'a besoin ni de DLL externe ni de pilote d'imprimante. TsgcReportEngine prépare les états sans fenêtre, dans un service Windows ou un daemon Linux64.

Un moteur par thread

Chaque thread de travail crée son propre état, son moteur, ses sources de données et ses exports, tandis qu'un TsgcReportFontManager en lecture seule sert tous les threads. sgcReportsConfigureForServer règle le gestionnaire de mémoire pour de nombreux threads sous Windows.

Des mises en page issues du concepteur

Une définition enregistrée par le concepteur est un fichier JSON ordinaire, donc un serveur la charge avec sgcReportLoadFromJSONFile et l'exécute en mode headless. La démo ReportLinuxDaemon surveille un dossier de tâches et produit du PDF, XLSX, CSV ou PNG avec 4 threads de travail.

Rubrique d'aide du daemon Linux →

Apporte tes modèles d'états existants

Une application qui passe à sgcReports a généralement déjà de nombreux états. Convertis-les au lieu de les redessiner.

Import d'états Registered uniquement

Importe des modèles ReportBuilder .rtm et des fiches QuickReport

TsgcReportImporter convertit les fiches QuickReport (.dfm avec un TQuickRep) et les modèles ReportBuilder (.rtm), en texte ou en binaire, en définitions d'états et liste chaque objet, propriété, expression et script qu'il n'a pas pu associer. Les concepteurs VCL, FireMonkey, WinForms, WPF et Avalonia ont une commande Import. Tu relis la liste, ajoutes les sources de données, corriges le reste dans le concepteur et enregistres le résultat comme définition JSON.

  • Le format est détecté automatiquement, donc un seul appel gère les deux types de fichier
  • Un pipeline ReportBuilder ou un jeu de données QuickReport devient un nom de source de données ; DataSourceMap le renomme vers ta propre source
  • ImportResult contient le résultat du dernier import, et les concepteurs affichent les problèmes dans une fenêtre
Lire la rubrique d'aide
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;

Tu migres toute une application ? Le kit de migration QuickReport associe les bandes et les contrôles à leurs équivalents sgcReports avec des étapes numérotées.

Versions de Delphi, plateformes et éditions

CibleCe qui fonctionnePlateformes
Delphi 7 à 13Modèle d'état, expressions, données, mise en page, moteur, builder fluent et exportsWindows, Linux64, macOS, iOS et Android
C++ Builder 2007 à 13Les mêmes classesEn-têtes .hpp générés et bibliothèques statiques
Concepteur et aperçu VCLTsgcVCLReportDesigner, TsgcReportPreviewVCLWindows
Concepteur et aperçu FireMonkeyTsgcFMXReportDesigner (Delphi XE6 et ultérieur), TsgcReportPreviewFMXAperçu sur Windows, macOS, iOS et Android

sgcReports se vend seul à partir de €199 par développeur, avec le code source complet et 1 an de mises à jour, et il est inclus dans sgcUI Enterprise et dans le bundle All-Access. Il écrit le PDF via sgcPDF, requis dans toutes les configurations. Les concepteurs pour utilisateurs finaux, l'import d'états, l'export DOCX, ODT et RTF et le concepteur web sont dans l'édition Registered ; l'essai a toutes les fonctionnalités débloquées.

Voir les tarifs Matrice des fonctionnalités

Questions sur le Report Builder

Lie tes données avec un TsgcReportDataSetSource sur un TDataSet, décris les bandes avec TsgcReportBuilder et appelle SaveToPDF, comme dans l'exemple de code ci-dessus. Si tu préfères dessiner la mise en page, dépose un TsgcReport, un TsgcReportEngine et un TsgcVCLReportDesigner sur une fiche, conçois l'état et enregistre-le comme définition JSON. Les deux méthodes produisent le même modèle d'état.

Oui, dans l'édition Registered. TsgcVCLReportDesigner et TsgcFMXReportDesigner sont des concepteurs pour utilisateurs finaux que tu intègres dans tes fiches, et sgcShowReportDesigner en ouvre un en modal depuis un menu. Pour les applications web, TsgcReportHTMLDesigner s'exécute dans le navigateur. Chaque concepteur enregistre des définitions JSON qui se chargent partout dans sgcReports.

Oui, dans l'édition Registered. TsgcReportImporter convertit les modèles ReportBuilder (.rtm), en texte ou en binaire, et les fiches QuickReport (.dfm avec un TQuickRep) en définitions d'états, et liste chaque objet, propriété, expression et script qu'il n'a pas pu associer. Les concepteurs ont une commande Import qui fait la même chose. Voir Apporte tes modèles d'états existants.

Oui. SaveToPDF et SaveToXLSX sur le builder, ou TsgcReportPDFExport et TsgcReportXLSXExport sur des pages préparées, écrivent du PDF/UA-1 balisé (PDF/A-3 sur demande) et des classeurs Excel qui gardent les nombres comme des nombres. CSV, PNG, HTML, ODS, SVG et texte brut sont dans toutes les éditions, et DOCX, ODT et RTF dans l'édition Registered.

Assigne le moteur à un TsgcReportPreviewVCL et appelle Prepare. L'aperçu pagine, zoome, recherche du texte et exporte, et Print imprime le document affiché. Les applications FireMonkey utilisent TsgcReportPreviewFMX sur Windows, macOS, iOS et Android.

Oui. Le noyau n'a aucune dépendance à VCL ou FireMonkey ni de DLL externe, donc TsgcReportEngine et les exports s'exécutent dans des services Windows et des daemons Linux64, avec un moteur par thread. La démo ReportLinuxDaemon produit des tâches depuis un dossier avec 4 threads de travail.

Delphi 7 à 13 et C++ Builder 2007 à 13. TsgcReportBuilder est une classe simple qui fonctionne sur Delphi 7, sans méthodes anonymes requises. Le concepteur FireMonkey nécessite Delphi XE6 ou ultérieur. Les mêmes classes sont disponibles pour .NET.

Oui, toujours. sgcReports écrit le PDF et dessine les codes-barres avec le moteur sgcPDF, et les aperçus dessinent via le contrôle de visualisation sgcPDF. sgcUI Enterprise inclut les deux.

Meilleur rapport qualité-prix : All-AccessTous les produits eSeGeCe, Support Premium inclus, à partir de €1,059/an.
Voir les tarifs All-Access

Essaie le Report Builder

L'essai de sgcUI inclut sgcReports, ses concepteurs et sgcPDF, avec toutes les fonctionnalités débloquées.