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

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

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ドキュメントの最適化は、単なる「掃除」ではない。それは、データの整合性を保ち、システムのライフサイクルを延長するための「エンジニアリング」である。

未使用のマスターを放置することは、設計図のゴミを溜め込み続けることに等しい。本稿で示したアルゴリズムを、貴殿の設計・運用プロセスに組み込み、常にクリーンで軽量なアーキテクチャを維持されたい。

「コードは書くものではない。管理するものだ。」

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