「ただの自動化」で終わらせるな。設計品質を決定づける、堅牢な図面エクスポート・エンジニアリング
設計現場において、「図面を保存したらPDFとDWGが自動で出る」というツールを求める声は絶えない。しかし、多くのエンジニアが作成するそのマクロは、実務の荒波に揉まれた瞬間に崩壊する。
「ファイル名がルール通りにならない」「出力先フォルダがなくてエラーで止まる」「DWGの書き出し設定がデフォルトのまま」……。これらはすべて、「APIの使い方は知っているが、システムの設計を知らない」者が陥る典型的な罠だ。
本記事では、単なるコピペ用コードの提供はしない。プロフェッショナルとして、「バグを許容せず、保守性を担保し、業務フローに組み込めるレベル」の自動化エクスポート・システムをどう設計すべきかを伝授する。
1. 凡庸な設計と、プロフェッショナルな設計の境界線
初心者が書くコードは、往々にして「現在のファイル名」をそのまま利用しようとする。これは極めて危険な設計だ。
なぜ「ファイル名」を直接使ってはいけないのか?
1. 命名規則の乖離: Windows上のファイル名(`Part_A_rev1.SLDDRW`)と、社内規定の管理番号(`ABC-12345`)は必ずしも一致しない。
2. 拡張子の依存: プログラム内で拡張子を文字列操作(`Replace`関数など)で置換しようとすると、ファイル名にドットが含まれていた場合に誤動作する。
3. データの不整合: 図面内の「カスタムプロパティ」こそが、設計データの真実(Single Source of Truth)である。
プロフェッショナルの設計思想:
ファイル名は「ファイル名」から取るのではない。「図面のカスタムプロパティ(型番、リビジョン等)」から動的に生成する。 これが、データ整合性を保つための鉄則である。
2. 実装における3つの技術的要諦
堅牢なツールを作るために、以下の3点をコードに組み込む。
① エラーハンドリングの局所化
`On Error Resume Next` を乱用するのは素人のすることだ。どこでエラーが起きたのかを特定し、ユーザーに「なぜ失敗したのか(フォルダがないのか、ファイルが開かれているのか)」を伝える設計が必要である。
② ファイルシステム操作の分離
パスの結合には `&` 演算子による文字列結合を使うな。`FileSystemObject` (FSO) を使用せよ。パスの末尾に `\` があるかないかといった、初歩的なミスによるバグを根絶するためだ。
③ SolidWorks APIのライフサイクル管理
エクスポート処理は、メモリとCPUに負荷をかける。特にDWG変換は重い処理だ。処理の成否を確実に判定し、失敗した場合にはログを残す、あるいは処理を中断するロジックが不可欠である。
3. 【Production-Ready】堅牢なエクスポート・マクロ
以下に、実務でそのまま使えるレベルのコードを示す。このコードを使用するには、VBAエディタの「ツール」→「参照設定」から 「Microsoft Scripting Runtime」 にチェックを入れておくこと。これが、プロフェッショナルなファイル操作の第一歩だ。
Option Explicit
' ==============================================================================
' Module: DrawingAutoExporter
' Description: 図面保存時に規定の命名規則に基づきPDF/DWGを自動出力する
' Author: Chief Architect
' ==============================================================================
Sub Main()
' 1. オブジェクトの初期化
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
' 2. 図面ドキュメントかどうかのバリデーション
If swModel Is Nothing Then
MsgBox "図面が開かれていません。", vbCritical
Exit Sub
End If
If swModel.GetType <> swDocDRAWING Then
MsgBox "このマクロは図面ファイル専用です。", vbCritical
Exit Sub
End If
Set swDraw = swModel
' 3. エクスポート処理の実行
' 実行前にエラーハンドリングを開始
On Error GoTo ErrorHandler
Call ExecuteExport(swApp, swModel)
MsgBox "エクスポートが正常に完了しました。", vbInformation
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
"Error Number: " & Err.Number & vbCrLf & _
"Description: " & Err.Description, vbCritical
End Sub
''' <summary>
''' エクスポートのメインロジック
''' </summary>
Private Sub ExecuteExport(swApp As SldWorks.SldWorks, swModel As SldWorks.ModelDoc2)
Dim fso As New FileSystemObject
Dim targetFolder As String
Dim baseFileName As String
Dim partNo As String
Dim revision As String
Dim pdfPath As String
Dim dwgPath As String
Dim errors As Long
Dim warnings As Long
' --- A. 命名規則の構築 (Custom Propertyから取得) ---
' ファイル名ではなく、プロパティから取得するのがプロの設計
partNo = GetCustomProperty(swModel, "PartNo")
revision = GetCustomProperty(swModel, "Revision")
If partNo = "" Then
Err.Raise 9999, , "カスタムプロパティ 'PartNo' が見つかりません。命名規則違反です。"
End If
' 命名規則例: [PartNo]_[Revision].ext
baseFileName = partNo & "_" & IIf(revision = "", "0", revision)
' --- B. 出力先ディレクトリの決定 ---
' ここでは図面と同じフォルダ内の "Export" フォルダを指定
targetFolder = fso.GetParentFolderName(swModel.GetPathName) & "\Export"
' フォルダが存在しない場合は作成する(堅牢性の要)
If Not fso.FolderExists(targetFolder) Then
fso.CreateFolder (targetFolder)
End If
' フルパスの組み立て
pdfPath = targetFolder & "\" & baseFileName & ".pdf"
dwgPath = targetFolder & "\" & baseFileName & ".dwg"
' --- C. PDFエクスポート ---
' SaveAsを使用してPDFを出力
Dim status As Boolean
status = swModel.Extension.SaveAs(pdfPath, swSaveAsCurrentVersion, swSaveAsOptions_Silent, Nothing, errors, warnings)
If Not status Then
Err.Raise 1001, , "PDFの出力に失敗しました。ファイルが使用中ではないか確認してください。"
End If
' --- D. DWGエクスポート ---
' 図面をDWGとして書き出す (Drawing専用メソッドを使用)
' ※DWGは詳細な設定が必要な場合があるが、ここでは標準的なSaveAsを使用
status = swModel.Extension.SaveAs(dwgPath, swSaveAsCurrentVersion, swSaveAsOptions_Silent, Nothing, errors, warnings)
If Not status Then
Err.Raise 1002, , "DWGの出力に失敗しました。"
End If
End Sub
''' <summary>
''' カスタムプロパティの値を安全に取得する関数
''' </summary>
Private Function GetCustomProperty(swModel As SldWorks.ModelDoc2, propName As String) As String
Dim swCustPropMgr As SldWorks.CustomPropertyManager
Dim valOut As String
Dim res As Long
' モデルのカスタムプロパティマネージャを取得
Set swCustPropMgr = swModel.Extension.CustomPropertyManager
' プロパティの取得
res = swCustPropMgr.GetDouble(propName, valOut, False) ' 数値として試行
If res <> 0 Then ' 数値でない場合は文字列として再試行
swCustPropMgr.GetText propName, False, valOut, res
End If
GetCustomProperty = Trim(valOut)
End Function
4. エンジニアリングの視点:保守性を高めるためのアドバイス
このコードをベースに、さらに実務へ適応させるための「次の一手」を伝えておく。
データベース(Excel/SQL)との連携
もし、社内の管理台帳(Excel等)に基づいた命名規則が必要なら、`ExecuteExport` 内でExcelを読み込むロジックを追加することになる。その際、「SolidWorksの処理」と「Excelの読み込み処理」を絶対に混ぜるな。
関数を分離し、`baseFileName` を引数として受け取る形に設計すれば、将来的に管理台帳がSQL Serverに移行しても、エクスポートロジック自体を書き換える必要はなくなる。
ログ出力の実装
実運用では、誰が、いつ、どの図面を、成功/失敗したかを記録するログファイル(`.log`)を自動生成させるべきだ。エラーが発生した際、`Err.Description` をログに書き出すだけで、トラブルシューティングの時間は劇的に短縮される。
パフォーマンスの最適化
大量の図面を一括処理する場合、`swApp.Visible = False` にして画面更新を止めるのは基本だ。しかし、それ以上に重要なのは、「エラーが起きた際に、そのファイルだけをスキップして次のファイルに進む」 という、バッチ処理としての耐性を持たせることだ。
結論
自動化の本質は「作業を楽にすること」ではない。「人間が介在することによるリスク(ミス)を、システム的に排除すること」にある。
今回提示したコードは、単なる「便利なツール」ではない。エラーを想定し、データの出所を明確にし、環境の変化に耐えうるよう設計された「プロダクション・コード」だ。この設計思想を理解し、君自身の武器として昇華させてほしい。
