HotXLS: formula calculation and custom functions in Delphi

Dieser deutsche Artikel behandelt HotXLS Component: XLSX AES-protected output in Delphi für Teams, die mit Delphi, C++Builder, Lazarus/FPC und losLab-Komponenten arbeiten

Der Fokus liegt auf praxisnahen Entscheidungen, Fallstricken und Prüfpunkten, damit die Lösung im produktiven Einsatz verlässlich bleibt

Das häufigste Fehlerszenario besteht darin, dass Beispieldateien normal erscheinen, aber tatsächliche Kundendateien, Ziel-Viewer oder Downstream-Systeme Abweichungen offenbaren. Um dies zu beheben, müssen Entscheidungen in der Entwurfsphase in Protokollen, Validierungsberichten und Support-Paketen sichtbar sein

Schreiben Sie Formelberechnungen und benutzerdefinierte Funktionen in den Arbeitsmappenvertrag

PDFlibPas pflegt beide Schichten hinter einem Klammerpaar: BeginTag öffnet ein Strukturelement und startet die Marked-Content-Sequenz, Zeichenaufrufe landen darin, und EndTag schließt beides. Die Buchführung — MCIDs, Parent Tree, Seitenreferenzen — geschieht intern und entfernt den fehleranfälligsten Teil von handgebautem Tagging

custom function names, argument types, null handling, and versioning
supported target applications and whether encrypted input reading is part of scope
temporary file and support-bundle handling for protected workbooks
Welche Warteschlange bekommt sie unter diesen Voraussetzungen: Dunkelverarbeitung, manuelle Prüfung oder Quarantäne
Aufbewahrungsregeln für Protokolle, temporäre Dateien, Passwörter, Kundendaten und Support-Pakete

Stabilisieren Sie zuerst die Arbeitsmappenstruktur, bevor Sie Formelberechnungen und benutzerdefinierte Funktionen verarbeiten

Gezeichnete Gitterlinien bedeuten außerhalb des Bildschirms nichts. Was Screenreader navigieren, sind Strukturbeziehungen: welche Zellen Kopfzellen sind, wofür jeder Kopf gilt und wie Datenzellen in unregelmäßigen Layouts an Köpfe gebunden werden. Die Strukturelement-Attributaufrufe behandeln alle drei:

save the protected XLSX to a controlled temporary destination
compare critical results with independent fixtures or approved Excel output
log security profile identifiers without logging secrets
Öffnen Sie das Ergebnis mit der Ziel-Excel-Version, dem Downstream-Importer oder dem Berichtsanzeigeprozess
Schreiben Sie die Eingabezusammenfassung, Konfigurationsversion, den Ausgabepfad, die Anzahl der Warnungen und die benötigte Zeit in die Support-Aufzeichnungen
security profile, output format, protection mode, target viewer test, and output hash

Nachweise zur Unterstützung von Go-Live und Fehlerbehebung für Formelberechnung und benutzerdefinierte Funktionen

Annotation-Navigation hat einen eigenen Knopf. PDF/UA erwartet, dass die Tastaturnavigation durch Formularfelder und Links der Strukturreihenfolge folgt, und SetTabOrderMode schreibt den seitenbezogenen Tab-Order-Eintrag, den Viewer beachten, während GetTabOrderMode für das Audit eingehender Dateien verfügbar ist. Es ist genau die Art Anforderung, die niemand bemerkt, bis ein reiner Tastaturnutzer den Fehler meldet, und sie kostet einen Aufruf pro Dokument

viewer compatibility result and operator-facing failure reason
Schlüsselbereiche, Anzahl der Formeln, Anzahl der Stile, Anzahl der Zeilen/Spalten und Speicherzeit
Überprüfungsergebnisse von Validierern, Excel, Downstream-Importern oder Kundenprüfungsworkflows
Liste der beibehaltenen, konvertierten, ignorierten oder blockierten Arbeitsmappen-Features
Konfigurationsversion, Anzahl der Warnungen, Eingabe-Hash, Ausgabe-Hash und Ort des Support-Pakets

Formelberechnung und benutzerdefinierte Funktionen sind kein einzelner Speichervorgang

Der HotXLS-Komponenten-Workflow sollte Vorlagen, Arbeitsblätter, Zellbereiche, Formeln, Stile, Exportformate und unterstützende Nachweise im selben Entwurfsmodell platzieren. So kann das Team bei Unstimmigkeiten bei Formelberechnungen und benutzerdefinierten Funktionen erklären, woher die Eingaben stammen, wie Konfigurationen gewählt wurden und warum die Ausgabe vertrauenswürdig ist

Praktische Kernpunkte der Produktion

Der Wert von Formelberechnungen und benutzerdefinierten Funktionen liegt nicht im Aufruf einer zusätzlichen Speicherfunktion, sondern darin, Eingabegrenzen, Arbeitsmappenstruktur, Excel-Kompatibilität, Validierungsnachweise und Fehlerbehandlung als wiederverwendbare Dienstprozesse zu schreiben

Definieren Sie zuerst die Datenquelle, den Zellbereich, das Ausgabeformat und das Zielszenario für Formelberechnungen und benutzerdefinierte Funktionen
Ein erfolgreicher SaveAs-Aufruf beweist noch nicht, dass der fachliche Vertrag stimmt
Schriftarten, Rechte und regionale Einstellungen können auf Servern anders sein als auf Entwicklerrechnern
Logs dürfen keine Passwörter, Kundendaten oder internen Links offenlegen

Ausführliches Delphi-Beispiel

