Crie, edite, inspecione, calcule e exporte pastas Excel diretamente de codigo Delphi ou C++Builder. HotXLS e uma biblioteca nativa Object Pascal para XLS e XLSX, projetada para ferramentas desktop, lotes, relatorios e geracao de documentos sem automacao do Microsoft Excel.
Este artigo é para teams accepting OpenDocument Spreadsheet files while still producing Excel-compatible workflows. Ele trata ODS open, save, and round-trip como engenharia documental de produção, não como uma chamada isolada de componente.
O risco prático é que round-trip support can preserve values but still lose formulas, styles, charts, or page settings when feature gaps are not reported. Por isso o fluxo precisa de contrato escrito, diagnósticos observáveis e arquivos de regressão representativos.
Decisões de arquitetura
Classify ODS compatibility before editing. accepted ODS sources, supported feature set, and blocked feature categories / formula, style, chart, image, conditional formatting, and page setup handling
- accepted ODS sources, supported feature set, and blocked feature categories
- formula, style, chart, image, conditional formatting, and page setup handling
- save format after editing and whether the user expects ODS or XLSX output
- warning policy for unsupported or approximated features
Fluxo de implementação
Track what is preserved, converted, or dropped. The order below keeps the workflow reviewable for Delphi and C++Builder teams.
- inspect the ODS package and create a feature inventory before editing
- map sheets, cells, formulas, styles, images, and charts to supported workbook objects
- apply edits while preserving original intent where possible
- save output in the chosen format and compare key sheets with the source
- attach a compatibility report when features are converted or dropped
Evidências de validação
Round-trip evidence for customer trust. Keep these fields with the output or support record.
- source format, sheet count, formula count, style count, chart count, and image count
- preserved, converted, approximated, and dropped feature counts
- output format, warning summary, and key-cell comparison
- viewer compatibility notes for LibreOffice and Excel when relevant
OpenDocument and Excel models overlap but differ
ODS support should identify which workbook features map cleanly, which require conversion, and which need warnings. A professional workflow gives users evidence instead of pretending every spreadsheet model is identical.
Notas de implementação para produção
Trate HotXLS Component: ODS open, save, and round-trip in Delphi como um contrato de serviço explícito em torno das chamadas HotXLS, separando validação de entrada, gravação da pasta de trabalho, verificação da saída e evidências para suporte
- Defina fonte de dados, intervalos de células e formato de saída antes de criar a pasta de trabalho
- Registre linhas, planilhas, avisos e caminho de saída em evidências revisáveis
- Encapsule detalhes da aplicação em helpers testáveis, não em eventos de interface
- Reabra ou inspecione o arquivo salvo antes de entregá-lo a outro sistema ou ao cliente
Falhas que devem ser ensaiadas
- SaveAs com sucesso não prova que o contrato de negócio continua correto
- Fontes, permissões e configurações regionais podem variar entre servidor e máquina de desenvolvimento
- Logs não devem expor senhas, dados de clientes nem links internos
Exemplo Delphi detalhado
O exemplo Delphi a seguir mostra uma fronteira de serviço prática para este tema, mantendo política, logs e validação em uma camada testável
procedure RoundTripOdsWorkbook(const InputOds, OutputOds: string);
var
Wb: TXLSXWorkbook;
BeforeState: TWorkbookInventory;
AfterState: TWorkbookInventory;
begin
RequireFileExists(InputOds);
Wb := TXLSXWorkbook.Create;
try
Wb.Open(InputOds);
BeforeState := CaptureWorkbookInventory(Wb);
NormalizeFeaturesForOdsOutput(Wb);
WriteCompatibilitySheet(Wb, BeforeState, 'ods-round-trip');
if Wb.SaveAs(OutputOds) <> 1 then
RaiseWorkbookSaveError(OutputOds);
AfterState := InspectSavedWorkbook(OutputOds);
CompareRoundTripInventory(BeforeState, AfterState, [
'sheet-count',
'used-ranges',
'formula-cells',
'visible-styles'
]);
finally
Wb.Free;
end;
end;Checklist de produção
- 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