【入門編】【中級】マスターシェイプの「ドロップ時」にカスタムプロパティを外部テキストファイルから自動流し込みする – Visio VBA解析バイブル

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

【中級】Visio VBAを「意志を持つ図面」へ。マスターシェイプ配置時に外部データを自動流し込みする極意

こんにちは。設計自動化の深淵へようこそ。

Visioを使っていて、「図面を描くこと」自体よりも「図面に属性情報を手入力すること」に時間を取られて、溜息をついたことはありませんか?

「このサーバーラックのシェイプを置いたら、あらかじめ用意したCSVにあるIPアドレスや管理番号を自動で流し込めたらいいのに……」

もしあなたがそう思っているなら、あなたはすでに「単なる描画ツール」としてのVisioを卒業し、「データ駆動型設計(Data-Driven Design)」の入り口に立っています。

今日は、マクロの記録レベルを脱却し、Visioに「イベント(出来事)」を検知させる、一歩上のプログラミング手法を伝授しましょう。テーマは「マスターシェイプのドロップ時に、外部CSVからカスタムプロパティを自動流し込みする」です。

1. なぜ「マクロの記録」では到達できないのか?

多くの初心者が陥る罠があります。それは「何かを自動化しようとして、操作をすべて記録してしまう」ことです。

しかし、今回の目的は「シェイプを置いた瞬間に、裏側で勝手に動く」ことです。ユーザーが「何を操作したか」を記録するのではなく、「Visioの中で何が起きたか(イベント)」をプログラムが待ち構えておく必要があります。

これを「イベント駆動型(Event-Driven)」の設計と呼びます。

今回の設計思想(アーキテクチャ)

1. 外部データ (CSV): データのマスター(真実の源)。
2. メモリ上の辞書 (Dictionary): 高速アクセスのためのキャッシュ。
3. イベントハンドラ (ShapeAdded): シェイプがページに追加された瞬間に起動するトリガー。
4. 属性書き込み (ShapeData): 判別されたデータをシェイプのプロパティに注入。

2. 準備:データソース(CSV)の構成

まずは、流し込みたいデータの準備です。シンプルに、1列目に「識別キー(シェイプの名前やID)」、2列目に「流し込みたい値」を配置したCSVを用意します。

data.csv の例:

Server_A,192.168.1.10
Server_B,192.168.1.11
Switch_01,10.0.0.1

3. 実装:魂を込めたVBAコード

ここからが本番です。このコードは、標準モジュールではなく、`ThisDocument` モジュールに記述してください。ここがVisioの「脳」となる場所だからです。

' ========================================================================
' 伝説のチーフアーキテクトによる:イベント駆動型データ注入スクリプト
' ------------------------------------------------------------------------
' 概要: シェイプが追加された瞬間に、CSVからデータを検索してShapeDataへ注入する
' ========================================================================

Option Explicit

' 高速検索のために、データをメモリ上に保持する辞書オブジェクト
Private DataCache As Object

' 1. 外部CSVを読み込み、Dictionaryに格納する関数
' パフォーマンスの要:毎回ファイルを開くのではなく、一度メモリに載せる
Private Sub LoadMasterData()
    Dim fso As Object
    Dim ts As Object
    Dim filePath As String
    Dim lineData As String
    Dim parts() As String
    
    ' CSVのパスを指定(実行環境に合わせて変更してください)
    filePath = ThisDocument.Path & "\data.csv"
    
    Set DataCache = CreateObject("Scripting.Dictionary")
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    If Not fso.FileExists(filePath) Then
        MsgBox "エラー: データファイルが見つかりません。" & vbCrLf & filePath, vbCritical
        Exit Sub
    End If
    
    Set ts = fso.OpenTextFile(filePath, 1) ' 1 = ForReading
    
    Do Until ts.AtEndOfStream
        lineData = ts.ReadLine
        If InStr(lineData, ",") > 0 Then
            parts = Split(lineData, ",")
            ' parts(0) をキー、parts(1) を値として格納
            ' 重複キーがある場合は上書きされる設計
            DataCache(Trim(parts(0))) = Trim(parts(1))
        End If
    Loop
    
    ts.Close
    Debug.Print "DataCache loaded: " & DataCache.Count & " items."
End Sub

