Artigo Técnico

Gravação de arquivos XLSX ISO 29500 Strict no Delphi

Uma verificação de admissão em arquivo rejeita uma planilha com uma única reclamação: o elemento raiz de xl/workbook.xml está no namespace http://schemas.openxmlformats.org/spreadsheetml/2006/main. O Excel abre o mesmo arquivo sem qualquer protesto. Os dois resultados estão corretos. A ISO/IEC 29500 define o SpreadsheetML Strict na Parte 1 e mantém a forma Transitional, com seus recursos de compatibilidade legados, na Parte 4, e a URI citada pelo validador pertence ao Transitional. Um edital ou uma política de arquivamento que cita ISO 29500 Strict espera o vocabulário purl.oclc.org em todas as partes do pacote, e um arquivo pode satisfazer o Excel e ainda reprovar nesse teste por completo

O que muda entre Strict e Transitional?

A mudança visível é o vocabulário. Uma parte de pasta de trabalho Strict declara http://purl.oclc.org/ooxml/spreadsheetml/main como namespace raiz e http://purl.oclc.org/ooxml/officeDocument/relationships para referências r:id. Os namespaces de DrawingML, gráficos, imagens e spreadsheet-drawing mudam da mesma forma, e as partes de propriedades do documento também. Os tipos de relationship mudam junto: a parte de relationships raiz aponta para http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument, e os tipos de propriedades estendidas e personalizadas passam a usar camelCase, como extendedProperties e customProperties, enquanto o Transitional os escreve com hífens

A mudança menos visível é o escopo. O Strict deixa de fora as partes do schema Transitional que existiam apenas para carregar comportamento binário legado, e não tem vocabulário algum para as extensões que o Office adicionou depois. Um buscar e substituir sobre strings não tapa essa brecha, porque alguns recursos simplesmente não têm grafia Strict. Converter um pacote significa, portanto, duas tarefas: renomear tudo que tem equivalente Strict e decidir o que fazer com tudo que não tem

Troca de vocabulário StrictOOXML do HotXLS no pacote XLSX: partes de workbook, relationship e extended-properties reescritas dos namespaces transitórios openxmlformats para os namespaces estritos purl.oclc.org
Toda parte muda de vocabulário de uma vez, do namespace raiz aos tipos de relacionamento até o tipo camelCase extendedProperties; nenhum namespace transiticional pode sobreviver em lugar nenhum do pacote

Mudando uma exportação Delphi para StrictOOXML

No HotXLS, a chave é um único Boolean em TXLSXWorkbook, o StrictOOXML, que vem como False por padrão. O código de criação fica exatamente como era. Você constrói planilhas, células e fórmulas do jeito de sempre, define a propriedade e salva. SaveAs retorna 1 em caso de sucesso; qualquer outro valor significa que o pacote não foi gravado, e o motivo está em Diagnostics

var
  Wb: TXLSXWorkbook;
  Sh: TXLSXWorksheet;
  I: Integer;
begin
  Wb := TXLSXWorkbook.Create;
  try
    Sh := Wb.Sheets.Add('Data');
    Sh.Cells[1, 1].Value := 'Product';
    Sh.Cells[1, 2].Value := 'Amount';
    Sh.Cells[2, 1].Value := 'Widget';
    Sh.Cells[2, 2].Value := 17;
    Sh.Cells[3, 1].Value := 'Gadget';
    Sh.Cells[3, 2].Value := 25;
    Sh.Cells[4, 2].Formula := '=SUM(B2:B3)';

    Wb.StrictOOXML := True;            // vocabulário ISO/IEC 29500 Strict
    if Wb.SaveAs('archive-copy.xlsx') <> 1 then
    begin
      for I := 0 to Wb.Diagnostics.Count - 1 do
        WriteLn(Wb.Diagnostics[I].Message);
      raise Exception.Create('Strict save was refused');
    end;
  finally
    Wb.Free;
  end;
end;

A propriedade é lida no início de cada salvamento e controla uma chave por salvamento que os writers consultam, de modo que um salvamento que falha no meio do caminho não deixa a tradução strict ligada para o próximo. Em um servidor em que um único objeto de pasta de trabalho atende a várias requisições de exportação, você pode alternar o StrictOOXML entre chamadas e cada salvamento recebe exatamente o vocabulário que pediu

Dois limites valem a pena conhecer de antemão. A saída Strict vale para os formatos Open XML: pasta de trabalho, modelo e modelo habilitado para macro. Pedir .xlsb com StrictOOXML em True é recusado com um diagnóstico que manda desligar a propriedade, porque o formato binário não tem variante Strict. E abrir um arquivo que o Excel salvou como "Strict Open XML Spreadsheet" não define a propriedade para você. Carregue esse arquivo, salve sem tocar em StrictOOXML e você recebe um pacote Transitional de volta

Por que um salvamento strict se recusa a rodar?

