Техническая статья

Запись файлов ISO 29500 Strict XLSX из Delphi

Архивная приёмка отклоняет электронную таблицу с одной-единственной претензией: корневой элемент xl/workbook.xml сидит в пространстве имён http://schemas.openxmlformats.org/spreadsheetml/2006/main. Excel открывает тот же самый файл без единого возражения. Оба результата корректны. ISO/IEC 29500 определяет Strict SpreadsheetML в Части 1, а переходную форму с её унаследованными средствами совместимости оставляет в Части 4, и URI, на который указал валидатор, относится к Transitional. Тендерная или архивная политика, требующая ISO 29500 Strict, ждёт словарь purl.oclc.org в каждой части пакета, и файл может полностью устраивать Excel, проваливая этот тест наглухо

Что меняется между Strict и Transitional?

Видимое изменение — словарь. Строгая часть книги объявляет http://purl.oclc.org/ooxml/spreadsheetml/main корневым пространством имён и http://purl.oclc.org/ooxml/officeDocument/relationships для ссылок r:id. Пространства имён DrawingML, диаграмм, картинок и spreadsheet-drawing сдвигаются так же, как и части свойств документа. Типы связей меняются вместе с ними: корневая часть связей указывает на http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument, а типы расширенных и пользовательских свойств переходят в camelCase как extendedProperties и customProperties, тогда как Transitional пишет их через дефис

Менее заметное изменение — охват. Strict не включает части переходной схемы, существовавшие только ради унаследованного двоичного поведения, и вообще не имеет словаря для расширений, добавленных в Office позже. Заделать эту брешь поиском и заменой по строкам нельзя: у некоторых функций строгого написания просто нет. Конвертация пакета — значит две работы: переименовать всё, у чего есть строгий эквивалент, и решить, что делать со всем остальным

Переключение словаря StrictOOXML в HotXLS в пакете XLSX: части workbook, relationship и extended-properties переписываются из переходных пространств имён openxmlformats в строгие пространства purl.oclc.org
Каждая часть меняет словарь разом — от корневого пространства имён через типы связей до camelCase-типа extendedProperties; ни одно переходное пространство имён не должно сохраниться нигде в пакете

Переключение экспорта Delphi на StrictOOXML

В HotXLS переключение — это один булев флаг на TXLSXWorkbook, StrictOOXML, по умолчанию False. Код авторинга остаётся ровно прежним: листы, ячейки и формулы строите как обычно, задаёте свойство и сохраняете. SaveAs возвращает 1 при успехе; любое другое значение означает, что пакет не записан, а причина лежит в 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;            // словарь 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;

Свойство читается в начале каждого сохранения и управляет переключателем на время одного сохранения, который консультируют писатели, поэтому сохранение, сорвавшееся на середине, не оставит строгий перевод включённым для следующего. На сервере, где один объект книги обслуживает несколько запросов на экспорт, можно переключать StrictOOXML между вызовами, и каждое сохранение получит ровно тот словарь, который запросило

Две границы стоит знать заранее. Строгий вывод касается форматов Open XML: workbook, шаблон и макро-шаблон. Запрос .xlsb при StrictOOXML = True отклоняется с диагностикой, предлагающей выключить свойство: у двоичного формата строгого варианта нет. А открытие файла, сохранённого Excel как "Strict Open XML Spreadsheet", само свойство не выставляет. Загрузите такой файл и сохраните его, не трогая StrictOOXML, — назад получите переходный пакет

Почему строгое сохранение может отказаться выполняться?

Строгое сохранение отказывается выполняться, когда в книге есть содержимое, которое ISO 29500 Strict выразить не может. Семейства, которые проверяет HotXLS: проекты VBA, элементы управления форм со своими частями ctrlProps, ветвевые комментарии (современная модель persons-and-threads, а не классические примечания), слайсеры, метаданные динамических массивов, гистограммы данных, опирающиеся на блок расширений 2009 года ради сплошной заливки, цветов отрицательных значений или собственной оси, и Timelines, пока не выбрана политика конвертации

