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

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

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 への移行を提案できるのが真のアーキテクトだ。

結びに

自動化エンジニアの仕事は、コードを書くことではない。「業務のルールを、デジタルな制約として、いかにエレガントに、かつ強固に実装するか」にある。

今回紹介した設計パターンは、その第一歩だ。データベースとの連携、エラーハンドリング、そして設計思想の選択。これらを疎かにせず、常に「システムが壊れた時に何が起きるか」を問い続けなさい。

それが、伝説的なエンジニアへの唯一の道である。

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