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

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

【上級】SQL Server上の図形定義データからステンシルを動的に生成するパイプライン

こんにちは。今日もコードの海を、ロジックの光を頼りに進んでいますか?

「マクロの記録」を使って、マウス操作をコードに変換することから始めた皆さん。その一歩は素晴らしいものです。しかし、あなたがもし「毎回手作業でステンシルを作ったり、図形を並べ替えたりしている」としたら、それはまだ「Visioを使っている」だけで、「Visioを制御している」わけではありません。

真の自動化エンジニアは、図形を「描く」ことはしません。図形を「生成する仕組み(パイプライン)」を構築するのです。

今回は、その極致とも言えるテーマ、「SQL Server上のデータベースから、Visioのステンシル(マスターシェイプの集合体)を動的に生成するアーキテクチャ」について解説します。

「難しそう……」と身構えないでください。仕組みを理解し、一つ一つのオブジェクトの役割を紐解いていけば、必ずマスターできます。ここをクリアすれば、あなたのVisio VBAスキルは「道具」から「システム」へと進化するはずですよ。

1. なぜ「動的ステンシル」が必要なのか?

通常、Visioで図形を使うときは、あらかじめ用意された「ステンシル」から図形をドラッグ&ドロップしますよね。しかし、設計現場では以下のような状況が起こります。

  • 製品の仕様が頻繁に変わる: データベース上の部品リストが更新されるたびに、手作業でステンシルを作り直すのは非効率です。
  • 膨大なバリエーション: 数千種類の部品がある場合、すべてをステンシルに手書きするのは不可能です。

ここで、「データベース(SQL Server)がマスター(正解)であり、Visioのステンシルは、そのデータベースを反映した『一時的な表示窓口』に過ぎない」という考え方を導入します。

これが「動的ステンシル・パイプライン」の思想です。

2. アーキテクチャの全体像

このシステムがどのように動くのか、データの流れをイメージしてみましょう。

graph LR
    A[(SQL Server)] -- "1. Query (ADO)" --> B[Visio VBA]
    B -- "2. Create Stencil" --> C[Dynamic Stencil]
    B -- "3. Add Masters" --> C
    C -- "4. Drag & Drop" --> D[Visio Drawing]

1. SQL Server: 図形の名前、種類、属性(サイズや色、カスタムプロパティ)を管理。
2. Visio VBA (ADO接続): SQLを実行し、結果(Recordset)を受け取る。
3. Dynamic Stencil: VBAがメモリ上に新しいステンシルを作成し、レコードごとに「マスターシェイプ」を生成して流し込む。
4. Visio Drawing: ユーザーは、最新のデータが反映されたステンシルから図形を配置できる。

3. 実装の核:マスターシェイプをどう作るか?

ここが最大の技術的ポイントです。実は、VBAで「ゼロから線や円を描いてマスターを作る」のは、非常に複雑で計算負荷も高い作業です。

プロの現場では、「テンプレートとなる図形(Base Shape)」を用意しておき、それをコピーして、属性(Shape Data)だけをデータベースの値に書き換えてから、マスターとして登録するという手法をとります。これが最も高速で、エラーの少ない「賢いやり方」です。

実装コード例

以下のコードは、SQL Serverからデータを取得し、新しいステンシルにマスターを追加していく実装イメージです。

> 事前準備: VBAエディタの [ツール] -> [参照設定] から 「Microsoft ActiveX Data Objects x.x Library」 にチェックを入れておいてください。

Option Explicit

' ===========================================================================
' テーマ: SQL Serverから図形定義を取得し、動的ステンシルを生成する
' 開発者: あなたの成長を支えるシニアアーキテクト
' ===========================================================================

