【テクニカル・上級編】【上級プロフェッショナル向け】SQL Server上の「承認ステータス」を確認し、未承認図面の「編集モードでのオープン」を制限するVBA – AutoCAD VBA解析バイブル

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

【極限の設計】SQL Serverによる図面ステータス強制制御:AutoCAD VBAにおける「状態遷移」の完全実装

設計業務のスケールが拡大し、プロジェクトが数千枚の図面を抱えるフェーズに達したとき、現場を崩壊させるのは「技術的負債」ではなく「運用上のヒューマンエラー」だ。

「承認された図面を、誤って編集モードで上書きしてしまう」
「未承認の図面に基づいた設計変更が、そのまま図面へ反映されてしまう」

これらの事象は、個人の注意力の問題ではない。システムが「状態(State)」を強制できていない、アーキテクチャの欠陥である。

本稿では、単なる「ファイルを開くスクリプト」の次元を超え、SQL Serverを単一の真実の源(Single Source of Truth)として活用し、AutoCADのドキュメント・オブジェクト・モデルを制御することで、図面のライフサイクルを物理的に保護する「ガードレール」の実装手法を詳説する。

1. アーキテクチャの概念図:DB駆動型アクセス制御

エンジニアが陥りがちな罠は、AutoCADのローカル環境だけで完結しようとすることだ。堅牢なシステムには、「権限の検証(Validation)」と「実行(Execution)」を分離する必要がある。

1. Data Layer (SQL Server): 図面のパスと、現在の承認ステータス(`Unapproved`, `Approved`, `Released` 等)を管理。
2. Control Layer (VBA/ADO): 図面パスを受け取り、DBへ問い合わせを行い、ステータスに応じた「開き方」を決定する。
3. Application Layer (AutoCAD API): 決定されたフラグ(`ReadOnly`)に基づき、ドキュメントをメモリ上にロードする。

このフローにおいて、VBAは単なるマクロではなく、「ポリシー・エグゼキューター(政策執行者)」として機能しなければならない。

2. 実装の核心:ステータス判定と条件付きオープン

以下に、プロフェッショナルな実装例を示す。ここでは、ADO(ActiveX Data Objects)を用いたDB接続と、AutoCADの`Documents.Open`メソッドの制御を組み合わせる。

実装コード:`modDocumentController`

Option Explicit

' ==============================================================================
' Module: modDocumentController
' Description: SQL Serverのステータスに基づき、図面のオープンモードを制御する
' Author: Chief Architect
' ==============================================================================

' 定数の定義 - 状態管理の整合性を保つため、マジックナンバーを排除する
Private Const STATUS_APPROVED As String = "APPROVED"
Private Const DB_CONN_STR As String = "Provider=SQLOLEDB;Data Source=YOUR_SERVER;Initial Catalog=YOUR_DB;Integrated Security=SSPI;"

''' <summary>
''' 指定された図面を、DBの承認ステータスに応じて適切に開く
''' </summary>
''' <param name="dwgPath">対象のDWGファイルのフルパス</param>
Public Sub ControlledOpen(ByVal dwgPath As String)
    Dim status As String
    Dim isReadOnly As Boolean
    
    ' 1. ファイルの存在確認(Windows APIを呼び出す前の基本動作)
    If Dir(dwgPath) = "" Then
        MsgBox "Error: 指定されたファイルが存在しません。" & vbCrLf & dwgPath, vbCritical
        Exit Sub
    End If

    ' 2. SQL Serverから承認ステータスを取得
    status = GetDrawingStatus(dwgPath)
    
    ' 3. ロジック判定: 承認済み以外はすべて読み取り専用とする
    If status = STATUS_APPROVED Then
        isReadOnly = False
        Debug.Print "Status: APPROVED. Opening in Write Mode."
    Else
        isReadOnly = True
        Debug.Print "Status: " & status & ". Opening in Read-Only Mode."
        ' ユーザーへの警告(業務フロー上の重要な通知)
        MsgBox "警告: この図面は未承認、またはロックされています。" & vbCrLf & _
               "読み取り専用モードで開きます。", vbExclamation, "アクセス制御"
    End If

    ' 4. AutoCADドキュメントのオープン実行
    OpenDocument dwgPath, isReadOnly

End Sub

