Artículo técnico

Escribir archivos XLSX ISO 29500 Strict desde Delphi

Un control de admisión de archivo rechaza una hoja de cálculo con una única queja: el elemento raíz de xl/workbook.xml está en el espacio de nombres http://schemas.openxmlformats.org/spreadsheetml/2006/main. Excel abre exactamente el mismo archivo sin pestañear. Los dos resultados son correctos. ISO/IEC 29500 define SpreadsheetML Strict en la Parte 1 y deja la forma transicional, con sus funciones de compatibilidad heredada, en la Parte 4, y la URI que citó el validador pertenece a la transicional. Un pliego o una política de archivos que menciona ISO 29500 Strict espera el vocabulario purl.oclc.org en todas las partes del paquete, y un archivo puede contentar a Excel y suspender ese test por completo

¿Qué cambia entre Strict y Transitional?

El cambio visible es el vocabulario. Una parte de libro Strict declara http://purl.oclc.org/ooxml/spreadsheetml/main como su espacio de nombres raíz y http://purl.oclc.org/ooxml/officeDocument/relationships para las referencias r:id. Los espacios de nombres de DrawingML, de gráficos, de imágenes y de spreadsheet-drawing se mueven igual, y también las partes de propiedades de documento. Los tipos de relación cambian con ellos: la parte de relaciones raíz apunta a http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument, y los tipos de propiedades extendidas y personalizadas pasan a camelCase como extendedProperties y customProperties, donde la transicional los escribe con guiones

El cambio menos visible es el alcance. Strict deja fuera las partes del esquema transicional que solo existían para transportar comportamiento binario heredado, y no tiene vocabulario alguno para las extensiones que Office añadió después. Un buscar y reemplazar sobre cadenas no puede tapar ese hueco, porque algunas funciones simplemente no tienen escritura Strict. Convertir un paquete significa por tanto dos trabajos: renombrar todo lo que tiene equivalente Strict y decidir qué hacer con todo lo que no

Conmutación de vocabulario StrictOOXML de HotXLS en el paquete XLSX: las partes workbook, relationship y extended-properties reescritas de los espacios de nombres transicionales openxmlformats a los strict de purl.oclc.org
Todas las partes cambian de vocabulario a la vez, desde el espacio de nombres raíz pasando por los tipos de relación hasta el tipo extendedProperties en camelCase; ningún espacio de nombres transicional puede sobrevivir en ningún punto del paquete

Cambiar una exportación Delphi a StrictOOXML

En HotXLS el interruptor es un Boolean de TXLSXWorkbook, StrictOOXML, que por defecto vale False. El código de creación se queda exactamente como estaba. Construyes hojas, celdas y fórmulas como siempre, activas la propiedad y guardas. SaveAs devuelve 1 si todo va bien; cualquier otra cosa significa que el paquete no se escribió, y el motivo queda en 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;            // vocabulario 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;

La propiedad se lee al inicio de cada guardado y gobierna un interruptor por guardado que consultan los escritores, así que un guardado que falla a mitad no puede dejar la traducción strict activada para el siguiente. En un servidor donde un único objeto de libro atiende varias peticiones de exportación, puedes alternar StrictOOXML entre llamadas y cada guardado recibe exactamente el vocabulario que pidió

Dos límites conviene conocer de antemano. La salida Strict se aplica a los formatos Open XML: libro, plantilla y plantilla habilitada para macros. Pedir .xlsb con StrictOOXML a True se rechaza con un diagnóstico que te dice que apagues la propiedad, porque el formato binario no tiene variante Strict. Y abrir un archivo que Excel guardó como «Hoja de cálculo Open XML estricta» no activa la propiedad por ti. Carga ese archivo, guárdalo sin tocar StrictOOXML y obtendrás de vuelta un paquete transicional

¿Por qué puede un guardado strict negarse a ejecutarse?

Un guardado strict se niega a ejecutarse cuando el libro contiene contenido que ISO 29500 Strict no puede expresar. Las familias que comprueba HotXLS son los proyectos VBA, los controles de formulario con sus partes ctrlProps, los comentarios encadenados (el modelo moderno de personas e hilos, no las notas clásicas), las segmentaciones de datos, los metadatos de arrays dinámicos, las barras de datos que dependen del bloque de extensión de 2009 para funciones como el relleno sólido, los colores de barra negativa o un eje personalizado, y los Timelines cuando no se ha elegido una política de conversión

