Word文書を「データベース」へ変える：CustomXMLPartsによる極限のデータ永続化
Word VBAの深淵に触れる際、多くのエンジニアが「ドキュメント変数（`Variables`）」や「カスタムプロパティ」で妥協する。だが、それらは所詮、断片的な文字列の集積に過ぎない。
真に堅牢なシステムを構築したいのであれば、Wordの内部構造であるOpenXML（.docx）の特権を使いこなす必要がある。今回は、ドキュメント内に不可視のデータ層を構築する「CustomXMLParts」について、アーキテクトの視点からその真髄を説く。
—
なぜ「CustomXMLParts」なのか
WordファイルをZip解凍してみれば分かるが、`.docx`の本質はXMLの集合体だ。`CustomXMLParts`は、その構造の中に任意のXMLツリーを埋め込むための公式APIである。
- 構造化データ: 単なる文字列ではなく、階層構造を持つデータを保持できる。
- 外部依存の排除: 外部のデータベースやJSON/XMLファイルを持ち歩く必要はない。文書そのものが自己完結したデータコンテナとなる。
- 整合性: 文書の変更履歴やコピー＆ペーストに追従させることが容易であり、システム連携のメタデータ保持に最適である。
—
実装の極致：CustomXMLPartsを操るコード
この技術を扱う際、最も注意すべきは「メモリリーク」と「名前空間の衝突」だ。特にVBAでCOMオブジェクトを扱う際、明示的な解放を怠れば、Wordのプロセスがゾンビ化する。
以下のコードは、文書内にカスタムXMLを生成し、データを永続化する堅牢な実装例である。
‘ —————————————————————————
‘ @description: Word文書にカスタムXMLパーツを注入/更新するアーキテクチャ
‘ @author: Chief Architect
‘ —————————————————————————
Public Sub UpsertCustomXMLData(ByVal doc As Document, ByVal xmlContent As String)
Dim customParts As CustomXMLParts
Dim part As CustomXMLPart
Const NAMESPACE_URI As String = “urn:my-company:system-meta”
‘ 1. 名前空間による絞り込み (高速化のためFindでは行わず直接コレクションを走査)
Set customParts = doc.CustomXMLParts.SelectByNamespace(NAMESPACE_URI)
‘ 2. 既存パーツが存在する場合は削除 (メモリリークを防ぐための上書き更新)
If customParts.Count > 0 Then
For Each part In customParts
part.Delete
Next part
End If
‘ 3. 新規パーツのロード
Set part = doc.CustomXMLParts.Add(xmlContent)
‘ 4. 明示的なオブジェクト解放 (VBAのガベージコレクションを信用するな)
Set part = Nothing
Set customParts = Nothing
End Sub
—
シニアエンジニアが意識すべき「見えないコスト」
1. 名前空間（Namespace）の設計
`CustomXMLParts`を扱う際、名前空間を省略する者は素人だ。他のアドインやWordの標準機能が生成するXMLと混同しないよう、必ず固有のURNを指定せよ。これにより、システム間連携時のデータ衝突を論理的に防ぐことができる。
2. メモリ管理の鉄則
`CustomXMLPart`オブジェクトは、ドキュメントを閉じるまでメモリに残り続ける。大量のデータを頻繁に書き換えるような設計は避けるべきだ。もし数MBを超えるような大規模データを扱う場合は、XMLを圧縮して保持するなどの工夫が必要になる。
3. パフォーマンスの最適化（Windows APIとの並行利用）
WordのCOMインターフェースは遅い。もし数千のXMLパーツを操作する必要があるならば、VBAではなく、C#で作成したDLLを`Late Binding`（CreateObject）で呼び出すか、あるいは「OpenXML SDK」を用いて、Wordを起動せずにZipストリームを直接操作することを検討せよ。これが伝説的なアーキテクトが選ぶ「脱・VBAの最適解」だ。
—
現場への提言：レガシーとの共存
この手法は、古いWordマクロシステムをモダンなバックエンドシステムと繋ぐ際の「ブリッジ」として極めて優秀だ。例えば、社内の稟議書システムにおいて、承認ステータスや署名検証用のハッシュ値を、可視領域に一切影響を与えずに埋め込むことができる。
注意点: ユーザーが「WordのXML編集機能」などを悪用してパーツを削除するリスクがある。重要なメタデータは、必ずしもユーザーに見えないことを前提とせず、適宜整合性チェック（Checksum）を実装すること。
—
結びに代えて
VBAはオモチャではない。Wordのオブジェクトモデルは、正しく理解すれば強力なエンタープライズプラットフォームだ。`CustomXMLParts`という、ドキュメントの内側に潜む「隠されたレイヤー」を掌握することで、君の作るツールは、単なるマクロから、堅牢なシステムへと進化する。
次回の講義では、このXMLパーツをXPathで高速検索し、Wordのコンテンツコントロールとバインディングさせる「自動データ同期メカニズム」について深掘りする。準備を怠るな。
