「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』だったら、私のプログラムはどう振る舞うだろうか?」と。
その問いへの答えこそが、君のコードの品質を決めるのだ。
