【実務・中級編】【実務中級者向け】図面保存時に「未解決の外部参照」を自動検出し、ログファイルへ出力するチェック機能 – AutoCAD VBA解析バイブル

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

【設計思想】データ整合性を守る防波堤:外部参照(Xref)の自動バリデーション実装

CADプロジェクトにおいて、最も致命的な事故の一つは「不完全なデータの納品」だ。
特に、外部参照(Xref)のリンク切れが含まれたまま図面が保存・送付された場合、それを受け取ったクライアントや後工程のエンジニアは、欠損した情報を基に意思決定を行うリスクに晒される。これは単なるミスではない。プロフェッショナルとしての信頼を失墜させる「設計上の欠陥」である。

多くの開発者は、単に「リンクが切れていたらメッセージを出す」というレベルのコードを書く。しかし、業務自動化エンジニアが目指すべきは、「エラーを検出し、ログを記録し、システムの整合性を担保する、堅牢なバリデーション・エンジン」の構築だ。

本稿では、AutoCAD VBAを用い、図面保存直前に外部参照の状態をスキャンし、不整合をログファイルへ強制出力する、プロダクション品質のバリデーションロジックを伝授する。

1. 設計思想:なぜ「単純なループ」では足りないのか

まず、初心者が陥りがちな設計ミスを指摘しておこう。
「すべてのブロックをループして、名前をチェックする」といった実装は、大規模な図面においてはパフォーマンスの劣化を招くだけでなく、例外処理(エラーハンドリング)が不十分なため、参照パスの特殊な形式(相対パス、絶対パス、サーバーパス)に対応できず、ツール自体がクラッシュする原因となる。

我々が実装すべき設計原則は以下の3点だ。

1. Single Responsibility Principle (単一責任の原則):
「参照のチェック」「ログの書き出し」「イベントの検知」を分離せよ。これらが混ざると、テストが不可能になり、保守性が死ぬ。
2. Defensive Programming (防御的プログラミング):
ファイルパスの存在確認、権限不足、ネットワーク切断など、外部要因によるエラーを前提としたコードを書け。
3. Audit Trail (監査証跡):
単に画面に警告を出すだけでは不十分だ。いつ、どの図面で、どの参照が壊れていたのかを「ログ」として残すことで、問題の追跡を可能にする。

2. 実装フェーズ:堅牢なバリデーション・エンジンの構築

以下に、クラスモジュールを活用した、保守性の高い実装例を示す。

A. ログ管理モジュール (Standard Module)

まず、ログ出力を担当する独立した関数を用意する。これにより、将来的にログの出力先をテキストファイルからデータベースやExcelに変更したくなった際も、このモジュールを修正するだけで済む。

' --- Module: ModLogger ---
Option Explicit

''' <summary>
''' 指定されたメッセージをログファイルに追記する
''' </summary>
''' <param name="msg">出力するメッセージ</param>
Public Sub WriteLog(ByVal msg As String)
    On Error GoTo ErrorHandler
    
    Dim logPath As String
    Dim fileNum As Integer
    
    ' ログファイルの保存先(実行ファイルと同じディレクトリを推奨)
    logPath = ThisDrawing.Path & "\Xref_Validation_Log.txt"
    If ThisDrawing.Path = "" Then logPath = CurDir & "\Xref_Validation_Log.txt"
    
    fileNum = FreeFile
    
    ' 追記モード(Append)で開く
    Open logPath For Append As #fileNum
    Print #fileNum, "[" & Now & "] " & msg
    Close #fileNum
    
    Exit Sub

ErrorHandler:
    ' ログ出力自体の失敗は致命的ではないが、デバッグ用にイミディエイトウィンドウへ
    Debug.Print "Log Write Error: " & Err.Description
End Sub

B. バリデーション・エンジン (Class Module)

次に、外部参照の状態を判定する心臓部だ。`Block`オブジェクトを走査し、その状態を厳密に評価する。

' --- Class Module: clsXrefValidator ---
Option Explicit

Private m_ErrorCount As Integer

