【入門編】【中級】ステンシル内の全マスターシェイプの「ShapeSheet」値を一括取得し、CSVで比較・検証するツール – Visio VBA解析バイブル

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

マクロ記録の先へ。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や他のシステムで解析する」という、ツール間の連携(オーケストレーション)こそが、真の業務自動化の姿なのです。

ここをクリアしたあなたは、もう立派な自動化エンジニアの卵です。自信を持って、次の自動化に挑んでください!

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