檔案庫的收件檢查退回一份試算表,理由只有一條:xl/workbook.xml 的根元素位於 http://schemas.openxmlformats.org/spreadsheetml/2006/main 命名空間。同一份檔案 Excel 卻開得毫無怨言。兩種結果都沒錯。ISO/IEC 29500 在 Part 1 定義 Strict SpreadsheetML,把帶舊版相容功能的 Transitional 形式留在 Part 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 版是用連字號拼寫
比較看不見的改變是範圍。Transitional 結構描述裡那些只為承載舊二進位行為而存在的部分,Strict 版一概省略,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;
這個屬性會在每次儲存開始時讀取,驅動一個各寫入器都會查詢的單次儲存開關,所以中途失敗的儲存,不會把嚴格模式轉譯遺留給下一次儲存。在單一活頁簿物件要服務多個匯出要求的伺服器裡,你可以在呼叫之間翻轉 StrictOOXML,每次儲存都會得到它點名的詞彙
有兩個邊界值得先知道。Strict 輸出適用於 Open XML 格式:活頁簿、範本與啟用巨集的範本。StrictOOXML 為 True 時要求 .xlsb 會被拒絕,診斷訊息會叫你把屬性關掉,因為二進位格式沒有 Strict 版。另外,開啟 Excel 以「Strict Open XML Spreadsheet」儲存的檔案,並不會替你設定這個屬性。載入這種檔案後,不去動 StrictOOXML 直接儲存,拿回來的就是 Transitional 套件
為什麼嚴格模式的儲存會拒絕執行?
當活頁簿裡有 ISO 29500 Strict 無法表達的內容時,嚴格儲存就會拒絕執行。HotXLS 檢查的類別有:VBA 專案、帶 ctrlProps 部件的表單控制項、討論串式留言(現代的 persons-and-threads 模型,不是傳統備註)、交叉分析篩選器(slicer)、動態陣列中繼資料、依賴 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 會把套在多儲存格範圍上的運算子當陣列求值,就算包在彙總函式裡也一樣,所以在 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 是嚴格輸出裡簡單的部分。麻煩的是那些追求速度的寫入器寧可原樣照抄的東西。HotXLS 開啟既有套件時,會保留原始的佈景主題、連線、外部連結、圖表與樞紐分析部件,而在模型沒變的前提下,Transitional 儲存會把它們壓縮後的位元組直接照抄過去。就保真度而言這是正確做法,對 Strict 而言卻恰恰相反,因為那些位元組帶的還是 Transitional 命名空間
開著 StrictOOXML,上述部件全部繞開位元組複製路徑。連線、外部連結與圖表會從模型重建;佈景主題與擷取下來的樞紐分析表、快取定義、快取記錄 XML 則透過命名空間轉譯器回放。這個轉譯器剖析每個開始標籤,只改寫兩樣東西:命名空間宣告,以及 .rels 部件裡 Relationship 元素的 Type 屬性。儲存格文字、其他屬性值、註解與 CDATA 區段逐位元組通過,所以碰巧含有 http://schemas.openxmlformats.org/... 的共用字串絕不會被碰到。至於 schemas.openxmlformats.org 之外的命名空間 URI,例如 extLst 區塊裡的微軟延伸命名空間,則原樣保留;如果你的驗證工具連延伸內容也拒收(而不只 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 檔案,以及 Transitional 套件的無損往返,在 HotXLS for Delphi 與 C++Builder 裡共用同一套 OOXML 引擎;HotXLS Delphi 試算表元件頁面 列出了它涵蓋的格式與功能