【極限の自動化】図面変換エンジンの設計思想:Windows APIによる監視とCOMオブジェクトの完全制御
業務自動化の現場において、「動けばいい」というコードは、後に必ずシステム全体の足を引っ張る「技術的負債」へと変貌する。
特にSolidWorksのような巨大なCOM(Component Object Model)アプリケーションを外部から制御する場合、その設計思想は、単なるスクリプトの域を超え、OSの挙動とメモリのライフサイクルを完全に掌握した「システム」でなければならない。
本稿では、図面ファイル(Drawing)の追加を検知し、PDFおよびDXFへと自動的に振り分け・出力する「常駐型バッチエンジン」の構築について、シニアエンジニアが直面する「真の課題」に焦点を当てて解説する。
1. 凡庸なエンジニアが陥る「ポーリングの罠」
多くの開発者は、フォルダ内の新着ファイルを検知するために、`Dir()` 関数を用いた無限ループと `DoEvents` によるポーリング(定期的な監視)を選択する。
' --- 避けるべきアンチパターン ---
Do While True
fileName = Dir(inputPath & "*.SLDDRW")
If fileName <> "" Then
' 処理を実行
End If
DoEvents ' CPUリソースを浪費し、UIスレッドを不安定にする
Loop
この手法は、CPUリソースを無駄に消費し続けるだけでなく、ファイルが書き込み中のタイミングでアクセスを試みるという「ファイルロック競合」の温床となる。
真のアーキテクトは、OSのイベント駆動型メカニズムを利用する。Windows APIの `ReadDirectoryChangesW` を用いて、ファイルシステムの変化をカーネルレベルで待ち受けるのが理想だが、VBA単体での実装は極めて複雑かつ不安定になりやすい。
実務的な最適解は、「.NETのFileSystemWatcherをラップした軽量なエージェント」を用いるか、あるいは「高精度タイマーを用いた、ファイルロックを検知する高度なポーリング・アルゴリズム」を実装することである。本稿では、VBA環境での堅牢性を重視し、後者の「ファイルロック検知型高精度ポーリング」をベースとした設計論を展開する。
2. SolidWorks API制御における「メモリ解放」の絶対原則
SolidWorksの自動化において、最大の敵は「ゴーストプロセス(残留する `SLDWORKS.exe`)」である。
VBAの `Set obj = Nothing` は、あくまでVBA側の参照カウントを減らすだけであり、背後のCOMオブジェクトが完全に破棄されたことを保証しない。特に、ループ内で大量の図面を開閉する場合、明示的なメソッド呼び出しによるリソース解放が不可欠である。
制御すべきライフサイクル
1. Application Object: 起動・接続の確立。
2. ModelDoc2 Object: ファイルのオープン、操作の主体。
3. DrawingDoc Object: 図面固有のプロパティ(シート、ビュー)へのアクセス。
4. Export/SaveAs Process: I/O操作に伴うメモリバッファの管理。
3. 実装:高精度図面変換エンジン・コア
以下に、設計思想に基づいた堅牢なエンジンのコード構造を示す。これは単なるコード例ではなく、エラーハンドリングとメモリ管理を組み込んだ「プロトタイプ」である。
Option Explicit
' --- 外部定義: Windows APIによる高精度な時間計測 ---
Private Declare PtrSafe Function GetTickCount Lib "kernel32" () As Long
' 定数定義
Private Const TARGET_EXT As String = ".SLDDRW"
Private Const PDF_EXT As String = ".pdf"
Private Const DXF_EXT As String = String(1, Chr(34)) & ".dxf" ' 実際には拡張子として扱う
' グローバル変数(ライフサイクル管理のため)
Private swApp As Object
Private isRunning As Boolean
''' <summary>
''' エンジンのメインエントリポイント
''' </summary>
Public Sub StartEngine(ByVal watchPath As String)
Dim fso As Object
Set fso = CreateObject("Scripting.FileSystemObject")
' SolidWorksへの接続(既存インスタンスの取得を優先)
On Error Resume Next
Set swApp = GetObject(, "SldWorks.Application")
If swApp Is Nothing Then
Set swApp = CreateObject("SldWorks.Application")
swApp.Visible = True
End If
On Error GoTo ErrorHandler
isRunning = True
Debug.Print "Engine Started: " & watchPath
' メイン監視ループ
Do While isRunning
Dim folder As Object
Set folder = fso.GetFolder(watchPath)
Dim file As Object
For Each file In folder.Files
If LCase(fso.GetExtensionName(file.Path)) = "slddrw" Then
' 1. ファイルが書き込み中(ロック中)でないかを確認
If IsFileReady(file.Path) Then
' 2. 変換処理の実行
ProcessDrawing file.Path
End If
End If
Next file
' CPU負荷軽減のための待機(APIによる高精度待機が望ましい)
' ここではシンプルにSleep相当の処理を想定
Dim t As Long: t = GetTickCount()
Do While GetTickCount() - t < 2000 ' 2秒間待機
DoEvents
Loop
Loop
ExitProcedure:
CleanUp
Exit Sub
ErrorHandler:
Debug.Print "Critical Error: " & Err.Description
Resume ExitProcedure
End Sub
''' <summary>
''' ファイルが完全に書き込まれ、ロックが解除されているかを確認する
''' </summary>
Private Function IsFileReady(filePath As String) As Boolean
Dim fileNum As Integer
fileNum = FreeFile()
On Error Resume Next
' 書き込みモードで開けるか試行
Open filePath For Binary Access Read Write Lock Read Write As #fileNum
Close #fileNum
If Err.Number = 0 Then
IsFileReady = True
Else
IsFileReady = False
End If
On Error GoTo 0
End Function
''' <summary>
''' 図面変換のコアロジック
''' </summary>
Private Sub ProcessDrawing(ByVal filePath As String)
Dim swModel As Object
Dim swDrawing As Object
Dim fileInfo As Object
Dim fso As Object
Dim savePathPDF As String
Dim savePathDXF As String
Dim errors As Long
Dim warnings As Long
Set fso = CreateObject("Scripting.FileSystemObject")
Set fileInfo = fso.GetFile(filePath)
' 出力パスの構築(命名規則に基づいたディレクトリ振り分けロジックをここに集約)
savePathPDF = fso.GetParentFolderName(filePath) & "\PDF\" & fso.GetBaseName(filePath) & PDF_EXT
savePathDXF = fso.GetParentFolderName(filePath) & "\DXF\" & fso.GetBaseName(filePath) & ".dxf"
' --- SolidWorks API 操作 ---
' ファイルのオープン(読み取り専用で開き、他プロセスへの影響を最小化)
Set swModel = swApp.OpenDoc6(filePath, 3, 1, "", errors, warnings) ' 3 = swDocDRAWING, 1 = swOpenDocOptions_Silent
If Not swModel Is Nothing Then
Set swDrawing = swModel
' PDF出力
' SaveAsを使用。第2引数は保存形式(swSaveAsPDF)
Dim status As Boolean
status = swModel.Extension.SaveAs(savePathPDF, 0, 1, Nothing, errors, warnings)
' DXF出力
status = swModel.Extension.SaveAs(savePathDXF, 0, 1, Nothing, errors, warnings)
' --- 重要:オブジェクトの明示的な解放 ---
' 参照を切り、メモリから破棄を促す
swApp.CloseDoc swModel.GetTitle
Set swDrawing = Nothing
Set swModel = Nothing
Debug.Print "Successfully Processed: " & fileInfo.Name
Else
Debug.Print "Failed to open: " & fileInfo.Name & " Error: " & errors
End If
Set fso = Nothing
Set fileInfo = Nothing
End Sub
''' <summary>
''' リソースの完全なクリーンアップ
''' </summary>
Private Sub CleanUp()
isRunning = False
Set swDrawing = Nothing
Set swModel = Nothing
Set swApp = Nothing
Debug.Print "Engine Stopped and Resources Released."
End Sub
4. アーキテクトの視点:実運用における極限の知見
このコードを実戦投入する際、シニアエンジニアが考慮すべきは「例外の連鎖」である。
4.1. 命名規則による動的ルーティング
上記のコードでは出力先を単純なサブフォルダとしているが、実務では「プロジェクトコード」「リビジョン」「図面種別」をファイル名からパースし、異なるサーバー(NAS)へ振り分けるロジックが求められる。この際、`FileSystemObject` を用いたディレクトリの存在チェックと、権限エラーのハンドリングを、`ProcessDrawing` の外側に切り出すことで、単一責任の原則(Single Responsibility Principle)を維持せよ。
4.2. 非同期的なエラーハンドリング
図面の中に「破損したジオメトリ」や「参照切れの外部参照」が含まれている場合、`OpenDoc6` は失敗するか、あるいは極端に長いタイムアウトを引き起こす。
大規模運用では、`swApp.OpenDoc6` の前に、ファイルヘッダーの整合性をチェックする軽量なバイナリ読み取り処理を挟む、あるいは一定時間応答がない場合にプロセスを強制再起動する「ウォッチドッグ・プロセス」を別途用意するのが、堅牢なシステム設計の定石である。
4.3. レガシー環境への配慮
もし対象の環境が 32bit 版の SolidWorks である場合、メモリ空間の制約(2GB/4GBの壁)が厳しくなる。この場合、一度に大量のファイルを処理するのではなく、一定件数ごとに `swApp` 自体を一度終了させ、再起動する「プロセス・リフレッシュ」戦略を実装することを強く推奨する。
結論
自動化エンジニアの価値は、コードの行数ではなく、「システムが止まらないための設計」に宿る。
Windows APIによる監視、COMオブジェクトの厳格なライフサイクル管理、そしてエラーを前提とした防衛的プログラミング。これらを統合して初めて、図面変換エンジンは「道具」から「信頼に足るインフラ」へと昇華するのである。
