【極限のVisio VBA】マスターシェイプの「魂」を外部から注入する:JSONによるSmartShapeの動的制御術
こんにちは。Visioの深淵へようこそ。
「マクロの記録」ボタンを押して、記録されたコードを眺めて「ふむふむ、こう動くのか」と納得する。それは素晴らしい第一歩です。しかし、あなたがもし、数千個の図形が複雑に絡み合う大規模なシステム設計図や、動的に挙動が変わる高度なシミュレーションツールを作りたいと考えているなら、そのやり方ではすぐに限界が訪れます。
今日、私たちが挑むのは「図形に魂(ロジック)を外部から吹き込む」という、メタプログラミングの領域です。
通常、図形の動き(例えば、特定の条件で色が変わる、サイズが自動で変わるなど)は、Visio内部のShapeSheetという数式シートに書き込まれています。これをVBAの中にベタ書き(ハードコード)するのは、設計としては「悪」です。なぜなら、ルールが変わるたびにプログラムを書き換え、再コンパイルしなければならないからです。
そこで今回は、「挙動の定義をJSONファイルという外部の設計図に切り出し、VBAを通じてマスターシェイプへ動的に注入する」という、プロフェッショナルなアーキテクチャを解説します。
1. アーキテクチャの全体像:ロジックとデータの分離
まず、頭の中に以下の図をイメージしてください。
[ 外部設計図 (JSON) ] <-- 「この図形は、幅が10を超えたら赤くなれ」という指示
| (読み込み)
v
[ VBAエンジン (Controller) ] <-- 指示を解釈し、Visioの言語に翻訳する
| (ShapeSheetへの注入)
v
[ Visioマスターシェイプ ] <-- 魂(数式)を宿した図形
| (自動反映)
v
[ 描画された図形 (Instances) ] <-- ユーザーが操作する実際の図形
この設計の最大のメリットは、「VBAのコードを一行も触ることなく、JSONファイルを書き換えるだけで、図形の動きを完全にコントロールできる」点にあります。これが、保守性の高いシステムを作るための「極限の知見」です。
2. 実践:動的注入システムの構築
では、具体的な実装を見ていきましょう。今回は、簡略化のために「JSONのパース(解析)部分は文字列操作で行う」という、依存関係の少ない実装例を示します。
ステップ1:外部設定ファイル (config.json)
まず、図形の挙動を定義したJSONファイルを用意します。
{
"ShapeBehavior": [
{
"CellName": "Width",
"Formula": "=GUARD(Width * 1.5)"
},
{
"CellName": "FillForeColor",
"Formula": "=IF(Width > 10, RGB(255,0,0), RGB(0,255,0))"
}
]
}
*※「幅が10を超えたら赤くなる」というロジックを、ここに閉じ込めています。*
ステップ2:VBAによる注入エンジン
ここが心臓部です。マスターシェイプの`ShapeSheet`を直接操作します。
Option Explicit
' =====================================================================
' 魂の注入エンジン (Master Shape Injector)
' =====================================================================
Sub InjectBehaviorFromJson()
Dim stencil As Visio.Document
Dim master As Visio.Master
Dim jsonContent As String
Dim filePath As String
' 1. 設定ファイルのパスを指定
filePath = ThisWorkbook.Path & "\config.json"
' 2. JSONファイルをテキストとして読み込む
On Error Resume Next
Dim fso As Object
Set fso = CreateObject("Scripting.FileSystemObject")
If Not fso.FileExists(filePath) Then
MsgBox "設定ファイルが見つかりません: " & filePath, vbCritical
Exit Sub
End If
jsonContent = fso.OpenTextFile(filePath, 1).ReadAll
On Error GoTo 0
' 3. 対象となるステンシル(マスター)を特定
' ここでは現在開いているドキュメント内の「MyStencil」を想定
On Error Resume Next
Set stencil = Visio.Documents("MyStencil.vssx")
If stencil Is Nothing Then
MsgBox "対象のステンシルが開かれていません。", vbExclamation
Exit Sub
End If
' 4. マスターシェイプを取得 (名前で指定)
Set master = stencil.Masters("SmartBox")
If master Is Nothing Then
MsgBox "指定されたマスターが見つかりません。", vbExclamation
Exit Sub
End If
On Error GoTo 0
' 5. JSONの解析とShapeSheetへの書き込み
' 本来はJSONライブラリを使うべきですが、今回は学習のため簡易的な文字列解析を行います
ParseAndApplyBehavior master, jsonContent
MsgBox "マスターシェイプへの魂の注入が完了しました。", vbInformation
End Sub
' ---------------------------------------------------------------------
' ShapeSheetへ数式を書き込むコアロジック
' ---------------------------------------------------------------------
Private Sub ParseAndApplyBehavior(ByRef targetMaster As Visio.Master, ByVal jsonText As String)
Dim lines() As String
Dim i As Long
Dim cellName As String
Dim formula As String
' 改行で分割して一行ずつ処理(簡易的なパース)
lines = Split(jsonText, vbCrLf)
' 画面更新を停止してパフォーマンスを稼ぐ(重要!)
Application.ScreenUpdating = False
For i = LBound(lines) To UBound(lines)
' "CellName": "..." のパターンを探す
If InStr(lines(i), """CellName"":") > 0 Then
cellName = ExtractValue(lines(i), "CellName")
' 次の行にある "Formula": "..." を取得
If i + 1 <= UBound(lines) Then
formula = ExtractValue(lines(i + 1), "Formula")
' --- ここが極限のポイント ---
' CellsU を使用することで、言語設定に依存しない「ユニバーサル名」でアクセスする
' これをしないと、英語版Visioで動かした時にエラーになる
On Error Resume Next
targetMaster.CellsU(cellName).FormulaU = formula
If Err.Number <> 0 Then
Debug.Print "Error applying " & cellName & ": " & Err.Description
Err.Clear
End If
On Error GoTo 0
End If
End If
Next i
Application.ScreenUpdating = True
End Sub
' 文字列からJSONの値を抽出する補助関数
Private Function ExtractValue(ByVal line As String, ByVal key As String) As String
Dim startPos As Long, endPos As Long
Dim searchKey As String
searchKey = """" & key & """: """
startPos = InStr(line, searchKey)
If startPos > 0 Then
startPos = startPos + Len(searchKey)
endPos = InStr(startPos, line, """")
ExtractValue = Mid(line, startPos, endPos - startPos)
Else
' キーが次の行にある場合を考慮
searchKey = """" & key & """: " ' コロンの後のダブルクォートなしパターン
startPos = InStr(line, searchKey)
If startPos > 0 Then
startPos = startPos + Len(searchKey)
endPos = InStr(startPos, line, """")
ExtractValue = Mid(line, startPos, endPos - startPos)
End If
End If
End Function
3. 伝説のアーキテクトが教える「ハマりどころ」と回避策
このコードを動かす際、初心者が必ずと言っていいほど陥る罠が3つあります。ここをクリアできれば、あなたはもう「ただのマクロ使い」ではありません。
① `Cells` ではなく `CellsU` を使え
これが最も重要です。Visioには、表示名(例:`Width`)と内部名(Universal Name)があります。日本語版Visioでは表示名が変わることがありますが、`CellsU` を使って英語のユニバーサル名で指定すれば、世界中のどの言語版Visioでも動く堅牢なコードになります。
② マスターとインスタンスの生存期間
今回は「マスター(型)」を書き換えています。マスターのShapeSheetを書き換えると、そのマスターからドラッグ&ドロップして配置されたすべての図形(インスタンス)に、一瞬で新しい挙動が適用されます。
もし「特定の1個の図形だけ」を変えたい場合は、`master.CellsU` ではなく、選択中の `ActiveWindow.Selection.Item(1).CellsU` を対象にする必要があります。用途に合わせて使い分けましょう。
③ パフォーマンスの重み:`ScreenUpdating`
図形の数式を大量に書き換えるとき、Visioは一回一回「画面を描画し直そう」とします。これが非常に重い。
`Application.ScreenUpdating = False` は、単なるテクニックではなく、「システムのリソースを制御する」というエンジニアの責務です。
4. まとめ:次なるステップへ
今回の手法を使えば、あなたはVisioを「単なる作図ツール」から、「外部データによって挙動が変化するダイナミックなシミュレーター」へと昇華させることができます。
1. ロジックを外部化(JSON)する。
2. VBAは「運び屋(Controller)」に徹する。
3. `CellsU` で言語の壁を越える。
ここをマスターすれば、Visio VBAの基本はバッチリですよ。
さあ、次はもっと複雑な、複数の図形が相互に影響し合う「ネットワーク・ロジック」の注入にも挑戦してみてください。
応援していますよ。
