脱・マクロ記録!AutoCAD VBAで「設計工数」を自動可視化するエンジニアリングの極意
こんにちは。設計自動化の世界へようこそ。
「マクロの記録」ボタンを押して、記録されたコードを眺めて「ふーん、こんな感じか」で終わっていませんか? もしそうなら、あなたはまだAutoCAD VBAの「表面」をなぞっている段階です。
本当の自動化エンジニアリングとは、単に作業を楽にするだけではありません。「業務のプロセスをデータ化し、経営や管理に役立つ資産に変えること」。これこそが、私たちが目指すべき真のゴールです。
今日は、その第一歩として、非常に実戦的で、かつ少し高度なアーキテクチャに挑戦しましょう。テーマは「SQL Serverと連携した、図面編集時間の自動ログ記録」です。
「図面を開いた時間」と「閉じた時間」をシステムが勝手に計測し、その差分をデータベースに放り込む。これが実現できれば、設計者が「今日、どの図面にどれくらい時間をかけたか」が、一切の手入力なしで正確に可視化されます。
準備はいいですか? さあ、プロフェッショナルの領域へ踏み出しましょう。
1. 全体像:アーキテクチャを設計する
いきなりコードを書き始めてはいけません。一流のエンジニアは、まず「データの流れ(ライフサイクル)」を設計します。
今回の仕組みは、以下のステップで動きます。
1. 【Openイベント】: 図面が開かれた瞬間、その時刻をメモリ(変数)に保存する。
2. 【作業中】: ユーザーは通常通り設計を行う。
3. 【Closeイベント】: 図面が閉じられる直前に、現在の時刻を取得。
4. 【計算・送信】: 「現在時刻 - 開始時刻」を計算し、SQL Serverへ通信してデータを書き込む。
図解:データのライフサイクル
[ AutoCAD ユーザー操作 ]
│
▼
① 図面を開く ──▶ [ 変数 StartTime に時刻を格納 ]
│
▼
② 設計作業中 ──▶ (何もしない。負荷をかけない)
│
▼
③ 図面を閉じる ─▶ [ 現在時刻を取得 ]
│ [ 経過時間を算出 ]
│ │
▼ ▼
④ DB連携 ─────▶ [ SQL Server へ INSERT 文を発行 ]
2. 事前準備:参照設定の魔法
SQL Serverと通信するためには、VBAに「データベースと話すための言語(ライブラリ)」を教えてあげる必要があります。
1. VBAエディタ(Alt + F11)を開きます。
2. メニューの [ツール] > [参照設定] をクリックします。
3. `Microsoft ActiveX Data Objects 6.1 Library` (バージョンは環境により異なりますが、最新のもの) にチェックを入れて OK を押してください。
これだけで、あなたのVBAは「データベース・エンジニア」の力を手に入れます。
3. 実装:魂を込めたコード
ここからは具体的なコードです。コードは2つのパーツに分けて管理するのが、プロフェッショナルの作法です。
Part A: 標準モジュール(データの保管とDB通信)
まず、図面をまたいでデータを保持するための「グローバル変数」と、実際にSQL Serverへ送るための「通信ロジック」を書きます。
' ============================================================
' 標準モジュール: Module1
' 役割: 状態の保持とデータベース通信のロジック
' ============================================================
Option Explicit
' 図面を開いた時刻を保持するためのグローバル変数
' Public宣言することで、図面が閉じられるまでメモリに残り続けます
Public StartTime As Date
' ログをSQL Serverへ書き込むメインルーチン
' 引数: filePath (図面パス), duration (作業時間/秒)
Sub SendLogToSQL(filePath As String, duration As Double)
Dim conn As ADODB.Connection
Dim strConn As String
Dim strSQL As String
' --- 1. 接続文字列の設定 ---
' ※環境に合わせてサーバー名、DB名、認証情報を書き換えてください
' ここではWindows認証を使用する例です
strConn = "Provider=SQLOLEDB;Data Source=YOUR_SERVER_NAME;" & _
"Initial Catalog=EngineeringDB;Integrated Security=SSPI;"
On Error GoTo ErrorHandler
' --- 2. データベース接続 ---
Set conn = New ADODB.Connection
conn.Open strConn
' --- 3. SQL文の組み立て ---
' 作業時間(秒)を分・秒に変換したり、日付型として扱うなどの加工もここで行えます
strSQL = "INSERT INTO DrawingLogs (FileName, FilePath, WorkSeconds, LogDate) " & _
"VALUES ('" & Mid(filePath, InStrRev(filePath, "\") + 1) & "', " & _
"'" & filePath & "', " & _
duration & ", " & _
"GETDATE());"
' --- 4. SQL実行 ---
conn.Execute strSQL
' クリーンアップ
conn.Close
Set conn = Nothing
Debug.Print "Log successfully sent: " & filePath
Exit Sub
ErrorHandler:
' ここが重要!DB接続エラーでAutoCAD自体が落ちたら本末転倒です。
' エラーはログに出すだけで、ユーザーの作業を妨げないのがプロの配慮です。
MsgBox "ログの送信に失敗しました。ネットワーク接続を確認してください。" & vbCrLf & _
"Error: " & Err.Description, vbExclamation
If Not conn Is Nothing Then
If conn.State = adStateOpen Then conn.Close
End If
End Sub
Part B: ThisDrawingモジュール(イベントの検知)
次に、AutoCADの「図面が開いた」「図面が閉じた」というイベントを捕まえる部分です。これは必ず `ThisDrawing` オブジェクト内に記述してください。
' ============================================================
' ThisDrawing モジュール
' 役割: AutoCADの図面イベント(Open/Close)のハンドリング
' ============================================================
Option Explicit
' --- 図面が開かれた時の処理 ---
Private Sub Document_Open()
' 開いた時刻をグローバル変数に記録
StartTime = Now
Debug.Print "Drawing Opened at: " & StartTime
End Sub
' --- 図面が閉じられる時の処理 ---
Private Sub Document_Close()
Dim EndTime As Date
Dim DurationSeconds As Double
Dim TargetFilePath As String
' 開始時刻が記録されていない(エラーや特殊な開き方)場合は中断
If StartTime = 0 Then Exit Sub
EndTime = Now
TargetFilePath = ThisDrawing.FullName
' 経過秒数を計算 (DateDiff関数を使用)
' "s" は秒単位を指定しています
DurationSeconds = DateDiff("s", StartTime, EndTime)
' もし図面が一度も保存されていない(新規図面)場合はパスが空なので除外
If TargetFilePath = "" Then Exit Sub
' 標準モジュールの通信関数を呼び出す
' 図面が完全に閉じる前に、非同期的に(あるいは即座に)データを飛ばす
Call SendLogToSQL(TargetFilePath, DurationSeconds)
' メモリのクリア
StartTime = 0
End Sub
4. 陥りやすい罠:エンジニアが直面する「壁」
このコードを動かす際、初心者が必ずと言っていいほど躓くポイントが3つあります。ここをクリアすれば、あなたはもう初級者ではありません。
① 変数のスコープ(生存範囲)の誤解
「図面を開いた時刻」を、普通の `Sub` の中で `Dim` 宣言してしまうと、その `Sub` が終わった瞬間に時刻は消えてしまいます。図面を閉じる時まで値を保持させるには、必ず `Public`(標準モジュール) で宣言する必要があります。これが「オブジェクトのライフサイクル」への理解です。
② ネットワークエラーによる「作業の中断」
もし、SQL Serverがメンテナンス中だったり、社内LANが切れていたりしたらどうなるでしょうか?
もしエラー処理(`On Error GoTo`)を書いていないと、「図面を閉じようとしただけでAutoCADがフリーズする」 という最悪の事態を招きます。
「ログ記録は、メイン業務(設計)を絶対に邪魔してはいけない」という哲学を持って、エラーハンドリングを丁寧に書きましょう。
③ 権限の問題
SQL Serverへの書き込みには、実行ユーザーの権限が必要です。開発時は、自分のPCのSQL Expressなどでテストを行い、本番環境では「書き込み専用のDBユーザー」を用意してもらうよう、IT部門と連携する。これもエンジニアの重要な仕事です。
最後に:次の一歩へ
お疲れ様でした! これであなたは、AutoCADを単なる「描画ツール」から、「業務データを生成するエージェント」へと進化させました。
今回構築した仕組みは、まだ基礎の基礎です。
- 「どのコマンドを何回使ったか」という操作ログを組み合わせる。
- 「設計変更(保存)が何回行われたか」を記録する。
- 蓄積されたデータをBIツール(Power BIなど)で可視化し、工数予測を行う。
これらを組み合わせることで、あなたの設計部門は「データに基づいた意思決定」ができる最強の組織へと変わっていくはずです。
「マクロの記録」の先にある、広大な自動化の世界を楽しんでください。応援していますよ!
