脱・スクリプト書き:SolidWorks図面自動変換エンジンを構築するためのアーキテクチャ設計論
「とりあえず、ファイル一覧を取得して、ループで一つずつPDFに書き出すVBAを書きました。動いています!」
もし君が今、そんな報告を私にしようとしているなら、今すぐそのキーボードから手を離してほしい。君が作ったのは「ツール」ではない。ただの「脆弱なスクリプト」だ。
実務の現場、特に設計部門のワークフローに組み込まれるツールにおいて、最も恐ろしいのは「エラーで止まること」ではなく、「エラーに気づかれずに、中途半端な状態で処理が完了してしまうこと」だ。ファイルがロックされている、SolidWorksが応答していない、出力先フォルダの権限がない……。こうした「現場のノイズ」を考慮せずに書かれたコードは、業務を効率化するどころか、データの整合性を破壊する時限爆弾となる。
今日は、中級者への階段を登るために、単なる「自動化」を超えた「堅牢なバッチエンジンの設計思想」を伝授する。テーマは、図面ファイルの監視と、PDF/DXFへの自動振り分け・出力エンジンだ。
1. なぜ君のコードは「現場」で使い物にならないのか
多くの開発者が陥る罠は、「ファイルシステムとアプリケーション(SolidWorks)のライフサイクルを同一視している」点にある。
ファイルロックの壁
図面が保存された瞬間、OSはまだそのファイルを書き込み中で、ロックをかけている可能性がある。その瞬間にVBAが「さあ、開くぞ!」と突っ込んでいけば、実行時エラーで無残に散る。
状態管理(State Management)の欠如
「どのファイルを処理済みで、どのファイルが未処理か」をメモリ上だけで管理していないか? ツールを再起動した瞬間に、また同じファイルを処理しようとして重複出力が発生する。これはデータベース設計における「冪等性(Idempotency)」の欠如だ。
モノリシックな設計
「監視」「解析」「変換」「移動」を一つのプロシージャに詰め込むな。これでは、PDF出力だけをテストしたい時ですら、ファイル監視のロジックを通らなければならなくなる。
2. 勝利の方程式:堅牢なエンジンの3層構造
プロフェッショナルなエンジンは、以下の3つのコンポーネントに分離して設計すべきだ。
1. Watcher(監視層): 指定フォルダの変更を検知し、対象ファイルのパスを「キュー(待ち行列)」に投入する。
2. Dispatcher(制御層): キューからタスクを取り出し、ファイルが「利用可能(ロック解除済み)」かを確認し、変換タスクへ割り振る。
3. Executor(実行層): SolidWorks APIを叩き、実際にPDF/DXFを生成し、指定のアーカイブへ格納する。
3. 実装例:プロダクション・クオリティのバッチエンジン
ここでは、VBAにおいて最も現実的かつ堅牢な「ポーリング方式によるステートマシン・エンジン」のコード例を示す。本来、Windows APIの`FileSystemWatcher`を使うのが理想だが、VBA環境での安定性と配布の容易さを考慮し、高度なリトライ・ロジックを組み込んだ設計にする。
モジュール構成の要諦
' --- プロダクション・レベルの定数定義 ---
Option Explicit
Private Const RETRY_COUNT As Integer = 5 ' ファイルロック解除待ちのリトライ回数
Private Const RETRY_INTERVAL_MS As Long = 1000 ' リトライ間隔(ミリ秒)
Private Const INPUT_DIR As String = "C:\SW_Input\"
Private Const PDF_DIR As String = "C:\SW_Archive\PDF\"
Private Const DXF_DIR As String = "C:\SW_Archive\DXF\"
' 処理済みファイルを記録する辞書(重複処理防止)
Private ProcessedFiles As Object
''' <summary>
''' メインエンジン:監視ループ
''' </summary>
Public Sub RunBatchEngine()
Dim swApp As SldWorks.SldWorks
Dim fso As Object
Dim folder As Object
Dim file As Object
Set ProcessedFiles = CreateObject("Scripting.Dictionary")
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
Debug.Print "--- Engine Started: " & Now & " ---"
' メインループ(常駐型)
Do While True
If fso.FolderExists(INPUT_DIR) Then
Set folder = fso.GetFolder(INPUT_DIR)
For Each file In folder.Files
' 図面ファイル(.slddrw)かつ未処理の場合
If LCase(fso.GetExtensionName(file.Path)) = "slddrw" Then
If Not ProcessedFiles.Exists(file.Path) Then
' 1. ファイルが使用可能か(ロックされていないか)チェック
If IsFileReady(file.Path) Then
' 2. 変換処理の実行
If ProcessDrawingFile(swApp, file.Path) Then
' 成功時のみ処理済みリストへ
ProcessedFiles.Add file.Path, True
End If
End If
End If
End If
Next file
End If
' CPU負荷軽減のためのウェイト(重要!)
DoEvents
Sleep 2000 ' 2秒待機
Loop
ExitLoop:
Exit Sub
ErrorHandler:
Debug.Print "CRITICAL ERROR: " & Err.Description
Resume ExitLoop
End Sub
''' <summary>
''' ファイルが書き込み完了しているかを確認する(重要:I/O Race Condition対策)
''' </summary>
Private Function IsFileReady(filePath As String) As Boolean
Dim fso As Object
Dim fileNum As Integer
Dim retry As Integer
Set fso = CreateObject("Scripting.FileSystemObject")
fileNum = FreeFile
On Error Resume Next
For retry = 1 To RETRY_COUNT
' ファイルを排他的に開けるか試行
Open filePath For Binary Access Read Write Lock Read Write As #fileNum
Close #fileNum
If Err.Number = 0 Then
IsFileReady = True
Exit Function
End If
Err.Clear
Sleep RETRY_INTERVAL_MS
Next retry
IsFileReady = False ' タイムアウト
End Sub
''' <summary>
''' 図面ファイルの変換・振り分けロジック
''' </summary>
Private Function ProcessDrawingFile(swApp As SldWorks.SldWorks, filePath As String) As Boolean
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim fileName As String
Dim baseName As String
Dim pdfPath As String
Dim dxfPath As String
Dim status As Boolean
On Error GoTo ProcessError
' ファイル名の解析
Dim fso As Object
Set fso = CreateObject("Scripting.FileSystemObject")
baseName = fso.GetBaseName(filePath)
pdfPath = PDF_DIR & baseName & ".pdf"
dxfPath = DXF_DIR & baseName & ".dxf"
' 1. SolidWorksでファイルを開く
' OpenDoc6は戻り値でエラーを確認できるため、堅牢な設計に必須
status = swApp.OpenDoc6(filePath, swDocDRAWING, swOpenDocOptions_Silent, "", status)
If Not status Then
Debug.Print "Failed to open: " & filePath
ProcessDrawingFile = False
Exit Function
End If
Set swModel = swApp.ActiveDoc
Set swDraw = swModel
' 2. PDF出力
' SaveAsを使う際は、出力先パスが正しいか、フォルダが存在するかを事前に検証すること
status = swModel.Extension.SaveAs(pdfPath, swSaveAsCurrentVersion, swSaveAsOptions_Silent, Nothing, 0, 0)
If Not status Then Debug.Print "PDF Export Failed: " & baseName
' 3. DXF出力
' DXFは設定(レイヤー等)に依存するため、必要に応じて設定を流し込むロジックをここに
status = swModel.Extension.SaveAs(dxfPath, swSaveAsCurrentVersion, swSaveAsOptions_Silent, Nothing, 0, 0)
If Not status Then Debug.Print "DXF Export Failed: " & baseName
' 4. クローズ
swApp.CloseDoc swModel.GetTitle
Debug.Print "Successfully Processed: " & baseName
ProcessDrawingFile = True
Exit Function
ProcessError:
Debug.Print "Error processing " & filePath & ": " & Err.Description
ProcessDrawingFile = False
End Function
' --- Windows APIの宣言 ---
If VBA7 Then
Private Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As LongPtr)
Else
Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)
End If
4. アーキテクトからの最終助言
このコードをベースに、君が実務に投入する際は以下の3点を必ず検討せよ。
① ログ管理の徹底
`Debug.Print` は開発用だ。プロダクション環境では、`FileSystemObject` を使って、日付・時刻・ファイル名・成否・エラー内容を書き出すテキストログファイルを必ず実装せよ。トラブルが起きた際、君の身を守るのはログだけだ。
② データベース(またはCSV)による永続的なステート管理
上記の例では `ProcessedFiles`(Dictionary)を使っているが、これはメモリ上にあるため、ツールを終了すると消える。真のプロフェッショナルは、処理済みリストを SQLite や CSVファイル に書き出し、再起動後も「どこまでやったか」を完全に記憶させる。
③ 例外的なファイル名のハンドリング
設計者は時として、ファイル名に特殊文字(`/`, `\`, `*`, `?` など)を紛れ込ませる。これらはファイルシステムにおいて「不正な文字」となり、`SaveAs` を確実に失敗させる。正規表現(`VBScript.RegExp`)を用いて、ファイル名をサニタイズ(洗浄)する工程を検討せよ。
「動けばいい」という考えを捨て、「止まらない、間違えない」設計へ。
これが、エンジニアリングの境界線だ。君のコードが、単なる自動化を超えた「信頼されるインフラ」になることを期待している。
