【実務・中級編】【中級】Visioドキュメント内の「使用されていないマスターシェイプ」を特定して削除する – Visio VBA解析バイブル

スポンサーリンク
スポンサーリンク

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の自動化において、単に「動く」コードを書くのは誰でもできる。しかし、大規模なデータに対しても、低メモリ消費で、高速に、そして安全に動作する「堅牢なエンジン」を書ける者こそが、真のエンジニアだ。

このマスターシェイプ・クリーンアップのロジックを、君のライブラリの核として組み込んでほしい。それが、プロフェッショナルの仕事だ。

タイトルとURLをコピーしました