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

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

バイナリの霧を晴らせ:Visio マスターシェイプの XML 構造化による「真の差分管理」への道

エンジニアリングの現場において、図面は単なる「絵」ではない。それは、システム設計の意図、制約、そして物理的なリレーションシップを記述した「非構造化データ」である。

しかし、多くの現場では、Visio の `.vssx` や `.vsdx` というバイナリ(実態は圧縮された XML パッケージ)をそのまま Git や SVN に放り込んでいる。これは、ソースコードのコンパイル済みバイナリを Git で管理しているのと同義であり、設計変更の「意図」を追跡することは不可能だ。

我々アーキテクトが真に求めるべきは、マスターシェイプの構成要素を「正規化された XML」へと抽出し、テキストベースで `diff` 可能にすることである。本稿では、Visio VBA を用いてステンシル内のマスターシェイプを解体し、差分管理に適した XML 形式へとシリアライズする、極限の自動化手法を論じる。

1. 抽象化の壁:なぜ単純な保存では足りないのか

Visio のファイル構造は複雑だ。一つのステンシル内には複数のマスターシェイプが存在し、各マスターは ShapeSheet、ジオメトリ、および独自のプロパティを保持している。これらをそのままファイルとして比較しようとしても、保存のたびに生成される GUID やタイムスタンプのノイズにより、意味のある差分(Delta)は埋没してしまう。

我々が実装すべきは、以下の要素のみを抽出した「カノニカル(標準化)XML」である。

1. Geometry (形状定義): ベクターデータの座標情報。
2. ShapeSheet Cells (論理定義): セル値、数式、およびその依存関係。
3. Custom Properties (属性定義): 設計者が定義したメタデータ。

これらをテキストとして出力することで、初めて `git diff` は「どの図形の、どの制約が変わったのか」を雄弁に語り始める。

2. 実装の要諦:メモリ管理とオブジェクトのライフサイクル

大規模なステンシルを処理する場合、VBA のメモリ管理を誤ると、Visio インスタンスのメモリリーク、あるいは `Out of Memory` によるプロセスの強制終了を招く。

特に注意すべきは、`Master` オブジェクトや `Shape` オブジェクトの解放だ。VBA は参照カウント方式を採用しているが、ループ内での明示的な `Set obj = Nothing` は、大規模処理における決定論的なリソース解放のために不可欠である。また、XML 生成には `MSXML2.DOMDocument` を使用し、低レイヤーでの高速なノード操作を実現する。

3. 極限のコード実装:Master Shape XML Exporter

以下に、ステンシル内の全マスターを走査し、その「魂(論理と形状)」を XML として書き出すプロフェッショナルな実装を示す。

' ==============================================================================
' Module: MasterXmlExporter
' Description: Extracts Master Shape definitions into a normalized XML format.
' Author: Legendary Chief Architect
' ==============================================================================

Option Explicit

' MSXML2 への参照設定が必要 (Microsoft XML, v6.0)
Private Const MSXML_VERSION As String = "Microsoft XML, v6.0"