Puerta de guardado strict de HotXLS en Delphi: SaveAs con StrictOOXML rechaza proyectos VBA, controles de formulario, comentarios encadenados, segmentaciones de datos y metadatos de arrays dinámicos, y solo completa cuando no queda ninguna función prohibida
Un guardado strict comprueba el libro contra lo que ISO 29500 Strict puede expresar y nombra la función bloqueante en vez de escribir un paquete que solo dice cumplir

Negarse es el comportamiento por defecto correcto aquí. La alternativa es soltar el proyecto de macros o las segmentaciones y aun así estampar el resultado como Strict, lo que le entrega a alguien un libro que abre limpiamente y se comporta distinto del que exportó. Excel jamás lo señalaría. Un rechazo nombra la función mientras tu código todavía sabe qué informe estaba generando. La mayoría de los rechazos llegan como SaveAs devolviendo -1 con un diagnóstico como StrictOOXML: Strict output cannot embed VBA. El almacenamiento de arrays dinámicos se decide mientras se escribe el paquete, así que una fórmula asignada en esta sesión aún puede detener el guardado con una excepción que nombra los metadatos; envuelve un SaveAs Strict en try..except además de comprobar su resultado. Si el libro necesita sus macros, su sitio es la vía transicional .xlsm que se describe en preservar proyectos VBA y enlaces externos

No hace falta descubrirlo guardando. GetConversionReport inspecciona el libro sin recalcularlo y devuelve un TXLSConversionReport cuyos elementos traen nombre de función, nivel de fidelidad, índice de hoja y un mensaje. Con StrictOOXML los elementos bloqueantes vuelven como xlsConversionUnsupported. El caso de Timeline muestra también el único sitio donde puedes cambiar contenido por conformidad a propósito: poner StrictTimelineOutputPolicy a xlsxStrictTimelineDateCriteria convierte las selecciones de Timeline soportadas en criterios de fecha estándar de tabla dinámica y deja fuera la interfaz de Timeline, sus partes de caché, relaciones y nombres definidos. El informe lo lista como xlsConversionDropped, y el libro de origen en memoria se queda sin cambios

function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
  Report: TXLSConversionReport;
  I: Integer;
begin
  Wb.StrictOOXML := True;
  // Acepta el compromiso documentado con Timeline: se quedan los criterios de fecha, se va la UI de Timeline
  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;

Ejecuta esto antes de la exportación y registra cada línea que devuelva. Un índice de hoja -1 marca un elemento a nivel de libro como el proyecto VBA; los elementos de hoja traen el número de hoja base 1 y el nombre de la hoja, igual que se indexa Sheets. El informe ve los metadatos de arrays dinámicos que un libro cargado ya arrastra; para fórmulas asignadas en código, apóyate en la reescritura escalar de la sección siguiente

La fórmula que se convierte en array dinámico sin avisar

El rechazo que pilla a la gente desprevenida son los metadatos de arrays dinámicos en un libro que nunca usó FILTER ni SEQUENCE. Excel 365 evalúa un operador aplicado a un rango de varias celdas como un array, incluso dentro de un reductor, así que =SUM(B2:B4*C2:C4) es una fórmula de array a ojos de Excel. Cuando asignas ese texto a Formula, HotXLS almacena la celda como lo haría Excel, como un array dinámico de una celda con una referencia cm hacia xl/metadata.xml; de lo contrario Excel aplicaría intersección implícita al cargar y mostraría #VALUE!. Los detalles están en fórmulas de operador array e intersección implícita. Strict no tiene vocabulario para esa parte de metadatos, así que el guardado se detiene

// Almacenamiento como array: el producto de dos rangos se evalúa como array
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)';    // bloquea un guardado Strict

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

Para exportaciones Strict, escribe la forma escalar. SUMPRODUCT con argumentos de rango simples da el mismo total, no necesita soporte de arrays dinámicos en quien lea el archivo después y deja la celda fuera de la parte de metadatos por completo. La misma reescritura sirve para recuentos condicionales: SUMPRODUCT((A2:A4="x")*1) sigue multiplicando arrays, así que ahí es mejor COUNTIF(A2:A4,"x"). Si un informe de verdad necesita resultados desbordados, necesita salida transicional

Las partes preservadas se reconstruyen en lugar de copiarse

