【テクニカル・上級編】【上級プロフェッショナル向け】SQL Serverと連携した「図面編集時間ログ」:図面を閉じる際に編集時間を集計テーブルへ自動記録 – AutoCAD VBA解析バイブル

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

【極限の設計】AutoCAD VBAによる実作業工数計測アーキテクチャ:SQL Server連携による高精度ログ収集

設計現場における「工数管理」は、常に不完全なデータに基づいている。
設計者が手入力する日報、あるいは「図面を開いていた時間」と「実際に設計を行っていた時間」の乖離。これらを排除し、真の設計生産性を可視化するためには、CADアプリケーションのライフサイクルそのものに介入し、データの完全性を担保するシステムが必要だ。

本稿では、AutoCAD VBAを用い、図面のオープン・クローズイベントをフックして、実作業時間をSQL Serverへ極めて低遅延かつ堅牢に記録するアーキテクチャを詳説する。これは単なる「ログ出力」ではない。業務プロセスをデータ駆動型へと変革するための、エンジニアリングの実践である。

1. 設計思想:ライフサイクル・イベントの捕捉

AutoCADにおける図面操作は、`Document` オブジェクトのライフサイクルに依存する。我々がターゲットとするのは、`ThisDrawing` モジュールにおける `Open` および `Close` イベントだ。

しかし、安易な実装は禁物である。図面を閉じる際(`Close`)の処理は、AutoCADのプロセス終了や強制終了と隣り合わせの、極めて不安定なフェーズだ。ここで重いDB接続処理や、エラーハンドリングの不備によるフリーズを発生させれば、設計者のワークフローを破壊することになる。

アーキテクチャの要件

1. 低レイテンシ: 図面を閉じる際の待ち時間を最小化すること。
2. 非同期的な振る舞い: DB接続のタイムアウトがAutoCADのUIスレッドをブロックしない設計。
3. メモリ管理の徹底: COMオブジェクトの明示的な解放により、メモリリークを根絶すること。
4. 原子性(Atomicity): ログの記録は「成功か失敗か」の二択であり、中途半端な状態を残さないこと。

2. 実装:高精度ログ収集エンジン

以下に、実戦投入可能なレベルのコード構造を示す。ここでは、`ThisDrawing` モジュールにイベントハンドラを配置し、外部の標準モジュールでDB通信を制御する構成をとる。

2.1. ThisDrawing モジュール

図面のライフサイクルを監視し、開始時刻をメモリ上に保持する。

' --- ThisDrawing Module ---
Option Explicit

' 図面が開いた時刻を保持するためのプライベート変数
' メモリ上に保持することで、DBへの不要なアクセスを避ける
Private m_OpenTime As Date

' 図面が開かれた時のイベント
Private Sub ThisDrawing_Open()
    On Error GoTo ErrorHandler
    
    ' 開いた時刻を記録
    m_OpenTime = Now
    
    ' デバッグ用途(本番環境では削除またはログレベルを制御)
    Debug.Print "Document Opened at: " & m_OpenTime
    
    Exit Sub

ErrorHandler:
    ' ライフサイクル開始時のエラーは、システム全体に影響しないよう慎重に処理
    MsgBox "Logging Error (Open): " & Err.Description, vbCritical
End Sub

' 図面が閉じられる時のイベント
Private Sub ThisDrawing_Close()
    On Error GoTo ErrorHandler
    
    Dim duration As Double
    Dim dwgName As String
    
    ' データの確定
    dwgName = ThisDrawing.Name
    duration = DateDiff("s", m_OpenTime, Now) ' 秒単位で差分を取得
    
    ' ログ送信プロシージャの呼び出し
    ' ここで重い処理を行わず、制御を専用モジュールに委譲する
    Call LogManager.SubmitWorkLog(dwgName, duration)
    
    Exit Sub

ErrorHandler:
    ' Closeイベントでのエラーは、ユーザーの保存作業を妨げないよう、
    ' 最小限の通知に留めるか、あるいは完全にサイレントにする判断が必要
    Debug.Print "Logging Error (Close): " & Err.Description
End Sub

2.2. LogManager モジュール(標準モジュール)

ADODBを用いたSQL Serverへの通信を担う。ここで最も重要なのは、オブジェクトのライフサイクル管理である。

' --- Standard Module: LogManager ---
Option Explicit

' ADODB Referenceが必要です (Microsoft ActiveX Data Objects x.x Library)
' 外部ライブラリへの依存を最小限にするため、Late Bindingも検討すべきだが、
' 開発時の型安全性確保のため、ここでは Early Binding の体裁をとる
Private Const CONN_STR As String = "Provider=SQLOLEDB;Data Source=YOUR_SERVER;Initial Catalog=YOUR_DB;Integrated Security=SSPI;"

