Artículo técnico

Escribir archivos XLSX ISO 29500 Strict desde Delphi

Una verificación de admisión de archivos rechaza una hoja de cálculo con una sola 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 poner ninguna objeción. Ambos resultados son correctos. ISO/IEC 29500 define Strict SpreadsheetML en la Parte 1 y conserva la forma Transitional, con sus características de compatibilidad heredadas, en la Parte 4, y la URI que el validador citó pertenece a Transitional. Una licitación o una política de archivos que nombra ISO 29500 Strict espera el vocabulario purl.oclc.org en cada parte del paquete, y un archivo puede satisfacer a Excel y fallar esa prueba por completo

¿Qué cambia entre Strict y Transitional?

El cambio visible es el vocabulario. Una parte de libro de trabajo 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 del 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 escribirse en camelCase como extendedProperties y customProperties, donde Transitional los escribe con guiones

El cambio menos visible es el alcance. Strict deja fuera las partes del esquema Transitional que existían solo para cargar comportamiento binario heredado, y no tiene vocabulario alguno para las extensiones que Office agregó después. Una búsqueda y reemplazo de cadenas no puede tapar ese hueco, porque algunas funciones sencillamente no tienen escritura Strict. Convertir un paquete significa entonces dos trabajos: renombrar todo lo que tiene un equivalente Strict y decidir qué hacer con todo lo que no

Conmutador de vocabulario StrictOOXML de HotXLS en el paquete XLSX: las partes de workbook, relationship y extended-properties reescritas de los namespaces transicionales openxmlformats a los namespaces estrictos purl.oclc.org
Cada parte cambia de vocabulario a la vez, desde el espacio de nombres raíz pasando por los tipos de relationship hasta el tipo camelCase extendedProperties; ningún namespace transicional puede sobrevivir en ningún punto del paquete

Cambiar una exportación de Delphi a StrictOOXML

En HotXLS el cambio es un solo Boolean en TXLSXWorkbook, StrictOOXML, que por defecto vale False. El código de autoría queda exactamente como estaba. Usted construye hojas, celdas y fórmulas de la manera usual, asigna la propiedad y guarda. SaveAs devuelve 1 en caso de éxito; cualquier otro valor 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 conmutador por guardado que consultan los escritores, así que un guardado que falla a mitad de camino no puede dejar la traducción strict activada para el siguiente. En un servidor donde un solo objeto de libro de trabajo atiende varias solicitudes de exportación, usted puede alternar StrictOOXML entre llamadas y cada guardado obtiene exactamente el vocabulario que pidió

Dos límites conviene conocer de antemano. La salida Strict aplica a los formatos Open XML: workbook, template y macro-enabled template. Pedir .xlsb con StrictOOXML en True se rechaza con un diagnóstico que le indica apagar la propiedad, porque el formato binario no tiene variante Strict. Y abrir un archivo que Excel guardó como "Strict Open XML Spreadsheet" no activa la propiedad por usted. Cargue ese archivo, guárdelo sin tocar StrictOOXML y obtendrá un paquete Transitional de vuelta

¿Por qué un guardado strict se niega a ejecutarse?

Un guardado strict se niega a ejecutarse cuando el libro de trabajo contiene contenido que ISO 29500 Strict no puede expresar. Las familias que HotXLS revisa 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 (slicers), los metadatos de matrices dinámicas, las barras de datos que dependen del bloque de extensiones de 2009 para funciones como relleno sólido, colores de barra negativa o un eje personalizado, y las escalas de tiempo (Timeline) cuando no se ha elegido una política de conversión

Compuerta de guardado estricto de HotXLS en Delphi: SaveAs con StrictOOXML rechaza proyectos VBA, controles de formulario, comentarios encadenados, segmentaciones de datos y metadatos de matrices dinámicas, y solo se completa cuando no hay ninguna característica prohibida presente
Un guardado strict coteja el libro de trabajo con lo que ISO 29500 Strict puede expresar y nombra la característica bloqueante en lugar de escribir un paquete que solo afirma conformidad

Negarse es el comportamiento predeterminado correcto aquí. La alternativa es descartar el proyecto de macros o las segmentaciones y aun así estampar el resultado como Strict, lo cual le entrega a alguien un libro de trabajo que abre sin problemas y se comporta de forma distinta al que exportó. Excel jamás señalaría esa diferencia. Un rechazo nombra la característica mientras su código todavía sabe qué reporte estaba produciendo. La mayoría de los rechazos llega como SaveAs devolviendo -1 con un diagnóstico como StrictOOXML: Strict output cannot embed VBA. El almacenamiento de matrices dinámicas se decide mientras el paquete se está escribiendo, así que una fórmula asignada en esta sesión aún puede detener el guardado con una excepción que nombra los metadatos; envuelva un SaveAs strict en try..except además de revisar su resultado. Si el libro de trabajo necesita sus macros, la ruta Transitional .xlsm descrita en preservación de proyectos VBA y vínculos externos es su lugar

No tiene que descubrirlo al guardar. GetConversionReport inspecciona el libro de trabajo sin recalcularlo y devuelve un TXLSConversionReport cuyos elementos traen un nombre de característica, un nivel de fidelidad, un índice de hoja y un mensaje. Bajo StrictOOXML los elementos bloqueantes regresan como xlsConversionUnsupported. El caso de Timeline también muestra el único lugar donde se puede intercambiar contenido por conformidad a propósito: asignar StrictTimelineOutputPolicy a xlsxStrictTimelineDateCriteria convierte las selecciones de Timeline soportadas en criterios de fecha estándar de tabla dinámica y deja fuera la UI de Timeline, sus partes de caché, relaciones y nombres definidos. El reporte lo lista como xlsConversionDropped, y el libro de trabajo de origen en memoria queda sin cambios

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

