HotXLS: defined names and cross-sheet formulas in Delphi

Skapa, redigera, granska, beräkna och exportera Excel-arbetsböcker direkt från Delphi- eller C++Builder-kod. HotXLS är ett nativt Object Pascal-bibliotek med källkod för XLS- och XLSX-flöden, avsett för skrivbordsverktyg, batchjobb, rapportsystem och serversidig dokumentgenerering utan Microsoft Excel-automatisering.

Den här artikeln är skriven för teams generating analytical workbooks whose formulas must survive sheet movement, template changes, and user edits. Den behandlar defined names and cross-sheet formulas som produktionsnära dokumentteknik, inte som ett isolerat komponentanrop.

Den praktiska risken är att cross-sheet formulas are fragile when workbook-level names, sheet-level names, external links, and range movement are not governed. Därför behöver flödet ett skrivet kontrakt, observerbar diagnostik och realistiska regressionsfiler.

Arkitekturbeslut

Use names as a stable formula interface. workbook-level versus sheet-level name scope / name syntax, collision handling, hidden names, and user-visible names

• workbook-level versus sheet-level name scope
• name syntax, collision handling, hidden names, and user-visible names
• formula references to generated ranges, moved sheets, and external workbooks
• recalculation policy after names or referenced ranges change

Implementeringsflöde

Resolve name scope before writing formulas. The order below keeps the workflow reviewable for Delphi and C++Builder teams.

1. inventory existing names before adding generated names
2. create stable names for generated ranges before writing dependent formulas
3. qualify sheet-level names deliberately to avoid accidental workbook-level collisions
4. update formulas after sheet insertion, deletion, or movement
5. calculate and inspect formulas before delivering the workbook

Valideringsbevis

Formula evidence for maintainable workbooks. Keep these fields with the output or support record.

• name, scope, visible state, target reference, and owner profile
• formula text, resolved references, calculation result, and error state
• external-link references and whether they were preserved, updated, or blocked
• name collisions and remediation actions

Names are API surfaces inside the workbook

Defined names create a contract between formulas, templates, and generated data. Managing scope and references deliberately makes workbooks easier to maintain than hard-coded cell addresses scattered across sheets.

Implementeringsanteckningar för produktion

Behandla HotXLS: defined names and cross-sheet formulas in Delphi som ett tydligt servicekontrakt runt HotXLS-anropen, med separerad indatavalidering, arbetsboksskrivning, utdata kontroll och supportbevis

• Bestäm datakälla, cellområden och utdataformat innan arbetsboken skapas
• Logga rader, blad, varningar och utdata sökväg i granskningsbar supportevidens
• Kapsla applikationsdetaljer i testbara helpers i stället för UI-händelser
• Öppna eller inspektera den sparade filen innan den lämnas till ett annat system eller kunden

Felmoder att öva

• En lyckad SaveAs bevisar inte att affärskontraktet fortfarande är korrekt
• Typsnitt, behörigheter och regionala inställningar kan skilja mellan server och utvecklingsdator
• Loggar får inte exponera lösenord, kunddata eller interna länkar

Detaljerat Delphi-exempel

Följande Delphi-exempel visar en praktisk servicegräns för ämnet och håller policy, loggning och validering testbart separerade

procedure BuildNamedFormulaWorkbook(const OutputFile: string; const Assumptions: TAssumptionSet);
var
  Wb: TXLSXWorkbook;
  Inputs: IXLSWorksheet;
  Summary: IXLSWorksheet;
begin
  Wb := TXLSXWorkbook.Create;
  try
    Inputs := Wb.Sheets[0];
    Inputs.Name := 'Inputs';
    Summary := AddWorksheet(Wb, 'Summary');

    WriteAssumptionTable(Inputs, Assumptions);
    DefineWorkbookName(Wb, 'TaxRate', 'Inputs!$B$2');
    DefineWorkbookName(Wb, 'DiscountRate', 'Inputs!$B$3');
    Summary.Range['A1'].Value := 'Net revenue';
    Summary.Range['B1'].Value := '=GrossRevenue*(1-DiscountRate)*(1-TaxRate)';

    AssertRequiredNames(Wb, ['TaxRate', 'DiscountRate', 'GrossRevenue']);
    Wb.Calculate;
    AssertFormulaRangeHasValues(Summary, 'B1:B1');
    WriteFormulaDependencyAudit(Wb);

    if Wb.SaveAs(OutputFile) <> 1 then
      RaiseWorkbookSaveError(OutputFile);
  finally
    Wb.Free;
  end;
end;

Produktionschecklista

• 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

Product documentation

HotXLS Component