Шлюз строгого сохранения HotXLS в Delphi: SaveAs с StrictOOXML отклоняет проекты VBA, элементы управления форм, ветвевые комментарии, слайсеры и метаданные динамических массивов и завершается, только когда запрещённых возможностей нет
Строгое сохранение сверяет книгу с тем, что ISO 29500 Strict может выразить, и называет блокирующую функцию, вместо того чтобы записывать пакет, который лишь заявляет о соответствии

Отказ — правильное поведение по умолчанию. Альтернатива — выбросить макро-проект или слайсеры и всё равно штамповать результат как Strict: человек получает книгу, которая открывается без проблем, но ведёт себя не так, как то, что он экспортировал. Excel никогда этого не пометит. Отказ называет функцию, пока ваш код ещё помнит, какой отчёт производил. Большинство отказов выглядят как SaveAs, вернувший -1, с диагностикой вроде StrictOOXML: Strict output cannot embed VBA. Хранение динамических массивов решается в момент записи пакета, поэтому формула, присвоенная в этом же сеансе, всё ещё может остановить сохранение исключением с именем метаданных — оборачивайте строгое SaveAs в try..except вдобавок к проверке результата. Если книге нужны макросы, её место — на переходном пути .xlsm, описанном в статье сохранение проектов VBA и внешних связей

Не обязательно узнавать об этом в момент сохранения. GetConversionReport осматривает книгу без её пересчёта и возвращает TXLSConversionReport, элементы которого несут имя функции, уровень сохранности, индекс листа и сообщение. Под StrictOOXML блокирующие элементы приходят как xlsConversionUnsupported. Случай с Timeline заодно показывает единственное место, где содержимое можно сознательно обменять на соответствие: StrictTimelineOutputPolicy = xlsxStrictTimelineDateCriteria превращает поддерживаемые выделения Timeline в стандартные критерии дат сводных таблиц, оставляя за бортом интерфейс Timeline, его части кэша, связи и определённые имена. В отчёте это значится как xlsConversionDropped, и исходная книга в памяти остаётся неизменной

function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
  Report: TXLSConversionReport;
  I: Integer;
begin
  Wb.StrictOOXML := True;
  // Принимаем документированный компромисс по Timeline: критерии дат остаются, интерфейс 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;

Запустите это перед экспортом и пишите в журнал каждую возвращённую строку. Индекс листа -1 помечает элемент уровня книги, например проект VBA; элементы листов несут номер листа с единицы и имя листа — так же, как индексируется Sheets. Отчёт видит метаданные динамических массивов, которые загруженная книга уже несёт; для формул, присвоенных кодом, полагайтесь на скалярную перезапись из следующего раздела

Формула, которая тихо становится динамическим массивом

Неожиданный отказ — это метаданные динамических массивов в книге, где ни FILTER, ни SEQUENCE никогда не использовались. Excel 365 вычисляет оператор, применённый к многоячеечному диапазону, как массив, даже внутри редуктора, поэтому =SUM(B2:B4*C2:C4) — формула массива в глазах Excel. Когда вы присваиваете этот текст свойству Formula, HotXLS хранит ячейку так же, как поступил бы Excel: как одноячеечный динамический массив со ссылкой cm в xl/metadata.xml; иначе Excel применил бы неявное пересечение при загрузке и показал #VALUE!. Подоплёка — в статье формулы с оператором массива и неявное пересечение. Strict не имеет словаря для той части метаданных, поэтому сохранение останавливается

// Хранение массивом: произведение двух диапазонов вычисляется как массив
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)';    // блокирует строгое сохранение

// Скалярное хранение: обычные аргументы-диапазоны, та же сумма
Sh.Cells[5, 2].Formula := '=SUMPRODUCT(B2:B4,C2:C4)';

Для строгого экспорта пишите скалярную форму. SUMPRODUCT с обычными аргументами-диапазонами даёт ту же сумму, не требует поддержки динамических массивов у тех, кто будет читать файл потом, и вовсе не пускает ячейку в часть метаданных. Та же перезапись работает для условных подсчётов: SUMPRODUCT((A2:A4="x")*1) всё ещё перемножает массивы, поэтому там лучше COUNTIF(A2:A4,"x"). Если отчёту действительно нужны разлитые результаты, ему нужен вывод в Transitional

Сохраняемые части пересобираются вместо копирования