Um salvamento strict se recusa a rodar quando a pasta de trabalho contém conteúdo que a ISO 29500 Strict não consegue expressar. As famílias que o HotXLS verifica são projetos VBA, controles de formulário com suas partes ctrlProps, comentários encadeados (o modelo moderno de pessoas e threads, não as notas clássicas), slicers, metadados de matriz dinâmica, barras de dados que dependem do bloco de extensão de 2009 para recursos como preenchimento sólido, cores de barra negativa ou eixo personalizado, e Timelines quando nenhuma política de conversão foi escolhida

Portão de salvamento estrito do HotXLS em Delphi: SaveAs com StrictOOXML levanta exceção para projetos VBA, controles de formulário, comentários encadeados e metadados de arrays dinâmicos, e só completa quando nenhum recurso proibido está presente
Falhar ruidosamente supera um projeto VBA silenciosamente descartado que ainda abre; conteúdo de extensão autodescritivo x14, xm e c15 não tem forma strict e é mantido como está

Recusar é o padrão certo aqui. A alternativa seria descartar o projeto de macro ou os slicers e ainda assim carimbar o resultado como Strict, o que entrega para alguém uma pasta de trabalho que abre sem ruído e se comporta de forma diferente da que a pessoa exportou. O Excel nunca sinalizaria isso. Uma recusa cita o recurso enquanto seu código ainda sabe qual relatório estava produzindo. A maioria das recusas chega como SaveAs retornando -1 com um diagnóstico como StrictOOXML: Strict output cannot embed VBA. O armazenamento de matriz dinâmica é decidido enquanto o pacote está sendo gravado, então uma fórmula atribuída nesta sessão ainda pode parar o salvamento com uma exceção que cita os metadados; envolva um SaveAs Strict em um try..except, além de checar o resultado. Se a pasta de trabalho precisa das macros dela, o caminho Transitional .xlsm descrito em preservação de projetos VBA e links externos é o lugar dela

Você não precisa descobrir isso salvando. GetConversionReport inspeciona a pasta de trabalho sem recalculá-la e retorna um TXLSConversionReport cujos itens trazem nome do recurso, nível de fidelidade, índice de planilha e mensagem. Sob StrictOOXML, os itens bloqueantes voltam como xlsConversionUnsupported. O caso dos Timelines também mostra o único lugar em que você pode trocar conteúdo por conformidade de propósito: definir StrictTimelineOutputPolicy como xlsxStrictTimelineDateCriteria converte seleções de Timeline suportadas em critérios de data de tabela dinâmica padrão e deixa de fora a UI da Timeline, suas partes de cache, relationships e nomes definidos. O relatório lista isso como xlsConversionDropped, e a pasta de trabalho de origem em memória permanece inalterada

function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
  Report: TXLSConversionReport;
  I: Integer;
begin
  Wb.StrictOOXML := True;
  // Aceita a troca documentada de Timeline: critérios de data ficam, a UI da Timeline sai
  Wb.StrictTimelineOutputPolicy := xlsxStrictTimelineDateCriteria;
  Report := Wb.GetConversionReport(xlsConversionOpenXmlWorkbook);
  try
    Result := False;
    for I := 0 to Report.Count - 1 do
      if Report[I].Fidelity in [xlsConversionUnsupported, xlsConversionDropped] then
      begin
        Log.Add(Format('%s (sheet %d): %s',
          [Report[I].Feature, Report[I].SheetIndex, Report[I].Message]));
        if Report[I].Fidelity = xlsConversionUnsupported then
          Result := True;
      end;
  finally
    Report.Free;
  end;
end;

Rode isso antes da exportação e registre cada linha que ele retorna. Um índice de planilha -1 marca um item no nível da pasta de trabalho, como o projeto VBA; itens de planilha trazem o número da planilha com base 1 e o nome dela, no mesmo formato em que Sheets é indexado. O relatório enxerga metadados de matriz dinâmica que uma pasta de trabalho carregada já contém; para fórmulas atribuídas em código, conte com a reescrita escalar da próxima seção

A fórmula que vira matriz dinâmica sem alarde

A recusa que pega a gente de surpresa são os metadados de matriz dinâmica em uma pasta de trabalho que nunca usou FILTER nem SEQUENCE. O Excel 365 avalia um operador aplicado a um intervalo de várias células como uma matriz, mesmo dentro de um redutor, então =SUM(B2:B4*C2:C4) é uma fórmula de matriz aos olhos do Excel. Quando você atribui esse texto a Formula, o HotXLS armazena a célula como o Excel faria, como uma matriz dinâmica de célula única com uma referência cm para o xl/metadata.xml; senão o Excel aplicaria interseção implícita ao carregar e mostraria #VALUE!. O contexto está em fórmulas com operador de matriz e interseção implícita. O Strict não tem vocabulário para essa parte de metadados, então o salvamento para

// Armazenamento como matriz: o produto de dois intervalos é avaliado como matriz
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)';    // bloqueia um salvamento Strict

// Armazenamento escalar: argumentos de intervalo simples, mesmo total
Sh.Cells[5, 2].Formula := '=SUMPRODUCT(B2:B4,C2:C4)';