' 2. Visioのイベント:シェイプが追加された時に自動実行される
' ThisDocumentモジュールに記述することで、ドキュメント全体を監視する
Private Sub Document_ShapeAdded(ByVal Shape As Visio.Shape)
    ' 起動直後やデータロード未完了時はスキップ
    If DataCache Is Nothing Then
        LoadMasterData
    End If
    
    ' --- ここからがロジックの核心 ---
    
    ' 判定基準:シェイプの名前(Name)またはマスター名がCSVのキーと一致するか
    ' ここでは、シェイプの名前(Name)をキーとして判定する例
    Dim key As String
    key = Shape.Name ' もしくは Shape.Master.Name など用途に合わせて変更
    
    ' 辞書にキーが存在するかチェック(O(1)の高速検索)
    If DataCache.Exists(key) Then
        On Error Resume Next ' プロパティが存在しない場合のエラー回避
        
        ' ShapeData(カスタムプロパティ)に値を流し込む
        ' 注意:事前にシェイプに「IP_Address」などの行が存在している必要があります
        Shape.CellExists("Prop.IP_Address", Visio.visSectionCharacter)
        
        If Err.Number = 0 Then
            Shape.Cells("Prop.IP_Address").FormulaU = """" & DataCache(key) & """"
            Debug.Print "Success: " & key & " -> " & DataCache(key)
        Else
            Debug.Print "Skip: " & key & " にプロパティ 'Prop.IP_Address' が見つかりません。"
        End If
        On Error GoTo 0
    End If
    
End Sub

4. 技術的解説:なぜこの書き方が「プロ」なのか

ここで、コードの裏側にある「設計の意図」を解説します。ここを理解すれば、あなたのエンジニアとしての格が上がります。

① `Scripting.Dictionary` による高速化

初心者はよく、シェイプを置くたびに「CSVファイルを一行ずつ読み込んで、一致するか探す」というコードを書きます。しかし、これは最悪のパフォーマンスを生みます。
ファイルI/O(読み書き)はコンピュータにとって非常に重い処理です。
私はあえて、最初に `LoadMasterData` で全データをメモリ(Dictionary)に展開しています。これにより、シェイプを置いた瞬間の検索スピードは、ファイル探索に比べて数千倍高速になります。

② `Document_ShapeAdded` のライフサイクル

`ShapeAdded` イベントは、マスターシェイプがページに「ドロップされた瞬間」に発火します。
このとき、引数として渡される `Shape` オブジェクトは、まだ「配置されたばかりのインスタンス」です。この瞬間にデータを書き込むことで、ユーザーは「配置した瞬間に情報が埋まっている」という魔法のような体験を得られるのです。

③ エラーハンドリングの重要性

`On Error Resume Next` を安易に使うのは素人ですが、プロは「対象のプロパティが存在しない可能性」を予見して、限定的に使用します。
もし、CSVにはデータがあるのに、シェイプ側に「IP_Address」という項目(Shape Data行)が定義されていなかった場合、コードはエラーで止まってしまいます。これを防ぐために、`CellExists` で存在確認を行う、あるいはエラーをスマートに受け流す設計が不可欠です。

5. 陥りやすいエラーと対策

実装中に「動かない!」となったら、以下のチェックリストを確認してください。

  • 「プロパティが見つからない」エラー:

Visioのシェイプには、あらかじめ「Shape Data」として、書き込みたい項目(例:`IP_Address`)が定義されている必要があります。マスターシェイプの編集画面から、カスタムプロパティを追加しておきましょう。

  • 「ファイルが開けません」エラー:

CSVファイルがExcelなどで開かれたままになっていませんか?ファイルがロックされていると、VBAからの読み込みに失敗することがあります。

  • 「名前が一致しない」問題:

`Shape.Name` は、Visio内部では `Process.123` のような自動生成された名前になることがあります。もしマスターの名前で判定したい場合は、`Shape.Master.Name` を使用するか、マスターシェイプ自体に「識別用プロパティ」を持たせておくのが賢明です。

最後に

「自動化」とは、単に作業を減らすことではありません。「人間がミスをしやすい領域から、人間を解放すること」です。

今回紹介した手法をマスターすれば、あなたはVisioを単なる「絵を描く道具」から、巨大なインフラやシステムを管理する「インテリジェントなデータベース」へと進化させることができます。

ここをクリアすれば、Visio VBAの基本はバッチリですよ。さあ、次はもっと複雑な、ネットワーク構成図の自動生成に挑戦してみましょう!

Happy Automation!

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