【テクニカル・上級編】【上級プロフェッショナル向け】AutoCADの「自動保存(.sv$)」ファイルをVBAで定期的にスキャンし、クラッシュ対策の独自バックアップを構築 – AutoCAD VBA解析バイブル

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

AutoCADの「自動保存」を信じるな:`.sv$`ファイルを掌握し、堅牢な世代管理バックアップを構築する

AutoCADを利用する大規模プロジェクトや、極めて高い精度が要求される設計現場において、エンジニアが最も恐れるべきは「作業内容の消失」である。

AutoCADには標準の「自動保存(Automatic Save)」機能が存在し、一定時間ごとに `.sv$` 形式のテンポラリファイルを作成する。しかし、プロフェッショナルの視点から言わせれば、標準機能だけに依存するのはあまりに無謀だ。

なぜか? `.sv$` ファイルはユーザーの `%TEMP%` ディレクトリという、極めて揮発性の高い、かつOSや他のクリーンアップツールによって容易に削除・上書きされる場所に生存しているからだ。また、クラッシュの瞬間、ファイルが破損しているリスクも否定できない。

本稿では、標準の自動保存機能を補完し、`.sv$` ファイルを監視・抽出し、安全な専用ディレクトリへ「世代管理」を行いながら退避させる、エンタープライズ級のバックアップ・エンジンをVBAで構築する手法を伝授する。

1. アーキテクチャの設計思想:監視・抽出・回転

単なるファイルのコピーでは、バックアップは「ゴミの山」へと変貌する。我々が構築すべきは、以下の3つのフェーズを持つ自律的なサイクルだ。

1. Scan & Detect(監視と検知):
AutoCADのテンポラリフォルダを走査し、最新の `.sv$` ファイルを特定する。この際、ファイルが現在AutoCADによって書き込み中(ロック状態)でないかを確認するプロセスが不可欠である。
2. Safe Extraction(安全な抽出):
検知したファイルを、作業ファイル(.dwg)の名称に基づいた、安全な専用バックアップディレクトリへコピーする。
3. Generational Rotation(世代管理の回転):
バックアップが無限に増殖してストレージを圧迫しないよう、定義した世代数(例:直近5世代)を超えた古いファイルを自動的に破棄する。

2. 実装:堅牢なバックアップエンジン

以下に、実戦投入を想定したコード・モジュールを示す。ここでは、メモリリークを防ぐためのオブジェクトの明示的な解放と、Windows APIを意識したエラーハンドリングを組み込んでいる。

' ==============================================================================
' Module: clsBackupEngine
' Description: AutoCAD .sv$ ファイルを監視し、世代管理バックアップを行う
' Author: Chief Architect
' ==============================================================================

Option Explicit

Private Const MAX_GENERATIONS As Integer = 5 ' 保存する世代数
Private Const FILE_EXT As String = ".sv$"

' ファイルシステム操作用のオブジェクト
Private fso As Object

' ------------------------------------------------------------------------------
' Method: ExecuteBackup
' Purpose: 現在開いている図面に関連する最新の.sv$をバックアップする
' ------------------------------------------------------------------------------
Public Sub ExecuteBackup()
    On Error GoTo ErrorHandler
    
    Dim activeDoc As AcadDocument
    Set activeDoc = ThisDrawing
    
    ' 1. 初期化
    If fso Is Nothing Then Set fso = CreateObject("Scripting.FileSystemObject")
    
    Dim tempPath As String
    tempPath = GetTempDirectory() ' WindowsのTEMPフォルダ取得
    
    Dim backupRoot As String
    backupRoot = activeDoc.Path & "\__AutoBackup_Engine\" ' 図面と同じ階層の専用フォルダ
    
    ' バックアップ用ディレクトリの作成
    If Not fso.FolderExists(backupRoot) Then
        fso.CreateFolder backupRoot
    End If
    
    ' 2. 最新の .sv$ ファイルの探索
    Dim latestSvFile As String
    latestSvFile = FindLatestSvFile(tempPath, activeDoc.Name)
    
    If latestSvFile = "" Then
        Debug.Print "[-] No valid .sv$ file found for: " & activeDoc.Name
        Exit Sub
    End If
    
    ' 3. バックアップの実行
    Dim targetFileName As String
    targetFileName = GenerateBackupName(activeDoc.Name)
    
    Dim destPath As String
    destPath = backupRoot & targetFileName
    
    ' ファイルのコピー(上書き防止のため、タイムスタンプ付きで保存)
    fso.CopyFile latestSvFile, destPath, True
    Debug.Print "[+] Backup successful: " & destPath
    
    ' 4. 世代管理(古いファイルの削除)
    RotateGenerations backupRoot, activeDoc.Name
    
CleanUp:
    ' オブジェクトの明示的な解放(メモリ管理の鉄則)
    Set fso = Nothing
    Exit Sub

ErrorHandler:
    Debug.Print "[!] Critical Error in ExecuteBackup: " & Err.Description
    Resume CleanUp
End Sub