Para exportações Strict, escreva a forma escalar. SUMPRODUCT com argumentos de intervalo simples dá o mesmo total, não exige suporte a matriz dinâmica em quem ler o arquivo depois e mantém a célula fora da parte de metadados por completo. A mesma reescrita vale para contagens condicionais: SUMPRODUCT((A2:A4="x")*1) ainda multiplica matrizes, então prefira COUNTIF(A2:A4,"x") nesse caso. Se um relatório realmente precisa de resultados com spill, ele precisa de saída Transitional

Partes preservadas são reconstruídas em vez de copiadas

O XML da planilha é a parte fácil da saída strict. A parte difícil é tudo que um writer rápido preferiria copiar verbatim. Quando o HotXLS abre um pacote existente, ele guarda o tema original, connections, links externos, gráficos e partes de tabela dinâmica, e em um salvamento Transitional copia os bytes comprimidos dessas partes direto, quando o modelo não mudou. Essa é a decisão certa para fidelidade e errada para o Strict, porque esses bytes ainda carregam namespaces Transitional

Com o StrictOOXML ligado, o caminho de cópia de bytes é contornado para todas essas partes. Connections, links externos e gráficos são reconstruídos a partir do modelo; o tema e o XML capturado de tabela dinâmica, definição de cache e registros de cache passam de novo pelo tradutor de namespaces. Esse tradutor interpreta cada tag de abertura e reescreve só duas coisas: declarações de namespace e o atributo Type dos elementos Relationship nas partes .rels. Texto de célula, outros valores de atributos, comentários e seções CDATA passam byte a byte, então uma shared string que por acaso contenha http://schemas.openxmlformats.org/... nunca é tocada. URIs de namespace fora de schemas.openxmlformats.org, como os namespaces de extensão da Microsoft dentro de blocos extLst, ficam como estão; se o seu validador rejeita conteúdo de extensão além dos namespaces Transitional, remova esses recursos da pasta de trabalho de origem antes de exportar

Caminho de saída estrito do HotXLS para partes XLSX preservadas: theme, connections, external links, gráficos e caches de pivot mudam de cópia byte a byte verbatim para reconstrução ou replay traduzindo por meio de uma única rotina ancorada em atributos entre aspas
Bytes comprimidos copiados contrabandeariam namespaces transitionais para o pacote strict, então os cinco caminhos preservados contornam o caminho rápido; a tradução ancora em valores de atributos entre aspas duplas e divide o esqueleto em stream em sheetData

Planilhas em modo streaming seguem a mesma regra com um detalhe. O writer constrói primeiro o esqueleto da planilha, traduz, e só então divide no <sheetData> para fazer streaming das linhas entre os dois. Blocos de linhas não contêm URIs de vocabulário, então planilhas grandes não pagam nada extra pela saída Strict. Shared strings e registros de cache de tabela dinâmica funcionam do mesmo jeito: só o elemento de cabeçalho é traduzido. Mais sobre o lado da preservação está em round-trips sem perdas de temas, listas de extensão e calcChain

Lendo arquivos Strict e conferindo o que você gravou

Arquivos que o Excel salvou como Strict abrem como qualquer outra pasta de trabalho. O HotXLS mapeia tipos de relationship Strict para os equivalentes Transitional ondequer que uma parte de relationship seja interpretada, na raiz do pacote, planilhas, drawings, links externos e tabelas dinâmicas, e o leitor resolve nomes de elemento pela URI do namespace em vez do prefixo. Geradores de terceiros vinculam prefixos livremente, então a mesma maquinaria serve arquivos comuns também; ela é descrita em resolução de relationships OPC em pacotes XLSX. Em um salvamento Transitional desse arquivo, qualquer parte XML preservada cuja raiz ainda use namespace Strict é convertida de volta na saída, para o resultado não acabar com metade de um vocabulário e metade do outro

Verifique a saída Strict contra o pacote, nunca contra o Excel, que abre as duas formas sem cerimônia. Descompacte o resultado e confira três coisas: xl/workbook.xml declara http://purl.oclc.org/ooxml/spreadsheetml/main, nenhuma parte contém a string schemas.openxmlformats.org/spreadsheetml, e os valores de Type em _rels/.rels e xl/_rels/workbook.xml.rels começam com http://purl.oclc.org/ooxml/. Um findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml rápido sobre a pasta extraída não deve listar nada

Depois abra o arquivo de novo via TXLSXWorkbook.Open e compare valores, fórmulas, formatos numéricos e hyperlinks com a pasta de trabalho de origem. Essa releitura exercita o mapeamento do lado do leitor ao mesmo tempo. Se a pasta de trabalho tem gráficos ou tabelas dinâmicas, inclua-os na comparação, porque ambos trocam a cópia de bytes por um caminho reconstruído ou reexecutado sob StrictOOXML

Saída Strict, leitura ciente de Strict e round-trip sem perdas de pacotes Transitional compartilham um único motor OOXML no HotXLS para Delphi e C++Builder; a página do componente de planilhas HotXLS para Delphi lista os formatos e recursos cobertos