【入門編】【中級】ステンシル内のマスターシェイプを「XML形式」にエクスポートして差分管理する – Visio VBA解析バイブル

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

【中級】Visioの「形状のDNA」を抜き出せ:マスターシェイプのXMLエクスポートによる差分管理術

こんにちは。今日もコードの海を、あるいは図面の迷宮を、知性というコンパスを持って進んでいますか?

Visioを使って業務自動化を進めていると、ある壁にぶつかることがあります。それは「いつ、誰が、シェイプの形やプロパティを変えてしまったのか分からない」という問題です。

「マクロの記録」で記録したコードをコピペして、なんとか動かす。その段階を脱したあなたなら、エンジニアとして「変更履歴の管理(バージョン管理)」の重要性に気づいているはずです。しかし、Visioのファイル(.vsdxや.vssx)はバイナリに近い複雑な構造を持っており、Gitなどのテキストベースの差分管理ツールでそのまま比較しても、人間には到底理解できない文字列の羅列が表示されるだけです。

そこで今日お伝えするのは、「マスターシェイプのDNA(XML)を抽出し、テキストとして管理する」という、プロフェッショナルな設計者が実践する一歩進んだワークフローです。

これさえマスターすれば、あなたのVisio資産は「単なる図面」から「管理されたエンジニアリング・データ」へと進化します。さあ、一緒に深淵を覗いてみましょう。

1. なぜ「XML」として書き出す必要があるのか?

まず、概念を整理しましょう。Visioの「ステンシル(Stencil)」とは、いわば部品のカタログです。そして、そのカタログの中に登録されている一つ一つの部品が「マスターシェイプ(Master Shape)」です。

マスターシェイプの内部には、頂点の座標、線の太さ、色、そして高度なロジック(ShapeSheet)といった膨大な情報が詰まっています。この情報の正体こそがXML形式のデータです。

従来の管理 vs XMLによる管理

特徴 通常のファイル管理 (.vssx) XMLエクスポート管理
比較方法 ファイル全体の比較(困難) 行単位の差分比較(容易)
変更箇所の特定 目視で図面を見るしかない 「どの座標が」「どの値が」変わったか即座に判明
Gitとの相性 最悪(バイナリ扱い) 最高(テキスト扱い)

「図面がちょっと変わった」という曖昧な報告ではなく、「マスターの頂点3のX座標が10.5から12.0に変わった」という決定的な証拠を、テキストベースで追跡できるようにするのが今回の目的です。

2. 核心となるオブジェクトモデルの理解

コードを書く前に、Visio VBAの「階層構造」を頭に叩き込んでください。ここを理解していないと、コードはただの呪文になってしまいます。

私たちが辿るルートはこうです:
`Application`(Visioそのもの)
 $\rightarrow$ `Document`(開いているステンシルファイル)
  $\rightarrow$ `Stencil`(図形集)
   $\rightarrow$ `Master`(個々のマスターシェイプ)
    $\rightarrow$ `.Xml` プロパティ(ここが宝の山!)

この `.Xml` プロパティを呼び出すだけで、そのシェイプが持つすべての設計図を文字列として手に入れることができるのです。

3. 実装:マスターシェイプXMLエクスポート・エンジン

では、実際に使えるコードを見ていきましょう。単に書き出すだけでなく、実務で使えるように「フォルダ作成」や「エラーハンドリング」を組み込んだ、少し「硬派」な設計にしています。

Option Explicit