Ein erfolgreiches SaveAs bedeutet nicht, dass der geschäftliche Vertrag korrekt ist; Ausgabeinhalte und Downstream-Verhalten müssen überprüft werden
Server-Schriftarten, Berechtigungen, Ländereinstellungen und temporäre Verzeichnisse unterscheiden sich häufig vom Entwicklungsrechner
Run the workflow on an empty workbook, a normal customer workbook, and a worst-case workbook

Ausführliches Delphi-Beispiel

Das folgende Delphi-Beispiel platziert den HotXLS-Aufruf innerhalb einer testbaren Dienstgrenze, wobei periphere Helper für Richtlinien, Protokollierung, Validierung und unterstützende Nachweise verantwortlich sind

procedure RecalculateInvoiceWorkbook(const TemplateFile, OutputFile: string; const Orders: TArray<TOrderRow>);
var
  Wb: TXLSXWorkbook;
  Sh: IXLSWorksheet;
  RowIndex: Integer;
  Order: TOrderRow;
begin
  Wb := TXLSXWorkbook.Create;
  try
    Wb.Open(TemplateFile);
    RegisterInvoiceFunctions(Wb);
    Sh := Wb.Sheets[0];
    EnsureTemplateVersion(Wb, 'invoice-formulas-v3');

    RowIndex := 2;
    for Order in Orders do
    begin
      Sh.Range['A' + IntToStr(RowIndex)].Value := Order.Sku;
      Sh.Range['B' + IntToStr(RowIndex)].Value := Order.Quantity;
      Sh.Range['C' + IntToStr(RowIndex)].Value := Order.UnitPrice;
      Sh.Range['D' + IntToStr(RowIndex)].Value := '=B' + IntToStr(RowIndex) + '*C' + IntToStr(RowIndex);
      Sh.Range['E' + IntToStr(RowIndex)].Value := '=InvoiceTax(D' + IntToStr(RowIndex) + ')';
      Inc(RowIndex);
    end;

    Wb.Calculate;
    AssertFormulaRangeHasValues(Sh, 'D2:E' + IntToStr(RowIndex - 1));
    WriteCalculationAudit(Wb, 'invoice-formulas', RowIndex - 2);

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

Checkliste für den Go-Live

Add regression workbooks when a customer file exposes a new edge case
Öffnen Sie die Ausgabe mit der Ziel-Excel-Version, dem Downstream-Importer oder dem Berichtsanzeigeprozess
Produktversion, Vorlagenversion, Konfigurationsname, Anzahl der Zeilen/Spalten, Ausgabepfad, benötigte Zeit und Anzahl der Warnungen protokollieren
Festlegung klarer Aufbewahrungsregeln für Passwörter, temporäre Dateien, Kundendaten und Supportpakete
Wenn Kundenarbeitsmappen neue Grenzfälle offenbaren, fügen Sie die Proben dem Regressionssatz hinzu

Relevante Produktdokumentation

Home · Suche · losLab.com

SEO-Optimierung und Praxis-Ergänzung: Formel-Engine und benutzerdefinierte Funktionen

Dieser Abschnitt konzentriert sich auf die Reproduzierbarkeit, die Behandlung von Grenzbereichen und den Prüfkreislauf dieses Themas in der Produktionsumgebung und hilft, das Ergebnis von „lauffähig“ zu „wartbar“ zu verbessern

Praktische Kernpunkte

Definieren Sie zuerst den Eingabevertrag und legen Sie die Grenzfelder fest
Unterscheidung der Leistungsengpässe zwischen Generierungs- und Speicherphase
Ausnahmepfade mit reproduzierbaren Proben abdecken
Schreiben Sie Indikatoren für kritische Knoten in die Support-Aufzeichnungen

Checkliste für den Go-Live

Ob Laufzeitmetriken historische Schwellenwerte überschreiten
Ob die Fehlerrate in den Alarmkanal eintritt
Ob die Ausgabedatei die Wiedergabeverifizierung besteht

Delphi-Beispiel

procedure ApplyHotxlsFormulaEngineCustomFunctions(const WorkbookFile, OutputFile: string);
var
  Book: TXLSXWorkbook;
  Sheet: IXLSWorksheet;
  Profile: TDictionary;
begin
for Row in Rows do
begin
  if ShouldSkip(Row) then
    Continue;
  WriteRowWithGuard(Sheet, Row);
  if NeedSnapshot(Row) then
    CaptureCellSnapshot(Sheet, Row);
end;
end;

Regression und Fehlerbehebung

Es wird empfohlen, im CI eine leere Datei, eine Standarddatei und eine Grenzdatei als Regressionsproben aufzubewahren, um die Stabilität der Ausgabe durch Hash-Vergleich zu bestätigen

Die in diesem Artikel neu hinzugefügte praktische Ergänzung deckt bereits die Kernimplementierung und Qualitätsprüfungspunkte des aktuellen Themas ab, was die spätere Suche und die Wiederverwendung von Inhalten erleichtert

Zusätzliche Codebeispiele

procedure TReportBuilder.HandleUserFunctionEx(Sender: TObject;
  const FunctionName: WideString; const Args: Variant;
  const Context: TXLSUserFunctionContext;
  var Value: Variant; var Handled: Boolean);
begin
  if SameText(FunctionName, 'REGIONRATE') then
  begin
    // the same formula yields a different rate on each regional sheet
    Value := RateForSheet(Context.SheetIndex) * Args[0];
    Handled := True;
  end;
end;

// one array formula spanning A2:A4
Sheet.RCRange[2, 1, 4, 1].SetArrayFormula('A1*{1;2;3}');