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

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

脱・マクロ記録!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など)で可視化し、工数予測を行う。

これらを組み合わせることで、あなたの設計部門は「データに基づいた意思決定」ができる最強の組織へと変わっていくはずです。

「マクロの記録」の先にある、広大な自動化の世界を楽しんでください。応援していますよ!

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