静的な図形から「論理エンジン」へ:外部JSONによるShapeSheetの動的注入とメタプログラミング
図面を描くためのツールとしてのVisio。その認識は、シニアエンジニアの視点から見れば、あまりに表層的だ。
真に高度なシステム設計において、Visioは「動的な論理モデルを可視化するための実行環境(Runtime Environment)」であるべきだ。マスターシェイプにハードコードされた数式は、仕様変更のたびにステンシルを書き換え、再配布するという、保守性の低い「技術的負債」を生む。
本稿では、マスターシェイプの挙動を司るShapeSheetの数式を、外部のJSON設定ファイルから動的に注入(Injection)するという、メタプログラミング的手法について解説する。これは、図形を単なるグラフィックから、外部のロジックに同期する「スマートなエージェント」へと昇華させるプロセスである。
1. アーキテクチャの設計思想:ロジックの分離
従来のVisio開発では、ロジック(ShapeSheetの数式)とデータ(図形上の値)が密結合していた。これを以下の三層構造に分離する。
1. Configuration Layer (JSON): 形状の制約、計算式、挙動のパラメータを定義。
2. Injection Engine (VBA): JSONをパースし、VisioのObject Modelを通じてShapeSheetへ書き込む制御層。
3. Execution Layer (Visio ShapeSheet): 注入された数式に基づき、リアルタイムに挙動を決定する実行層。
この分離により、VBAコードを一切触ることなく、JSONを書き換えるだけで図形の「物理法則」を制御することが可能になる。
2. 実装の核心:JSONパースとShapeSheetへの動的書き込み
VBAにはネイティブのJSONパーサーが存在しない。ここでは、実務上の安定性を考慮し、`Microsoft Script Control` または `MSXML2.DOMDocument` を介したアプローチ、あるいは現代的な `.NET` 資産を利用したインターフェースを想定するが、ここでは最も汎用性の高い「外部構成定義に基づいた数式注入」のコアロジックを示す。
構成例:`logic_config.json`
各マスターシェイプの特定のセルに対して、どのような数式を適用するかを定義する。
{
"MasterShapes": [
{
"Name": "ProcessBlock",
"Logic": [
{ "Cell": "Width", "Formula": "Width + 0.5in" },
{ "Cell": "User.ProcessStatus", "Formula": "IF(Width > 2in, 1, 0)" },
{ "Cell": "FillForeColor", "Formula": "RGB(255, 0, 0)" }
]
}
]
}
実装:Injection Engine (VBA)
ここでは、メモリリークを防ぎ、大量のシェイプを処理する際のパフォーマンスを最適化したコードを示す。
Option Explicit
' Windows APIの宣言(プロセスの安定性とタイミング制御のため)
If VBA7 Then
Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As LongPtr)
Else
Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
End If
''' <summary>
''' マスターシェイプの挙動を外部定義から動的に書き換えるメインルーチン
''' </summary>
Public Sub InjectSmartShapeLogic()
Dim vsoApplication As Visio.Application
Dim vsoStencil As Visio.Document
Dim vsoMaster As Visio.Master
Dim vsoShape As Visio.Shape
Dim jsonContent As String
Dim i As Long
Set vsoApplication = Visio.Application
' 1. 高速化のための最適化設定
' 画面更新とイベントを停止し、描画負荷を最小限に抑える
vsoApplication.ScreenUpdating = False
vsoApplication.EnableEvents = False
On Error GoTo ErrorHandler
' 2. JSONファイルの読み込み (本来はここでJSONパーサーを呼び出す)
' 擬似的にパース済みのデータ構造を想定
jsonContent = LoadJsonFile("C:\Config\logic_config.json")
' 3. ステンシルのロード
' 既存のステンシルを操作するか、動的に生成する
Set vsoStencil = vsoApplication.Documents.OpenEx("C:\Stencils\CustomLogic.vssx", visOpenDocked)
' 4. マスターシェイプへのロジック注入
' ここでは概念を示すため、特定のマスターをループ処理する
For Each vsoMaster In vsoStencil.Masters
' JSON内のMasterNameと一致するか判定(ロジック簡略化)
If vsoMaster.Name = "ProcessBlock" Then
Debug.Print "Injecting logic into Master: " & vsoMaster.Name
' マスターシェイプ自体に数式を書き込む
' ※注意: マスターへの書き込みは、すべてのインスタンスに影響する
ApplyLogicToMaster vsoMaster
End If
Next vsoMaster
MsgBox "Logic Injection Completed Successfully.", vbInformation
CleanUp:
' 5. リソースの明示的な解放と状態復旧
' オブジェクトのライフサイクルを管理し、メモリリークを防止する
Set vsoMaster = Nothing
Set vsoStencil = Nothing
Set vsoApplication = Nothing
vsoApplication.ScreenUpdating = True
vsoApplication.EnableEvents = True
Exit Sub
ErrorHandler:
MsgBox "Critical Error: " & Err.Description, vbCritical
Resume CleanUp
End Sub
''' <summary>
''' マスターシェイプの各セルに対して数式を適用する
''' </summary>
Private Sub ApplyLogicToMaster(ByRef targetMaster As Visio.Master)
Dim targetShape As Visio.Shape
' マスターの「最初のシェイプ」を取得してShapeSheetを操作
' マスターの構造によっては、特定のインデックスを指定する必要がある
Set targetShape = targetMaster.Shapes(1)
On Error Resume Next
' セルへの数式注入
' セルが存在しない場合に備え、エラーハンドリングを厳格に行う
With targetShape
.Cells("Width").Formula = "Width + 0.5in"
.Cells("User.ProcessStatus").Formula = "IF(Width > 2in, 1, 0)"
' カラーなどの動的な制御
.Cells("FillForeColor").Formula = "RGB(255, 0, 0)"
End With
If Err.Number <> 0 Then
Debug.Print "Cell Injection Failed: " & Err.Description
Err.Clear
End If
On Error GoTo 0
End Sub
''' <summary>
''' ファイル読み込みのヘルパー関数
''' </summary>
Private Function LoadJsonFile(filePath As String) As String
' 実務ではFileSystemObject等を用いて実装
LoadJsonFile = "{...}"
End Function
3. 極限の知見:パフォーマンスとメモリ管理の要諦
この手法をエンタープライズレベルのシステムに組み込む際、シニアエンジニアが直面する「壁」がいくつかある。
A. ShapeSheet書き込みの計算コスト
ShapeSheetの数式を書き換えるたびに、Visioは図形全体の再計算(Recalculation)を試みる。数千のシェイプに対して個別に `Cells(“…”).Formula = …` を実行すると、計算コストが指数関数的に増大する。
- 対策: 書き込みフェーズでは必ず `Application.ScreenUpdating = False` を適用すること。また、可能な限り「マスター」に対して一度だけ書き込みを行い、個別の「インスタンス(Shape)」への書き込みは最小限に留めるのが鉄則だ。
B. COMオブジェクトのライフサイクル管理
VBAにおいて、`Set obj = Nothing` は単なる作法ではない。Visioのような巨大なCOMオートメーション環境では、参照カウントが適切にデクリメントされないと、Visioプロセスがメモリを掴み続け、最終的に `Out of Memory` または `Access Violation` を引き起こす。
- 対策: ループ内でオブジェクトを生成する場合、必ずループの末尾で `Set = Nothing` を実行せよ。特に `Master` オブジェクトは、ステンシルへの参照を保持しているため、解放が極めて重要だ。
C. Windows APIによる制御
大量のデータ注入中、VisioのUIが「応答なし」になるのを防ぐには、`DoEvents` ではなく、Windows APIの `Sleep` やメッセージループを適切に制御し、OSに制御を戻す必要がある。これにより、注入プロセス中もユーザーがシステムの状態を監視できる「生存確認」が可能になる。
4. 結論
マスターシェイプのShapeSheetを外部から制御する手法は、単なる自動化のテクニックではない。それは、「図面をデータ駆動型の動的モデルへと変換する」というアーキテクチャの転換である。
JSONという汎用的なインターフェースを採用することで、Visioはエンジニアリング・ロジックを分離・管理可能な「高度なビジュアライゼーション・エンジン」へと進化する。レガシーなVBA環境であっても、この設計思想を導入することで、モダンなマイクロサービス的アプローチに近い、保守性の高い図面管理システムを構築できるのだ。
技術の真髄は、既存のツールの限界を理解し、その限界を突破するための「構造」を設計することにある。
