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

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

静的な図面から、動的なロジックエンジンへ:外部構成による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へ。
この分離が完成したとき、君が作るツールは「単なる図面」を超え、ビジネスプロセスを動的に表現する「高度なシミュレーター」へと昇華する。

設計に妥協するな。その一行のハードコードが、将来の君自身を苦しめることになる。

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