【入門編】【中級】ステンシル内のマスターシェイプに「独自のメタデータ」をVBAで付与する – Visio VBA解析バイブル

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

【Visio VBA 極限の知見】マスターシェイプに「魂(メタデータ)」を吹き込む:自動化の真髄へ

こんにちは。コードの海を渡る旅人の皆さん。
今日は、Visio VBAの世界において「単なる図形描画」から「データ駆動型のシステム構築」へとステップアップするための、極めて重要なテクニックをお話ししましょう。

「マクロの記録」を使って、図形の色を変えたり、位置を動かしたりすることはできるようになりましたね。でも、実務で本当に求められるのはそこではありません。

「図形そのものに、業務に必要な属性(ID、コスト、担当者、ステータスなど)をあらかじめ埋め込んでおき、それを後から一括抽出できる仕組み」

これこそが、プロの自動化エンジニアが設計する仕組みです。今回は、その中核となる「ステンシル内のマスターシェイプに、プログラムで独自のShape Data(カスタムプロパティ)を付与する方法」を徹底解説します。

ここをクリアすれば、あなたの作るVisioファイルは、単なる「絵」から、価値ある「データベース」へと進化しますよ。

1. 概念の理解: 「マスター」と「インスタンス」の違い

まず、多くの初学者が陥る罠について触れておきましょう。

Visioにおいて、ステンシル(Stencil)の中にあるのは「マスターシェイプ(Master Shape)」です。そして、それをページにドラッグ&ドロップして配置したものは「シェイプ(Shape/Instance)」です。

ここが運命の分かれ道です。

  • 間違ったアプローチ: ページ上の図形(インスタンス)に対して、VBAでプロパティを一つずつ書き込む。
  • *結果:* 図形が増えるたびに処理が重くなり、配布した図形にはデータが入っていないという事態を招きます。
  • プロのアプローチ: ステンシル内の「マスターシェイプ」自体にプロパティを定義しておく。
  • *結果:* マスターから図形を配置した瞬間、その図形は最初から「属性を持った状態」で生まれてきます。

私たちは今日、この「マスターに魂を吹き込む(メタデータを埋め込む)」方法をマスターします。

2. 実装の核心: Shape Data Section を操作する

Visioの図形は、内部的に「セクション」という単位でデータを管理しています。カスタムプロパティ(Shape Data)は、`visSectionShapeData` というセクションに格納されます。

VBAでこれを行うには、以下の3ステップが必要です。
1. 対象となるマスターシェイプを特定する。
2. `AddRow` メソッドを使って、Shape Dataセクションに新しい行(プロパティ)を追加する。
3. 追加した行に対して、`Label`(項目名)と `Value`(値)を設定する。

それでは、実際に動くコードを見てみましょう。

実装コード例:マスターへのメタデータ注入

このコードは、開いているステンシル内の特定のマスターシェイプに対し、「資産ID」と「管理部門」という独自のメタデータを自動的に付与するものです。

Option Explicit

