Crea, modifica, ispeziona, calcola ed esporta cartelle di lavoro Excel direttamente da Delphi o C++Builder. HotXLS e una libreria nativa Object Pascal per XLS e XLSX, progettata per strumenti desktop, batch, report e generazione documenti senza automazione Microsoft Excel.
Questo articolo è rivolto a teams producing customer-facing workbooks from maintained Excel templates rather than assembling every cell in code. Tratta template-based report generation come ingegneria documentale di produzione, non come una semplice chiamata al componente.
Il rischio pratico è che template-driven output becomes fragile when placeholder ownership, dynamic rows, styles, formulas, and localization are not versioned. Per questo il flusso richiede un contratto scritto, diagnostica osservabile e file di regressione realistici.
Decisioni architetturali
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
Percorso di implementazione
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
Evidenze di validazione
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.
Note di implementazione per la produzione
Tratta HotXLS Component: template-based report generation in Delphi come un contratto di servizio esplicito attorno alle chiamate HotXLS, separando validazione dell'input, scrittura della cartella, controllo dell'output ed evidenze di supporto
- Definire origine dati, intervalli di celle e formato di output prima di creare la cartella
- Registrare righe, fogli, avvisi e percorso di output in una prova verificabile
- Incapsulare i dettagli applicativi in helper testabili invece che in eventi UI
- Riaprire o ispezionare il file salvato prima di consegnarlo a un altro sistema o al cliente
Casi di errore da provare
- Un SaveAs riuscito non prova che il contratto di business sia corretto
- Font, permessi e impostazioni locali possono variare tra server e macchina di sviluppo
- I log non devono esporre password, dati cliente o link interni
Esempio Delphi dettagliato
L'esempio Delphi seguente mostra un confine di servizio pratico per questo tema, mantenendo policy, logging e validazione in un livello testabile
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;Checklist di produzione
- 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