''' <summary>
''' ステンシル内の全てのマスターシェイプをXML形式でエクスポートする
''' </summary>
Sub ExportMastersToXML()
    Dim vsoStencil As Visio.Document
    Dim vsoMaster As Visio.Master
    Dim fso As Object
    Dim targetFolder As String
    Dim xmlContent As String
    Dim fileName As String
    Dim fileStream As Object
    
    ' --- 設定エリア ---
    ' 現在開いているステンシルを対象とする
    Set vsoStencil = Visio.ActiveDocument
    
    ' エクスポート先のフォルダパス(実行ファイルと同じ階層の "MasterXML" フォルダ)
    targetFolder = ThisWorkbook.Path & "\MasterXML_Export\" ' ※Excelから呼ぶ場合
    ' Visio単体で動かす場合は、以下のように直接指定してください
    ' targetFolder = "C:\Temp\VisioXML\" 
    
    ' ------------------

    ' 1. FileSystemObjectの初期化 (ファイル操作用)
    On Error Resume Next
    Set fso = CreateObject("Scripting.FileSystemObject")
    On Error GoTo 0
    
    If fso Is Nothing Then
        MsgBox "FileSystemObjectの作成に失敗しました。", vbCritical
        Exit Sub
    End If

    ' 2. 保存先フォルダの作成(なければ作る)
    If Not fso.FolderExists(targetFolder) Then
        fso.CreateFolder (targetFolder)
    End If

    Debug.Print "--- エクスポート開始: " & vsoStencil.Name & " ---"

    ' 3. ステンシル内のマスターをループで回す
    ' ここがパフォーマンスの肝。Masterコレクションを直接走査します。
    For Each vsoMaster In vsoStencil.Masters
        
        ' マスターの名前をファイル名に使用(不正文字の置換が必要な場合あり)
        ' 今回は簡易的にそのまま使用しますが、実務では記号の除去を推奨します
        fileName = targetFolder & vsoMaster.Name & ".xml"
        
        ' マスターのDNA(XML)を取得
        xmlContent = vsoMaster.Xml
        
        ' 4. ファイルへの書き出し
        ' TextStreamを使用して、テキストファイルとして保存
        On Error Resume Next
        Set fileStream = fso.CreateTextFile(fileName, True, True) ' True, True = Unicode書き出し
        
        If Err.Number = 0 Then
            fileStream.Write xmlContent
            fileStream.Close
            Debug.Print "成功: " & vsoMaster.Name
        Else
            Debug.Print "失敗: " & vsoMaster.Name & " (エラー: " & Err.Description & ")"
        End If
        On Error GoTo 0
        
    Next vsoMaster

    Debug.Print "--- エクスポート完了 ---"
    MsgBox "エクスポートが完了しました!" & vbCrLf & "保存先: " & targetFolder, vbInformation
End Sub

コードの解説:ここがプロの視点

1. `FileSystemObject (FSO)` の採用:
VBA標準の `Open` 文よりも、`FSO` を使う方がファイル操作の柔軟性が高いです。フォルダの存在確認 (`FolderExists`) や、Unicodeへの対応が容易になります。
2. `vsoMaster.Xml`:
これが魔法の言葉です。これだけで、シェイプの幾何学情報から、ShapeSheetの計算式までがすべて文字列として取り出せます。
3. `CreateTextFile(…, True, True)`:
第3引数を `True` にすることで、Unicode (UTF-16) として書き出しています。VisioのXMLは特殊な文字を含むことがあるため、標準のANSIではなくUnicodeで扱うのが安全な作法です。
4. エラーハンドリング:
マスター名にファイル名として使えない文字(`/` や `*` など)が含まれていると、書き出しでエラーが起きます。`On Error Resume Next` でループを止めずに、エラーログを `Debug.Print` に流す設計にしています。

4. 陥りやすい罠(Pitfalls)と回避策

この技術を運用する上で、初心者がハマりやすいポイントを伝授しておきます。

① ファイル名に使えない文字

マスターシェイプの名前に `[ ]` や `/` が含まれていると、Windowsのファイルシステムが「そんな名前のファイルは作れません!」と怒ってきます。
対策: `Replace(vsoMaster.Name, “/”, “_”)` のように、記号をアンダースコアに置換する処理を挟むのが「デキるエンジニア」です。

② XMLの肥大化

非常に複雑なマスター(大量のサブシェイプを持つもの)は、XMLのサイズが巨大になります。これを大量にエクスポートすると、ディスク容量やメモリを圧迫します。
対策: 全てを書き出すのではなく、特定の「カテゴリ」や「タグ」を持つマスターに絞り込んでエクスポートするロジックを追加しましょう。

③ 差分管理の「ノイズ」

XMLには、Visioが自動生成するID(GUID)が含まれています。シェイプをコピー&ペーストしただけで、見た目は変わっていなくてもIDが変わってしまうことがあります。これではGitの差分が「常に変更あり」になってしまいます。
対策: 本気で差分管理を行うなら、エクスポートしたXMLから特定のID属性を正規表現などで除去(マスク)する、さらなる高度な処理が必要になります。

最後に:一歩先へ進むあなたへ

「ただ図面を描く」のと、「図面をデータとして管理する」のでは、エンジニアとしての視座が全く異なります。

今回紹介したXMLエクスポート手法は、Visioを単なる「お絵描きツール」から、プログラマブルな「構成管理対象」へと昇華させるための第一歩です。最初は難しく感じるかもしれませんが、一度この仕組みを構築してしまえば、チームでの設計変更の追跡は劇的に楽になります。

ここをクリアすれば、Visio VBAの基本、そして「システム設計」の考え方はバッチリですよ。

さあ、次はこれらのXMLをどう解析するか……。その挑戦を、楽しみにしています。

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