請求ジョブが顧客テンプレートを開き、B3に42750を書き込んで保存します。後で展開したパッケージをdiffすると、変更リストは1セルどころではない長さになります。xl/theme/theme1.xmlは顧客の青緑とスレート色ではなく標準のOfficeパレットに置き換わり、ワークシートXMLの末尾の<extLst>からはスパークライングループと新しい条件付き書式ルールが失われ、xl/calcChain.xmlは丸ごと消えています。Excelは修復を申し出て結果を開き、ブランドカラーは消えています。コードが触れたのは1つのセルです。それ以外が変わったのは、保存がメモリ上のモデルが知っているものからパッケージを組み立て直すためで、典型的なテンプレートの3つのパーツは、スプレッドシートモデルが通常保持する範囲の外にあります
1セルの編集がなぜXLSXパッケージ全体を書き換えるのか
.xlsxファイルはXMLパーツのZIPです。xl/workbook.xml、シートごとのxl/worksheets/sheetN.xml、xl/styles.xml、xl/sharedStrings.xml、テーマ、計算チェーン、そしてワークブックが持つ図形、テーブル、ピボットキャッシュです。値と数式をオブジェクトに読み込み、保存時にそのオブジェクトからすべてのパーツを再生成するライブラリには、弱点が1つあります。オブジェクトモデルにスロットを持たないものは、メモリへ載ることすらないため、再生成されたパーツにはそれがありません。スパークラインを誰かが削除する必要はありません。OpenとSaveAsの間に、それが住める場所がもともとないのです
ECMA-376はこの問題の半分を見越していました。SpreadsheetMLはextLst(ECMA-376 Part 1 §18.2.10のワークブックレベル要素。ワークシート、スタイル、条件付き書式にも対応要素があります)を将来機能の格納域として予約しています。新しいプロデューサーは各機能をuri属性で機能名を示す<ext>要素に包み、古いコンシューマーは理解できないものを運び続けることが期待されます。スパークライン、スライサーリスト、新しいデータバーやアイコンセットのオプション、拡張データ入力規則は、今日Excelが書くファイルでみなこの経路を通ります。したがって未知の<ext>ブロックを落とすことは、フォーマットが成り立たせている前方互換性の契約を破ることであり、被害は顧客がExcelでファイルを開き直したときに初めて現れます
テーマと計算チェーンは別の理由で失敗するため、それぞれ別の扱いが必要です。この記事の残りでは、HotXLSが3つすべてをどう扱うか、Delphiの呼び出し側が何を観測し確認できるか、そして保証がどこで終わるかを順に見ていきます
Delphiでカスタムtheme1.xmlを無傷のまま保つ
HotXLSは、開いたパッケージからxl/theme/theme1.xmlの元のバイトを保持し、SaveAsでそのパーツをそのまま書き戻すことでワークブックのテーマを守ります。テーマパーツ(ECMA-376 Part 1 §14.2.7)はDrawingMLです。12スロットのカラースキーム、フォントスキーム、フィル・線・効果のフォーマットスキームです。セルスタイルは<color theme="4"/>などの参照でここを指すため、スプレッドシートエンジンはスロットを解決するだけでよく、グラデーションや効果スタイルを理解する必要はありません。保存のたびに固定のOfficeテーマを再生成するのは、まさに顧客の青緑をOfficeブルーへ変える動作です。スクラッチで作られテーマを持たないワークブックには、代わりに組み込みのOfficeテーマが与えられます
日常的なケースではテーマコードは一切不要です。シートのインデックスに注意してください。XLSXエンジンではSheetsは1始まりで、Cells[3, 2]は行3、列2、つまりB3です
var
Book: TXLSXWorkbook;
begin
Book := TXLSXWorkbook.Create;
try
Book.Open('branded-invoice.xlsx');
Book.Sheets[1].Cells[3, 2].Value := 42750.00; // 唯一の編集
Book.SaveAs('branded-invoice-out.xlsx');
// 出力のxl/theme/theme1.xmlはテンプレート自身のテーマを持つ
finally
Book.Free;
end;
end;
生バイトは、こういうパーツについて得られる最も強い忠実度です。パースなし、再シリアル化なし、ずれようがないのです。保存が移行方言ではなくStrict OOXMLを書く場合は、キャプチャされたテーマはコピーされず名前空間トランスレーターを通ります。バイトコピーでは、Strictパッケージの中に移行方言の名前空間URIが残ってしまうからです
罠はAPI側にあります。TXLSXWorkbookはThemeMajorFontとThemeMinorFontを公開し、Openの後にはテンプレートのフォントスキームからパースされた見出し用・本文用の書体を報告します。これらを設定することがフォント交換の自然なやり方に見えますが、効くのは新しいワークブックが受け取る組み込みOfficeテーマだけです。自分のテーマを持ってきたワークブックでは、キャプチャされたパーツが勝ち、この2つのセッターは保存ファイルに何も変えません。色は別の扱いです。ThemeColor[Slot]は12のclrSchemeスロットをアドレスし、オーバーライドは保持テーマの中のそのスロットの色だけを置き換えて書き込まれます。フォントスキーム、フォーマットスキーム、テーマ拡張には触れません
Book.Open('branded-invoice.xlsx');
// 保存ファイルには無効。テンプレート自身のテーマが保持されるため
Book.ThemeMajorFont := 'Segoe UI Semibold';
// これはファイルへ届く。theme1.xml内のaccent1スロットだけが変わる
Book.ThemeColor[xlsxThemeAccent1] := $FF0F7B6C; // $AARRGGBB
Book.SaveAs('rebranded.xlsx');
この分かれ方は意図的なものです。色のオーバーライドは1つの要素への狭く明確に定義された編集なので、デザイナーのテーマの残りは元のまま保てます。フォントスキームの書き換えは、スクリプトごとのフォントリストに触れることになり、データ指向のAPIがうまく表現できるものではありません。テンプレートに新しい書体が必要なら、Excelで変更して新しいテンプレートを配布してください。テーマはブランドの持ち主の手の中に留まります
保存時に未知のextLstブロックはどうなるか
HotXLSは、ネイティブにモデル化していないすべてのワークシートレベルの<ext>ブロックをキャプチャし、保存されるワークシートのextLstの中で再生します。モデル化しているブロックは型付きオブジェクトにパースされ、そこから組み立て直されます。スパークライングループはSparklineGroupsへ、x14データ入力規則拡張はデータ入力規則コレクションへ読まれ、スライサーリストはスライサーモデルが再出力します。それ以外はすべて、ブロックごとに1つのXMLフラグメントとして、各TXLSXWorksheetの読み取り専用のRawWorksheetExts文字列リストに収まります。テストが、運ばれるものを正確に検査できるということです
var
Book: TXLSXWorkbook;
Sheet: TXLSXWorksheet;
i: Integer;
begin
Book := TXLSXWorkbook.Create;
try
Book.Open('from-newer-excel.xlsx');
Sheet := Book.Sheets[1];
WriteLn(Format('%d foreign ext block(s), %d sparkline group(s)',
[Sheet.RawWorksheetExts.Count, Sheet.SparklineGroups.Count]));
for i := 0 to Sheet.RawWorksheetExts.Count - 1 do
WriteLn(Copy(Sheet.RawWorksheetExts[i], 1, 100)); // 開始タグにuriが現れる
// フラグメントが<worksheet>ルートから借りた名前空間宣言
WriteLn(Sheet.RawExtNamespaceDecls);
finally
Book.Free;
end;
end;
キャプチャはXMLイベントストリームから動作します。ストリーミングリーダーが渡すのは要素、テキスト、終了タグであって、ソース内のバイトオフセットではないからです。未知のサブツリーは、イベントが流れてくるときにそこから再構築されます。素朴な深さカウンターはここで壊れます。開始タグのたびに増え、終了タグのたびに減りますが、<x14:cfvo type="min"/>のような自己完結の子は、空を示すフラグ付きの1つの開始イベントとして届き、後続する終了タグがありません。これを開いた要素として数えると、カウンターは決してゼロに戻らず、キャプチャはワークシートの残りを飲み込みます。HotXLSのキャプチャループは、空でない開始タグにだけ深さを増やし、それ自体が空の<ext/>は1行フラグメントとして即座に格納されます
イベントからの再構築には目に見える副作用があります。属性の引用符の付け方、要素間の空白、<a></a>と<a/>の選択は正規化されて返ってくるため、フラグメントは意味としては元と等価ですが、バイト単位では同一ではありません。ExcelはXMLをパースするのであって、バイトを比較しているわけではありません。ただしテキストを比較するdiffツールはこの変更を検出するので、誰かが回帰として届け出る前に知っておく価値があります
名前空間は、再生されたフラグメントで2番目に困り得るものです。Excelは普通、必要な接頭辞を<ext>要素自身に宣言するため、フラグメントは自己完結しています。しかし、ソースの<worksheet>ルートに1回だけ宣言されたx14acやxrのような接頭辞に、ブロックが頼ることがあります。宣言のないワークシートへそのフラグメントを再生すると、保存されたXMLは名前空間的に正しい形になりません。HotXLSはキャプチャした各フラグメントについて、使用していながら宣言していない接頭辞を走査し、ソースから対応する宣言をRawExtNamespaceDeclsに記録し、保存されるワークシートのルートに書き込みます。フラグメントはプレーンな文字列なので、ワークブック内外でのワークシート複製でも、新しいシートへそれらを運べます
Excelが数式を信頼するようにcalcChain.xmlを書く
HotXLSは、保存されるワークブックに数式セルが1つでもあるとき、常にxl/calcChain.xml(Calculation Chainパーツ、ECMA-376 Part 1 §12.3.1)を、そのcontent-typeオーバーライドとワークブックリレーションシップとともに書き込みます。各エントリは<c r="D10" i="1"/>要素です。セル参照に1始まりのシートインデックスを足したもので、スキーマは同一シートの連続エントリでの省略を許していますが、ライターはすべてのエントリに出します。明示的な方が単純で、同じく正当です
順序は、ワークブックがすでに知っていることに依存します。数式依存グラフが存在し最新のとき——Recalculateの直後がその状態です——チェーンは完全なトポロジカル順に従います。すべての数式はその依存先のセルの後に来て、循環参照のメンバーは末尾に追加されるため、チェーンはすべての数式セルを列挙し続けます。グラフが古いか構築されていないときは、数式セルはシートごとにドキュメント順で列挙されます。どちらも正当です。このフォーマットに対するMicrosoftの実装ノート[MS-XLSX]は、チェーンを、Excelが計算中に検査し並べ替えるヒントとして説明しており、どんな順序の完全な列挙でもきれいに読み込みます
Book.Open('model.xlsx');
Book.Sheets[1].Cells[10, 4].Formula := '=SUM(D2:D9)';
// この時点で保存すると、数式の変更が依存グラフを無効化したため、
// 数式セルはドキュメント順に列挙される。
Book.Recalculate; // グラフを再構築しキャッシュ値を更新する
Book.SaveAs('model-out.xlsx');
// calcChain.xmlは依存順に従う。D10はD2:D9の後
SaveAsは自発的にグラフを構築しません。完全な依存構築はすべての数式のすべての参照を解決することで、大きなモデルでは本物の計算コストであり、ファイルに書きたいだけの呼び出し側が頼んだものではありません。出力にキャッシュ値が重要なら——Excelを開かずに読む下流システムにとってはたいてい重要です——保存前にRecalculateを呼んでください。依存順のチェーンはおまけについてきます
Excelが参考情報として扱うパーツを、なぜ出力するのか。それは不在が目立つからです。修復ヒューリスティックもサードパーティビューアーもdiffツールも、数式ワークブックが計算チェーンを持つことを期待しており、それのないパッケージは、Excel自身が作るどのものにも似ていません。正当なチェーンを書くことは、出力を、エコシステムの他の部分がこれまで鍛えられてきた形の中に保ち、数式セルを1回走査するコストしかありません
ロスレスラウンドトリップが終わる場所
HotXLSはパッケージ全体をバイト単位でコピーするわけではなく、出力はそのように判断されるべきではありません。ワークシートXML、styles.xml、共有文字列、ワークブックパーツはパース済みモデルから再生成されるため、内容は忠実でも入力とバイナリ同一ではありません。ZIPのローカルヘッダーだけでも新しいタイムスタンプを持ちます。キャプチャされた<ext>フラグメントは前述の通り正規化されて返ります。ThemeMajorFontとThemeMinorFontは保持テーマの外に留まり、ThemeColorオーバーライドはスロット単位で中に入ります
維持の網には明確な形があります。エンジンがネイティブにモデル化する機能(スパークラインや拡張データ入力規則。パースされ書き直されます)、ワークシートレベルの外部<ext>コンテンツ(再生されます)、そしてテーマパーツ(キャプチャされたまま運ばれます)です。VBAプロジェクトと外部ワークブック参照は、「モデル化していないものは保持する」という同じやり方で保存を通過します。これはVBAと外部リンク維持の姉妹記事で扱い、docPropsのドキュメントプロパティには専用の読み書きAPIがあります。モデル化もされず拡張ポイントの内側でもない、風変わりなアドインのパーツは、ここで扱った3つの機構の外にあります
重要な検査は自分のファイルで行います。機能豊富な本番テンプレートを開き、値を1つ変え、保存し、両パッケージを展開し、パーツごとにdiffします。編集したシートとstyles.xml、extLst内の属性書式には差異があると考えてください。テーマパーツは入力と一致し、<ext>要素は同じuri値を列挙し、calcChain.xmlはすべての数式セルを名指すはずです。そのリストを超えたものは、テンプレートを本番へ出す前に追跡する価値があります
テーマ維持、外部extLstの再生、計算チェーン出力は、HotXLS Delphi Excel ComponentのXLSXエンジンの一部です。製品ページには、DelphiとC++Builderプロジェクト向けに読み書きできる残りの機能が一覧されています