''' <summary>
''' 指定したマスターシェイプにカスタムプロパティを付与するプロシージャ
''' </summary>
Sub InjectMetadataToMaster()
    Dim stencil As Visio.Stencil
    Dim master As Visio.Master
    Dim masterShape As Visio.Shape
    Dim rowIdx As Integer
    
    On Error GoTo ErrorHandler

    ' 1. 現在開いているステンシルを取得(または特定のステンシルを名前で開く)
    ' ここでは例として、アクティブなステンシルを使用します
    Set stencil = ActiveDocument.Application.Application.ActiveStencil
    
    If stencil Is Nothing Then
        MsgBox "ステンシルが開かれていません。先にステンシルを開いてください。", vbExclamation
        Exit Sub
    End If

    ' 2. 対象となるマスターシェイプを名前で検索
    ' ※マスターの名前は、ステンシル内で定義されている正確な名前を指定してください
    On Error Resume Next
    Set master = stencil.Masters("Basic Rectangle") ' 例として四角形を指定
    On Error GoTo ErrorHandler

    If master Is Nothing Then
        MsgBox "指定されたマスターが見つかりません。", vbCritical
        Exit Sub
    End If

    ' 3. マスター内の「形状(Shape)」にアクセス
    ' マスターそのものはコンテナであり、実際のデータ保持は中のShapeに対して行います
    Set masterShape = master.Shapes.Item(1)

    ' --- メタデータの注入開始 ---
    
    ' プロパティ1: [AssetID] を追加
    ' AddRow(セクション, 行の挿入位置, 行の削除タイプ, タグ)
    ' visSectionShapeData = 14 (Shape Dataセクション)
    ' visRowDelAfter = 0 (挿入した行の後に既存の行を削除しない)
    rowIdx = masterShape.AddRow(visSectionShapeData, visRowDelAfter, visTag)
    
    ' 行のラベル(項目名)と値(データ)を設定
    masterShape.CellsSRC(visSectionShapeData, rowIdx, visRowLabel).FormulaU = """AssetID"""
    masterShape.CellsSRC(visSectionShapeData, rowIdx, visRowValue).FormulaU = """TEMP-001"""

    ' プロパティ2: [Department] を追加
    rowIdx = masterShape.AddRow(visSectionShapeData, visRowDelAfter, visTag)
    masterShape.CellsSRC(visSectionShapeData, rowIdx, visRowLabel).FormulaU = """Department"""
    masterShape.CellsSRC(visSectionShapeData, rowIdx, visRowValue).FormulaU = """Engineering"""

    ' --- 注入完了 ---

    MsgBox "マスターシェイプへのメタデータ注入が完了しました!" & vbCrLf & _
           "新しい図形を配置して確認してください。", vbInformation

    Exit Sub

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

3. ここが落とし穴! アーキテクトからの警告

このコードを動かす際、あるいは実務に投入する際に、必ず意識しておくべき「3つの重要事項」があります。

① ステンシルの「書き込み権限」

最も多いエラーは、「読み取り専用のステンシル(.vssxファイルが保護されている場合など)」に対して実行してしまうことです。マスターを書き換えるということは、ステンシルファイルそのものを更新することを意味します。
配布用のステンシルを作成する場合は、必ず「編集可能な状態」でマクロを実行し、完了後に保存してください。

② `CellsSRC` の魔法と作法

コード内で使っている `masterShape.CellsSRC(visSectionShapeData, rowIdx, visRowLabel)`。これは、セクション番号、行番号、そして「それがラベルなのか値なのか」という属性を指定して、ピンポイントでセルを操作する非常に強力なメソッドです。
`FormulaU`(ユニバーサル・フォーミュラ)に値を代入する際は、文字列をダブルクォーテーションで囲む(`”””Value”””`)ことを忘れないでください。これを忘れると、Visioは「値」ではなく「数式」として解釈しようとしてエラーを吐きます。

③ 既存プロパティの上書き問題

上記のコードは、実行するたびに新しい行を追加します。もし、すでに「AssetID」が存在している場合に、それを更新したいのであれば、一度 `AddRow` する前に「既存の行があるか」をループでチェックし、あればその `rowIdx` を再利用するロジックが必要です。

4. まとめ: 次のステージへ

お疲れ様でした。これであなたは、単に図形を描く人から、「データ構造を設計し、自動生成するエンジニア」への一歩を踏み出しました。

マスターシェイプにメタデータを埋め込むことができれば、次のような高度な自動化が可能になります:

  • 図形を全スキャンして、特定の「AssetID」を持つものだけをExcelに書き出す。
  • 「Department」が「Engineering」の図形だけを、特定の色に一括変更する。
  • 図形のステータスに基づいて、自動的に警告色を付ける。

Visio VBAの真の力は、描画機能ではなく、この「データ管理能力」にあります。

もしエラーが出ても、それは設計を見直すための貴重なシグナルです。一つずつデバッグして、理想のシステムを構築していきましょう。応援していますよ!

Happy Coding!

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