Visioの「肥大化」を制する:未使用マスターシェイプを外科手術的に排除する設計思想
Visioを用いた大規模なシステム構成図やネットワーク図の自動生成ツールを開発していると、避けては通れない問題に直面する。それは、「ファイルサイズの異常な増大」と「描画パフォーマンスの低下」だ。
多くの開発者は、図面上のシェイプを消せばファイルは軽くなると誤解している。しかし、それは大きな間違いだ。Visioの内部構造において、シェイプ(インスタンス)を削除しても、その「設計図」であるマスターシェイプ(Master Shape)は、ドキュメント内のステンシル(Document Stencil)に居座り続ける。
これがいわゆる「ゴースト・マスター」だ。数千のシェイプを生成・削除するプロセスを繰り返す自動化ツールでは、このゴーストが蓄積し、メモリを食いつぶし、最終的にはVisioの挙動を不安定にさせる。
今日は、この肥大化の根本原因を特定し、安全かつ高速にクリーンアップするための、プロフェッショナルな設計と実装を伝授する。
1. アーキテクチャの本質:なぜ「消えない」のか
Visioのオブジェクトモデルを理解せよ。
1. Shape: ページ上に配置された実体。
2. Master: そのシェイプの定義(プロパティ、形状、接続点)。
3. Document Stencil: そのドキュメント内で利用可能なマスターの集合体。
ユーザーがページ上のシェイプを削除しても、`Document.Masters` コレクションから該当するマスターが自動的に削除されることはない。マスターは「再利用される可能性のあるリソース」として保持されるからだ。
我々が実装すべきは、「全ページの全シェイプを走査し、現在使用されているマスターのリストを作成。その後、そのリストに含まれないマスターを `Document.Masters` から一掃する」というロジックである。
2. 陥りやすい「低品質な実装」と、エンジニアリングによる解決
ここで、多くの初級者が書く「ダメなコード」のパターンを示そう。
アンチパターン:二重ループによる単純走査
すべてのマスターに対して、全ページの全シェイプをループで回して「君は使われているか?」と確認する手法だ。
- 計算量: $O(M \times S)$ ($M$=マスター数, $S$=全シェイプ数)
- 結果: 図面が大規模になると、処理時間が指数関数的に増大し、アプリケーションがフリーズしたように見える。
プロフェッショナルな設計:ハッシュセット(Dictionary)による高速照合
我々が採用すべきは、「使用済みマスターを一度だけ走査してハッシュテーブルに格納し、マスターの削除時に $O(1)$ で検索する」手法だ。
- 計算量: $O(S + M)$
- 結果: 規模に依存しない、極めて高いパフォーマンスを実現できる。
3. 実装:堅牢なクリーンアップ・エンジン
以下に、プロダクション環境で使用することを想定した、堅牢なコードを示す。単なる「削除」ではなく、「シミュレーションモード(Dry Run)」を搭載し、破壊的な操作に対する安全策を講じている。
Option Explicit
''' <summary>
''' Visioドキュメント内の未使用マスターシェイプを特定し、クリーンアップする。
''' </summary>
''' <param name="isDryRun">Trueの場合、実際の削除は行わず、ログ出力のみを行う。</param>
Public Sub CleanupUnusedMasters(Optional ByVal isDryRun As Boolean = True)
Dim doc As Visio.Document
Set doc = ActiveDocument
' 1. パフォーマンス最適化のための準備
' 描画更新を停止し、計算モードを調整することで実行速度を劇的に向上させる
On Error GoTo ErrorHandler
Application.ScreenUpdating = False
Dim usedMasterNames As Object
' Dictionaryを使用して、使用中のマスター名を高速に管理する (Late Binding)
Set usedMasterNames = CreateObject("Scripting.Dictionary")
Debug.Print "--- Cleanup Process Started (DryRun: " & isDryRun & ") ---"
' 2. 使用中のマスターをスキャン (O(S) Complexity)
Dim pg As Visio.Page
Dim shp As Visio.Shape
Dim mName As String
For Each pg In doc.Pages
' 非表示ページも含めて走査する必要があるか、要件に応じて検討せよ
For Each shp In pg.Shapes
' Shape.Master.Name を取得。Masterが取得できない特殊なケースを考慮
On Error Resume Next
mName = shp.Master.Name
On Error GoTo ErrorHandler
If mName <> "" Then
' Dictionaryに登録(重複は無視される)
If Not usedMasterNames.Exists(mName) Then
usedMasterNames.Add mName, True
End If
End If
Next shp
Next pg
Debug.Print "Detected used masters: " & usedMasterNames.Count
' 3. 未使用マスターの特定と削除 (O(M) Complexity)
Dim master As Visio.Master
Dim deleteCount As Integer
deleteCount = 0
' Document.Masters コレクションをループ。
' 注意:コレクションをループしながら要素を削除する場合、
' インデックスの逆順走査、あるいはエラーハンドリングによる制御が必要となる。
' VisioのMastersコレクションは、削除によりインデックスが動的に変わるため、
' ここではFor Eachではなく、後ろから回すか、安全な手法を選択する。
' 一旦、削除対象のマスター名をリストアップする(安全策)
Dim mastersToDelete As Collection
Set mastersToDelete = New Collection
For Each master In doc.Masters
If Not usedMasterNames.Exists(master.Name) Then
mastersToDelete.Add master.Name
End If
Next master
' 4. 実際の削除フェーズ
Dim targetName As Variant
For Each targetName In mastersToDelete
If isDryRun Then
Debug.Print "[DryRun] Would delete master: " & targetName
deleteCount = deleteCount + 1
Else
On Error Resume Next
' マスターの削除を試行
doc.Masters.Item(targetName).Delete
If Err.Number = 0 Then
Debug.Print "[Deleted] " & targetName
deleteCount = deleteCount + 1
Else
Debug.Print "[Error] Could not delete " & targetName & ": " & Err.Description
End If
On Error GoTo ErrorHandler
End If
Next targetName
Debug.Print "--- Cleanup Finished. Total processed: " & deleteCount & " ---"
MsgBox "Cleanup Complete." & vbCrLf & "Count: " & deleteCount, vbInformation
CleanUp:
' 後処理:必ず設定を元に戻す
Application.ScreenUpdating = True
Set usedMasterNames = Nothing
Set mastersToDelete = Nothing
Exit Sub
ErrorHandler:
MsgBox "An unexpected error occurred: " & Err.Description, vbCritical
Resume CleanUp
End Sub
4. チーフアーキテクトの視点:実務における注意点
このコードを現場に投入する際、以下の3点を必ず念頭に置け。
① 外部ステンシルの保護
`doc.Masters` はドキュメント固有のマスターを指すが、設計によっては外部ステンシルからコピーされたマスターがドキュメント内に「埋め込まれた(Embedded)」状態で存在する。このロジックはそれらを対象とするが、もし「特定のマスターは絶対に消したくない」という業務ルールがある場合は、`usedMasterNames` にあらかじめホワイトリストとして追加しておく設計にせよ。
② データベース・ファイル連携時の整合性
もし、このVisioファイルをサーバー上の共有フォルダに保存したり、データベース(SQL Server等)のBLOBとして管理している場合、削除処理によってファイルサイズが劇的に変わる。
このクリーンアップは、「ファイル保存直前」、あるいは「自動生成プロセスの最終工程」として組み込むのがベストプラクティスだ。
③ 破壊的変更への備え
`Master.Delete` は取り消し(Undo)が効かない場合がある。
プロダクションツールとして提供するのであれば、このメソッドを実行する前に、必ず `doc.SaveAs` を用いてバックアップを作成するか、ユーザーに対して「実行後に元に戻せない」旨の警告を明示的に行うインターフェースを設計せよ。
結論
Visioの自動化において、単に「動く」コードを書くのは誰でもできる。しかし、大規模なデータに対しても、低メモリ消費で、高速に、そして安全に動作する「堅牢なエンジン」を書ける者こそが、真のエンジニアだ。
このマスターシェイプ・クリーンアップのロジックを、君のライブラリの核として組み込んでほしい。それが、プロフェッショナルの仕事だ。
