【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!
