【実務・中級編】【上級】マスターシェイプの「バイナリ構造」を解析し、破損したステンシルを修復する – Visio VBA解析バイブル

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

壊れたステンシルを「外科手術」せよ:VSSXバイナリ構造の解析とマスターシェイプの救出術

現場のエンジニアが陥る最も無力な瞬間。それは、長年使い込み、複雑なマスターシェイプを蓄積してきた「自社専用ステンシル」が、ある日突然、Visioによって「ファイルが破損しています」と一蹴される瞬間だ。

`Application.Documents.Open` を叩いても、エラーを吐いて終了する。標準のリファレンスに書かれているような「バックアップから復元してください」という回答は、設計者への冒涜だ。バックアップはあっても、その「中身(マスターシェイプの定義)」こそが資産であり、それを救出することこそが、真の自動化エンジニアの責務である。

本稿では、`.vssx` ファイルの正体である OpenXML 構造を解体し、破損したファイルから「マスターシェイプの定義データ」をバイナリ・XMLレベルで抽出し、健全なステンシルへと再構築する、極限のリカバリ手法を伝授する。

1. 致命的な誤解:Visio Object Model は「救急箱」ではない

多くの開発者は、ファイルが壊れた際に Visio VBA のオブジェクトモデルを使って解決しようとする。しかし、それは決定的な間違いだ。

Visio のオブジェクトモデルは、「ファイルが正常にパース(解析)できること」を前提としたインターフェースである。XMLのタグが一つ閉じられていない、あるいは圧縮ストリームに不整合がある場合、`Visio.Document` オブジェクト自体が生成されない。つまり、壊れたファイルに対して VBA を実行しようとする行為は、溺れている人間に対して「泳ぎ方のレクチャー」をしているようなものだ。

私たちが取るべき戦略は、Visio というアプリケーションを介さず、ファイルそのものを「データ構造の集合体」として扱うこと。これが、アーキテクトの視点だ。

2. `.vssx` の解剖学:ステンシルは「ZIPコンテナ」である

現代の Visio ステンシル(`.vssx`)は、実態として OpenXML 形式の ZIP アーカイブである。拡張子を `.zip` に書き換えれば、中身を覗くことができる。

重要なのは、ステンシルを構成する以下の要素だ:

  • `masters.xml` (あるいは `visio/masters/` 以下の各ファイル): マスターシェイプの定義、ジオメトリ、シェイプデータが格納されている。
  • `connections.xml`: マスター間の関係性。
  • `_rels/`: 各パーツがどのように紐付いているかを定義するリレーションシップ。

破損の多くは、この中の XML 要素の不整合、あるいは圧縮されたストリームの破損に起因する。したがって、救出のプロセスは以下のステップになる。

1. コンテナの解体: ZIPとして展開し、XMLファイルを直接抽出する。
2. XMLの外科手術: `MSXML2.DOMDocument` を用い、破損箇所をスキップして、健全な `` ノードのみを抽出する。
3. データの再注入: 抽出したデータを、正常な新しいステンシルへ VBA を通じて再構成する。

3. 実装:破損した XML からマスター定義を救出するプロフェッショナル・コード

ここでは、破損した `.vssx` から展開された `masters.xml` を読み込み、その中の「ジオメトリ情報」と「シェイプ名」を解析して、新しいステンシルへシェイプを再生成するロジックを示す。

このコードは、Visio の API に依存せず、XML パースエンジン(MSXML2)を主軸に据えることで、ファイルが開けない状況下でも動作する堅牢性を備えている。

' ======================================================================================
' Module: Module_StencilRecovery
' Description: 破損したXML構造からマスターシェイプの属性を抽出し、
'              健全なステンシルへ再構築するためのエンジニアリング・ツール
' Author: Chief Architect
' ======================================================================================

Option Explicit

' XML解析用のライブラリ参照: Microsoft XML, v6.0
' 参照設定に追加していない場合は、Late Binding を使用する設計とする

