【実務・中級編】【実務中級者向け】保存時の「DWGバージョン」を、送信先のクライアント名(フォルダ名)から自動判別して切り替える – AutoCAD VBA解析バイブル

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

バージョン互換性の罠を回避せよ:クライアント属性に連動する「知的な保存制御」の実装

業務自動化の現場において、最も「低レベル」かつ「致命的」なミスが何であるかを知っているか?

それは、「ファイルが保存できたこと」を成功と定義してしまうことだ。

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を更新するだけで、システム全体がアップデートされる。これこそが、真に堅牢な自動化システムの姿である。

結びに代えて

自動化とは、単に「作業を速くすること」ではない。「人間が犯しがちな、不注意によるミスを、システム的に不可能にすること」である。

「保存形式を間違えた」という初歩的なミスで、クライアントとの信頼関係を損なう。そんな事態を、君が書いた一行のコードで防ぐのだ。設計に魂を込めろ。健闘を祈る。

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