AutoCAD VBAを掌握する極限の知見:SQL Server連携による「権限制御型保存プロセス」の設計思想
業務自動化の世界において、「動くコード」を書くことは容易だ。しかし、エンタープライズ環境で「壊れない、そして運用に耐えうるシステム」を構築できるエンジニアは極めて稀である。
今回扱うテーマは、SQL Serverの権限マスタと連携し、許可されたユーザーのみに上書き保存を許可するという、極めてクリティカルな制御である。これは単なる「if文の追加」ではない。データベースの遅延、ネットワークの切断、そしてAutoCADのイベントハンドリングの特性を考慮した、高度な設計判断が求められる領域だ。
この記事では、凡庸なプログラマーが陥る罠を回避し、プロフェッショナルとして実装すべき「堅牢な制御ロジック」を伝授する。
1. アーキテクチャの設計:なぜ「単純なイベント監視」では不十分なのか
多くの開発者は、AutoCADの`BeforeSave`イベントをフックし、その中でSQL Serverに問い合わせを行おうとする。しかし、ここに致命的な設計ミスが潜んでいる。
罠1:イベントのキャンセル不能性
AutoCAD VBAの標準的な`DocumentEvents`における`BeforeSave`イベントには、実は「保存処理を完全にキャンセルする」ための`Cancel`引数が存在しない(※.NET APIとは異なる)。つまり、保存が走り始めた後に「あ、権限がないから止める」という後追いの処理は、図面の整合性を破壊するリスクを伴う。
罠2:DB接続のオーバーヘッド
保存のたびにSQL Serverへ新規接続(Connection Open)を行っていれば、ネットワーク遅延が発生した瞬間にAutoCADのUIがフリーズする。ユーザー体験(UX)を著しく損なう、エンジニアとして最も避けるべき設計だ。
解決策:Command Wrapper(コマンド・ラッパー)戦略
真のプロフェッショナルは、ネイティブの`QSAVE`に頼らず、「権限チェックを内包したカスタム保存コマンド」を定義し、ユーザーの操作をそのフローへ誘導する設計をとる。
2. 実装の要:堅牢なモジュール構成
設計思想に基づき、以下の3つのレイヤーで構成する。
1. Data Access Layer (DAL): SQL Serverとの通信をカプセル化し、接続の再利用とエラーハンドリングを担う。
2. Business Logic Layer (BLL): 現在のユーザーが権限を持っているかを判定する。
3. Presentation/Command Layer: AutoCADのコマンドとして実行され、ユーザーに結果を通知する。
プロダクションレベルのコード例
以下のコードは、保守性と再利用性を極限まで高めた実装例である。
# Module: `modDBManager` (Data Access Layer)
DB接続の管理を単一のモジュールに集約する。
'-------------------------------------------------------------------------------
' Module: modDBManager
' Purpose: SQL Serverとのセキュアな通信管理
'-------------------------------------------------------------------------------
Option Explicit
Private Const CONN_STR As String = "Provider=SQLOLEDB;Data Source=YOUR_SERVER;Initial Catalog=YourDB;Integrated Security=SSPI;"
Private conn As ADODB.Connection
' DB接続の取得(シングルトン・パターンを模倣)
Public Function GetConnection() As ADODB.Connection
On Error GoTo ErrHandler
If conn Is Nothing Then
Set conn = New ADODB.Connection
conn.ConnectionString = CONN_STR
conn.Open
End If
Set GetConnection = conn
Exit Function
ErrHandler:
MsgBox "データベース接続に失敗しました。ネットワーク環境を確認してください。", vbCritical, "System Error"
Set GetConnection = Nothing
End Function
' 接続の明示的なクローズ
Public Sub CloseConnection()
If Not conn Is Nothing Then
If conn.State = adStateOpen Then conn.Close
Set conn = Nothing
End If
End Sub
# Module: `modPermissionControl` (Business Logic Layer)
権限判定のロジック。ここで「Fail-Safe(失敗時は許可)」か「Fail-Secure(失敗時は禁止)」かを決定する。
'-------------------------------------------------------------------------------
' Module: modPermissionControl
' Purpose: ユーザー権限の検証ロジック
'-------------------------------------------------------------------------------
Option Explicit
' ユーザーに保存権限があるか判定
Public Function IsUserAuthorized() As Boolean
Dim dbConn As ADODB.Connection
Dim rs As ADODB.Recordset
Dim sql As String
Dim currentUser As String
' Windowsのログインユーザー名を取得
currentUser = Environ("USERNAME")
' 判定ロジック:Fail-Secure(DBエラー時は保存禁止)を採用
IsUserAuthorized = False
Set dbConn = GetConnection()
If dbConn Is Nothing Then Exit Function ' 接続失敗時は既にFalse
' SQL Serverへのクエリ(権限マスタを照合)
sql = "SELECT PermissionLevel FROM UserPermissions WHERE UserName = '" & Replace(currentUser, "'", "''") & "'"
Set rs = New ADODB.Recordset
rs.Open sql, dbConn, adOpenStatic, adLockReadOnly
If Not rs.EOF Then
' 'Editor' または 'Admin' 権限を持つ場合のみ許可
If rs.Fields("PermissionLevel").Value = "Editor" Or rs.Fields("PermissionLevel").Value = "Admin" Then
IsUserAuthorized = True
End If
End If
rs.Close
Set rs = Nothing
End Function
# Module: `modMainCommand` (Command Layer)
ユーザーが実際に叩く「カスタム保存コマンド」。
'-------------------------------------------------------------------------------
' Module: modMainCommand
' Purpose: AutoCADへのコマンド登録と実行フロー
'-------------------------------------------------------------------------------
Option Explicit
' AutoCAD起動時に実行される初期化ルーチン
Public Sub InitializeSystem()
' ここでコマンドのエイリアス設定や、UIのカスタマイズを行う
Debug.Print "Permission System Initialized."
End Sub
' カスタム保存コマンド (ユーザーにはこれを実行させる)
' 実際の運用では、QSAVEの代わりにこのコマンドをボタンやショートカットに割り当てる
Public Sub SecureSave()
On Error GoTo ErrHandler
' 1. 権限チェック
If IsUserAuthorized() Then
' 2. 権限あり:ネイティブの保存コマンドを実行
ThisDrawing.SendCommand "_QSAVE "
MsgBox "保存が完了しました。", vbInformation, "Success"
Else
' 3. 権限なし:警告を表示して終了
MsgBox "【警告】あなたにはこの図面を上書き保存する権限がありません。" & vbCrLf & _
"管理者へ連絡してください。", vbCritical, "Access Denied"
End If
Exit Sub
ErrHandler:
MsgBox "保存プロセス中に予期せぬエラーが発生しました: " & Err.Description, vbCritical, "Error"
End Sub
3. プロフェッショナルが意識すべき「極限の注意点」
このシステムをプロダクション環境へ投入する際、君が必ず直面する課題が3つある。
① Fail-Safe vs Fail-Secure の選択
設計において最も重要な決断だ。
- Fail-Safe (失敗時は許可): DBがダウンしている時、作業を止めないために保存を許可する。業務効率は高いが、セキュリティリスクがある。
- Fail-Secure (失敗時は禁止): DBがダウンしている時、一切の保存を禁じる。セキュリティは完璧だが、DB障害が即、全社の業務停止に直結する。
設計者として、どちらのコストが重いかをステークホルダーと合意しておくこと。
② SQLインジェクションへの対策
上記のコードでは `Replace(currentUser, “‘”, “””)` を用いて最低限の対策を行っているが、本来はパラメータ化クエリを使用すべきだ。VBA(ADODB)におけるパラメータ化クエリの実装はやや煩雑だが、セキュリティを妥協してはならない。
③ ユーザーへの「強制力」の持たせ方
VBAで「コマンドを置き換える」だけでは、ユーザーは `QSAVE` と直接入力すれば回避できてしまう。
- 究極の対策: AutoCADのプロファイルや、`.arg` ファイル、あるいは .NET Add-in を使用して、標準の `QSAVE` コマンド自体をフックし、強制的に自作のロジックへリダイレクトさせる必要がある。VBAの限界を知り、必要に応じて .NET への移行を提案できるのが真のアーキテクトだ。
結びに
自動化エンジニアの仕事は、コードを書くことではない。「業務のルールを、デジタルな制約として、いかにエレガントに、かつ強固に実装するか」にある。
今回紹介した設計パターンは、その第一歩だ。データベースとの連携、エラーハンドリング、そして設計思想の選択。これらを疎かにせず、常に「システムが壊れた時に何が起きるか」を問い続けなさい。
それが、伝説的なエンジニアへの唯一の道である。