Public Sub RecoverMastersFromCorruptedXML(ByVal xmlFilePath As String, ByVal targetStencilPath As String)
    Dim xmlDoc As Object ' MSXML2.DOMDocument60
    Dim masterNodes As Object ' IXMLDOMNodeList
    Dim masterNode As Object ' IXMLDOMNode
    Dim targetDoc As Visio.Document
    Dim targetStencil As Visio.Stencil
    Dim newMaster As Visio.Master
    
    On Error GoTo ErrorHandler

    ' 1. XMLドキュメントのロード (Visioを介さず、XMLエンジンで直接叩く)
    Set xmlDoc = CreateObject("MSXML2.DOMDocument.6.0")
    xmlDoc.async = False
    xmlDoc.validateOnParse = False ' 破損に備え、厳格なバリデーションはオフにする
    
    If Not xmlDoc.load(xmlFilePath) Then
        Debug.Print "Critical Error: XMLのロードに失敗。構造が致命的に破壊されています。"
        Debug.Print "Error: " & xmlDoc.parseError.reason
        Exit Sub
    End If

    ' 2. ターゲットとなる健全なステンシルを開く
    Set targetDoc = Visio.Documents.Open(targetStencilPath)
    Set targetStencil = targetDoc.Masters

    ' 3. XML内の <Master> ノードを走査 (Namespaceの扱いに注意)
    ' ※実際のVSSXのNamespaceに合わせて適宜調整が必要
    Set masterNodes = xmlDoc.selectNodes("//Master") 

    Debug.Print "--- Recovery Operation Started ---"

    For Each masterNode In masterNodes
        On Error Resume Next ' 個別のマスターの破損による全停止を防ぐ
        
        Dim mName As String
        Dim mID As String
        
        ' XML属性からマスター情報を抽出
        mName = masterNode.Attributes.getNamedItem("Name").Text
        mID = masterNode.Attributes.getNamedItem("ID").Text
        
        If Err.Number = 0 And mName <> "" Then
            Debug.Print "Attempting to recover Master: " & mName
            
            ' --- ここからが「再構築」のロジック ---
            ' 本来はXML内の <Geometry> ノードを解析し、
            ' Shape.Drawメソッド等で描画する複雑な処理が必要だが、
            ' ここでは概念的な再構成フローを示す
            
            Call ReconstructMaster(targetStencil, mName, masterNode)
            
            Debug.Print "Successfully recovered: " & mName
        Else
            Debug.Print "Skipping corrupted Master node. Error: " & Err.Description
            Err.Clear
        End If
        On Error GoTo ErrorHandler
    Next masterNode

    Debug.Print "--- Recovery Operation Completed ---"
    Exit Sub

ErrorHandler:
    MsgDebug "Unexpected Error in Recovery Loop: " & Err.Description
    Resume Next
End Sub

''' <summary>
''' XMLノードの情報を元に、新しいマスターを構築する
''' </summary>
Private Sub ReconstructMaster(ByRef stencil As Visio.Stencil, ByVal name As String, ByVal node As Object)
    ' 注: この関数は、XML内のジオメトリデータ(Pathデータ)を解析し、
    ' VisioのShapeオブジェクトとして再描画する極めて高度な実装が必要となる。
    ' ここでは、堅牢な設計における「責務の分離」を示すためのスケルトンとする。
    
    Dim tempDoc As Visio.Document
    Set tempDoc = Visio.Documents.Add("") ' 一時的なドキュメントで形状を組み立てる
    
    ' 1. XMLからPathデータを抽出 (例: <Path>タグ内のデータ)
    ' 2. tempDoc.Page(1).Draw(...) で形状を再現
    ' 3. tempDoc.Master.Copy してステンシルへPaste
    ' 4. tempDoc.Close
    
    ' 実務上のヒント: XMLの <Geometry> 内の指令(MoveTo, LineTo等)を
    ' 逐次解析し、VBAのDrawメソッドへ変換するパーサーを実装せよ。
End Sub

Private Sub DebugMsg(ByVal msg As String)
    Debug.Print "[RECOVERY_LOG] " & msg
End Sub

4. アーキテクトの教訓:バグを生まないための設計原則

この救出作業を、そもそも不要にするための設計思想をここに記しておく。

① アトミックな更新(Atomicity)を徹底せよ

ステンシルを更新する際、既存の `.vssx` を直接上書きしてはいけない。必ず「新しいファイルを作成」→「データをコピー」→「古いファイルをリネームしてアーカイブ(バックアップ)」という、アトミックな操作を実装せよ。書き込み中のクラッシュが、資産を即座に破壊する。

② XMLスキーマの検証を自動化せよ

業務ツールの一部としてステンシルを生成する場合、生成後に `MSXML2` を用いて、出力された XML が正しいスキーマ(XSD)に準拠しているかを自動チェックする工程を組み込め。これは「テストコード」ではなく、「品質保証プロセス」の一部だ。

③ 外部データベースとの同期設計

マスターシェイプの定義(名前、ID、シェイプデータ)を、Visioファイル内にのみ閉じ込めるな。重要なメタデータは SQL Server や JSON ファイルとして外部管理し、Visioはあくまで「レンダリングエンジン」として扱う設計にせよ。そうすれば、ファイルが壊れても、データベースから定義を再生成できる。

結びに代えて

「ファイルが壊れた」という事象に直面したとき、ツールを投げ出すか、それとも構造を解体して真実を暴くか。その差が、単なるプログラマーと、伝説的なアーキテクトを分かつ境界線である。

バイナリの背後にある構造を理解せよ。それが、真に堅牢な業務自動化を実現する唯一の道だ。

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