Ejecute esto antes de la exportación y registre cada línea que devuelva. Un índice de hoja de -1 marca un elemento a nivel de libro de trabajo como el proyecto VBA; los elementos de hoja de cálculo traen el número de hoja con base 1 y el nombre de la hoja, igual que como se indexa Sheets. El reporte ve los metadatos de matrices dinámicas que un libro de trabajo cargado ya trae; para fórmulas asignadas en código, apóyese en la reescritura escalar de la siguiente sección

La fórmula que se convierte en matriz dinámica en silencio

El rechazo que toma a la gente por sorpresa son los metadatos de matriz dinámica en un libro de trabajo que nunca usó FILTER ni SEQUENCE. Excel 365 evalúa un operador aplicado a un rango de varias celdas como un arreglo, incluso dentro de un reductor, así que =SUM(B2:B4*C2:C4) es una fórmula de arreglo a los ojos de Excel. Cuando asigna ese texto a Formula, HotXLS almacena la celda como lo haría Excel, como un arreglo dinámico de una sola 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!. El trasfondo está en fórmulas con operador de arreglo e intersección implícita. Strict no tiene vocabulario para esa parte de metadatos, así que el guardado se detiene

// Almacenamiento de arreglo: el producto de dos rangos se evalúa como un arreglo
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, escriba la forma escalar. SUMPRODUCT con argumentos de rango simples da el mismo total, no necesita soporte de matrices dinámicas en quien lea el archivo después y mantiene la celda fuera de la parte de metadatos por completo. La misma reescritura funciona para conteos condicionales: SUMPRODUCT((A2:A4="x")*1) sigue multiplicando arreglos, así que ahí prefiera COUNTIF(A2:A4,"x"). Si un reporte realmente necesita resultados desbordados, necesita salida Transitional

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 tal cual. Cuando HotXLS abre un paquete existente, conserva el theme original, las conexiones, los vínculos externos, los gráficos y las partes pivot, y en un guardado Transitional copia sus bytes comprimidos directamente cuando el modelo no ha cambiado. Eso es lo correcto para la fidelidad y lo incorrecto para Strict, porque esos bytes todavía llevan espacios de nombres Transitional

Con StrictOOXML activado, la ruta de copia de bytes se omite para todas esas partes. Las conexiones, los vínculos externos y los gráficos se reconstruyen a partir del modelo; el theme y el XML capturado de la tabla dinámica, de la definición de caché y de los registros de caché se reproducen a través del traductor de espacios de nombres. Ese traductor analiza cada tag 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, los demás valores de atributos, los comentarios y las secciones CDATA pasan byte por byte, así que una cadena compartida que contenga http://schemas.openxmlformats.org/... jamás se toca. Las URIs de espacios de nombres fuera de schemas.openxmlformats.org, como los namespaces de extensión de Microsoft dentro de bloques extLst, quedan como están; si su validador rechaza también el contenido de extensión además de los namespaces Transitional, elimine esas funciones del libro de trabajo de origen antes de exportar

Ruta de salida estricta de HotXLS para partes XLSX preservadas: theme, connections, vínculos externos, gráficos y cachés de tablas dinámicas pasan de copia de bytes textual 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 namespaces transicionales en el paquete strict, así que las rutas preservadas evitan la vía rápida; la traducción reescribe solo declaraciones de espacios de nombres y tipos de relación, y el esqueleto transmitido de la hoja se traduce antes de dividirse en sheetData

Las hojas de cálculo transmitidas 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 transmitir las filas intermedias. Los bloques de fila no contienen URIs de vocabulario, así que las hojas grandes no pagan nada extra por la salida Strict. Las cadenas compartidas y los registros de caché de tablas dinámicas funcionan igual: solo el elemento de encabezado se traduce. Más sobre el lado de la preservación en round-trips sin pérdida de temas, listas de extensión y calcChain

Leer archivos Strict y verificar lo que escribió

Los archivos que Excel guardó como Strict abren como cualquier otro libro de trabajo. HotXLS mapea los tipos de relación Strict sobre sus contrapartes Transitional dondequiera que se analiza una parte de relaciones, en la raíz del paquete, hojas de cálculo, dibujos, vínculos externos y tablas dinámicas, y el lector resuelve los nombres de elemento por URI de espacio de nombres en lugar de por prefijo. Los generadores de terceros asignan prefijos libremente, así que la misma maquinaria sirve también para archivos ordinarios; está descrita en resolución de relaciones OPC en paquetes XLSX. En un guardado Transitional de ese archivo, cualquier parte XML preservada cuya raíz todavía use un namespace Strict se convierte de vuelta a la salida, así que el resultado no termina medio vocabulario y medio el otro

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

Luego abra el archivo de nuevo con TXLSXWorkbook.Open y compare valores, fórmulas, formatos numéricos e hipervínculos con el libro de trabajo de origen. Esa relectura ejercita el mapeo del lado del lector al mismo tiempo. Si el libro de trabajo trae gráficos o tablas dinámicas, inclúyalos en la comparación, porque ambos cambian de copia de bytes a una ruta reconstruida o reproducida bajo StrictOOXML

La salida Strict, la lectura consciente de Strict y el round-trip sin pérdida de paquetes Transitional comparten un motor OOXML en HotXLS para Delphi y C++Builder; la página del componente de hojas de cálculo HotXLS para Delphi lista los formatos y características que cubre