静的な図面から、動的なロジックエンジンへ:外部構成によるSmartShapeのメタプログラミング
図面作成ツールとしてのVisioを、単なる「描画ツール」として扱っているうちは、エンジニアとして二流だ。
現場で求められるのは、複雑な業務ロジックを内包し、入力値に応じて挙動を自律的に変化させる「SmartShape(スマートシェイプ)」の群れである。しかし、多くの開発者が陥る罠がある。それは、ShapeSheetの数式を個々のマスターシェイプに直接書き込んだり、VBAコードの中にハードコードしてしまったりすることだ。
そんな設計では、仕様変更のたびに膨大なマスターシェイプを修正し、バイナリファイルを書き換え、バージョン管理もままならない地獄を招くことになる。
本記事では、設計思想を「図形への書き込み」から「外部定義による注入(Injection)」へとシフトさせる。JSONを用いた外部設定ファイルによるShapeSheetの動的制御、すなわち「SmartShapeのメタプログラミング手法」を伝授しよう。
1. なぜ「ハードコード」は死を招くのか
プロフェッショナルな開発において、ロジック(計算式)とデータ(図形)の分離は鉄則だ。
VisioにおけるSmartShapeの挙動(例:接続された図形との距離に応じて色を変える、特定のセル値に基づいてサイズを制御するなど)は、すべて`ShapeSheet`というセルに格納された数式によって決定される。
もし、100種類のマスターシェイプがあり、その計算ロジックが共通のパラメータに依存していた場合、ロジックの変更は100回の修正作業を意味する。これは「バグの温床」であり、「保守不能なレガシー」への第一歩だ。
理想的なアーキテクチャ
我々が目指すべきは、以下の三層構造である。
1. Configuration Layer (JSON): ロジックの「定義」を記述する。Git等でバージョン管理が可能。
2. Orchestration Layer (VBA): JSONを解析し、図形の属性(Tag)に基づいて適切な数式を「注入」するエンジン。
3. Presentation Layer (Visio Shape): 注入された数式に従って振る舞う、軽量な「器」としての図形。
2. 設計の要:Tagを用いた動的バインディング
すべての図形に数式を配るのではない。図形には「自分は何者か」を示すTag(識別子)を持たせておく。
例えば、あるシェイプの `Shape Data` または `Tag` に `LogicType: “DynamicSize”` という情報を埋め込んでおく。VBAエンジンは、このタグをスキャンし、JSONから該当する数式を検索して適用する。これにより、図形自体はロジックを知らず、ただ「指示を待つ」だけのクリーンな状態を保てる。
3. 実装:JSON駆動型SmartShapeエンジンの構築
ここでは、JSON形式の設定ファイルを用いて、ShapeSheetの特定のセル(例:`Width` や `Color`)に数式を動的に流し込む実装例を示す。
※注:VBAには標準のJSONパーサーがないため、実務では `VBA-JSON` ライブラリ(Tim Hall氏作)を使用するか、後述するように `ScriptControl` を経由してJavaScriptのエンジンを利用するのが定石だ。
構成ファイル例 (`logic_config.json`)
{
"LogicDefinitions": [
{
"TagTarget": "DynamicSize",
"TargetCells": {
"Width": "Width@ = Max(1 in, ConnectedWidth*2)",
"Height": "Height@ = 1.5 in"
}
},
{
"TagTarget": "ColorAlert",
"TargetCells": {
"FillRGB": "RGB(255, 0, 0)"
}
}
]
}
プロダクション・コード例 (VBA)
Option Explicit
' ======================================================================================
' Module: SmartShapeEngine
' Description: JSON定義に基づき、図形のShapeSheetに数式を動的に注入する
' ======================================================================================
' ※ 事前に Microsoft Script Control 2.0 などの参照設定、
' もしくは VBA-JSON ライブラリの導入を前提とする。
' ここでは概念を示すため、擬似的なJSON解析ロジックで記述する。
Public Sub ApplyDynamicLogic(ByVal targetPage As Visio.Page, ByVal configPath As String)
Dim shp As Visio.Shape
Dim jsonContent As String
Dim logicDict As Object ' Dictionary: Tag -> CellMap
On Error GoTo ErrorHandler
' 1. 設定ファイルの読み込み
jsonContent = ReadFile(configPath)
' 2. JSONのパース (ここでは解析済みオブジェクトが返ると仮定)
' 実際には JsonConverter.ParseJson(jsonContent) 等を使用
Set logicDict = ParseJsonToDictionary(jsonContent)
' 描画停止によるパフォーマンス最適化
Application.ScreenUpdating = False
' 3. ページ内の全シェイプを走査
For Each shp In targetPage.Shapes
Dim tag As String
tag = shp.Tag ' 図形に設定された識別子を取得
' 4. タグが定義済みロジックに存在するか照合
If logicDict.Exists(tag) Then
Dim cellMap As Object
Set cellMap = logicDict(tag) ' CellName -> Formula のペア
Dim cellName As Variant
For Each cellName In cellMap.Keys
' 5. ShapeSheetへの数式注入
' CellsU (Universal Name) を使用することで言語依存を回避する
InjectFormula shp, CStr(cellName), CStr(cellMap(cellName))
Next cellName
End If
Next shp
CleanUp:
Application.ScreenUpdating = True
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
''' <summary>
''' 数式注入の堅牢なラップメソッド
''' </summary>
Private Sub InjectFormula(ByRef shp As Visio.Shape, ByVal cellName As String, ByVal formula As String)
On Error Resume Next
Dim targetCell As Visio.Cell
Set targetCell = shp.CellsU(cellName)
If Not targetCell Is Nothing Then
' 数式を直接代入。ShapeSheetの計算エンジンが即座に評価する
targetCell.FormulaU = formula
If Err.Number <> 0 Then
Debug.Print "Error injecting [" & cellName & "] to shape [" & shp.Name & "]: " & Err.Description
Err.Clear
End If
Else
Debug.Print "Cell [" & cellName & "] not found in shape [" & shp.Name & "]"
End If
On Error GoTo 0
End Sub
' --- 以下、ユーティリティ関数(実装の詳細は省略) ---
Private Function ReadFile(path As String) As String
' ファイル読み込みロジック
End Function
Private Function ParseJsonToDictionary(json As String) As Object
' JSONパースロジック(VBA-JSON等の利用を推奨)
End Function
4. アーキテクトとしての「極限の知見」
この実装を実務に投入する際、多くのジュニアエンジニアが見落とし、後にプロジェクトを破綻させるポイントが3つある。
① `CellsU` と `FormulaU` の絶対使用
Visio VBAにおいて、`Cells(“Width”)` のような非ユニバーサル名を使用するのは、プロフェッショナルとしては言語道断だ。ユーザーのVisioが日本語版であれば `幅`、英語版であれば `Width` となり、コードは即座に死ぬ。常に Universal Name (`U`) を使用せよ。
② COMインターフェースのオーバーヘッド
ページ内のシェイプが数千個に及ぶ場合、`For Each shp In targetPage.Shapes` ループの中で頻繁に `Application.ScreenUpdating = True` を行うと、描画更新のたびにCOM通信のオーバーヘッドが発生し、パフォーマンスが指数関数的に低下する。
「処理の開始前に停止、終了後に一括更新」。これは鉄則だ。
③ 循環参照とバリデーションの欠如
外部から注入する数式は「外部から来た不審者」だ。JSONに記述された数式が間違っていれば(例:`Width@ = ERROR`)、VisioのShapeSheet自体が壊れた状態になる。
`InjectFormula` 内で `On Error Resume Next` を使いつつ、エラーログを詳細に残す設計にしているのはそのためだ。本番環境では、注入前に数式の構文チェックを行う「Dry Runモード」を実装することを強く推奨する。
結論:図形を「コード」として扱え
SmartShapeの挙動を外部化することは、単なる効率化ではない。それは、Visioという描画プラットフォームの上に、独自の実行環境(Runtime)を構築する行為である。
ロジックをJSONへ、器をShapeへ、そして制御をVBAへ。
この分離が完成したとき、君が作るツールは「単なる図面」を超え、ビジネスプロセスを動的に表現する「高度なシミュレーター」へと昇華する。
設計に妥協するな。その一行のハードコードが、将来の君自身を苦しめることになる。
