マクロ記録の先へ。Visio VBAで「マスターシェイプのDNA」を解析し、設計品質を自動検証する
こんにちは。現場の自動化を指揮するチーフアーキテクトです。
「マクロの記録」ボタンを押して、自分の操作をコードに変換する。それはVisio VBAの世界への第一歩として素晴らしい入り口です。しかし、もしあなたが「もっと複雑なことをしたい」「設計図の整合性を自動でチェックしたい」と願い始めたなら、それはあなたが「操作の自動化」から「データの制御」へとステップアップしようとしている証拠です。
今日、私たちが挑むのは、単なる自動操作ではありません。
「ステンシル内に眠るマスターシェイプの設計値(ShapeSheet)をすべて抜き出し、CSVとして書き出す」という、実務における「品質管理(バリデーション)」の仕組みを構築することです。
ここをクリアすれば、あなたはVisioを単なる描画ツールではなく、強力な「設計データベース」として扱えるようになります。準備はいいですか? さあ、極限の知見へ踏み込みましょう。
1. 概念の理解:ステンシル、マスター、そしてShapeSheetの階層構造
コードを書く前に、まず「対象の構造」を脳内にマッピングしてください。ここを間違えると、どれだけ優れたコードも、存在しないオブジェクトを指してエラーを吐き続けます。
Visioのデータ構造は、以下の階層になっています。
1. Application: Visioそのもの
2. Document: 開いている図面ファイル
3. Stencil(ステンシル): 図形(マスター)の集合体。いわば「道具箱」
4. Master(マスター): ステンシルの中に格納されている「設計図の雛形」
5. Shape(シェイプ): 図面に配置された実体
6. ShapeSheet(シェイプシート): 全てのシェイプの「設計値(幅、高さ、色、接続ルール等)」が書き込まれた、いわばシェイプのDNA
今回のミッションは、「道具箱(Stencil)の中にある、全ての雛形(Master)のDNA(ShapeSheet)を読み取り、報告書(CSV)にまとめる」ことです。
2. 実装:マスターシェイプ属性抽出ツール
それでは、実践的なコードを見ていきましょう。このコードは、現在開いているステンシル内の全マスターを走査し、その「幅(Width)」「高さ(Height)」「名前(Name)」をCSVに出力します。
Option Explicit
''' <summary>
''' ステンシル内の全マスターシェイプの属性をCSVに出力する
''' </summary>
Sub ExportMasterShapesToCSV()
Dim st As Visio.Stencil
Dim m As Visio.Master
Dim s As Visio.Shape
Dim filePath As String
Dim fileNum As Integer
Dim csvContent As String
Dim errorCount As Integer
' --- 1. 設定フェーズ ---
' 出力先のパス(実行ファイルと同じフォルダに保存する例)
filePath = ThisWorkbook.Path & "\MasterShapeInventory.csv" ' Excel経由の場合
' Visio単体で動かす場合は以下のように直接指定してください
' filePath = "C:\Temp\MasterShapeInventory.csv"
' 現在アクティブなステンシルを取得
On Error Resume Next
Set st = ActiveDocument.Stencil
On Error GoTo 0
If st Is Nothing Then
MsgBox "エラー: アクティブなステンシルが見つかりません。" & vbCrLf & _
"ステンシルが開いていることを確認してください。", vbCritical
Exit Sub
End If
' --- 2. 準備フェーズ ---
fileNum = FreeFile
Open filePath For Output As #fileNum
' CSVのヘッダー(項目名)を書き込み
Print #fileNum, "MasterName,ShapeName,Width(mm),Height(mm)"
errorCount = 0
' --- 3. 実行フェーズ(ループ処理) ---
' ステンシル内の全マスターを一つずつ確認
For Each m In st.Masters
' マスター自体は「図形」ではないため、その中にある「最初のシェイプ」を
' 設計値取得のターゲットとして参照する
If m.Shapes.Count > 0 Then
Set s = m.Shapes.Item(1)
' --- ここが重要:ShapeSheetの値を読み取る ---
' Cells("Width").Result は、ドキュメントの単位(mmやinch)での値を返します
' Cellのプロパティ名を直接指定することで、DNAにアクセスします
Dim masterName As String: masterName = m.Name
Dim shapeName As String: shapeName = s.Name
Dim widthVal As Double: widthVal = s.Cells("Width").Result
Dim heightVal As Double: heightVal = s.Cells("Height").Result
' CSV形式の1行を作成(カンマ区切り)
' ※数値の精度を保つため、フォーマットを指定するのがプロの技です
Dim line As String
line = masterName & "," & _
shapeName & "," & _
Format(widthVal, "0.00") & "," & _
Format(heightVal, "0.00")
' ファイルへ書き出し
Print #fileNum, line
Else
' マスターの中にシェイプが含まれていない特殊なケース
errorCount = errorCount + 1
End If
Next m
' --- 4. 終了フェーズ ---
Close #fileNum
MsgBox "完了しました!" & vbCrLf & _
"出力先: " & filePath & vbCrLf & _
"異常なマスター数: " & errorCount, vbInformation
End Sub
3. アーキテクトの視点:ここが「プロ」の分かれ道
このコードを単なる「動くコード」で終わらせないために、重要な知見を共有します。
① `m.Shapes.Item(1)` の意味を見極める
マスター(Master)は、それ自体が図面上の「点」ではありません。マスターはあくまで「定義」です。そのため、マスターの属性(幅や高さ)を知りたいときは、そのマスターが持っている「中身のシェイプ(Shapesコレクション)」にアクセスする必要があります。
`m.Shapes.Item(1)` と書くことで、そのマスターを構成する主要なシェイプの設計値にアクセスできるのです。
② `Result` vs `ResultIU` の使い分け
ここが最も陥りやすい罠です。
- `Result`: ユーザーが見ている単位(mmやインチ)での値。CSV出力などの「人間が検証する」目的にはこちらを使います。
- `ResultIU`: Visio内部の計算単位(Internal Units)。プログラム内で計算を続ける場合は、こちらの方が精度が高く、計算誤差を防げます。
検証ツールを作るなら、「人間が見るためのCSVには `Result` を使う」。これが鉄則です。
③ パフォーマンスの重み
もし、ステンシルに数千のマスターがあった場合、ループの中で毎回ファイルを開閉したり、重い処理を挟むと動作が極端に遅くなります。今回のコードでは、`Open` をループの外で行い、最後に `Close` するという、「I/O(入出力)の最小化」を行っています。これは大規模な自動化において必須の作法です。
4. 陥りやすいエラーと対策
開発中に遭遇するかもしれない「壁」をあらかじめ伝えておきます。
- 「実行時エラー ‘438’: オブジェクトは、このプロパティまたはメソッドをサポートしていません」
- 原因: `Cells(“Width”)` のスペルミスや、そのシェイプに `Width` というCellが存在しない場合に発生します。
- 対策: `On Error Resume Next` で無理やり飛ばすのではなく、まずは `Debug.Print s.Cells(“Width”).Name` などで、プロパティが存在するか確認する癖をつけましょう。
- 「書き出されたCSVの数値がおかしい」
- 原因: Visioのページ単位(Units)が、想定しているもの(mm)と異なる可能性があります。
- 対策: `s.Cells(“Width”).Result` を取得する際、ドキュメントの単位設定を意識してください。
最後に:次のステップへ
お疲れ様でした。これであなたは、Visioの「見た目」を操作する段階を卒業し、「設計データ」を抽出・管理するエンジニアの入り口に立ちました。
今回作成したCSVは、Excelで開けばすぐに「設計基準との比較」が可能です。
「マスターの幅が、規定の100mmを超えていたら赤字にする」
そんな自動検品プロセスは、Excel側の関数だけで簡単に作れます。
Visio VBAは、単独で動くものだけが正解ではありません。「Visioでデータを抜き出し、Excelや他のシステムで解析する」という、ツール間の連携(オーケストレーション)こそが、真の業務自動化の姿なのです。
ここをクリアしたあなたは、もう立派な自動化エンジニアの卵です。自信を持って、次の自動化に挑んでください!
