【入門編】【上級】マスターシェイプの「動作(SmartShape)」を外部スクリプトで動的に書き換える – Visio VBA解析バイブル

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

【極限の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の基本はバッチリですよ。
さあ、次はもっと複雑な、複数の図形が相互に影響し合う「ネットワーク・ロジック」の注入にも挑戦してみてください。

応援していますよ。

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