归档入库检查只凭一条抱怨就拒收了一份表格文件:xl/workbook.xml 的根元素落在命名空间 http://schemas.openxmlformats.org/spreadsheetml/2006/main 里。Excel 打开同一个文件却毫无怨言。两个结果都对。ISO/IEC 29500 在第 1 部分定义了 Strict SpreadsheetML,把带遗留兼容特性的 Transitional 形式留在第 4 部分,而校验器引用的那个 URI 属于 Transitional。招标文件或归档制度里写明 ISO 29500 Strict,就意味着包内每个部件都得用 purl.oclc.org 词汇表;一个文件可以完全让 Excel 满意,却在这个测试上彻底不及格
Strict 与 Transitional 之间到底变了什么?
看得见的变化是词汇表。Strict 工作簿部件把 http://purl.oclc.org/ooxml/spreadsheetml/main 声明为根命名空间,r:id 引用则用 http://purl.oclc.org/ooxml/officeDocument/relationships。DrawingML、图表、图片和电子表格绘图的命名空间同样搬家,文档属性部件也不例外。关系类型跟着一起变:根关系部件指向 http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument,扩展属性和自定义属性的类型名变成驼峰式的 extendedProperties 和 customProperties,而 Transitional 用连字符拼写
更隐蔽的变化是范围。Strict 剔除了 Transitional 模式里那些只为承载遗留二进制行为而存在的部分,对 Office 后来加入的扩展则完全没有对应词汇。对字符串做查找替换填不平这个坑,因为有些特性根本就没有 Strict 写法。所以转换一个包意味着两件事:把所有有 Strict 对应物的内容改名,再决定没有对应物的内容怎么办
把 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;
这个属性在每次保存开始时读取,并驱动一个所有写入器都会查询的按次开关,所以一次中途失败的保存不会把 strict 翻译带到下一次保存。在一个工作簿对象要应答多个导出请求的服务器上,你可以在调用之间翻转 StrictOOXML,每次保存都拿到它点名要的词汇表
有两个边界值得先知道。Strict 输出只适用于 Open XML 格式:工作簿、模板和启用宏的模板。StrictOOXML 为 True 时请求 .xlsb 会被拒绝,并给出一条让你关掉该属性的诊断,因为二进制格式没有 Strict 变体。另外,打开一个 Excel 存成 "Strict Open XML Spreadsheet" 的文件并不会自动替你设置该属性。加载这类文件后不动 StrictOOXML 直接保存,得到的还是 Transitional 包
为什么 strict 保存会拒绝执行?
当工作簿里有 ISO 29500 Strict 无法表达的内容时,strict 保存会拒绝执行。HotXLS 检查的类别有:VBA 工程、带 ctrlProps 部件的窗体控件、线程化评论(现代的 persons-and-threads 模型,不是传统批注)、切片器、动态数组元数据、依赖 2009 扩展块才能实现实心填充、负值条颜色或自定义坐标轴等特性的数据条,以及未选择转换策略时的 Timeline
拒绝是这里的正确默认。另一种做法是丢掉宏工程或切片器,仍然给结果盖上 Strict 的章,这等于递给别人一个能正常打开、行为却与你导出的那份不一致的工作簿,而 Excel 永远不会指出这一点。拒绝会点名特性,而此时你的代码还知道自己在生成哪份报表。多数拒绝表现为 SaveAs 返回 -1 并附带 StrictOOXML: Strict output cannot embed VBA 这样的诊断。动态数组存储是在写包过程中决定的,所以本会话里赋的公式仍可能以一个点名元数据的异常终止保存;除了检查返回值,还要把 Strict 的 SaveAs 包进 try..except。如果工作簿离不开宏,那它属于 保留 VBA 工程与外部链接一文中那条 Transitional 的 .xlsm 路线
你不必靠保存来试错。GetConversionReport 不重算工作簿就能完成检查,返回一个 TXLSConversionReport,其中的条目带有特性名、保真级别、工作表序号和消息。在 StrictOOXML 下,拦截项以 xlsConversionUnsupported 返回。Timeline 的情况还展示了唯一一处可以有意用内容换合规的地方:把 StrictTimelineOutputPolicy 设为 xlsxStrictTimelineDateCriteria,受支持的 Timeline 选区会转换成标准的数据透视日期条件,Timeline UI 及其缓存部件、关系和定义名称则被舍弃。报表把这类条目标为 xlsConversionDropped,内存中的源工作簿保持不变
function StrictBlockers(Wb: TXLSXWorkbook; Log: TStrings): Boolean;
var
Report: TXLSConversionReport;
I: Integer;
begin
Wb.StrictOOXML := True;
// 接受文档写明的 Timeline 取舍:日期条件留下,Timeline UI 舍弃
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 工程);工作表条目带 1 起算的工作表编号和表名,与 Sheets 的索引方式一致。报表能看到已加载工作簿自带的动态数组元数据;代码里赋的公式,则靠下一节的标量改写来把关
悄悄变成动态数组的公式
最让人措手不及的拒绝,发生在一个从没用过 FILTER 或 SEQUENCE 的工作簿里冒出动态数组元数据时。Excel 365 会把作用于多单元格区域的运算符求值成数组,即使在 reducer 里也一样,所以在 Excel 眼里 =SUM(B2:B4*C2:C4) 就是数组公式。把这段文本赋给 Formula 时,HotXLS 会像 Excel 那样存储该单元格:作为带 cm 引用、指向 xl/metadata.xml 的单单元格动态数组;否则 Excel 会在加载时施加隐式交集并显示 #VALUE!。背景见 数组运算符公式与隐式交集。Strict 对这个元数据部件没有词汇,于是保存停止
// 数组存储:两个区域的乘积按数组求值
Sh.Cells[5, 2].Formula := '=SUM(B2:B4*C2:C4)'; // 会让 Strict 保存被拦下
// 标量存储:普通区域参数,总和相同
Sh.Cells[5, 2].Formula := '=SUMPRODUCT(B2:B4,C2:C4)';
Strict 导出请写成标量形式。带普通区域参数的 SUMPRODUCT 给出同样的总和,不要求日后读这个文件的任何软件支持动态数组,还让单元格彻底远离元数据部件。条件计数也能做同样的改写:SUMPRODUCT((A2:A4="x")*1) 依然在乘数组,所以那里更推荐 COUNTIF(A2:A4,"x")。如果报表真的需要溢出结果,那它需要 Transitional 输出
保留部件走重建,而不是照搬
工作表 XML 是 strict 输出里容易的部分,难的是那些快速写入器本想原样照搬的内容。HotXLS 打开现有包时,会保留原始主题、连接、外部链接、图表和数据透视部件;Transitional 保存且模型未变时,直接把它们的压缩字节透传。这对保真度是正确之举,对 Strict 却是错误之举,因为这些字节仍带着 Transitional 命名空间
StrictOOXML 打开后,上述部件全部绕开字节照搬路径。连接、外部链接和图表从模型重建;主题以及捕获的数据透视表、缓存定义和缓存记录 XML 则经由命名空间转换器重放。这个转换器解析每个起始标签,只改写两样东西:命名空间声明,以及 .rels 部件中 Relationship 元素的 Type 属性。单元格文本、其他属性值、注释和 CDATA 段逐字节通过,所以碰巧含有 http://schemas.openxmlformats.org/... 的共享字符串绝不会被碰。schemas.openxmlformats.org 之外的命名空间 URI,比如 extLst 块里的 Microsoft 扩展命名空间,保持原样;如果你的校验器连扩展内容连同 Transitional 命名空间一起拒绝,请在导出前把这些特性从源工作簿里移除
流式工作表遵循同一条规则,只是多了一个转折。写入器先构建工作表骨架,翻译它,然后才在 <sheetData> 处切开、流式输出中间的行。行块里不含词汇表 URI,所以大表为 Strict 输出付出的额外代价为零。共享字符串和数据透视缓存记录也是同样处理:只翻译头部元素。保留侧的更多内容见 主题、扩展列表与 calcChain 的无损往返
读取 Strict 文件并检查你写出的内容
Excel 存成 Strict 的文件照常打开。凡解析关系部件的地方——包根、工作表、绘图、外部链接和数据透视表——HotXLS 都把 Strict 关系类型映射到对应的 Transitional 类型,读取器按命名空间 URI 而不是前缀来解析元素名。第三方生成器随意绑定前缀,所以同一套机制也服务于普通文件;详见 XLSX 包中的 OPC 关系解析。对这类文件做 Transitional 保存时,任何根元素仍在使用 Strict 命名空间的保留 XML 部件都会在输出途中转换回去,结果不会一半一种词汇表、一半另一种
验证 Strict 输出要对包本身做,永远不要拿 Excel 当标准,它两种形式都乐意打开。解压结果,检查三件事:xl/workbook.xml 声明 http://purl.oclc.org/ooxml/spreadsheetml/main;没有任何部件含有字符串 schemas.openxmlformats.org/spreadsheetml;_rels/.rels 和 xl/_rels/workbook.xml.rels 里的 Type 值都以 http://purl.oclc.org/ooxml/ 开头。对解压目录跑一条 findstr /s /m "schemas.openxmlformats.org/spreadsheetml" *.xml,应当什么也列不出来
然后用 TXLSXWorkbook.Open 重新打开文件,把值、公式、数字格式和超链接与源工作簿逐一比对。这一步读回同时锻炼了读取侧映射。如果工作簿带图表或数据透视表,把它们也纳入比对,因为在 StrictOOXML 下两者都从字节照搬切换到重建或重放路径
Strict 输出、感知 Strict 的读取以及 Transitional 包的无损往返在 HotXLS for Delphi and C++Builder 中共用同一个 OOXML 引擎;HotXLS Delphi 电子表格组件页面列出了它覆盖的格式与特性