El XML de la hoja de cálculo es la parte fácil de la salida strict. La parte difícil es todo aquello que un escritor rápido preferiría copiar literalmente. Cuando HotXLS abre un paquete existente, conserva el theme original, las conexiones, los enlaces externos, los gráficos y las partes de tabla dinámica, y en un guardado transicional copia sus bytes comprimidos directamente cuando el modelo no ha cambiado. Es el movimiento correcto para la fidelidad y el incorrecto para Strict, porque esos bytes todavía llevan espacios de nombres transicionales

Con StrictOOXML activado, la vía de copia de bytes se omite para todas esas partes. Conexiones, enlaces externos y gráficos se reconstruyen desde el modelo; el theme y el XML capturado de tabla dinámica, definición de caché y registros de caché se reproducen a través del traductor de espacios de nombres. Ese traductor analiza cada etiqueta de apertura y reescribe solo dos cosas: las declaraciones de espacios de nombres y el atributo Type de los elementos Relationship en las partes .rels. El texto de celda, otros valores de atributo, los comentarios y las secciones CDATA pasan byte a byte, de modo que una cadena compartida que contenga por casualidad http://schemas.openxmlformats.org/... nunca se toca. Los URI de espacios de nombres fuera de schemas.openxmlformats.org, como los espacios de nombres de extensión de Microsoft dentro de bloques extLst, se quedan como están; si tu validador rechaza también el contenido de extensión además de los espacios de nombres transicionales, elimina esas funciones del libro de origen antes de exportar

Ruta de salida strict de HotXLS para las partes XLSX preservadas: theme, connections, enlaces externos, charts y cachés de tablas dinámicas pasan de copia de bytes literal a reconstrucción o a una repetición traducida que reescribe solo declaraciones de espacios de nombres y tipos de relación
Los bytes comprimidos copiados colarían espacios de nombres transicionales en el paquete strict, así que las vías preservadas omiten la vía rápida; la traducción reescribe solo declaraciones de espacios de nombres y tipos de relación, y el esqueleto de la hoja en streaming se traduce antes de dividirse en sheetData

Las hojas en streaming siguen la misma regla con un giro. El escritor construye primero el esqueleto de la hoja, lo traduce y solo entonces lo divide en <sheetData> para emitir en streaming las filas de en medio. Los bloques de filas no contienen URI de vocabulario, así que las hojas grandes no pagan nada extra por la salida Strict. Las cadenas compartidas y los registros de caché de tabla dinámica funcionan igual: solo se traduce el elemento de cabecera. Más sobre la parte de preservación está en los ida y vuelta sin pérdida de temas, listas de extensión y calcChain

Leer archivos Strict y comprobar lo que has escrito

Los archivos que Excel guardó como Strict se abren como cualquier otro libro. HotXLS mapea los tipos de relación Strict sobre sus equivalentes transicionales donde sea que se analice una parte de relación: en la raíz del paquete, hojas, dibujos, enlaces externos y tablas dinámicas, y el lector resuelve los nombres de elemento por URI de espacio de nombres en vez de por prefijo. Los generadores de terceros asignan prefijos libremente, así que la misma maquinaria sirve también para archivos ordinarios; se describe en la resolución de relaciones OPC en paquetes XLSX. En un guardado transicional de ese archivo, cualquier parte XML preservada cuya raíz siga usando un espacio de nombres Strict se convierte de vuelta a la salida, para que el resultado no acabe medio con un vocabulario y medio con el otro

Verifica la salida Strict contra el paquete, nunca contra Excel, que abre ambas formas encantado. Descomprime el resultado y comprueba tres cosas: que xl/workbook.xml declara http://purl.oclc.org/ooxml/spreadsheetml/main, que ninguna parte contiene la cadena schemas.openxmlformats.org/spreadsheetml y que los valores de Type en _rels/.rels y xl/_rels/workbook.xml.rels empiezan por http://purl.oclc.org/ooxml/. Una pasada breve de findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml sobre la carpeta extraída no debería listar nada

Después vuelve a abrir el archivo con TXLSXWorkbook.Open y compara valores, fórmulas, formatos numéricos e hipervínculos con el libro de origen. Esa relectura ejercita a la vez el mapeo del lado lector. Si el libro lleva gráficos o tablas dinámicas, inclúyelos en la comparación, porque ambos pasan de copia de bytes a una vía reconstruida o reproducida con StrictOOXML

La salida Strict, la lectura consciente de Strict y los ida y vuelta sin pérdida de paquetes transicionales comparten un mismo motor OOXML en HotXLS para Delphi y C++Builder; la página del componente de hojas de cálculo para Delphi de HotXLS lista los formatos y funciones que cubre