XML листа — простая часть строгого вывода. Трудная часть — всё то, что быстрый писатель предпочёл бы копировать дословно. Открывая существующий пакет, HotXLS сохраняет исходные темы, подключения, внешние связи, диаграммы и части сводных таблиц, а при переходном сохранении переносит их сжатые байты напрямую, пока модель не менялась. Для точности это правильный ход, для Strict — неправильный: те байты всё ещё несут переходные пространства имён

При включённом StrictOOXML путь побайтового копирования обходится для всех этих частей. Подключения, внешние связи и диаграммы пересобираются из модели; тема и захваченные XML сводной таблицы, определения кэша и записей кэша проигрываются через переводчик пространств имён. Этот переводчик разбирает каждый открывающий тег и переписывает только две вещи: объявления пространств имён и атрибут Type элементов Relationship в частях .rels. Текст ячеек, прочие значения атрибутов, комментарии и секции CDATA проходят байт в байт, так что общая строка, в которой случайно встретится http://schemas.openxmlformats.org/..., никогда не тронута. URI пространств имён вне schemas.openxmlformats.org, например пространства расширений Microsoft внутри блоков extLst, остаются как есть; если ваш валидатор строг и к содержимому расширений, а не только к переходным пространствам имён, удалите эти функции из исходной книги перед экспортом

Строгий путь вывода HotXLS для сохраняемых частей XLSX: theme, connections, внешние связи, диаграммы и кэши сводных переключаются с дословного копирования байтов на пересборку или переводящее воспроизведение, переписывающее только объявления пространств имён и типы связей
Скопированные сжатые байты пронесли бы переходные пространства имён в строгий пакет, поэтому сохраняемые пути обходят быстрый путь; перевод переписывает только объявления пространств имён и типы связей, а стримимый скелет листа переводится до разбиения по sheetData

Стримимые листы следуют тому же правилу с одним нюансом. Писатель сначала строит скелет листа, переводит его и лишь затем режет по <sheetData>, стримя строки между. Блоки строк не содержат URI словарей, поэтому большие листы не платят за строгий вывод ничего лишнего. Общие строки и записи кэша сводных работают так же: переводится только заголовочный элемент. Подробнее о стороне сохранения — в статье беспотерянный round-trip тем, списков расширений и calcChain

Чтение Strict-файлов и проверка того, что вы записали

Файлы, сохранённые Excel как Strict, открываются как любая другая книга. HotXLS сопоставляет строгие типы связей с их переходными двойниками везде, где разбирается часть связей: в корне пакета, листах, рисунках, внешних связях и сводных таблицах, а читатель разрешает имена элементов по URI пространства имён, а не по префиксу. Сторонние генераторы привязывают префиксы произвольно, так что та же механика обслуживает и обычные файлы — она описана в статье разрешение связей OPC в пакетах XLSX. При переходном сохранении такого файла любая сохраняемая XML-часть, чей корень всё ещё в строгом пространстве имён, конвертируется обратно на выходе, чтобы результат не оказался наполовину одним словарём, наполовину другим

Проверяйте строгий вывод по пакету, никогда по Excel, который благополучно открывает обе формы. Распакуйте результат и проверьте три вещи: xl/workbook.xml объявляет http://purl.oclc.org/ooxml/spreadsheetml/main, ни одна часть не содержит строку schemas.openxmlformats.org/spreadsheetml, а значения Type в _rels/.rels и xl/_rels/workbook.xml.rels начинаются с http://purl.oclc.org/ooxml/. Короткий прогон findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml по распакованной папке не должен выдать ничего

Затем откройте файл заново через TXLSXWorkbook.Open и сравните значения, формулы, числовые форматы и гиперссылки с исходной книгой. Чтение обратно заодно прогоняет сопоставление на стороне читателя. Если в книге есть диаграммы или сводные таблицы, включите их в сравнение: под StrictOOXML обе уходят от побайтового копирования к пересборке или повторному воспроизведению

Строгий вывод, чтение с учётом Strict и беспотерянный round-trip переходных пакетов — это один движок OOXML в HotXLS для Delphi и C++Builder; форматы и возможности перечислены на странице компонента HotXLS для электронных таблиц Delphi