設計工数の「真実」を掴む:AutoCAD VBAとSQL Serverによる堅牢な編集時間ログ・アーキテクチャ
設計現場における「工数管理」は、常に不確実性の霧の中にあります。「この図面、完成まで何時間かかった?」という問いに対し、多くの現場では設計者の「記憶」という極めて不確実なデータが回答として提示されます。
エンジニアリングの本質は、主観を排除し、客観的なデータに基づいてプロセスを最適化することにあります。
本記事では、AutoCAD VBAを用いて、図面の「オープン時刻」と「クローズ時刻」を正確に捕捉し、SQL Serverへ自動記録する、実戦投入レベルのシステム設計について解説します。単なるコードの書き方ではなく、「ユーザー体験(UX)を損なわずに、いかにデータの整合性を担保するか」という、アーキテクトの視点から論じていきます。
1. 素人が陥る「致命的な設計ミス」:同期処理の罠
多くの開発者が最初に書くコードは、おそらくこのようなものです。
' --- アンチパターン:絶対に真似してはいけない ---
Private Sub Document_Close()
Dim conn As Object
Set conn = CreateObject("ADODB.Connection")
conn.Open "Server=myServer;Database=myDB;..."
' ここで重たいINSERT処理...
conn.Execute "INSERT INTO WorkLog ..."
conn.Close
End Sub
一見、動いているように見えます。しかし、これはプロダクションコードとしては「欠陥品」です。理由は以下の3点に集約されます。
1. I/OブロッキングによるUXの破壊: 図面を閉じようとした瞬間に、ネットワーク経由のSQL接続が発生します。もしDBサーバーが応答遅延を起こしていたら? ユーザーは「図面を閉じられない」というストレスを抱え、最悪の場合、AutoCADごとフリーズします。
2. オブジェクトのライフサイクル無視: `Document_Close` イベントが発生した時点では、既にドキュメントオブジェクトの破棄プロセスが始まっています。ここで複雑なロジックを走らせるのは、崩れゆく砂の城の上で作業するようなものです。
3. 例外処理の欠如: DB接続エラーが発生した場合、エラーハンドリングが不適切だとAutoCAD自体が異常終了(クラッシュ)します。
2. プロフェッショナルの設計思想:疎結合と堅牢性
我々が目指すべきは、「図面の操作」と「データの記録」を論理的に分離(Decouple)した設計です。
アーキテクチャの要件
- インメモリ管理: オープン時刻は、メモリ上の `Dictionary` オブジェクトで管理し、ファイルパスをキーとして保持する。
- Fail-Fast(フェイルファスト): DB通信に失敗しても、ユーザーの作業(図面を閉じる動作)を絶対に妨げない。エラーはログに吐き出すだけで、ユーザーには見せない。
- Parameterized Query(パラメータ化クエリ): SQLインジェクションを防ぎ、データ型の整合性を保つため、文字列連結によるSQL構築は厳禁。
3. 実装:プロダクション・グレードのコード
以下に、実務でそのまま利用可能な構成例を示します。
※ `Microsoft Scripting Runtime` および `Microsoft ActiveX Data Objects x.x Library` への参照設定が必要です。
A. 共通管理モジュール (`modTimeTracker`)
図面ごとの開始時刻を保持するためのシングルトン的な役割を果たします。
Option Explicit
' 図面パスをキー、開始時刻を値とするDictionary
' 参照設定: Microsoft Scripting Runtime
Public OpenTimeDict As Scripting.Dictionary
' 初期化ルーチン
Public Sub InitializeTracker()
If OpenTimeDict Is Nothing Then
Set OpenTimeDict = New Scripting.Dictionary
End If
End Sub
' 開始時刻の記録
Public Sub RecordStartTime(ByVal dwgPath As String)
InitializeTracker
If Not OpenTimeDict.Exists(dwgPath) Then
OpenTimeDict.Add dwgPath, Now
End If
End Sub
' 開始時刻の取得
Public Function GetStartTime(ByVal dwgPath As String) As Variant
InitializeTracker
If OpenTimeDict.Exists(dwgPath) Then
GetStartTime = OpenTimeDict(dwgPath)
Else
GetStartTime = Empty
End If
End Sub
' 記録の削除
Public Sub RemoveStartTime(ByVal dwgPath As String)
If Not OpenTimeDict Is Nothing Then
If OpenTimeDict.Exists(dwgPath) Then OpenTimeDict.Remove dwgPath
End If
End Sub
B. データベース通信モジュール (`modDBEngine`)
DBとの通信をカプセル化し、エラーが発生しても呼び出し元を殺さない設計にします。
Option Explicit
' 参照設定: Microsoft ActiveX Data Objects x.x Library
Private Const CONN_STR As String = "Provider=SQLOLEDB;Data Source=YOUR_SERVER;Initial Catalog=YOUR_DB;Integrated Security=SSPI;"
' ログの書き込み(非同期的な挙動を意識した設計)
Public Sub LogWorkTime(ByVal dwgPath As String, ByVal startTime As Date, ByVal endTime As Date)
On Error GoTo ErrorHandler
Dim conn As ADODB.Connection
Dim cmd As ADODB.Command
Set conn = New ADODB.Connection
' タイムアウト設定を短めにし、ユーザーを待たせない
conn.ConnectionTimeout = 5
conn.Open CONN_STR
Set cmd = New ADODB.Command
With cmd
.ActiveConnection = conn
.CommandText = "usp_InsertDrawingLog" ' ストアドプロシージャの使用を推奨
.CommandType = adCmdStoredProc
' パラメータのバインド(SQLインジェクション対策)
.Parameters.Append .CreateParameter("@FilePath", adVarChar, adParamInput, 512, dwgPath)
.Parameters.Append .CreateParameter("@StartTime", adDBTimeStamp, adParamInput, , startTime)
.Parameters.Append .CreateParameter("@EndTime", adDBTimeStamp, adParamInput, , endTime)
.Execute
End With
CleanUp:
If Not conn Is Nothing Then
If conn.State = adStateOpen Then conn.Close
End If
Set cmd = Nothing
Set conn = Nothing
Exit Sub
ErrorHandler:
' プロダクション環境では、ここでWindowsイベントログやローカルテキストファイルにエラーを記録する
' ユーザーには一切通知せず、作業を継続させる
Debug.Print "DB Log Error: " & Err.Description
Resume CleanUp
End Sub
C. 図面イベントハンドラ (`ThisDrawing`)
ここでライフサイクルをフックします。
Option Explicit
Private Sub Document_Open()
' 図面が開かれた瞬間の時刻を記録
modTimeTracker.RecordStartTime ThisDrawing.FullName
End Sub
Private Sub Document_Close()
Dim startTime As Variant
Dim dwgPath As String
dwgPath = ThisDrawing.FullName
startTime = modTimeTracker.GetStartTime(dwgPath)
' 開始時刻が記録されている場合のみ処理
If Not IsEmpty(startTime) Then
' 図面を閉じる際、即座にDBへ飛ばす。
' ただし、modDBEngine側でタイムアウトを制御しているため、
' ネットワーク遅延があってもユーザーへの影響は最小限に抑えられる。
modDBEngine.LogWorkTime dwgPath, CDate(startTime), Now
' メモリからも削除
modTimeTracker.RemoveStartTime dwgPath
End If
End Sub
4. チーフアーキテクトからのアドバイス:運用上の要諦
このシステムを真に「プロフェッショナル」なものにするために、以下の3点を必ず検討してください。
① ストアドプロシージャの活用
VBAから直接 `INSERT INTO…` を発行するのは避けてください。SQL Server側に `usp_InsertDrawingLog` というストアドプロシージャを作成し、そこで「ファイル名からプロジェクト名を特定する」「重複記録をチェックする」といったロジックを実装してください。ビジネスロジックはVBAではなく、DB側に持たせるのが鉄則です。
② クラッシュへの備え
VBAの `Document_Close` は、AutoCADが異常終了(Crash)した場合には実行されません。これは避けられない限界です。
「完璧なデータ」を目指すのではなく、「統計的に有意なデータ」を収集するというスタンスを持ってください。もし100%の精度が求められるなら、VBAではなく、AutoCAD .NET APIを使用して、AutoCADのプロセス外で動作するサービスを構築する必要があります。
③ セキュリティ
接続文字列(Connection String)をコード内にハードコードしてはいけません。環境変数、あるいは暗号化された設定ファイルから読み込む仕組みを導入してください。
結びに
「自動化」の真の価値は、単に作業を減らすことではなく、「人間が意識せずとも、価値あるデータが蓄積される仕組みを作ること」にあります。
今回紹介したアーキテクチャは、ユーザーの作業フローを邪魔することなく、設計プロセスの可視化を実現するための、堅牢な第一歩となります。この設計思想を胸に、より高度な業務自動化の世界へ踏み出してください。
