整合性の崩壊を防げ: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による自動化は、単に「マウス操作を置き換えること」ではない。「設計のルールをコードによって強制すること」である。
マスターシェイプの競合を放置することは、設計のルールを放棄することと同義だ。今回提示したような、データ構造に基づいた厳格な管理ロジックを組み込むことで、君の作るツールは「便利な道具」から「信頼に値するシステム」へと昇華する。
設計に妥協するな。整合性を守れ。
