混沌としたステンシルに秩序を。名前の類似度でマスターシェイプを自動整理する極限のVBA術
こんにちは。現場の自動化を支えるチーフアーキテクトです。
Visioを使って大規模なシステム構成図やネットワーク図を描いていると、必ずと言っていいほど直面する「魔の領域」があります。それは、「命名規則が崩壊し、カオスと化したステンシル」です。
「`Server_TypeA`」「`Srv_01`」「`Server-New`」……。
同じ意味なのに名前がバラバラ。これでは、ユーザーが図面を描く際に、目的のシェイプを探し回るだけで時間が過ぎてしまいます。
今日は、そんな「名前の乱れ」を、文字列の数学的な「距離」を用いて自動的に検知し、論理的なグループに整理するための高度なVBAテクニックを伝授します。マクロの記録から一歩踏み出し、「オブジェクトの性質」と「アルゴリズム」を組み合わせて、Visioを真に賢いツールへと進化させましょう。
1. アーキテクトの視点:Master(マスター)とShape(シェイプ)の違い
コードを書く前に、まず最も重要な「オブジェクトのライフサイクル」について整理しておきましょう。ここを混同すると、プログラムはすぐに不安定になります。
- Master(マスターシェイプ): ステンシルの中に格納されている「設計図(金型)」です。メモリ上には定義として存在しますが、図面にはまだ存在していません。
- Shape(シェイプ): マスターから「実体化(ドロップ)」された、図面上に配置された個々のオブジェクトです。
今回私たちが操作するのは、図面上にある図形ではなく、ステンシルの中に眠っている「設計図(Master)」です。マスターを整理することは、図面全体に配置されるすべての図形の「親」を整理することに他なりません。
2. 核心のアルゴリズム:レーベンシュタイン距離(Levenshtein Distance)
「名前が似ている」という感覚を、コンピュータに理解させるにはどうすればいいでしょうか?
「`Server`が含まれていたら」という単純な判定では、精度が足りません。そこで、プロの現場で使われる「レーベンシュタイン距離」というアルゴリズムを導入します。
これは、ある文字列を別の文字列に変えるために、「あと何回の操作(挿入・削除・置換)が必要か」を数値化したものです。
- `Server` と `Server_01` の距離は小さい(似ている)。
- `Server` と `Switch` の距離は大きい(似ていない)。
この「距離」を計算することで、名前の揺らぎを数学的に捉えることができるのです。
3. 実装:マスターシェイプ整理自動化スクリプト
それでは、実際に使えるコードを見ていきましょう。このスクリプトは、指定したステンシル内のマスターをスキャンし、名前の類似度に基づいて「グループ名」を判定するロジックの雛形です。
Option Explicit
''' <summary>
''' ステンシル内のマスターシェイプを名前の類似度に基づいて整理するメインルーチン
''' </summary>
Sub OrganizeMastersBySimilarity()
Dim vsoStencil As Visio.Document
Dim vsoMaster As Visio.Master
Dim masterNames() As String
Dim i As Long, j As Long
Dim similarityThreshold As Double
' --- 設定エリア ---
' 整理したいステンシル名を指定してください
On Error Resume Next
Set vsoStencil = Visio.Documents("MyCustomStencil.vssx")
On Error GoTo 0
If vsoStencil Is Nothing Then
MsgBox "指定されたステンシルが見つかりません。パスを確認してください。", vbCritical
Exit Sub
End If
' 類似度のしきい値(0.0〜1.0) 1.0に近いほど「完全に一致」
' ここでは「編集距離」を変換して利用するロジックを想定
similarityThreshold = 0.7
' ------------------
Debug.Print "--- マスター解析開始 ---"
' 1. 全てのマスター名を配列に格納(計算効率のため)
ReDim masterNames(vsoStencil.Masters.Count - 1)
For i = 0 To vsoStencil.Masters.Count - 1
' NameU (Unified Name) を使うのがプロの鉄則。
' Nameはローカル、NameUはシステム全体で一意のユニークな名前。
masterNames(i) = vsoStencil.Masters(i).NameU
Next i
' 2. 類似度によるグループ化判定(二重ループによる比較)
' 注意:マスター数が膨大な場合、計算量は O(n^2) になるため注意が必要
For i = LBound(masterNames) To UBound(masterNames)
For j = i + 1 To UBound(masterNames)
Dim dist As Double
dist = CalculateSimilarity(masterNames(i), masterNames(j))
If dist >= similarityThreshold Then
' 類似度が高いものを見つけた場合の処理
Debug.Print "【類似発見】: '" & masterNames(i) & "' <-> '" & masterNames(j) & "' (Score: " & Format(dist, "0.00") & ")"
' ここで「新しいステンシルへのコピー」や「タグ付け」の処理を行う
' 今回はデバッグ出力に留めます
End If
Next j
Next i
MsgBox "解析が完了しました。イミディエイトウィンドウを確認してください。", vbInformation
End Sub
''' <summary>
''' 2つの文字列の類似度を0.0〜1.0で返す関数
''' </summary>
Private Function CalculateSimilarity(str1 As String, str2 As String) As Double
Dim len1 As Long, len2 As Long, maxLen As Long
Dim distance As Long
len1 = Len(str1)
len2 = Len(str2)
' 文字列が空の場合は回避
If len1 = 0 Or len2 = 0 Then
CalculateSimilarity = 0
Exit Function
End If
' レーベンシュタイン距離の計算
distance = LevenshteinDistance(str1, str2)
' 最大長を基準に、0.0(不一致)〜1.0(一致)に正規化
maxLen = IIf(len1 > len2, len1, len2)
CalculateSimilarity = 1 - (CDbl(distance) / CDbl(maxLen))
End Function
''' <summary>
''' レーベンシュタイン距離の計算アルゴリズム(動的計画法)
''' </summary>
Private Function LevenshteinDistance(s As String, t As String) As Long
Dim i As Long, j As Long
Dim cost As Long
Dim d() As Long
Dim n As Long, m As Long
n = Len(s)
m = Len(t)
If n = 0 Then LevenshteinDistance = m: Exit Function
If m = 0 Then LevenshteinDistance = n: Exit Function
ReDim d(0 To n, 0 To m)
For i = 0 To n: d(i, 0) = i: Next i
For j = 0 To m: d(0, j) = j: Next j
For i = 1 To n
For j = 1 To m
If Mid(s, i, 1) = Mid(t, j, 1) Then
cost = 0
Else
cost = 1
End If
' 最小値を計算(挿入、削除、置換)
d(i, j) = Application.WorksheetFunction.Min( _
d(i - 1, j) + 1, _
d(i, j - 1) + 1, _
d(i - 1, j - 1) + cost)
Next j
Next i
LevenshteinDistance = d(n, m)
End Function
4. ここがエンジニアの「こだわり」:陥りやすい罠と回避策
このスクリプトを実戦投入するにあたって、初心者が陥りやすい「3つの落とし穴」を解説しておきます。
① `Name` ではなく `NameU` を使え
Visio VBAにおいて、`Master.Name` はユーザーに見える名前ですが、`Master.NameU` はシステムが管理するユニークな名前(Unified Name)です。
多言語環境や、名前の一部に特殊文字が含まれる場合、`Name` を使うと予期せぬエラーや重複判定ミスを招きます。「オブジェクトの識別には必ずNameUを使う」。これが鉄則です。
② 計算量の爆発(O(n²) の恐怖)
上記のコードでは、マスター同士を総当たりで比較しています(二重ループ)。
マスターが100個なら $100 \times 100 = 10,000$ 回の計算で済みますが、もし1,000個あると $1,000,000$ 回になります。
大規模なステンシルを扱う場合は、あらかじめ「先頭の数文字が一致するものだけを比較する」といったプリフィルタリングを挟むことで、劇的にパフォーマンスを向上させることができます。
③ エラーハンドリングの欠如
ステンシルが読み込まれていない、あるいは書き込み権限がない場合に、エラーでマクロが止まるのは「素人」の仕事です。
`On Error Resume Next` を乱用するのではなく、オブジェクトが存在するかどうかを `If Not vsoStencil Is Nothing Then` のように、「型を確認してから進む」という作法を身につけてください。
まとめ:自動化の先にあるもの
「名前が似ているものを探す」という一見単純な作業に、数学的なアルゴリズムを組み込む。これができると、Visio VBAの扱いの幅は飛躍的に広がります。
単に「マクロの記録」を書き換えるのではなく、「データ構造はどうなっているか?」「どうすれば効率的に計算できるか?」という視点を持つこと。これが、単なるユーザーから、業務を設計するエンジニアへと進化する境界線です。
ここをクリアすれば、Visio VBAの基本はバッチリですよ。
さあ、次はもっと複雑な、データの自動生成や、外部データベースとの連携に挑戦してみましょう。応援しています!
