【実務・中級編】【初心者向け】ThisDrawing.Pathの長さ判定による「未保存図面(Drawing1)」の保存強制ロジック – AutoCAD VBA解析バイブル

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

「Drawing1」の恐怖を排除せよ:ThisDrawing.Path を用いた堅牢な図面保存強制ロジックの設計思想

業務自動化ツールを開発する際、我々エンジニアが最も恐れるべきは、プログラムの計算ミスでも、ループの無限回帰でもない。「ユーザーが意図せず、未保存の図面(Drawing1.dwg)に対して重篤な処理を実行してしまうこと」だ。

想像してみてほしい。数千個のオブジェクトを走査し、複雑な属性値を書き換え、外部データベースへログを書き込む――そんな数分間に及ぶ高負荷なマクロを実行した直後、図面が「保存されていない」ために、すべての成果が揮発する瞬間を。これは単なる「不便」ではなく、ツールの「信頼性」に対する致命的な欠陥である。

本稿では、AutoCAD VBAにおける「未保存図面」を検知し、確実に保存プロセスへと誘導するための、プロフェッショナルな設計手法を伝授する。

1. なぜ `ThisDrawing.Saved` では不十分なのか

初心者が陥りがちなミスに、「`ThisDrawing.Saved` プロパティを確認すれば、保存状況がわかる」という誤解がある。

しかし、`Saved` プロパティが返しているのは、「図面内に未保存の変更があるか」という変更フラグの状態に過ぎない。新規作成直後の「Drawing1」は、変更がないため `True` を返す場合がある。つまり、「ファイルとしてディスク上に存在するかどうか」という実体(パス)の有無を判定するには、`ThisDrawing.Path` を見るのが最も確実で、かつ軽量なアプローチなのだ。

設計の極意:ガード句(Guard Clause)の導入

プロフェッショナルなコードは、メインロジックに入る前に「前提条件」を徹底的に排除する。これを「ガード句」と呼ぶ。
「図面が保存されていること」を前提条件とし、満たされない場合は即座に処理を中断、あるいは保存ダイアログへ誘導する。これが、バグの起きない堅牢な設計の第一歩である。

2. 実装:プロダクション・グレードの保存強制ロジック

以下に、実務でそのまま利用可能な、保守性の高いコード例を示す。単に `SaveAs` を呼ぶのではなく、ユーザーのキャンセル操作にも対応し、エラーハンドリングを組み込んだ設計にしている。

Option Explicit

''' <summary>
''' 図面がディスク上に保存されていることを保証する。
''' 未保存の場合は保存ダイアログを表示し、ユーザーがキャンセルした場合は処理を中断する。
''' </summary>
''' <returns>図面が有効なパスを持っている場合は True、キャンセルされた場合は False</returns>
Public Function EnsureDrawingIsSaved() As Boolean
    On Error GoTo ErrorHandler
    
    ' 1. ガード句: Pathプロパティが空文字列なら、未保存の図面と判断
    ' ThisDrawing.Path は、ファイルがディスクに存在しない場合、空の文字列 "" を返す
    If ThisDrawing.Path = "" Then
        Debug.Print "Status: Unsaved drawing detected. Prompting user for SaveAs..."
        
        ' 2. SaveAsダイアログの呼び出し
        ' 注意: AutoCADのVBAにおいて、ダイアログを表示して保存させる標準的な手法
        ' ※環境により、SaveAsメソッドの引数制御が必要な場合がある
        ThisDrawing.SaveAs ThisDrawing.FullName ' 一旦、デフォルト名で試行(あるいは適切なパス指定)
        
        ' 保存後の再チェック(ユーザーがダイアログを閉じた後の状態を確認)
        If ThisDrawing.Path = "" Then
            MsgBox "図面が保存されていません。処理を中断します。", vbCritical, "致命的エラー"
            EnsureDrawingIsSaved = False
            Exit Function
        End If
    End If

    ' 3. 既に変更がある場合は、上書き保存の確認を促す設計も検討すべきだが、
    ' 今回は「パスの存在(未保存の回避)」に焦点を当てる。
    EnsureDrawingIsSaved = True
    Exit Function

ErrorHandler:
    MsgBox "保存処理中に予期せぬエラーが発生しました: " & Err.Description, vbExclamation, "Error"
    EnsureDrawingIsSaved = False
End Function

''' <summary>
''' メインの業務ロジック
''' </summary>
Public Sub ExecuteBusinessProcess()
    ' --- ステップ1: 前提条件のチェック(ここが重要) ---
    If Not EnsureDrawingIsSaved() Then
        ' ガード句によって、未保存図面での実行を阻止
        Exit Sub
    End If
    
    ' --- ステップ2: メイン処理の開始 ---
    On Error GoTo MainErrorHandler
    
    Debug.Print "Starting heavy process on: " & ThisDrawing.FullName
    
    ' ここに実際の業務ロジック(DB連携、オブジェクト操作等)を記述
    ' 例: Call DataSyncWithDatabase
    
    MsgBox "処理が正常に完了しました。", vbInformation, "Success"
    
    Exit Sub

MainErrorHandler:
    MsgBox "業務処理中にエラーが発生しました。図面の整合性を確認してください。" & vbCrLf & _
           "Error: " & Err.Description, vbCritical, "Process Failure"
End Sub

3. データベース・外部ファイル連携時の致命的な落とし穴

もし君が、図面内の情報を外部のSQLデータベースやCSVファイルに書き出すツールを作っているなら、この `Path` チェックは「オプション」ではなく「必須要件」だ。

なぜ連携において重要なのか?

多くの自動化ツールでは、以下のようなログ記録を行う。

  • `Log_Table.Insert(Drawing_Path, User_ID, Timestamp)`

もし `ThisDrawing.Path` が空のまま処理が進み、データベースに書き込みが行われた場合、`Drawing_Path` カラムには空の文字列が入り、「どの図面に対する操作だったのか」という追跡可能性(Traceability)が完全に失われる。 これは、エンタープライズ環境における監査ログとしては「ゴミ」に等しい。

設計上のアドバイス

1. コンテキストの確立: 外部リソース(DB/File)にアクセスする前に、必ず「操作対象の識別子(この場合はファイルパス)」が確定していることを保証せよ。
2. トランザクションの意識: 図面の保存に失敗したなら、データベースへの書き込みもロールバック(あるいは実行しない)という設計思想を持て。

4. まとめ:エンジニアとしての矜持

「動けばいい」というコードは、誰でも書ける。しかし、「失敗した時に、いかに被害を最小限に食い止めるか」を設計できるのが、真のエンジニアである。

`ThisDrawing.Path` の長さを判定するという、一見すると些細なチェック。しかし、この一行が、ユーザーの数時間を守り、データの整合性を担保し、ツールのプロフェッショナリズムを証明する。

次にコードを書くときは、自分に問いかけてほしい。
「もし、この図面が『Drawing1』だったら、私のプログラムはどう振る舞うだろうか?」と。

その問いへの答えこそが、君のコードの品質を決めるのだ。

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