「ただのスクリプト」で終わらせるな。納品用DWG生成を自動化する、堅牢なエンジニアリングの極意
業務自動化の現場において、多くの開発者が陥る罠がある。それは「動けばいい」という、いわゆるスクリプタ(Script-writer)の思考だ。
「特定の画層を非表示にして保存する」――。
一見、単純なタスクに見えるだろう。しかし、これを実務で耐えうる「プロダクション・ツール」へと昇華させるには、AutoCADのオブジェクトモデルに対する深い理解と、予期せぬエラーを排除する設計思想が必要不可欠だ。
今回は、検討用画層(例:「XXX_CONFIDENTIAL」や「TEMP_」など)を一括でフリーズし、納品用のクリーンなDWGを生成する自動化ツールの設計について、プロフェッショナルな視点から解説する。
1. 設計思想:なぜ「単純なループ」では不十分なのか
初心者はこう書く。
「画層を全スキャンし、キーワードが含まれていたら `Layer.Off = True` にする」
これでは、現場では使い物にならない。なぜか? 理由は3つある。
① 「現在の画層(Current Layer)」の制約
AutoCADの仕様上、「現在使用中の画層」をフリーズ(Freeze)したり、オフ(Off)にしたりすることはできない。 もしキーワードに合致した画層が現在選択されていた場合、コードは実行時エラーを吐いて即死する。
② 「Off」と「Freeze」の決定的な違い
単に非表示にする(Off)だけでは、図面内のデータはメモリ上に残り続け、再描画(Regen)の負荷を軽減できない。納品用図面として「軽量化」を謳うのであれば、計算対象から完全に除外する `Freeze` を選択すべきだ。
③ ファイルの「破壊」を防ぐ
アクティブな図面を直接操作して保存してしまうと、ユーザーが作業中の「検討用データ」が書き換えられてしまう。これは致命的な設計ミスだ。「作業中の図面」と「生成される納品用図面」のライフサイクルを明確に分離しなければならない。
2. 堅牢なアーキテクチャの構築
プロフェッショナルなツールは、以下の3フェーズで設計する。
1. Validation(検証): 禁止キーワードの定義と、現在の画層が対象外であることを確認。
2. Transformation(変換): 画層のステータスを変更。この際、現在の画層を回避するロジックを組み込む。
3. Persistence(永続化): `SaveAs` を用い、適切なバージョン(例:2018形式など)で別名保存する。
3. 実装:プロダクション・クオリティのVBAコード
以下に、そのまま実務に投入できるレベルのコードを示す。単なるコピペではなく、コメントに込めた「意図」を読み取ってほしい。
Option Explicit
''' <summary>
''' 納品用図面生成エンジン
''' 特定のキーワードを含む画層をフリーズし、別名で保存する。
''' </summary>
Public Sub GenerateDeliveryDrawing()
Dim acadDoc As AcadDocument
Set acadDoc = ThisDrawing
' --- 設定領域(本来は外部ファイルやUIから取得すべき) ---
Const EXCLUDE_KEYWORD As String = "CONFIDENTIAL" ' 除外対象のキーワード
Const TARGET_VERSION As Long = 2018 ' 保存形式の指定(環境に合わせて調整)
' ------------------------------------------------------
Dim lay As AcadLayer
Dim currentLayerName As String
Dim savePath As String
Dim successCount As Integer
Dim errorCount As Integer
' 1. 保存先の決定 (実行ディレクトリに _Delivery を付与)
savePath = Replace(acadDoc.FullName, ".dwg", "_Delivery.dwg")
If savePath = acadDoc.FullName Then
MsgBox "図面が保存されていません。先に保存を行ってください。", vbCritical
Exit Sub
End If
On Error GoTo ErrorHandler
' AutoCADの画面更新を停止(パフォーマンス向上とチラつき防止)
' ※VBA標準では不完全なため、コマンドでの制御を検討
currentLayerName = acadDoc.ActiveLayer.Name
successCount = 0
errorCount = 0
' 2. 画層の走査と処理
' コレクションをループする際は、オブジェクトのライフサイクルに注意
For Each lay In acadDoc.Layers
' キーワードが含まれているかチェック
If InStr(1, lay.Name, EXCLUDE_KEYWORD, vbTextCompare) > 0 Then
' 【重要】現在の画層をフリーズしようとするとエラーになるためのガード
If lay.Name = currentLayerName Then
' 現在の画層が対象の場合は、一時的に別の画層へ切り替える
' もしくは、この画層はスキップする設計にする
errorCount = errorCount + 1
Else
' Freeze(フリーズ)を実行。Offよりもメモリ効率が良い。
lay.Freeze = True
successCount = successCount + 1
End If
End If
Next lay
' 3. 別名保存 (SaveAs)
' 注意: SaveAsを実行すると、現在開いているドキュメント自体が新しいファイルに切り替わる
acadDoc.SaveAs savePath
MsgBox "処理が完了しました。" & vbCrLf & _
"生成ファイル: " & savePath & vbCrLf & _
"フリーズした画層数: " & successCount & vbCrLf & _
"スキップした画層(Current): " & errorCount, vbInformation
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
"エラー番号: " & Err.Number & vbCrLf & _
"内容: " & Err.Description, vbCritical
End Sub
4. チーフアーキテクトの視点:さらに高みを目指すために
このコードをベースに、さらに実用性を高めるためのアドバイスを送る。
バージョン互換性の制御
`SaveAs` メソッドは、AutoCADのバージョンによって挙動が異なる場合がある。納品先が古いバージョンのAutoCADを使用している場合、VBAから直接「2013形式で保存」といった細かな制御を行うのは難しい。
その場合は、「一度DXF形式で書き出し、それを新しいドキュメントで読み込む」というプロセスを挟むことで、極めて高い互換性を担保できる。
データベース(外部連携)の活用
キーワードをコード内に `Const` でハードコーディングするのは、保守性の観点から「悪」だ。
実務では、CSVファイルやExcelファイルに「除外キーワードリスト」を持たせ、それを読み込む設計にせよ。これにより、エンジニアの手を借りずに、現場の担当者がキーワードを更新できるようになる。
パフォーマンスの最適化
大規模な図面(数百MBクラス)を扱う場合、画層を一つずつ変更するたびにAutoCADの図面再計算が走ることがある。
もし処理が重いと感じるなら、画層の変更後に一度だけ `ThisDrawing.Regen acAllViewports` を実行する、あるいは、画層の変更を「一括」で行うようなアプローチ(拡張オブジェクトの検討)が必要になる。
結論
自動化ツールの価値は、「動くこと」ではなく、「誰が、どのような環境で使っても、図面を壊さず、意図通りの結果を、高速に返せること」にある。
「現在の画層」という落とし穴を回避し、`Off` ではなく `Freeze` を選択する。この細かな差が、君の書くコードを「スクリプト」から「システム」へと進化させるのだ。
次にコードを書くときは、その一行が図面データベースにどのような影響を与えるか、その重みを噛み締めながら書き進めてほしい。