Public Sub SubmitWorkLog(ByVal dwgName As String, ByVal durationSeconds As Double)
    Dim conn As Object ' ADODB.Connection
    Dim cmd As Object  ' ADODB.Command
    Dim userId As String
    
    ' ユーザー情報の取得(Windows環境を前提とする)
    userId = Environ("USERNAME")
    
    On Error GoTo ErrorHandler
    
    ' 1. オブジェクトの生成 (Late Bindingによる互換性確保)
    Set conn = CreateObject("ADODB.Connection")
    Set cmd = CreateObject("ADODB.Command")
    
    ' 2. 接続の確立
    ' ConnectionTimeoutを短く設定し、AutoCADのフリーズを防止する
    conn.ConnectionTimeout = 5 
    conn.Open CONN_STR
    
    ' 3. パラメータ化クエリによるSQL実行
    ' SQLインジェクション対策および実行プランの再利用のため、必ずパラメータを使用すること
    With cmd
        .ActiveConnection = conn
        .CommandText = "INSERT INTO WorkLogs (UserName, FileName, DurationSec, LogTime) " & _
                       "VALUES (?, ?, ?, ?)"
        .CommandType = 4 ' adCmdText
        
        ' パラメータのバインド
        .Parameters.Append .CreateParameter("@User", 200, 1, 50, userId)        ' adVarChar
        .Parameters.Append .CreateParameter("@File", 200, 1, 255, dwgName)      ' adVarChar
        .Parameters.Append .CreateParameter("@Dur", 3, 8, , durationSeconds)   ' adDouble
        .Parameters.Append .CreateParameter("@Time", 135, 7, , Now)            ' adDBTimeStamp
        
        .Execute
    End With

CleanUp:
    ' 4. 【極めて重要】オブジェクトの明示的解放
    ' VBAのガベージコレクションに頼らず、COMオブジェクトの参照カウントをゼロにする
    If Not cmd Is Nothing Then Set cmd = Nothing
    If Not conn Is Nothing Then
        If conn.State = 1 Then conn.Close ' adStateOpen
        Set conn = Nothing
    End If
    Exit Sub

ErrorHandler:
    ' ログ送信の失敗がメイン業務(図面保存)を阻害してはならない
    ' エラーはイベントログやローカルファイルに逃がすのがプロフェッショナルな設計
    Debug.Print "Critical DB Error: " & Err.Description
    Resume CleanUp
End Sub

3. 伝説的アーキテクトによる技術的深掘り

3.1. メモリ管理の極意:なぜ `Set obj = Nothing` なのか

VBAはCOM(Component Object Model)上で動作している。`CreateObject` で生成されたオブジェクトは、参照カウントがゼロになるまでメモリ上に残り続ける。特にAutoCADのような巨大なアプリケーションにおいて、図面を閉じるたびに小さなメモリリークが発生すれば、数日間稼働したCADプロセスは確実に不安定化し、最終的にはクラッシュする。

`SubmitWorkLog` 内で `Set cmd = Nothing` を明示的に行うのは、単なる作法ではない。「リソースの占有時間を極限まで短縮する」という生存戦略である。

3.2. ネットワーク遅延への耐性

図面を閉じる瞬間、ユーザーは「保存が完了した」という安心感を求めている。ここで `conn.Open` がネットワークのタイムアウト待ち(デフォルト30秒〜)に入れば、ユーザー体験は最悪となる。
本実装では `conn.ConnectionTimeout = 5` と設定し、DB接続が遅延している場合は、即座にエラーハンドラへスキップさせている。「工数データが欠損すること」と「設計者の作業を止めること」を天秤にかけた時、後者は絶対に選んではならない。

3.3. レガシー環境への配慮

`SQLOLEDB` プロバイダーを使用しているが、環境によっては `MSOLEDBSQL` (Microsoft OLE DB Driver for SQL Server) への移行が必要になる場合がある。接続文字列の抽象化と、Late Binding(`CreateObject`)の採用は、配布先環境の差異を吸収するための必須テクニックだ。

4. 結論

設計工数の可視化は、単なる管理ツールではない。それは、エンジニアリングの質をデータによって証明するための基盤である。

今回構築したアーキテクチャは、AutoCADのイベント駆動モデルを深く理解し、COMオブジェクトのライフサイクルを完全に制御することで、業務への干渉を最小限に抑えつつ、極めて高いデータの信頼性を実現している。

エンジニアリングとは、常に「例外」と「副作用」との戦いである。このコードが、君たちのシステムに堅牢な秩序をもたらすことを願っている。

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