Twórz, edytuj, sprawdzaj, obliczaj i eksportuj skoroszyty Excel bezpośrednio z kodu Delphi lub C++Builder. HotXLS to natywna biblioteka Object Pascal z kodem źródłowym dla przepływów XLS i XLSX, przeznaczona do narzędzi desktopowych, zadań batch, systemów raportowych i generowania dokumentów po stronie serwera bez automatyzacji Microsoft Excel.
Ten artykuł jest przeznaczony dla teams receiving workbooks that must be inspected, classified, converted, or routed before processing. Traktuje workbook audit and conversion workbench jako produkcyjną inżynierię dokumentów, a nie pojedyncze wywołanie komponentu.
Praktyczne ryzyko polega na tym, że conversion pipelines fail when macros, external links, hidden sheets, formulas, metadata, and unsupported features are not visible before save. Dlatego przepływ wymaga spisanego kontraktu, obserwowalnej diagnostyki i realistycznych plików regresyjnych.
Decyzje architektoniczne
Audit before converting. conversion targets such as XLSX, XLS, ODS, CSV, HTML, or PDF-like reports / macro, external-link, hidden-sheet, protection, and formula policies
- conversion targets such as XLSX, XLS, ODS, CSV, HTML, or PDF-like reports
- macro, external-link, hidden-sheet, protection, and formula policies
- feature preservation versus flattening versus blocking
- operator review states, warnings, and retained audit reports
Przebieg implementacji
Use a feature inventory to choose conversion policy. The order below keeps the workflow reviewable for Delphi and C++Builder teams.
- open the workbook in audit mode and inventory sheets, metadata, formulas, links, and macros
- classify features into safe, warn, convert, preserve, or block
- show the operator a concise risk summary before conversion
- run the conversion with a named profile and capture feature-loss warnings
- compare key cells and workbook structure after conversion
Dowody walidacji
Audit evidence for conversion decisions. Keep these fields with the output or support record.
- source format, sheet list, hidden-sheet count, macro presence, and external-link count
- formula, chart, image, protection, validation, and defined-name summary
- conversion profile, warning list, dropped-feature list, and output hash
- operator decision and support report path
Conversion is a risk decision, not only a file save
A workbench should show what the workbook contains before converting it. Operators need to know whether macros, links, hidden content, formulas, charts, or protection change the acceptable path.
Uwagi wdrożeniowe dla produkcji
Traktuj HotXLS: workbook audit and conversion workbench in Delphi jako jawny kontrakt usługi wokół wywołań HotXLS, oddzielając walidację wejścia, zapis skoroszytu, kontrolę wyniku i dowody dla wsparcia
- Ustal źródło danych, zakresy komórek i format wyjściowy przed utworzeniem skoroszytu
- Zapisuj liczbę wierszy, arkusze, ostrzeżenia i ścieżkę wyjściową w możliwym do sprawdzenia logu
- Szczegóły aplikacji zamykaj w testowalnych helperach zamiast w zdarzeniach UI
- Otwórz lub sprawdź zapisany plik przed przekazaniem go do innego systemu lub klienta
Tryby awarii do przećwiczenia
- Udany SaveAs nie dowodzi, że kontrakt biznesowy nadal jest poprawny
- Czcionki, uprawnienia i ustawienia regionalne mogą różnić się między serwerem a maszyną deweloperską
- Logi nie mogą ujawniać haseł, danych klientów ani linków wewnętrznych
Szczegółowy przykład Delphi
Poniższy przykład Delphi pokazuje praktyczną granicę usługi dla tego tematu, z polityką, logowaniem i walidacją w warstwie możliwej do testowania
procedure ConvertWorkbookWithAudit(const InputFile, OutputFile: string; const Profile: TConversionProfile);
var
Wb: TXLSXWorkbook;
BeforeState: TWorkbookInventory;
AfterState: TWorkbookInventory;
begin
RequireFileExists(InputFile);
Wb := TXLSXWorkbook.Create;
try
Wb.Open(InputFile);
BeforeState := CaptureWorkbookInventory(Wb);
ApplyConversionProfile(Wb, Profile);
WriteConversionAuditSheet(Wb, BeforeState, Profile);
if Wb.SaveAs(OutputFile) <> 1 then
RaiseWorkbookSaveError(OutputFile);
AfterState := InspectSavedWorkbook(OutputFile);
AssertConversionResult(BeforeState, AfterState, Profile.RequiredSignals);
ArchiveConversionEvidence(InputFile, OutputFile, BeforeState, AfterState);
finally
Wb.Free;
end;
end;Lista produkcyjna
- 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