Visioの肥大化を断つ:ドキュメント内未使用マスターシェイプの完全抹消とメモリ・ライフサイクルの制御
企業規模のシステムにおいて、Visioは単なる「図面作成ツール」ではない。それは、複雑なネットワークトポロジー、インフラ構成、あるいは業務プロセスを定義する「構造化データ」の器である。
しかし、長年運用されているVisioドキュメント(.vsdx)のファイルサイズが、図面上の形状数に対して不自然に膨れ上がっているケースを、我々エンジニアは幾度となく目にしてきた。その原因の多くは、「ドキュメント内に埋め込まれた、使用されていないマスターシェイプ(Master Shapes)」の蓄積にある。
ユーザーがステンシルからシェイプをドラッグ&ドロップするたび、あるいは外部のステンシルをドキュメントにインポートするたび、ドキュメント内部の「Document Stencil」にはマスターの定義が書き込まれる。図面上のシェイプを削除しても、その「定義(Master)」はステンシル内に残り続けるのだ。これは、メモリとディスク容量を蝕む、静かなる腐敗である。
本稿では、この腐敗を根絶するための、極限まで最適化されたクリーンアップ・ロジックを解説する。
1. 理論的背景:オブジェクト・ライフサイクルとステンシルの構造
Visioのデータ構造を理解するためには、以下の階層構造を脳内にマッピングする必要がある。
1. Document: ファイルそのもの。
2. DocumentStencil: ドキュメント内部に保持される、シェイプの「設計図」の集合体。
3. Master: ステンシル内に格納された、単一のシェイプの定義。
4. Shape: ページ上に配置された、マスターを実体化したインスタンス。
我々の目的は、「どのページのどのShapeも参照していないMaster」を特定し、そのMasterを`DocumentStencil`から物理的に削除することだ。
単なるループ処理では、大規模なドキュメントにおいて計算量が $O(N \times M)$ ($N$: ページ数, $M$: シェイプ数)で増大し、実行時にメモリ圧迫を引き起こす。効率的なアルゴリズムには、ハッシュテーブルを用いた参照確認が不可欠である。
2. 高効率クリーンアップ・アルゴリズムの実装
以下の実装では、`Scripting.Dictionary` を活用し、使用中のマスター名を $O(1)$ で検索可能にしている。また、COMオブジェクトの解放を意識した設計を行っている。
実装コード (VBA)
' -----------------------------------------------------------------------------
' Module: Mod_VisioOptimizer
' Description: 未使用マスターシェイプを特定し、ドキュメントから削除する。
' Author: Chief Architect
' -----------------------------------------------------------------------------
Option Explicit
''' <summary>
''' ドキュメント内の未使用マスターシェイプをスキャンし、クリーンアップを実行する。
''' </summary>
Public Sub PurgeUnusedMasters()
Dim doc As Visio.Document
Dim dictUsedMasters As Object ' Scripting.Dictionary
Dim pg As Visio.Page
Dim shp As Visio.Shape
Dim stencil As Visio.DocumentStencil
Dim master As Visio.Master
Dim masterName As String
Dim i As Long, j As Long
Dim deletedCount As Long
' 高速化のため、Dictionaryオブジェクトを初期化
' ※参照設定: Microsoft Scripting Runtime が必要だが、
' 互換性を重視し Late Binding を採用する。
Set dictUsedMasters = CreateObject("Scripting.Dictionary")
On Error GoTo ErrorHandler
Set doc = ActiveDocument
If doc Is Nothing Then
MsgBox "アクティブなドキュメントが見つかりません。", vbCritical
Exit Sub
End If
Debug.Print "--- Optimization Start: " & doc.Name & " ---"
' STEP 1: 全ページを走査し、使用中のマスター名を収集する
' 計算量: O(Total Shapes)
For Each pg In doc.Pages
For Each shp In pg.Shapes
' Shapeが持つMasterの情報を取得
' Shape.Masterは、そのシェイプの定義を参照している
On Error Resume Next ' マスターを持たない特殊なシェイプ対策
masterName = shp.Master.Name
On Error GoTo ErrorHandler
If masterName <> "" Then
' Dictionaryに登録(重複は自動的に無視される)
If Not dictUsedMasters.Exists(masterName) Then
dictUsedMasters.Add masterName, True
End If
End If
Next shp
Next pg
Debug.Print "使用中のマスター数: " & dictUsedMasters.Count
' STEP 2: ドキュメント内のステンシルを走査し、未使用のマスターを削除する
' 計算量: O(Total Masters in Stencils)
deletedCount = 0
' DocumentStencilsは、ドキュメントに埋め込まれた定義集合である
For Each stencil In doc.DocumentStencils
' コレクションの逆順ループ(削除を行う際の定石)
' 前方から削除すると、インデックスがズレてスキップが発生するため
For i = stencil.Masters.Count To 1 Step -1
Set master = stencil.Masters.Item(i)
masterName = master.Name
' STEP 3: 使用中リストに含まれていないマスターを抹消
If Not dictUsedMasters.Exists(masterName) Then
' ユーザー定義マスター以外のシステムマスターを保護するためのガード
' (必要に応じて条件を強化せよ)
On Error Resume Next
master.Delete
If Err.Number = 0 Then
deletedCount = deletedCount + 1
Else
' 削除不可(システム保護等)の場合は静かにスキップ
Err.Clear
End If
On Error GoTo ErrorHandler
End If
Next i
Next stencil
' 後処理
Debug.Print "削除されたマスター数: " & deletedCount
Debug.Print "--- Optimization Complete ---"
MsgBox "クリーンアップ完了。" & vbCrLf & _
"削除されたマスター数: " & deletedCount, vbInformation
CleanUp:
' COMオブジェクトの明示的な解放(メモリリーク防止)
Set dictUsedMasters = Nothing
Set doc = Nothing
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
3. アーキテクチャ上の重要知見
このコードを実戦投入するにあたり、シニアエンジニアが留意すべき「極限の知見」を3点共有する。
① コレクションの逆順走査 (Reverse Iteration)
`stencil.Masters.Delete` を実行する際、`For Each` や `For i = 1 To Count` を使用するのは致命的なミスだ。要素を削除した瞬間、残りの要素のインデックスが再構成されるため、次に参照すべき要素を飛び越えてしまう。コレクション操作における「削除」は、常に `Step -1` による降順ループが鉄則である。
② メモリ管理と Late Binding の選択
大規模な自動化システムでは、`Microsoft Scripting Runtime` への参照設定(Early Binding)は、実行環境の差異(バージョンの不一致)によるランタイムエラーのリスクを孕む。本コードでは `CreateObject` による Late Binding を採用している。これは、配布用ツールとしての堅牢性を確保するための、プロフェッショナルな選択である。
③ Windows API による副作用の監視
もし、このスクリプトをサーバーサイドのバッチ処理(Visioをバックグラウンドで起動する形態)として組み込む場合、`Process ID` を管理し、処理終了後に確実に `Visio.Application` インスタンスが破棄されているかを確認する必要がある。VBA側で `Set obj = Nothing` を行っても、COMの参照カウントが残っている限り、`visio.exe` はメモリ上にゾンビとして残り続ける。これは、システム全体のメモリ枯渇を招く。
4. 結論
Visioドキュメントの最適化は、単なる「掃除」ではない。それは、データの整合性を保ち、システムのライフサイクルを延長するための「エンジニアリング」である。
未使用のマスターを放置することは、設計図のゴミを溜め込み続けることに等しい。本稿で示したアルゴリズムを、貴殿の設計・運用プロセスに組み込み、常にクリーンで軽量なアーキテクチャを維持されたい。
「コードは書くものではない。管理するものだ。」
