Создавайте, редактируйте, проверяйте, вычисляйте и экспортируйте книги Excel напрямую из кода Delphi или C++Builder. HotXLS — нативная библиотека Object Pascal с исходным кодом для рабочих процессов XLS и XLSX, предназначенная для настольных инструментов, batch-задач, систем отчетности и серверной генерации документов без автоматизации Microsoft Excel.
Эта статья предназначена для teams receiving workbooks that must be inspected, classified, converted, or routed before processing. Она рассматривает workbook audit and conversion workbench как промышленную инженерию документов, а не как одиночный вызов компонента.
Практический риск состоит в том, что conversion pipelines fail when macros, external links, hidden sheets, formulas, metadata, and unsupported features are not visible before save. Поэтому процессу нужны письменный контракт, наблюдаемая диагностика и реалистичные регрессионные файлы.
Архитектурные решения
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
Порядок реализации
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
Доказательства проверки
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.
Заметки по промышленной реализации
Рассматривайте HotXLS: workbook audit and conversion workbench in Delphi как явный сервисный контракт вокруг вызовов HotXLS, разделяя проверку входных данных, запись книги, контроль результата и сведения для поддержки
- Определите источник данных, диапазоны ячеек и формат вывода до создания книги
- Записывайте число строк, листы, предупреждения и путь вывода в проверяемые сведения поддержки
- Инкапсулируйте прикладные детали в тестируемые helper-функции, а не в события UI
- Повторно откройте или проверьте сохраненный файл перед передачей другой системе или клиенту
Сценарии отказов для проверки
- Успешный SaveAs не доказывает, что бизнес-контракт остался корректным
- Шрифты, права и региональные настройки на сервере могут отличаться от машины разработчика
- Журналы не должны раскрывать пароли, данные клиентов или внутренние ссылки
Подробный пример Delphi
Следующий пример Delphi показывает практическую границу сервиса для этой темы, где политика, журналирование и проверка остаются тестируемыми
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;Производственный чек-лист
- 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