【実務・中級編】【中級】複数のステンシルから「重複する名前」のマスターシェイプを検出し、競合を解消する – Visio VBA解析バイブル

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

整合性の崩壊を防げ:Visio VBAにおけるマスターシェイプ競合の設計思想

自動化エンジニアとして現場に立つとき、我々が最も恐れるべきは「バグ」ではない。「静かに、しかし確実に進行するデータの不整合」だ。

Visioを用いた大規模な構成図作成ツールや、設計データ管理システムを構築する際、避けて通れないのが「ステンシル(Stencil)の管理」である。複数のステンシルを読み込み、そこからマスターシェイプをドキュメントへ配置するプロセスにおいて、ある日突然、設計の根幹を揺るがす事態が起こる。

「名前は同じだが、中身(プロパティや形状)が異なるマスターシェイプが、異なるステンシルから混在して読み込まれる」

この事態を、単なる「ユーザーの操作ミス」で片付けるのは三流だ。プロフェッショナルなアーキテクトなら、これを「設計上の未解決課題」と捉え、コードレベルで競合を検出し、解消するロジックを組み込む。

本稿では、複数のステンシル間におけるマスター名衝突を検出し、優先順位に基づいて解決する、堅牢な管理ロジックの設計手法を伝授する。

1. なぜ「単純なループ比較」では破綻するのか

初心者はこう書く。
「すべてのステンシルをループし、すべてのマスターをループし、名前が一致したら警告を出す」

' --- アンチパターン:非効率かつ脆弱な設計 ---
For Each stencil In Application.Documents
    For Each master In stencil.Masters
        For Each otherStencil In Application.Documents
            ' ... 名前を比較して MsgBox で通知 ...
        Next
    Next
Next

このアプローチには、致命的な欠陥が3つある。

1. 計算量の爆発 ($O(n^2)$ 問題): ステンシルの数とマスターの数が増えるにつれ、比較回数は指数関数的に増加する。数千のマスターを扱う実務環境では、実行速度が無視できないレベルで低下する。
2. UXの崩壊: 衝突のたびに `MsgBox` を出すなど、ユーザーの作業を中断させる設計は、ツールとしての価値をゼロにする。
3. 解決策の欠如: 「検出」はできても、「どちらが正しいか」という判定基準(Single Source of Truth)がコードに含まれていない。

2. アーキテクチャ設計:Dictionaryを用いたハッシュマップ管理

我々が採用すべきは、ハッシュマップ(VBAにおいては `Scripting.Dictionary`)を用いた、一回走査による衝突検出アルゴリズムだ。

設計の要件

  • 検出フェーズ: ステンシルを走査し、`MasterName` をキー、`StencilName` を値とする構造を構築する。
  • 判定フェーズ: 既にキーが存在する場合、それを「衝突」と定義する。
  • 解消フェーズ: 事前に定義された「優先度リスト(Priority List)」に基づき、正しいマスターを特定する。

必要な参照設定

この実装には、高速な検索を実現するために `Microsoft Scripting Runtime` が必須である。VBAエディタの `Tools` -> `References` からチェックを入れておけ。

3. プロダクション・コード:Master Conflict Resolver

以下に、実務でそのまま利用可能な、堅牢な衝突検知・解決ロジックを示す。

Option Explicit

' ==============================================================================
' Module: MasterConflictManager
' Description: 複数のステンシル間におけるマスターシェイプの競合を検出し、
'              優先順位に基づき解消するための管理クラス。
' ==============================================================================

Private Enum ResolutionStrategy
    KeepHighestPriority ' 優先度リストに基づき、最も優先度の高いものを保持
    ReportOnly          ' 警告のみを出し、自動解決はしない
End Enum

''' <summary>
''' ステンシル内のマスター競合をスキャンし、レポートを作成する。
''' </summary>
''' <param name="priorityList">優先されるステンシルの名前リスト</param>
Public Sub ScanAndResolveMasterConflicts(ByRef priorityList As Collection)
    Dim dictMasterMap As New Scripting.Dictionary ' Key: MasterName, Value: Collection of StencilNames
    Dim stencil As Visio.Document
    Dim master As Visio.Master
    Dim conflictFound As Boolean
    
    On Error GoTo ErrorHandler

    ' --- Phase 1: Data Collection (O(n) Complexity) ---
    For Each stencil In Application.Documents
        ' ステンシルファイルのみを対象とする(拡張子チェック等のガード条件を推奨)
        If stencil.Type = visDocStencil Then
            For Each master In stencil.Masters
                If Not dictMasterMap.Exists(master.Name) Then
                    ' 新規マスター名の場合、その名前をキーとし、ステンシル名を格納するコレクションを作成
                    Dim stencils As New Collection
                    stencils.Add stencil.Name
                    dictMasterMap.Add master.Name, stencils
                Else
                    ' 既に存在する場合、衝突が発生している
                    dictMasterMap(master.Name).Add stencil.Name
                End If
            Next master
        End If
    Next stencil

    ' --- Phase 2: Conflict Detection & Resolution ---
    Debug.Print "--- Conflict Scan Started: " & Now & " ---"
    
    Dim mName As Variant
    For Each mName In dictMasterMap.Keys
        Dim associatedStencils As Collection
        Set associatedStencils = dictMasterMap(mName)
        
        ' 2つ以上のステンシルに同じ名前が存在する場合
        If associatedStencils.Count > 1 Then
            conflictFound = True
            HandleConflict mName, associatedStencils, priorityList
        End If
    Next mName

    If Not conflictFound Then
        MsgBox "競合は検出されませんでした。整合性は保たれています。", vbInformation
    End If

    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
