Maak, bewerk, inspecteer, bereken en exporteer Excel-workbooks rechtstreeks vanuit Delphi- of C++Builder-code. HotXLS is een native Object Pascal-spreadsheetbibliotheek met broncode voor XLS- en XLSX-workflows, ontworpen voor desktoptools, batchtaken, rapportagesystemen en server-side documentgeneratie zonder Microsoft Excel-automatisering.
Dit artikel is bedoeld voor teams producing customer-facing workbooks from maintained Excel templates rather than assembling every cell in code. Het behandelt template-based report generation als productiegerichte documentengineering, niet als een losse componentaanroep.
Het praktische risico is dat template-driven output becomes fragile when placeholder ownership, dynamic rows, styles, formulas, and localization are not versioned. Daarom heeft de workflow een geschreven contract, observeerbare diagnose en representatieve regressiebestanden nodig.
Architectuurbeslissingen
Make templates part of the application interface. placeholder syntax, required values, repeated regions, and named-range ownership / style preservation, formula refresh, merged-cell behavior, and row insertion rules
- placeholder syntax, required values, repeated regions, and named-range ownership
- style preservation, formula refresh, merged-cell behavior, and row insertion rules
- localization of labels, number formats, dates, and sheet names
- template versioning, approval, rollback, and compatibility with old data profiles
Implementatiepad
Bind placeholders to typed data contracts. The order below keeps the workflow reviewable for Delphi and C++Builder teams.
- validate template version and required placeholders before loading data
- bind typed data to named ranges or placeholder regions
- expand repeating sections while preserving formulas, styles, merges, and page breaks
- calculate and validate key cells after data insertion
- store template version and placeholder results with the generated workbook
Validatiebewijs
Template evidence that speeds up support. Keep these fields with the output or support record.
- template version, data profile, placeholder list, and missing-placeholder warnings
- expanded region sizes, inserted rows, formula refresh status, and style preservation
- localized label set and number-format profile
- regression workbook comparison against approved samples
A template is executable design
A workbook template carries layout, formatting, formulas, and business assumptions. The code should treat placeholders, named ranges, and repeating regions as a documented contract rather than free-form cell addresses.
Implementatienotities voor productie
Behandel HotXLS Component: template-based report generation in Delphi als een expliciet servicecontract rond de HotXLS-aanroepen, met gescheiden invoercontrole, werkmapopbouw, uitvoercontrole en supportbewijs
- Leg gegevensbron, celbereiken en uitvoerformaat vast voordat de werkmap wordt gemaakt
- Log rijenaantal, bladen, waarschuwingen en uitvoerpad in controleerbaar supportbewijs
- Plaats applicatiespecifieke details in testbare helpers in plaats van UI-events
- Open of inspecteer het opgeslagen bestand voordat het naar een ander systeem of klant gaat
Foutscenario's om te oefenen
- Een geslaagde SaveAs bewijst niet dat het zakelijke contract klopt
- Lettertypen, rechten en regionale instellingen kunnen verschillen tussen server en ontwikkelmachine
- Logs mogen geen wachtwoorden, klantgegevens of interne links onthullen
Uitgebreid Delphi-voorbeeld
Het volgende Delphi-voorbeeld toont een praktische servicegrens voor dit onderwerp en houdt beleid, logging en validatie testbaar gescheiden
procedure GenerateReportFromTemplate(const TemplateFile, OutputFile: string; const Context: TReportContext);
var
Wb: TXLSXWorkbook;
begin
RequireFileExists(TemplateFile);
Wb := TXLSXWorkbook.Create;
try
Wb.Open(TemplateFile);
EnsureTemplateVersion(Wb, Context.TemplateVersion);
SetNamedValue(Wb, 'ReportTitle', Context.Title);
SetNamedValue(Wb, 'ReportPeriod', Context.PeriodText);
FillNamedTable(Wb, 'RevenueRows', Context.RevenueRows);
FillNamedTable(Wb, 'ExpenseRows', Context.ExpenseRows);
Wb.Calculate;
AssertNoUnresolvedTemplateMarkers(Wb);
AssertRequiredSheetsVisible(Wb, ['Cover', 'Summary', 'Detail']);
WriteGenerationAudit(Wb, Context);
if Wb.SaveAs(OutputFile) <> 1 then
RaiseWorkbookSaveError(OutputFile);
finally
Wb.Free;
end;
end;Productiechecklist
- Run the workflow on an empty workbook, a normal customer workbook, and a worst-case workbook
- Open the output with the target spreadsheet application or downstream importer
- Log product version, template version, profile, row count, output path, elapsed time, and warning count
- Keep passwords, temporary files, customer data, and support bundles under explicit retention rules
- Add regression workbooks when a customer file exposes a new edge case