Sub GenerateDynamicStencil()
    Dim conn As ADODB.Connection
    Dim rs As ADODB.Recordset
    Dim connString As String
    Dim targetStencil As Visio.Stencil
    Dim templatePage As Visio.Page
    Dim baseShape As Visio.Shape
    Dim newMaster As Visio.Master
    Dim i As Integer
    
    ' --- 1. 設定エリア ---
    ' SQL Serverへの接続文字列(環境に合わせて書き換えてください)
    connString = "Provider=SQLOLEDB;Data Source=YOUR_SERVER;Initial Catalog=YOUR_DB;Integrated Security=SSPI;"
    
    ' エラーハンドリングの開始
    On Error GoTo ErrorHandler
    
    ' パフォーマンス向上のため、画面更新を停止(これ、鉄則ですよ!)
    Application.ScreenUpdating = False

    ' --- 2. データベース接続 ---
    Set conn = New ADODB.Connection
    conn.Open connString
    
    ' 図形定義を取得するクエリ(例: 部品名, タイプ, 幅, 高さ を取得)
    Dim sql As String
    sql = "SELECT PartName, ShapeType, Width, Height FROM ComponentDefinitions"
    
    Set rs = New ADODB.Recordset
    rs.Open sql, conn, adOpenStatic, adLockReadOnly

    ' --- 3. ステンシルの準備 ---
    ' 新しいステンシルを作成(既存のテンプレートをベースにすると楽です)
    ' ここでは新しく作成するプロセスを示します
    Set targetStencil = Application.Documents.AddStencil(visStencilTemplate)
    
    ' テンプレート用の図形を配置するための「隠しページ」を一時的に利用する手法
    ' (テンプレート図形をページに置いておき、それを元にマスターを作る)
    Set templatePage = Application.ActiveDocument.Pages(1)
    ' ※実際には、あらかじめ用意したテンプレート図形を特定する方法をとります
    ' ここでは仮に、ページ上の最初の図形をテンプレートとします
    If templatePage.Shapes.Count = 0 Then
        MsgBox "テンプレートとなる図形をページに配置してください。"
        Exit Sub
    End If
    Set baseShape = templatePage.Shapes(1)

    ' --- 4. ループ処理:レコードの数だけマスターを生成 ---
    Do While Not rs.EOF
        ' A. テンプレート図形をコピーして属性を変更
        Dim tempShape As Visio.Shape
        Set tempShape = baseShape.Duplicate
        
        ' B. データベースの値で図形の属性を書き換え
        With tempShape
            .Text = rs.Fields("PartName").Value        ' 図形のテキスト
            .Cells("Width").Formula = rs.Fields("Width").Value & " mm"
            .Cells("Height").Formula = rs.Fields("Height").Value & " mm"
            
            ' カスタムプロパティ(Shape Data)の追加
            ' これにより、後で図形を配置した後に詳細情報を参照できる
            .AddSection visSectionCustomer, False
            .CellsSRC(visSectionCustomer, 1, visCustomerDataID).Formula = "PartType"
            .CellsSRC(visSectionCustomer, 1, visCustomerDataValue).Formula = rs.Fields("ShapeType").Value
        End With
        
        ' C. 変更した図形をステンシルの「マスター」として登録
        ' これにより、ドラッグ&ドロップ可能な状態になります
        Set newMaster = targetStencil.Masters.CreateMasterFromShape(tempShape)
        newMaster.Name = rs.Fields("PartName").Value
        
        ' D. 使い終わった一時的な図形を削除
        tempShape.Delete
        
        ' 次のレコードへ
        rs.MoveNext
    Loop

    ' --- 5. 後処理 ---
    MsgBox "ステンシルの生成が完了しました!"

CleanUp:
    ' オブジェクトの解放(メモリリーク防止の極意)
    If Not rs Is Nothing Then If rs.State = adStateOpen Then rs.Close
    Set rs = Nothing
    If Not conn Is Nothing Then If conn.State = adStateOpen Then conn.Close
    Set conn = Nothing
    
    Application.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
    Resume CleanUp
End Sub

4. 陥りやすい罠(アンチパターン)と回避策

この高度な実装を行う際、初心者が必ずと言っていいほど躓くポイントが3つあります。

① メモリリークの恐怖

VBAでは、`Set obj = Nothing` を怠ると、プログラムが終了してもメモリ上にオブジェクトが残り続け、Visioが動作不能になることがあります。特にデータベース接続(`ADODB.Connection`)は、必ず `Close` してから `Nothing` を代入してください。

② 画面更新のパフォーマンス

ループの中で図形を大量に作成するとき、`Application.ScreenUpdating = True`(デフォルト)のままだと、Visioが図形を作るたびに画面を描画し直そうとします。これが原因で、処理が10倍以上遅くなることがあります。「処理を始める前に止める、終わったら戻す」。これはエンジニアの嗜みです。

③ ステンシルの「揮発性」

`AddStencil` で作成したステンシルは、メモリ上に存在する一時的なものです。プログラムが終了すると消えてしまいます。もし永続的に使いたい場合は、`targetStencil.SaveAs “C:\Path\To\MyStencil.vssx”` のように、明示的に保存する処理を加えてください。

5. まとめ:次に目指すべきステップ

お疲れ様でした。ここまで読み進めたあなたは、単なる「マクロ使い」を卒業し、「システム設計者」の入り口に立っています。

今回のコードは、あくまで「動的なデータの橋渡し」です。
これができれば、次は以下のような拡張も可能です。

  • 変更検知: データベースの更新日時をチェックし、差分がある場合のみステンシルを更新する。
  • Web API連携: SQL Serverだけでなく、REST API経由でクラウド上の製品カタログから図形を取得する。

Visio VBAは、単なる図形描画ツールではありません。「データという魂を、図形という肉体に宿すためのインターフェース」なのです。

一歩ずつ、着実に。コードの向こう側にある、美しく自動化された世界を目指して進んでいきましょう。応援していますよ!

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