End Sub

''' <summary>
''' 衝突したマスターに対する具体的な解決ロジック
''' </summary>
Private Sub HandleConflict(ByVal masterName As Variant, _
                           ByRef stencils As Collection, _
                           ByRef priorityList As Collection)
    
    Dim i As Integer
    Dim bestStencil As String
    Dim foundPriority As Boolean
    
    foundPriority = False
    
    ' 優先度リストに基づき、最も「強い」ステンシルを特定する
    For i = 1 To priorityList.Count
        Dim pName As String
        pName = priorityList(i)
        
        ' 優先リストにあるステンシルが、衝突リストに含まれているか確認
        Dim j As Integer
        For j = 1 To stencils.Count
            If stencils(j) = pName Then
                bestStencil = pName
                foundPriority = True
                Exit For
            End If
        Next j
        If foundPriority Then Exit For
    Next i

    ' 結果の出力
    If foundPriority Then
        Debug.Print "[RESOLVED] Master: " & masterName & " | Conflict detected between: " & _
                    GetCollectionString(stencils) & " | Winner: " & bestStencil
    Else
        ' 優先度が不明な場合は警告としてログ出力
        Debug.Print "[WARNING] Master: " & masterName & " | Multiple sources found: " & _
                    GetCollectionString(stencils) & " | No priority defined!"
    End If
End Sub

''' <summary>
''' Collectionの内容をデバッグ用に文字列化するヘルパー
''' </summary>
Private Function GetCollectionString(ByRef col As Collection) As String
    Dim item As Variant
    Dim s As String
    For Each item In col
        s = s & item & ", "
    Next item
    If Len(s) > 0 Then s = Left(s, Len(s) - 2)
    GetCollectionString = s
End Function

' ==============================================================================
' Test Execution
' ==============================================================================
Public Sub RunConflictTest()
    Dim priorities As New Collection
    ' 優先順位の高い順にステンシル名を登録
    priorities.Add "Standard_Components.vss"
    priorities.Add "Legacy_Parts.vss"
    priorities.Add "Custom_Library.vss"
    
    Call ScanAndResolveMasterConflicts(priorities)
End Sub

4. エンジニアとしての深淵:設計のポイント

このコードを単なる「動くコード」として終わらせてはいけない。以下の3点において、プロフェッショナルな視点を持て。

① 計算量の最適化

前述の通り、`Dictionary` を使用することで、マスター名の検索を $O(1)$ に落としている。全ステンシルの全マスターを総当たりする $O(n^2)$ の設計とは、実行時間のオーダーが全く異なる。大規模なシステムでは、この差が「ツールが動かない」というクレームに直結する。

② 外部設定との連携(Scalability)

上記のコードでは `priorityList` を引数として受け取っている。実務では、これをVBA内にハードコードしてはならない。Excelの管理シートや、外部のJSON/XML設定ファイルから読み込む設計にせよ。
「どのステンシルが優先されるか」というビジネスルールは、頻繁に変更される。ロジック(VBA)とルール(外部設定)を分離すること。これが保守性の極意だ。

③ エラーハンドリングとロギング

`MsgBox` による対話型エラーは、自動化プロセスにおいては「毒」である。本コードでは `Debug.Print` によるロギングを採用している。バッチ処理として実行する場合、結果は標準出力ではなく、テキストログファイルとして物理的に書き出すように拡張すべきだ。後から「なぜこの図面はこの形状になったのか?」という問いに、ログが答えを出してくれる。

結びに

Visio VBAによる自動化は、単に「マウス操作を置き換えること」ではない。「設計のルールをコードによって強制すること」である。

マスターシェイプの競合を放置することは、設計のルールを放棄することと同義だ。今回提示したような、データ構造に基づいた厳格な管理ロジックを組み込むことで、君の作るツールは「便利な道具」から「信頼に値するシステム」へと昇華する。

設計に妥協するな。整合性を守れ。

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