【入門編】【上級プロフェッショナル向け】SQL Serverの「図面管理テーブル」と連携し、特定ユーザー以外は「保存禁止」にするフック処理の実装 – AutoCAD VBA解析バイブル

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

AutoCAD VBAの深淵へようこそ:データベースと同期する「鉄壁の保存制御」実装ガイド

「マクロの記録」で自動化の第一歩を踏み出したあなたへ。
おめでとうございます。あなたは今、単なる「作業の自動化」というフェーズを終え、「システムの構築」という、エンジニアとしての真の領域に足を踏み入れようとしています。

今日、私があなたに伝授するのは、単なるコードの書き方ではありません。
「AutoCADという巨大なアプリケーションを、いかにして自社の業務ルール(権限管理)に従わせるか」という、アーキテクチャ設計の極意です。

具体的には、SQL Server上の権限マスタを参照し、許可されていないユーザーによる図面の書き換えを、保存ボタンが押された瞬間に「物理的に阻止する」という、プロフェッショナルなフック処理の実装に挑みます。

ここをマスターすれば、あなたは「マクロ使い」ではなく、「業務システムエンジニア」へと進化できるはずです。準備はいいですか?

1. コンセプト:なぜ「保存」をフックするのか?

通常、図面の保存はユーザーの自由です。しかし、大規模な設計現場では「この図面は設計変更の承認が降りるまで、誰にも上書きさせたくない」「特定の権限を持つリーダーだけが最終版を保存できる」といった、厳格な統制が必要になります。

これを実現するために、私たちはAutoCADの「イベント(Event)」を利用します。

図解:処理の流れ

1. ユーザーが「保存」を実行(Ctrl+S または アイコンクリック)
2. AutoCADが「保存直前イベント」を発火(まだファイルは書き換えられていない!)
3. VBAが割り込み(フック)

  • 現在のユーザー名を取得
  • SQL Serverへ「このユーザーにこのファイルの保存権限はあるか?」と問い合わせ

4. 判定結果の返却

  • [許可] $\rightarrow$ 保存処理を続行
  • [拒否] $\rightarrow$ 保存処理を強制キャンセル(`Cancel = True`)

この「保存される直前に、運命を左右する判断を下す」というプロセスが、プロフェッショナルな制御の肝となります。

2. 事前準備:道具を揃える

この実装には、外部データベース(SQL Server)と対話するための「ADO (ActiveX Data Objects)」というライブラリを使用します。

ライブラリの参照設定

VBAエディタ(Alt + F11)を開き、メニューの [ツール] $\rightarrow$ [参照設定] から以下にチェックを入れてください。

  • `Microsoft ActiveX Data Objects 6.1 Library` (バージョンは環境により異なります)

これが、VBAがSQL Serverと会話するための「通訳」になります。

3. 実装コード:鉄壁のガードマン

それでは、魂を込めたコードを見ていきましょう。このコードは `ThisDrawing` モジュールに記述することを想定しています。

Option Explicit

' =================================================================
' テーマ:SQL Server連携による図面保存権限の強制制御
' 概要:保存イベントをインターセプトし、DBの権限マスタと照合する
' =================================================================

Private Sub Document_BeforeSave(ByVal SaveAs As Boolean, Cancel As Boolean)
    Dim currentUserName As String
    Dim isAuthorized As Boolean
    
    ' 1. 現在のユーザー名を取得 (Windowsログイン名)
    currentUserName = Environ("USERNAME")
    
    ' 2. データベースに権限を確認
    ' 引数: ユーザー名
    ' 戻り値: 許可されていれば True
    isAuthorized = CheckSavePermission(currentUserName)
    
    ' 3. 判定に基づいた制御
    If isAuthorized = False Then
        ' 【重要】Cancel を True にすることで、AutoCAD本来の保存処理を中断させる
        Cancel = True
        
        ' ユーザーへの警告(これがないと、なぜ保存できなかったか分からず混乱を招く)
        MsgBox "【警告】あなたにはこの図面を上書き保存する権限がありません。" & vbCrLf & _
               "管理者へ申請してください。", vbCritical, "権限エラー"
    Else
        ' 許可されている場合は、何もしない(AutoCADがそのまま保存を進める)
    End If
End Sub