''' <summary>
''' 指定されたステンシル内の全マスターシェイプをXMLとしてエクスポートする。
''' </summary>
''' <param name="stencilPath">ステンシルのフルパス</param>
''' <param name="outputFolder">XML出力先のディレクトリ</param>
Public Sub ExportAllMastersToXml(ByVal stencilPath As String, ByVal outputFolder As String)
    Dim visApp As Visio.Application
    Dim stencil As Visio.Document
    Dim master As Visio.Master
    Dim xmlDoc As Object ' MSXML2.DOMDocument60
    Dim rootNode As Object
    Dim masterNode As Object
    Dim cellNode As Object
    Dim shapeNode As Object
    Dim i As Integer
    
    On Error GoTo ErrorHandler

    ' 1. 環境の初期化
    Set visApp = Visio.Application
    Set stencil = visApp.Documents.OpenEx(stencilPath, visioOpenReadOnly)
    
    ' XMLドキュメントの生成 (MSXML2.DOMDocument60 を使用)
    Set xmlDoc = CreateObject("MSXML2.DOMDocument." & Replace(MSXML_VERSION, " ", ""))
    Set rootNode = xmlDoc.createElement("StencilExport")
    xmlDoc.appendChild rootNode

    ' 2. マスターシェイプの反復処理
    For Each master In stencil.Masters
        Debug.Print "Processing Master: " & master.Name
        
        ' マスターごとのノード作成
        Set masterNode = xmlDoc.createElement("Master")
        masterNode.setAttribute "Name", master.Name
        rootNode.appendChild masterNode
        
        ' --- A. ShapeSheet セルの抽出 (論理の抽出) ---
        ' ShapeSheet の全セルを回すと膨大なため、主要なセルに絞るか、
        ' 特定のセクション(Geometry, User-defined等)に限定するのが実務的である。
        Dim sectionIdx As Integer
        For sectionIdx = 0 To 15 ' 主要なセクションを走査
            On Error Resume Next ' セクションが存在しない場合はスキップ
            Dim section As Visio.Section
            Set section = master.CellsSRC(sectionIdx, 0, 0).Parent.Parent ' 簡略化したアクセス
            ' 注: 実際には ShapeSheet へのアクセスは非常に重いため、
            ' 必要なセクション(visSectionUser, visSectionGeometry等)を厳選すべき
            On Error GoTo ErrorHandler
        Next sectionIdx

        ' --- B. ジオメトリ情報の抽出 (形状の抽出) ---
        ' マスターに含まれる代表的な形状(通常は1つ)のジオメトリを解析
        ' ここでは簡略化のため、マスターの最初のシェイプを対象とする
        If master.Shapes.Count > 0 Then
            Set shapeNode = xmlDoc.createElement("ShapeDefinition")
            masterNode.appendChild shapeNode
            
            ' セル値のシリアライズ (例: Area, Width, Height 等の主要プロパティ)
            Dim propNames As Variant
            propNames = Array("Width", "Height", "Area")
            
            For i = LBound(propNames) To UBound(propNames)
                On Error Resume Next
                Dim cellVal As String
                cellVal = master.Shapes(1).Cells(propNames(i)).Formula
                If Err.Number = 0 Then
                    Set cellNode = xmlDoc.createElement("Property")
                    cellNode.setAttribute "Name", propNames(i)
                    cellNode.Text = cellVal
                    shapeNode.appendChild cellNode
                End If
                On Error GoTo ErrorHandler
            Next i
        End If

        ' 3. 個別マスターのファイル保存
        ' ファイル名に使用できない文字を置換する処理をここに挟むのが定石
        Dim safeFileName As String
        safeFileName = Replace(master.Name, " ", "_") & ".xml"
        xmlDoc.Save outputFolder & "\" & safeFileName
        
        ' メモリ解放: 次のマスターへ行く前に、このループ内で生成したオブジェクトをクリア
        Set masterNode = Nothing
        Set shapeNode = Nothing
        Set cellNode = Nothing
    Next master

    Msg.Exit Sub

ErrorHandler:
    Msg.Print "Critical Error in " & master.Name & ": " & Err.Description
    ' 異常終了時も、リソースを解放してプロセスを汚さない
    Set stencil = Nothing
    Set visApp = Nothing
    Err.Raise Err.Number
End Sub

4. アーキテクトの視点:システム間連携への昇華

この手法を単なる「スクリプト」で終わらせてはならない。真の自動化エンジニアは、これを CI/CD パイプラインの一部として組み込む。

推奨されるワークフロー

1. Local Development: 設計者が Visio でステンシルを更新。
2. Pre-commit Hook / CI: Git push をトリガーに、ヘッドレス環境(Windows Server + Visio Runtime)で上記 VBA を実行。
3. Normalization: 生成された XML から、非決定的な要素(GUID、日付、計算用の一時的な `User` セル)をスクリプト(Python 等)で除去。
4. Diff Analysis:

  • `git diff` を実行。
  • 変更が「意図的な設計変更(例:Width の変更)」か「単なる保存によるノイズ」かを自動判別。

5. Approval: 意味のある差分のみがコードレビューの対象となる。

Windows API による最適化の余地

さらに極限を求めるならば、大量の XML ファイルを書き出す際に、Windows API の `CreateFile` や `WriteFile` を直接呼び出し、バッファリングを制御することで、ファイル I/O のオーバーヘッドを最小化することも検討に値する。しかし、VBA レベルでは `MSXML2` の最適化された実装に任せるのが、保守性とパフォーマンスのバランスとして最も賢明な判断となるだろう。

結論

バイナリという「ブラックボックス」の中に、設計の真実を閉じ込めてはならない。
マスターシェイプを XML という「言葉」に変換するプロセスは、図面を単なる描画データから、管理可能な「エンジニアリング・アセット」へと昇華させる儀式である。

この知見を手に、君たちのシステムを、不確実性のない、堅牢なアーキテクチャへと導いてほしい。

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