【テクニカル・上級編】【上級】SQL Server上の図形定義データからステンシルを動的に生成するパイプライン – Visio VBA解析バイブル

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

【極限の知見】SQL ServerからVisioステンシルを動的に紡ぎ出す:データ駆動型図形定義パイプラインの構築

静的なステンシル(.vssx)を使い、手作業で図形を配置する。そんな光景は、エンタープライズ規模のシステム設計においては「技術的負債」でしかない。

設計変更が頻繁に起こる大規模インフラや、数千のコンポーネントを管理するシステムにおいて、図形定義(マスターシェイプ)と実データの乖離は致命的なミスを招く。真のアーキテクトが目指すべきは、「図形定義そのものをデータ(SQL Server)から動的に生成するパイプライン」の構築である。

本稿では、データベースのスキーマを読み解き、Visioのステンシルおよびマスターシェイプを自動生成・同期させる、極限の自動化アーキテクチャについて詳述する。

1. アーキテクチャの設計思想:Single Source of Truth

図形(Shape)の属性、例えば「デバイス種別」「IPアドレス」「ポート数」といった情報は、データベースが持つべき「真実の源(Single Source of Truth)」である。

我々が構築するのは、以下のフローを持つパイプラインだ。

1. Data Layer: SQL Server上の定義テーブル(Shape Definition Table)からメタデータを取得。
2. Orchestration Layer: VBAによる制御ロジック。ADOを用いてデータをストリームとして読み込み、Visioのオブジェクトモデルへと変換。
3. Presentation Layer: 動的に生成されたステンシルを介して、エンジニアが最新の定義に基づいた図面を描画。

この設計により、DBの定義を変更するだけで、Visio上の「使える部品」が瞬時に更新される世界を実現する。

2. メモリ管理とオブジェクトのライフサイクル

Visio VBAにおける最大の落とし穴は、COMオブジェクトの不適切な解放によるメモリリークである。特に、ループ内で大量の `Master` や `ShapeData` オブジェクトを生成・操作する場合、単に `Set obj = Nothing` と記述するだけでは不十分なケースがある。

Visioの内部的な参照カウントが残存すると、プロセスのメモリ使用量は指数関数的に増大し、最終的には `Out of Memory` でクラッシュする。

高度なメモリ管理戦略

  • ScreenUpdatingの制御: 描画更新を停止し、CPUリソースをロジックに集中させる。
  • オブジェクトの明示的破棄: ループの各イテレーションにおいて、使用したオブジェクトを確実に `Nothing` にし、さらに必要に応じて `DoEvents` を挟むことで、OSに制御を戻し、メモリのクリーンアップを促す。
  • エラーハンドリングの徹底: 予期せぬエラー発生時でも、生成途中のステンシルを破棄し、メモリを解放する `CleanUp` ルーチンを実装する。

3. 実装:SQL Server連携型ステンシル・ジェネレーター

以下に、SQL Serverから定義を取得し、新しいステンシルを作成してマスターシェイプを注入する、実戦的なコードの雛形を示す。

Option Explicit

' ==============================================================================
' Module: StencilGenerator
' Description: SQL Serverから図形定義を読み込み、動的にステンシルを生成する
' ==============================================================================

' Windows APIを利用した高度な制御が必要な場合はここに宣言を行う
' Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As LongPtr)

