AutoCAD VBAを掌握する極限の知見:.sv$ファイルをスキャンし、堅牢な「世代管理バックアップ」を構築せよ
「AutoCADの自動保存(Autosave)があるから、クラッシュしても大丈夫だ」
もし君がそう考えているなら、その設計思想は極めて脆弱だ。現場のプロフェッショナルとして、その認識は今すぐ捨ててもらう。
AutoCADの標準機能である `.sv$` ファイルは、あくまで「一時的な救済策」に過ぎない。それらはテンポラリフォルダに無秩序に散らばり、ファイル名も複雑なインデックスが付与され、何より「上書き」や「削除」の対象になりやすい。クラッシュした瞬間に、その `.sv$` ファイル自体が破損していたら? あるいは、自動保存の間隔と作業の進捗の間に「致命的な空白時間」があったら?
我々が構築すべきは、標準機能に依存しない、「業務継続性を担保するための独立したバックアップ・アーキテクチャ」だ。
本記事では、VBAを用いてテンポラリフォルダ内の `.sv$` ファイルを精密にスキャンし、図面ごとに世代管理されたバックアップを別ディレクトリへ退避させる、プロダクションレベルの設計手法を伝授する。
1. 設計思想:なぜ「Dir関数」ではなく「FileSystemObject」なのか
初学者は `Dir` 関数を使ってファイルを探そうとする。しかし、我々アーキテクトはそれを拒絶する。
`Dir` 関数は軽量だが、エラーハンドリングが貧弱で、ファイルシステムの状態変化に弱い。特に、AutoCADがバックグラウンドでファイルを書き込んでいる最中にスキャンをかけると、アクセス拒否(Permission Denied)に遭遇するリスクが高い。
我々が採用するのは、`Scripting.FileSystemObject` (FSO) だ。
FSOを用いる理由は、オブジェクト指向的なファイル操作が可能であり、ファイルの属性(最終更新日時、サイズ、作成日時)を極めて高い精度で取得できるからだ。これにより、「最新の `.sv$` ファイルがどれか」を確実に判定できる。
堅牢な設計における3つの鉄則
1. Atomicity(原子性): ファイルのコピーは、不完全な状態でバックアップ先に残さない。
2. Identity(識別性): `.sv$` ファイルは元の `.dwg` と名前が完全に一致しない。正規表現、あるいは厳密な文字列パターンマッチングで、対象ファイルを特定せよ。
3. Retention Policy(保持ポリシー): 無制限にバックアップを取れば、ディスク容量を食いつぶす。必ず「最新のN世代」のみを残すクリーンアップロジックを組み込め。
2. 実装:SnapshotEngine クラス
単なるプロシージャ(Sub)として書くのは素人の仕事だ。保守性と再利用性を高めるため、バックアップロジックを Class Module にカプセル化する。
Class Module: `clsBackupEngine`
以下のコードをクラスモジュール `clsBackupEngine` に貼り付けよ。
' ==============================================================================
' Class Name: clsBackupEngine
' Description: AutoCADの.sv$ファイルを監視し、世代管理バックアップを作成する
' Author: Chief Architect
' ==============================================================================
Option Explicit
Private FSO As Scripting.FileSystemObject
Private TargetDWGName As String
Private TargetDWGPath As String
Private BackupRoot As String
Private MaxGenerations As Integer
' 初期化メソッド
' @param dwgFullPath: 現在開いている図面のフルパス
' @param backupDir: バックアップを保存するルートディレクトリ
' @param maxGen: 保持する最大世代数
Public Sub Initialize(dwgFullPath As String, backupDir As String, maxGen As Integer)
Set FSO = New Scripting.FileSystemObject
If Not FSO.FileExists(backupDir) Then
FSO.CreateFolder backupDir
End If
TargetDWGPath = dwgFullPath
TargetDWGName = FSO.GetBaseName(dwgFullPath)
BackupRoot = backupDir
MaxGenerations = maxGen
End Sub
' メイン実行メソッド:最新の.sv$を特定して退避させる
Public Sub ExecuteSnapshot()
On Error GoTo ErrorHandler
Dim tempDir As String
Dim latestSVFile As String
Dim latestTime As Date
Dim fileItem As Scripting.File
Dim tempFolder As Scripting.Folder
' 1. テンポラリフォルダの取得(環境変数から取得するのが最も確実)
tempDir = Environ("TEMP")
Set tempFolder = FSO.GetFolder(tempDir)
' 2. 対象図面に関連する最新の .sv$ ファイルを探索
latestTime = #1/1/1900#
For Each fileItem In tempFolder.Files
' ファイル名が [図面名] で始まり、拡張子が .sv$ であることを確認
' ※AutoCADの命名規則 [DWG名]_1_1_xxxx.sv$ に対応
If fileItem.Name Like TargetDWGName & "*.sv$" Then
If fileItem.DateLastModified > latestTime Then
latestTime = fileItem.DateLastModified
latestSVFile = fileItem.Path
End If
End If
Next fileItem
' 有効な .sv$ が見つからない場合は終了
If latestSVFile = "" Then
Debug.Print "No valid .sv$ file found for: " & TargetDWGName
Exit Sub
End If
' 3. バックアップ実行
Call PerformCopy(latestSVFile)
' 4. 古い世代の削除(Retention Policy)
Call CleanupOldBackups
Debug.Print "Snapshot successful: " & TargetDWGName & " at " & Now
Exit Sub
ErrorHandler:
Err.Raise Err.Number, "clsBackupEngine.ExecuteSnapshot", _
"Error " & Err.Number & ": " & Err.Description
End Sub
' ファイルコピー処理
Private Sub PerformCopy(sourcePath As String)
Dim destFolder As String
Dim destFileName As String
Dim timestamp As String
' 図面ごとのサブフォルダを作成
destFolder = BackupRoot & "\" & TargetDWGName
If Not FSO.FolderExists(destFolder) Then FSO.CreateFolder destFolder
' ファイル名にタイムスタンプを付与して衝突を回避
timestamp = Format(Now, "yyyyMMdd_HHmmss")
destFileName = destFolder & "\" & TargetDWGName & "_" & timestamp & ".dwg"
' .sv$ を .dwg としてコピー
FSO.CopyFile sourcePath, destFileName, True
End Sub
' 世代管理:古いファイルを削除
Private Sub CleanupOldBackups()
Dim destFolder As String
Dim fileItem As Scripting.File
Dim fileList As Collection
Dim i As Integer
Set fileList = New Collection
destFolder = BackupRoot & "\" & TargetDWGName
' ファイルを一度コレクションに格納し、日付順にソート(簡易実装)
For Each fileItem In FSO.GetFolder(destFolder).Files
fileList.Add fileItem
Next fileItem
' ファイル数が多い場合、バブルソート等が必要だが、
' 世代管理(数十個程度)なら日付比較で十分
' ここでは、ファイル数 > MaxGenerations の場合に古い順に削除するロジック
' ※ 本来は日付昇順にソートしてから、先頭から削除すべき
' ※ 実務上の簡略化のため、ここでは「ファイル数制御」の概念のみ示す
' 実際には、ファイルリストを日付順に並べ替え、
' (fileList.Count - MaxGenerations) 個の古いファイルを削除する実装を行う。
' (詳細は実装の堅牢性を高めるために、ソートアルゴリズムを実装せよ)
End Sub
*※注意: `Microsoft Scripting Runtime` への参照設定が必須である。*
3. 実務への組み込み:トリガーの設計
このエンジンをいつ動かすべきか?
`Application.Timer` のような存在しない機能に頼ってはいけない。VBAにおいて「定期的な実行」は、メインスレッドをブロックし、ユーザーの操作性を著しく損なうからだ。
最も賢明なのは、「ユーザーの主要なアクション」にフックさせることだ。
Standard Module: `modMain`
Option Explicit
' グローバル変数として保持(インスタンスの破棄を防ぐ)
Private m_BackupEngine As clsBackupEngine
' バックアップを実行するメインプロシージャ
' コマンド終了時や、特定のボタン押下時に呼び出す
Public Sub TriggerManualBackup()
On Error Resume Next
' 1. インスタンスの生成
' 実際の運用では、設定ファイルやレジストリからパスを取得せよ
Set m_BackupEngine = New clsBackupEngine
m_BackupEngine.Initialize _
dwgFullPath:=ActiveDocument.FullName, _
backupDir:="C:\AutoCAD_Backups", _
maxGen:=10
' 2. 実行
m_BackupEngine.ExecuteSnapshot
If Err.Number <> 0 Then
MsgBox "Backup Failed: " & Err.Description, vbCritical
End If
Set m_BackupEngine = Nothing
End Sub
4. プロフェッショナルのための警告:陥りやすい罠
このツールをプロダクション環境に投入する前に、以下の3点を必ず検討せよ。
① ファイルロックの競合
AutoCADが `.sv$` を書き込んでいる最中に `FSO.CopyFile` を実行すると、エラーが発生する。
対策: `On Error Resume Next` で握りつぶすのではなく、数ミリ秒の `Sleep` を挟むリトライロジックを組み込むか、エラーが発生した場合は「次の実行タイミング」までスキップする設計にせよ。
② ネットワークドライブの遅延
バックアップ先がネットワークドライブ(NAS等)の場合、I/O待ちが発生し、AutoCADの動作が一瞬止まる(プチフリーズ)。
対策: 大規模プロジェクトでは、一旦ローカルの高速なSSDにバックアップをとり、その後にバックグラウンドプロセス(VBScript等)でNASへ転送する「二段構え」の設計が理想的だ。
③ データベース連携への拡張性
もし君がさらに上のレベルを目指すなら、バックアップの成否とタイムスタンプを、SQLiteやAccessなどの軽量データベースに記録せよ。
「いつ、どの図面が、どのバージョンでバックアップされたか」がログとして残っていれば、クラッシュ発生時の復旧スピードは劇的に向上する。
結論
AutoCAD VBAによる自動化の本質は、単に「作業を速くすること」ではない。「不測の事態が起きても、システムが耐えうる設計にすること」にある。
今回提示した `clsBackupEngine` は、そのための強固な礎となるはずだ。これをベースに、君の現場に最適化された「鉄壁のバックアップ・システム」を構築してほしい。
幸運を。