''' <summary>
''' SQL Serverへ問い合わせを行い、図面の承認ステータスを返す
''' </summary>
Private Function GetDrawingStatus(ByVal dwgPath As String) As String
    Dim conn As ADODB.Connection
    Dim rs As ADODB.Recordset
    Dim sql As String
    Dim result As String
    
    ' 初期化
    result = "UNKNOWN"
    Set conn = New ADODB.Connection
    Set rs = New ADODB.Recordset

    On Error GoTo ErrorHandler

    ' DB接続
    conn.Open DB_CONN_STR
    
    ' SQLクエリの構築 (SQL Injectionを防ぐため、本来はパラメータ化クエリを推奨)
    ' ここではシンプルにするため、パスを直接結合しているが、実運用では厳重に扱うこと
    sql = "SELECT ApprovalStatus FROM DrawingMaster WHERE FilePath = '" & Replace(dwgPath, "'", "''") & "'"
    
    rs.Open sql, conn, adOpenStatic, adLockReadOnly

    If Not rs.EOF Then
        result = rs.Fields("ApprovalStatus").Value
    End If

CleanUp:
    ' メモリ解放の徹底(COMオブジェクトのライフサイクル管理)
    If Not rs Is Nothing Then
        If rs.State = adStateOpen Then rs.Close
    End If
    Set rs = Nothing
    
    If Not conn Is Nothing Then
        If conn.State = adStateOpen Then conn.Close
    End If
    Set conn = Nothing
    Exit Function

ErrorHandler:
    MsgBox "DB Connection Error: " & Err.Description, vbCritical
    Resume CleanUp
End Function

''' <summary>
''' AutoCADのAPIを使用してドキュメントを開く
''' </summary>
Private Sub OpenDocument(ByVal dwgPath As String, ByVal isReadOnly As Boolean)
    Dim acadApp As Object ' AutoCAD.Application
    Dim doc As Object     ' AutoCAD.Document
    
    On Error Resume Next
    Set acadApp = GetObject(, "AutoCAD.Application")
    If Err.Number <> 0 Then
        MsgBox "AutoCADが起動していません。", vbCritical
        Exit Sub
    End If
    On Error GoTo 0

    ' AutoCADのDocuments.Openメソッドを使用
    ' 第2引数のReadOnlyフラグが、本設計の要である
    On Error GoTo OpenError
    Set doc = acadApp.Documents.Open(dwgPath, isReadOnly)
    
    If doc Is Nothing Then
        MsgBox "図面のオープンに失敗しました。ファイルが他のプロセスで使用されている可能性があります。", vbCritical
    End If
    
    Exit Sub

OpenError:
    MsgBox "Document Open Error: " & Err.Description, vbCritical
End Sub

3. アーキテクトの視点:メモリ管理とCOMオブジェクトの生存期間

このコードを実装する際、シニアエンジニアが最も注視すべきは 「COMオブジェクトの明示的解放」 だ。

VBAはガベージコレクションが脆弱であり、特にADO(`ADODB.Connection`)やAutoCADの`Document`オブジェクトを適切に解放しない場合、AutoCADのプロセスがバックグラウンドでゾンビ化したり、DBのコネクションプールを枯渇させたりする原因となる。

鉄則:

1. `Set obj = Nothing` の徹底: 関数を抜ける直前、あるいはエラーハンドリング内で必ず実行すること。
2. `On Error GoTo CleanUp` パターンの採用: エラーが発生しても、必ず解放処理(`CleanUp`)を通るように設計すること。
3. スコープの最小化: オブジェクトの宣言は、それが使用される直前に行い、生存期間を極限まで短くすること。

4. レガシー環境とスケーラビリティへの配慮

本実装は、古いバージョンのAutoCADや、レガシーなSQL Server環境でも動作するよう、堅牢な設計思想に基づいている。

  • Windows APIの検討: もし「ファイル自体がOSレベルでロックされているか」を事前に判定したい場合は、`kernel32.dll` の `CreateFile` 関数を呼び出し、`GENERIC_READ` 権限でファイルハンドルを取得できるかを確認する手法が有効だ。しかし、本設計では「DBによる論理制御」を優先している。
  • パフォーマンス: 図面数が増大した場合、`GetDrawingStatus` を毎回呼び出すのはオーバーヘッドになる。クライアント側でステータスをキャッシュする仕組み、あるいは、図面を開く際の「一括処理」を行うバッチモードの実装を検討すべきである。

結論

図面管理におけるセキュリティとは、単にパスワードをかけることではない。「正しい状態にあるものだけが、正しい方法で操作できる」という秩序を、コードによって強制することである。

この実装により、エンジニアは「間違えて保存してしまった」という取り返しのつかないミスから解放され、本来の設計業務に集中できる。これこそが、真の業務自動化エンジニアが提供すべき価値である。

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