Public Sub GenerateDynamicStencil()
    Dim conn As Object ' ADODB.Connection
    Dim rs As Object   ' ADODB.Recordset
    Dim vApp As Visio.Application
    Dim vStencil As Visio.Document
    Dim vMaster As Visio.Master
    Dim strConn As String
    Dim sql As String
    
    ' --- 設定領域 ---
    ' SQL Serverへの接続文字列(環境に合わせて調整)
    strConn = "Provider=SQLOLEDB;Data Source=YOUR_SERVER;Initial Catalog=YOUR_DB;Integrated Security=SSPI;"
    ' 図形定義を取得するクエリ
    sql = "SELECT ShapeType, ShapeName, Description, DefaultColor FROM ShapeDefinitions"
    ' ----------------
    
    On Error GoTo ErrorHandler
    
    Set vApp = Visio.Application
    vApp.ScreenUpdating = False ' パフォーマンス最適化:描画停止
    
    ' 1. SQL Serverへの接続
    Set conn = CreateObject("ADODB.Connection")
    conn.Open strConn
    
    Set rs = conn.Execute(sql)
    
    ' 2. 新規ステンシル(Document)の作成
    ' 注: 既存のステンシルを更新する場合は、Openメソッドを使用する
    Set vStencil = vApp.Documents.Add("") ' 空のドキュメントを作成
    vStencil.Type = visDocument stencil
    vStencil.SaveAs "C:\Temp\Dynamic_System_Stencil.vssx"
    
    Debug.Print "Pipeline Started: " & Now
    
    ' 3. データに基づいたマスターシェイプの生成ループ
    Do While Not rs.EOF
        ' マスターの追加
        ' 引数: Name, ShapeType (ここでは簡易化のためデフォルトを使用)
        Set vMaster = vStencil.Masters.Add(rs.Fields("ShapeName").Value)
        
        ' マスターの属性(Shape Data)の設定
        ' ここがエンジニアの腕の見せ所である
        With vMaster
            ' ShapeDataセルの操作は非常に重いため、最小限に留める
            ' 例: 説明文をShape Dataとして登録
            .Cells("ShapeData.Description").FormulaU = """" & rs.Fields("Description").Value & """"
            
            ' 色などの属性を定義
            ' ※実際には、事前に定義されたShape Dataフィールドがマスターに存在する必要がある
            ' .Cells("ShapeData.Color").FormulaU = rs.Fields("DefaultColor").Value
        End With
        
        Debug.Print "Created Master: " & rs.Fields("ShapeName").Value
        
        rs.MoveNext
    Loop
    
    MsgBox "Stencil Generation Completed Successfully.", vbInformation
    
CleanUp:
    ' 4. リソースの明示的解放(極めて重要)
    On Error Resume Next
    If Not rs Is Nothing Then
        rs.Close
        Set rs = Nothing
    End If
    If Not conn Is Nothing Then
        conn.Close
        Set conn = Nothing
    End If
    If Not vStencil Is Nothing Then
        ' 保存済みの場合は、ここで閉じても良い
        ' vStencil.Close
        Set vStencil = Nothing
    End If
    
    vApp.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    MsgMsg = "Critical Error: " & Err.Description
    Debug.Print ErrMsg
    MsgBox ErrMsg, vbCritical
    Resume CleanUp
End Sub

4. 極限の最適化:Shape Dataの管理

上記のコードでは、`vMaster.Cells(“ShapeData.Description”).FormulaU` という記述を用いている。ここで注意すべきは、「マスターシェイプ自体に、あらかじめ Shape Data フィールドが定義されている必要がある」という点だ。

動的にフィールドそのものを作ることはVisioのオブジェクトモデル上、非常に困難かつ不安定である。したがって、アーキテクチャとしては以下の二段構えを推奨する。

1. Template Stencilの用意: 必要なShape Data(IP, MAC, Model, Location等)があらかじめ定義された「空のマスター」を持つテンプレートを作成しておく。
2. Data Injection: SQL Serverから取得した値を、テンプレートのマスターに対して流し込む(または、テンプレートをベースに新マスターを生成する)。

これにより、Visioの内部構造を破壊することなく、データの整合性を保ったまま高速な更新が可能となる。

5. 結論:レガシーを脱却し、インテリジェントな描画へ

Visioを単なる「絵を描く道具」として使う段階は終わった。
SQL Serverをソースとし、VBAをパイプラインとして、ステンシルを動的に制御する。このアプローチを採用することで、システム構成図は「ドキュメント」から、常に最新のシステム状態を反映する「動的なビュー」へと昇華する。

この実装には、COMの挙動に対する深い理解と、厳格なエラーハンドリングが求められる。しかし、その苦労の先に、メンテナンスコストを極限まで低減した、堅牢な設計環境が待っている。

「コードを書くな。パイプラインを設計せよ。」

それが、真のアーキテクトへの第一歩である。

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