成果物の「自動生成」に潜む設計思想:SolidWorksにおけるPDF/DWG同時出力の極限実装
設計現場において、「図面を保存する際にPDFとDWGも同時に出力する」というタスクは、一見すると初歩的な自動化の対象に見える。しかし、これを「単なるマクロ」として実装するか、「堅牢なシステムコンポーネント」として実装するかで、設計部門のエンジニアリング・エントロピー(無秩序さ)は劇的に変わる。
安易な `SaveAs` の羅列は、ファイルロック、メモリリーク、あるいは不正なパス指定によるランタイムエラーを招き、結果として設計者の作業を中断させる「負の遺産」となる。
本稿では、単なるコードの書き方を教えるのではない。Windows APIを用いた堅牢なファイルシステム制御、COMオブジェクトのライフサイクル管理、そして業務プロセスに耐えうる命名規則の動的生成――これらを統合した、プロフェッショナルなための実装アーキテクチャを提示する。
1. 命名規則の「真実のソース」を定義する
自動化において最も脆弱なのは、ファイル名の生成ロジックである。ハードコードされた文字列や、ファイル名そのものに依存するロジックは、設計変更に対して極めて脆い。
設計思想として、ファイル名は「図面内のカスタムプロパティ(Custom Properties)」を唯一の真実(Single Source of Truth)として構築すべきである。型番、プロジェクトコード、リビジョンといったメタデータを、図面データそのものから抽出することで、命名規則の整合性を担保する。
2. Windows APIによるファイルシステムの防御的制御
VBAの標準関数 `Dir` や `MkDir` は簡便だが、ネットワークドライブの遅延や、権限のないディレクトリへのアクセスに対して極めて無力である。
堅牢なシステムを構築する場合、`kernel32.dll` の関数を呼び出し、ファイルシステムのステータスを低レイヤーで判定するアプローチが求められる。これにより、書き込み失敗による「見えないエラー」を未然に防ぐ。
3. 実装:プロフェッショナル・エクスポート・エンジン
以下に、メモリ管理とエラーハンドリングを極限まで突き詰めた実装例を示す。このコードは、単なる「おまけ」ではなく、実務に投入可能なレベルの設計思想に基づいている。
Option Explicit
' --- Windows API Declarations ---
' ファイル属性を確認し、ディレクトリの存在を低レイヤーで判定する
Private Declare PtrSafe Function GetFileAttributes Lib "kernel32" Alias "GetFileAttributesA" (ByVal lpFileName As String) As Long
Private Const FILE_ATTRIBUTE_DIRECTORY As Long = &H10
''' <summary>
''' 図面保存時にPDFおよびDWGを規定の命名規則で出力するメインルーチン
''' </summary>
Public Sub ProfessionalExportSystem()
' オブジェクトの宣言(型を明示し、実行速度とメモリ効率を最大化)
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swCustPropMgr As SldWorks.CustomPropertyManager
Dim targetFolder As String
Dim baseName As String
Dim partNumber As String
Dim revision As String
Dim pdfPath As String
Dim dwgPath As String
Dim status As Boolean
Dim errors As Long
Dim warnings As Long
On Error GoTo ErrorHandler
' SolidWorks インスタンスの取得
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
' コンテキストチェック:図面ドキュメントか?
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 ' キャスト
' --- 1. メタデータの抽出 (Single Source of Truth) ---
' カスタムプロパティマネージャーから設計情報を取得
Set swCustPropMgr = swModel.Extension.CustomPropertyManager("")
' 型番とリビジョンの取得(プロパティが存在しない場合のフォールバックを考慮)
partNumber = GetCustomProperty(swCustPropMgr, "PartNumber")
revision = GetCustomProperty(swCustPropMgr, "Revision")
If partNumber = "" Then
Err.Raise vbObjectError + 513, "ExportSystem", "カスタムプロパティ 'PartNumber' が未定義です。"
End If
' --- 2. 出力パスの構築 ---
' 現在のファイルと同じディレクトリをベースとする
targetFolder = Left(swModel.GetPathName, InStrRev(swModel.GetPathName, "\"))
' Windows APIによるディレクトリ存在確認
If GetFileAttributes(targetFolder) = &xFFFFFFFF Then
Err.Raise vbObjectError + 514, "ExportSystem", "出力先ディレクトリが無効です。"
End If
' 命名規則の適用: [型番]_[リビジョン].拡張子
baseName = partNumber & "_" & revision
pdfPath = targetFolder & baseName & ".pdf"
dwgPath = targetFolder & baseName & ".dwg"
' --- 3. エクスポート実行 ---
' PDF出力
' SaveAsを使用する際、オプションを指定して制御する
status = swModel.Extension.SaveAs(pdfPath, swSaveAsCurrentVersion, swSaveAsOptions_Silent, Nothing, errors, warnings)
If Not status Then
Debug.Print "PDF Export Failed. Error Code: " & errors
End If
' DWG出力 (DrawingをDWG形式として保存)
' DWGは形式が異なるため、SaveAsの引数に注意が必要
status = swModel.Extension.SaveAs(dwgPath, swSaveAsDWG, swSaveAsOptions_Silent, Nothing, errors, warnings)
If Not status Then
Debug.Print "DWG Export Failed. Error Code: " & errors
End If
MsgBox "エクスポート完了:" & vbCrLf & pdfPath & vbCrLf & dwgPath, vbInformation
CleanUp:
' --- 4. メモリの明示的解放 (Critical for Long-running Sessions) ---
' COMオブジェクトの参照を解除し、メモリリークを防ぐ
Set swCustPropMgr = Nothing
Set swDraw = Nothing
Set swModel = Nothing
Set swApp = Nothing
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました:" & vbCrLf & Err.Description, vbCritical
Resume CleanUp
End Sub
''' <summary>
''' カスタムプロパティの値を安全に取得するためのヘルパー関数
''' </summary>
Private Function GetCustomProperty(cpMgr As SldWorks.CustomPropertyManager, propName As String) As String
Dim valOut As String
Dim res As Long
' Get6を使用することで、最新のAPI仕様に基づいた確実な値取得を行う
res = cpMgr.Get6(propName, False, valOut, False, False)
If res = 0 Then
GetCustomProperty = valOut
Else
GetCustomProperty = ""
End If
End Function
4. 伝説的アーキテクトの視点:なぜこの実装なのか
メモリ管理の重要性
VBAはガベージコレクション(GC)が強力ではない。特にSolidWorksのような巨大なCOMアプリケーションを操作する場合、`Set Object = Nothing` を怠ると、SolidWorksのプロセスがメモリ上に居座り続け、最終的にシステム全体のパフォーマンスを低下させる。本コードでは、`CleanUp` ラベルによる明示的な解放を徹底している。
エラーハンドリングの階層化
`On Error Resume Next` という「思考停止のコード」は、プロフェッショナルな現場では禁忌である。エラーが発生した際、それが「プロパティの欠如」なのか「ファイルシステムのアクセス拒否」なのかを明確に切り分け、ユーザーにフィードバックしなければならない。本実装では、`Err.Raise` を用いて、エラーの文脈(Context)を保持している。
パフォーマンスの重み
`swModel.Extension.SaveAs` を使用する際、`swSaveAsOptions_Silent` を指定している。これにより、ユーザーへのダイアログ表示を抑制し、バッチ処理や大量の図面を一括処理する際のオーバーヘッドを最小限に抑えている。
結論
自動化の本質は、「作業を楽にすること」ではない。「ヒューマンエラーを排除し、データの整合性を機械的に担保すること」にある。
今回提示した実装は、単なる「PDF保存マクロ」を超えた、設計資産管理の基盤となるコードである。これをテンプレートとし、自社の命名規則やファイルサーバーの構造に合わせて拡張していくこと。それが、エンジニアリングを一段上のステージへと引き上げる唯一の道である。