' -----------------------------------------------------------------
' 関数名:CheckSavePermission
' 役割:SQL Serverへ接続し、ユーザーの権限を照合する
' -----------------------------------------------------------------
Private Function CheckSavePermission(ByVal userName As String) As Boolean
    Dim conn As ADODB.Connection
    Dim rs As ADODB.Recordset
    Dim strConn As String
    Dim strSQL As String
    Dim hasPermission As Boolean
    
    ' 初期値は「拒否(安全側)」に設定しておく(Fail-Secureの原則)
    hasPermission = False
    
    ' --- 設定エリア ---
    ' 接続文字列(環境に合わせて書き換えてください)
    ' ※実際の実務では、接続情報は設定ファイルや暗号化された場所から読み込むのが理想的です
    strConn = "Provider=SQLOLEDB;Data Source=SERVER_NAME;Initial Catalog=DB_NAME;User ID=sa;Password=your_password;"
    
    ' 照合用SQL(権限マスタテーブルを想定)
    ' 例: ユーザー名が一致し、かつ PermissionLevel が 1 (管理者) のレコードを探す
    strSQL = "SELECT COUNT(*) FROM UserPermissionMaster " & _
             "WHERE UserName = '" & userName & "' AND CanSaveDWG = 1"
    ' ------------------

    On Error GoTo ErrorHandler
    
    ' 1. データベース接続
    Set conn = New ADODB.Connection
    conn.Open strConn
    
    ' 2. クエリ実行
    Set rs = New ADODB.Recordset
    rs.Open strSQL, conn, adOpenStatic, adLockReadOnly
    
    ' 3. 結果判定(レコードが存在すれば権限あり)
    If Not rs.EOF Then
        If rs.Fields(0).Value > 0 Then
            hasPermission = True
        End If
    End If

CleanUp:
    ' 4. 後始末(オブジェクトのライフサイクル管理はエンジニアの義務)
    If Not rs Is Nothing Then
        If rs.State = adStateOpen Then rs.Close
    End If
    If Not conn Is Nothing Then
        If conn.State = adStateOpen Then conn.Close
    End If
    Set rs = Nothing
    Set conn = Nothing
    Exit Function

ErrorHandler:
    ' データベース接続失敗時などのエラーハンドリング
    MsgBox "データベース通信エラーが発生しました。システム管理者に連絡してください。" & vbCrLf & _
           "Error: " & Err.Description, vbCritical, "システムエラー"
    hasPermission = False ' エラー時は「保存不可」として扱う(安全策)
    Resume CleanUp
End Function

4. プロフェッショナルが教える「極限の知見」

コードを書くだけでは、あなたはまだ「初級者」です。設計者として、以下の3つのポイントを脳に刻んでください。

① Fail-Secure(フェイル・セキュア)の原則

コード内の `hasPermission = False` という初期値に注目してください。
もし、ネットワークトラブルでSQL Serverに接続できなかった場合、どうすべきでしょうか?
「接続できないなら、とりあえず保存させておこう」……これは間違いです。
セキュリティの鉄則は、「何らかの異常が発生したときは、最も安全な状態(=拒否)を選択する」ことです。これをFail-Secureと呼びます。

② オブジェクトのライフサイクルとメモリ管理

`Set rs = Nothing` や `conn.Close` を忘れていませんか?
AutoCADは長時間立ち上げっぱなしにされるアプリケーションです。ループやイベントの中で接続を適切に閉じずに放置すると、メモリリークを引き起こし、最終的にはAutoCADがクラッシュしたり、SQL Serverの接続上限に達してシステム全体を停止させたりします。
「使い終わったら、確実に片付ける」。これは基本中の基本です。

③ パフォーマンスの重み

`Document_BeforeSave` は、ユーザーが保存を押すたびに呼び出されます。
もし、この関数の中で「重たいSQLクエリ」を実行したり、「ネットワーク越しに巨大なファイルを読み込んだり」すると、ユーザーは保存ボタンを押した後に数秒間フリーズしたような感覚に陥ります。
これはユーザー体験(UX)を著しく損ないます。
クエリは「最小限の条件で、最速の結果を返す」ようにインデックスを貼ったテーブルに対して実行してください。

5. まとめ:次なるステップへ

お疲れ様でした。あなたは今、AutoCADを単なる「描画ツール」から、「企業のルールを強制する統制ツール」へと昇華させるコードを手にしました。

最初はエラーが出るかもしれません。接続文字列が間違っているかもしれません。しかし、そのエラーを一つずつ潰していくプロセスこそが、エンジニアとしての血肉となります。

「コードの向こう側には、常に利用者の業務がある」

このことを忘れずに、素晴らしい自動化の世界を切り拓いていってください。応援していますよ。

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