Word文書を「データベース」に変える：カスタムプロパティを掌握せよ
多くの開発者がWordを「文書作成ソフト」としてしか見ていない。だが、真の自動化エンジニアにとって、Wordファイルは「メタデータを内包する極めて堅牢なポータブル・データベース」だ。
今回は、文書のプロパティを制御し、業務のトレーサビリティを劇的に向上させる「カスタムドキュメントプロパティ」の極意を伝授する。なぜ、セルに管理番号を埋め込むような愚行をしてはいけないのか。その答えがここにある。
—
1. なぜ「カスタムプロパティ」を使うべきなのか
業務効率化ツールを設計する際、管理番号や承認ステータスを文書内のテキストとして配置するのは最悪の設計だ。ユーザーが誤って削除するリスクがあり、解析用の正規表現を走らせるのも計算コストの無駄である。
`CustomDocumentProperties` を使えば、以下のメリットが享受できる。
- 不可視性: 誤操作でデータが壊れることがない。
- 構造化: キーと値のペアで管理できるため、後続のシステム連携が極めて容易。
- 永続性: ファイルをどこへ移動してもメタデータは追従する。
—
2. 堅牢な実装：プロパティの書き込みと読み込み
初心者は「いきなり値を書き込む」コードを書くが、それはバグの温床だ。プロパティが存在しない場合にエラーを吐くか、既存のプロパティを上書きしようとして例外が発生する。
「存在確認 → なければ追加 → あれば更新」。このライフサイクルを関数化するのがプロの作法だ。
実装例：DocumentProperty Manager
以下のモジュールを自身のプロジェクトにコピーしてほしい。
Option Explicit
‘ @brief 指定したカスタムプロパティに値をセットする（存在しない場合は自動生成）
Public Sub SetCustomProperty(ByVal doc As Document, ByVal propName As String, ByVal propValue As String)
Dim cp As DocumentProperty
Dim exists As Boolean
exists = False
‘ コレクションを直接操作せず、まずは存在チェック
For Each cp In doc.CustomDocumentProperties
If cp.Name = propName Then
cp.Value = propValue
exists = True
Exit For
End If
Next cp
‘ プロパティが存在しない場合は新規追加
If Not exists Then
doc.CustomDocumentProperties.Add _
Name:=propName, _
LinkToContent:=False, _
Type:=msoPropertyTypeString, _
Value:=propValue
End If
End Sub
‘ @brief 指定したカスタムプロパティを取得する（存在しない場合は空文字を返す）
Public Function GetCustomProperty(ByVal doc As Document, ByVal propName As String) As String
On Error Resume Next
GetCustomProperty = doc.CustomDocumentProperties(propName).Value
If Err.Number <> 0 Then GetCustomProperty = “”
On Error GoTo 0
End Function
—
3. 実務で「死なない」ための設計指針
ファイル連携の注意点：型変換の罠
カスタムプロパティには `String`, `Number`, `Boolean`, `Date` が指定できるが、API連携を行う際は「すべてStringで保存し、利用側でキャストする」のが安全だ。Excelや外部DBと連携する際、型が混在していると暗黙的な型変換でエラーが頻発する。
データベース連携の最適解
もし、このWordファイルをデータベースのレコードとして扱うなら、プロパティを「主キー」として活用せよ。
1. UUIDの埋め込み: 文書作成時に `Guid` を生成し、プロパティに保存する。
2. インデックス化: ファイルサーバーを巡回するスクリプトで全ファイルのプロパティを抽出し、SQL ServerやSQLiteにインデックスを構築する。
これにより、ファイル名が変更されても、Word文書内の「UUID」さえ生きていれば、その文書の履歴を追跡し続けることが可能になる。
—
4. 最後に：プロフェッショナルの視座
Word VBAを操ることは、単なるマクロの記述ではない。文書のライフサイクル全体を設計することだ。
プロパティを使いこなす者は、文書という「塊」を、情報システムの一部品として制御できる。泥臭いコピペ修正や、ファイル名での管理といった旧態依然とした手法から脱却し、メタデータ駆動の堅牢な自動化アーキテクチャを構築してほしい。
これが、我々エンジニアに求められる「品質」だ。次の実装から、ぜひこの設計思想を取り入れてみてほしい。
