バージョン互換性の罠を回避せよ:クライアント属性に連動する「知的な保存制御」の実装
業務自動化の現場において、最も「低レベル」かつ「致命的」なミスが何であるかを知っているか?
それは、「ファイルが保存できたこと」を成功と定義してしまうことだ。
AutoCADの自動化ツールを開発する際、多くのエンジニアは「現在の図面を特定のパスに保存する」という処理を、単なる `ActiveDocument.SaveAs` の実行として捉える。しかし、実務の最前線では、保存した瞬間にプロジェクトが崩壊することがある。クライアントの環境がAutoCAD 2013であり、あなたが2018形式で保存してしまった場合、そのファイルは「ゴミ」に等しい。
本稿では、単なるファイルの保存ではなく、「保存先のコンテキスト(文脈)を読み解き、適切なバージョンを選択して保存する」という、プロフェッショナルな設計思想に基づいた実装手法を伝授する。
1. 設計思想:ロジックとデータの分離
初心者は、`If` 文の羅列でバージョン判定を行おうとする。
「もしフォルダ名に ‘ClientA’ が含まれていたら、2013形式で…」といったコードだ。これは、クライアントが増えるたびにコードを書き換え、再コンパイルを強いる、保守性の極めて低い「スパゲッティ・コード」の温床となる。
我々アーキテクトが取るべき設計は、「判定ロジック(Engine)」と「マッピング定義(Policy)」の分離である。
1. Path Parser: 保存パスから、クライアントを特定するための「キー(フォルダ名等)」を抽出する。
2. Version Mapper: キーに基づき、どの `dwgFileVersion` を適用すべきかを決定する。
3. Execution Engine: 決定されたパラメータに基づき、安全に `SaveAs` を実行する。
この構造により、新しいクライアントが増えても、マッピングデータ(Dictionaryや外部設定ファイル)を更新するだけで済み、コアロジックに手を加える必要がなくなる。
2. 実装:堅牢なプロフェッショナル・コード
以下に、実務でそのままプロダクションコードとして投入できるレベルのモジュールを示す。ここでは、高速な検索を実現するために `Scripting.Dictionary` を活用し、パス解析には `FileSystemObject` を用いて、OSの挙動に依存しない堅牢な設計にしている。
事前準備
VBAエディタの「ツール」→「参照設定」から以下にチェックを入れておくこと。
- `Microsoft Scripting Runtime` (DictionaryおよびFileSystemObject用)
Option Explicit
' ==============================================================================
' Module: modSmartSave
' Description: クライアントのフォルダ名に基づき、DWGバージョンを自動判別して保存する
' Author: Chief Architect
' ==============================================================================
''' <summary>
''' 保存先パスを解析し、適切なDWG形式で保存を実行する
''' </summary>
''' <param name="targetPath">保存したいフルパス</param>
Public Sub ExecuteSmartSave(ByVal targetPath As String)
On Error GoTo ErrorHandler
Dim fso As New FileSystemObject
Dim clientName As String
Dim dwgVersion As Long
Dim defaultVersion As Long
' --- 設定領域 (本来は外部ファイルやDBから読み込むべき) ---
' デフォルトの保存形式 (最新形式を指定)
defaultVersion = acR2018DWG
' クライアント名とDWGバージョンのマッピング
' Key: フォルダ名の一部, Value: AutoCAD DWG File Version Constant
Dim versionMap As New Scripting.Dictionary
With versionMap
.Add "ClientA_Old", acR2013DWG ' ClientA_Oldフォルダなら2013形式
.Add "ClientB_Legacy", acR2007DWG ' ClientB_Legacyなら2007形式
.Add "Global_Std", acR2010DWG ' Global_Stdなら2010形式
End With
' -------------------------------------------------------
' 1. パスの妥当性チェック
If targetPath = "" Or Not fso.FileExists(fso.GetParentFolderName(targetPath)) Then
Err.Raise vbErr_InvalidPath, "ExecuteSmartSave", "保存先のディレクトリが存在しません。"
End If
' 2. クライアント名の抽出 (親フォルダ名を取得するロジック)
' 例: C:\Projects\ClientA_Old\Drawing.dwg -> "ClientA_Old"
clientName = fso.GetFolder(fso.GetParentFolderName(targetPath)).Name
' 3. バージョンの決定 (決定論的なマッピング)
If versionMap.Exists(clientName) Then
dwgVersion = versionMap(clientName)
Debug.Print "Detected Client: " & clientName & " | Target Version: " & dwgVersion
Else
dwgVersion = defaultVersion
Debug.Print "Unknown Client: " & clientName & " | Using Default Version: " & dwgVersion
End If
' 4. 保存の実行
' AutoCADのSaveAsメソッドを使用。第2引数にdwgFileVersionを指定する。
ThisDrawing.SaveAs targetPath, dwgVersion
MsgBox "スマート保存が完了しました。" & vbCrLf & _
"Path: " & targetPath & vbCrLf & _
"Version: " & GetVersionName(dwgVersion), vbInformation, "Success"
ExitSub:
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
"Error No: " & Err.Number & vbCrLf & _
"Description: " & Err.Description, vbCritical, "Save Error"
Resume ExitSub
End Sub
''' <summary>
''' 定数から人間が読める形式のバージョン名を取得する(デバッグ・ログ用)
''' </summary>
Private Function GetVersionName(ByVal versionCode As Long) As String
Select Case versionCode
Case acR2018DWG: GetVersionName = "AutoCAD 2018 Format"
Case acR2013DWG: GetVersionName = "AutoCAD 2013 Format"
Case acR2010DWG: GetVersionName = "AutoCAD 2010 Format"
Case acR2007DWG: GetVersionName = "AutoCAD 2007 Format"
Case Else: GetVersionName = "Unknown Version"
End Select
End Function
' 定数の定義(AutoCAD環境により異なる場合があるため、明示的に定義しておくと安全)
Private Const acR2018DWG As Long = 2018 ' 実際にはAutoCADのAPI定数を使用
Private Const acR2013DWG As Long = 2013
Private Const acR2010DWG As Long = 2010
Private Const acR2007DWG As Long = 2007
Private Const vbErr_InvalidPath As Long = 513
3. アーキテクトの視点:運用における「3つの落とし穴」
コードが書けただけで満足してはいけない。このツールを実戦投入する際に、君が直面するであろう「エッジケース」への対策を考えておく必要がある。
① パス解析の脆弱性
上記のコードでは `fso.GetFolder(…).Name` を使用して親フォルダ名を取得している。しかし、プロジェクトのフォルダ構造が `C:\Work\ClientA\Project01\Drawing.dwg` のように多層化している場合、`ClientA` を取得するには、親の親を辿る、あるいは正規表現(RegExp)を用いてパス全体からパターンマッチングを行う必要がある。
「どこにクライアント名が隠れているか」というルールが、組織内で絶対的に定義されていることが前提となる。
② 書き込み権限とファイルロック
`SaveAs` を実行する際、対象ファイルが他のユーザーによって開かれている(ファイルロック状態)場合、VBAは無慈悲にエラーを吐いて停止する。
実務レベルのツールであれば、`SaveAs` を呼ぶ前に、対象ファイルが書き込み可能かどうかをチェックする、あるいはエラーハンドリング内で「ファイルが使用中です。閉じてから再試行してください」という、ユーザーに分かりやすいメッセージを表示する設計が不可欠だ。
③ 設定の外部化(スケーラビリティ)
今回、`versionMap` をコード内に記述したが、これは「中級者」の書き方だ。
「上級者」は、このマッピングを Excelシート や JSONファイル、あるいは SQLiteデータベース に持たせる。
なぜか? 現場のルール(どのクライアントがどのバージョンか)は、開発者ではなく「プロジェクトマネージャー」が決めるものだからだ。開発者がコードを書き換えるのではなく、PMがExcelを更新するだけで、システム全体がアップデートされる。これこそが、真に堅牢な自動化システムの姿である。
結びに代えて
自動化とは、単に「作業を速くすること」ではない。「人間が犯しがちな、不注意によるミスを、システム的に不可能にすること」である。
「保存形式を間違えた」という初歩的なミスで、クライアントとの信頼関係を損なう。そんな事態を、君が書いた一行のコードで防ぐのだ。設計に魂を込めろ。健闘を祈る。