''' <summary>
''' 外部参照の整合性をチェックする
''' </summary>
''' <returns>エラーがあった場合はTrue</returns>
Public Function ValidateXrefs() As Boolean
    Dim objBlock As AcadBlock
    Dim xRefPath As String
    Dim fso As Object
    
    Set fso = CreateObject("Scripting.FileSystemObject")
    m_ErrorCount = 0
    
    ' 全てのブロック定義を走査
    For Each objBlock In ThisDrawing.Blocks
        ' ブロックが外部参照(Xref)であるかを確認
        If objBlock.IsXref Then
            ' 参照パスを取得
            xRefPath = objBlock.Path
            
            ' 状態の判定ロジック
            ' 1. パスが空でないか
            ' 2. ファイルが物理的に存在するか
            If xRefPath = "" Then
                ReportError objBlock.Name, "Path is empty (Detached or Invalid)"
            Else
                ' FileSystemObjectを使用して物理的な存在確認
                If Not fso.FileExists(xRefPath) Then
                    ReportError objBlock.Name, "File not found: " & xRefPath
                End If
            End If
        End If
    Next objBlock
    
    ValidateXrefs = (m_ErrorCount > 0)
    Set fso = Nothing
End Function

''' <summary>
''' エラーをカウントし、ログへ出力する内部メソッド
''' </summary>
Private Sub ReportError(ByVal blockName As String, ByVal reason As String)
    m_ErrorCount = m_ErrorCount + 1
    Dim logMsg As String
    logMsg = "ERROR: [Block: " & blockName & "] -> " & reason
    
    ' 標準モジュールのログ関数を呼び出し
    Call ModLogger.WriteLog(logMsg)
    
    ' ユーザーへの即時通知(デバッグ用)
    Debug.Print logMsg
End Sub

Public Property Get ErrorCount() As Integer
    ErrorCount = m_ErrorCount
End Property

C. イベントハンドラ (ThisDrawing Module)

最後に、図面保存のイベントにフックさせる。ここで、ユーザーの操作をインターセプトし、バリデーションを実行する。

' --- ThisDrawing Module ---
Option Explicit

''' <summary>
''' 保存直前に実行されるイベント
''' </summary>
Private Sub Document_BeforeSave(ByVal SaveMode As Integer, ByVal FileName As String)
    Dim validator As New clsXrefValidator
    
    ' バリデーション実行
    If validator.ValidateXrefs() Then
        ' 警告ダイアログの表示
        Dim msg As String
        msg = "【警告】外部参照に未解決のリンクが含まれています。" & vbCrLf & _
              "エラー数: " & validator.ErrorCount & vbCrLf & _
              "詳細はログファイルを確認してください。"
        
        MsgBox msg, vbCritical, "Xref Validation Failed"
        
        ' ここで保存をキャンセルするかどうかは運用次第
        ' 厳格な運用なら、保存を阻止するために以下のコメントアウトを外す
        ' Cancel = True 
    End If
    
    Set validator = Nothing
End Sub

3. プロフェッショナルの視点:パフォーマンスと運用上の注意点

このコードを実戦投入するにあたり、以下の「重み」を理解しておく必要がある。

パフォーマンスの最適化

`For Each objBlock In ThisDrawing.Blocks` は、図面内のすべてのブロック定義を走査する。数万個のブロックを持つ超大規模図面では、保存ボタンを押してから数秒のラグが発生する。
もしパフォーマンスが問題になる場合は、`Blocks`コレクションを直接回すのではなく、`Xref`情報のみを保持している特定のコレクションや、ダイレクトなAPIコールを検討すべきだが、VBAの範囲内ではこの実装が最も堅実でバグが少ない。

ファイルパスの罠

`objBlock.Path` が返す文字列は、図面の「相対パス」設定によって挙動が変わる。

  • `C:\Projects\Drawing.dwg` (絶対パス)
  • `.\Xref\Sub.dwg` (相対パス)

本コードでは `FileSystemObject` を使用しているため、相対パスであっても、AutoCADの現在のカレントディレクトリに基づいた適切な判定が可能だ。これは、単なる文字列比較を行う実装に対する大きなアドバンテージである。

運用ルールとしての「保存キャンセル」

コード内の `Cancel = True` を有効にすると、エラーがある限り保存ができなくなる。これは「不完全なデータの流出」を物理的に防ぐ強力な手段だが、緊急時に作業を妨げる「毒」にもなり得る。
現場の運用に合わせて、「警告は出すが保存は許可する(ただしログは必ず残す)」のか、「エラーがある限り保存を禁ずる」のか、設計段階で合意形成しておくことが、ツールを「使い物になる」ものにするための条件だ。

結論

自動化ツールを作る際、我々は「動くもの」を作っているのではない。「仕組み」を作っているのだ。
エラーを検出し、それを記録し、再発を防止するためのプロセスを組み込む。この一歩こそが、単なるスクリプターと、真のエンジニアを分かつ境界線である。

このバリデーション・ロジックを、君のプロジェクトの「防波堤」として組み込んでほしい。

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