' ------------------------------------------------------------------------------
' Private Function: FindLatestSvFile
' Description: 指定フォルダから、図面名に一致する最新の .sv$ を探す
' ------------------------------------------------------------------------------
Private Function FindLatestSvFile(ByVal folderPath As String, ByVal dwgName As String) As String
    Dim baseName As String
    baseName = fso.GetBaseName(dwgName)
    
    Dim folder As Object
    Set folder = fso.GetFolder(folderPath)
    
    Dim file As Object
    Dim latestDate As Date
    Dim targetFile As String
    
    latestDate = DateSerial(1900, 1, 1)
    
    For Each file In folder.Files
        ' ファイル名が「図面名(数字).sv$」のパターンに一致するか検証
        ' 注意: AutoCADの仕様により、ファイル名は図面名に基づいている
        If InStr(1, file.Name, baseName, vbTextCompare) > 0 And _
           fso.GetExtensionName(file.Name) = "sv$" Then
            
            ' ファイルが使用中(ロック中)でないか確認
            If IsFileNotLocked(file.Path) Then
                If file.DateLastModified > latestDate Then
                    latestDate = file.DateLastModified
                    targetFile = file.Path
                End If
            End If
        End If
    Next file
    
    FindLatestSvFile = targetFile
End Function

' ------------------------------------------------------------------------------
' Private Function: IsFileNotLocked
' Description: ファイルが他のプロセス(AutoCAD)によってロックされているか判定
' ------------------------------------------------------------------------------
Private Function IsFileNotLocked(filePath As String) As Boolean
    Dim fileNum As Integer
    fileNum = FreeFile
    On Error Resume Next
    ' 書き込みモードで開けるか試行
    Open filePath For Binary Access Read Write Lock Read Write As #fileNum
    Close #fileNum
    
    If Err.Number = 0 Then
        IsFileNotLocked = True
    Else
        IsFileNotLocked = False
    End If
    On Error GoTo 0
End Function

' ------------------------------------------------------------------------------
' Private Function: RotateGenerations
' Description: 指定した世代数を超えた古いバックアップを削除する
' ------------------------------------------------------------------------------
Private Sub RotateGenerations(ByVal folderPath As String, ByVal dwgName As String)
    Dim baseName As String
    baseName = fso.GetBaseName(dwgName)
    
    Dim folder As Object
    Set folder = fso.GetFolder(folderPath)
    
    Dim file As Object
    Dim fileList As Object
    Set fileList = CreateObject("System.Collections.ArrayList")
    
    ' 関連ファイルをリストアップ
    For Each file In folder.Files
        If InStr(1, file.Name, baseName, vbTextCompare) > 0 Then
            fileList.Add file.Path
        End If
    Next file
    
    ' ファイルを更新日時でソート(昇順:古いものが先頭)
    ' 注: ArrayListのSortは単純な文字列ソートのため、命名規則に注意が必要
    ' ここでは簡易的にファイル名に基づいた処理を行う
    
    If fileList.Count > MAX_GENERATIONS Then
        ' 古いファイルから順に削除
        ' 実運用では、ファイル名にタイムスタンプを含めることで確実なソートが可能
        Dim i As Integer
        For i = 0 To (fileList.Count - MAX_GENERATIONS - 1)
            fso.DeleteFile fileList(i), True
            Debug.Print "[*] Pruned old backup: " & fileList(i)
        Next i
    End If
End Sub

' ------------------------------------------------------------------------------
' Helper Functions
' ------------------------------------------------------------------------------
Private Function GetTempDirectory() As String
    ' Windows環境変数の %TEMP% を取得
    GetTempDirectory = Environ("TEMP")
End Function

Private Function GenerateBackupName(ByVal dwgName As String) As String
    ' ファイル名にタイムスタンプを付与: OriginalName_yyyyMMdd_HHmmss.sv$
    Dim baseName As String
    baseName = fso.GetBaseName(dwgName)
    GenerateBackupName = baseName & "_" & Format(Now, "yyyymmdd_hhmmss") & ".sv$"
End Function

3. 技術的深掘り:プロフェッショナルが意識すべき急所

このコードを単に「動くもの」として終わらせてはならない。以下の3点は、システムとして運用する上で極めて重要な設計判断である。

A. ファイルロックの回避(Race Conditionの防止)

AutoCADが `.sv$` ファイルを書き込んでいる最中に、VBAがそのファイルをコピーしようとすると、`Permission Denied` エラーが発生するか、あるいは不完全な(壊れた)ファイルをコピーすることになる。
`IsFileNotLocked` 関数において、`Open … For Binary Access Read Write` を用いてファイルハンドルを取得できるか試行する手法は、最も低レイヤーで確実な判定方法の一つだ。

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

VBA、特にCOMオブジェクト(`FileSystemObject`)を扱う際、エラー発生時にオブジェクトがメモリ上に残留すると、AutoCADプロセス全体の安定性を損なう。
`On Error GoTo ErrorHandler` を用い、必ず `CleanUp` ラベルを経由して `Set fso = Nothing` を実行させる構造は、長時間稼働する自動化ツールにおける「作法」である。

C. 世代管理のアルゴリズム

上記のコードでは `System.Collections.ArrayList` を用いて簡略化しているが、より厳密な運用(数千のファイルを扱う場合など)では、ファイル名に `YYYYMMDD_HHMMSS` 形式のタイムスタンプを強制し、文字列比較によるソートを行うべきだ。これにより、OSのファイルシステムに依存しない、決定論的な(Deterministic)世代管理が可能になる。

4. 結論

標準の自動保存は、あくまで「予備」に過ぎない。
設計業務の継続性を担保するのは、ツールを使いこなすエンジニアが構築した、「失敗を前提とした防護策」である。

このバックアップエンジンを、AutoCADの `Application_Startup` イベントや、定期的な `Timer` 処理として組み込むことで、あなたの設計環境は、未曾有のクラッシュに対しても揺るぎない堅牢性を手にするだろう。

コードは、書かれた瞬間から、その運用環境の過酷さにさらされることを忘れてはならない。

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