【実務・中級編】【中級者向け】図面ファイル群を一括変換する際のカレントフォルダ監視と「PDF/DXF自動振り分け」バッチエンジン – SolidWorks VBA解析バイブル

スポンサーリンク
スポンサーリンク

脱・スクリプト書き: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`)を用いて、ファイル名をサニタイズ(洗浄)する工程を検討せよ。

「動けばいい」という考えを捨て、「止まらない、間違えない」設計へ。
これが、エンジニアリングの境界線だ。君のコードが、単なる自動化を超えた「信頼されるインフラ」になることを期待している。

タイトルとURLをコピーしました