COMインターフェースの深淵を制御せよ:ExcelからSolidWorks図面プロパティへの高信頼性データ注入アーキテクチャ
設計自動化の現場において、「動くもの」を作ることは容易だ。しかし、数千枚の図面を扱うエンタープライズ環境において、「止まらない、壊れない、そしてメモリを食いつぶさない」システムを構築することは、全く別の次元の技術を要求される。
多くの若手エンジニアが書くマクロは、Excelから値を読み取り、SolidWorksのAPIを叩く。それだけで終わる。しかし、そのコードは、実行中に数GBのメモリを解放せずに滞留させ、ゾンビプロセス(`SLDWORKS.exe`)をタスクマネージャーに大量に残し、最終的にはシステム全体の不安定化を招く。
本稿では、単なる「図面番号の書き換え」を超え、オブジェクトのライフサイクル管理、COMインターフェースのオーバーヘッド最小化、そして堅牢なエラーハンドリングを備えた、プロフェッショナルな自動化エンジンの設計思想を伝授する。
1. アーキテクチャの設計思想:COMブリッジの最適化
ExcelとSolidWorksは、共にWindowsのCOM (Component Object Model) に基づいて動作している。この二つのアプリケーション間でデータをやり取りする際、最大のボトルネックとなるのは「プロセス間通信(IPC)」の回数だ。
致命的なアンチパターン:セルの逐次読み取り
Excelのセルに対して、ループの中で毎回 `Cells(i, j).Value` を呼び出す行為は、VBAからExcelのCOMオブジェクトへ通信を飛ばすコストを最小単位で繰り返すことを意味する。これは極めて低速だ。
アーキテクトの解法:
データを一度、Variant配列(メモリ上の配列)に一括で吸い上げる。メモリ空間に展開されたデータに対してループ処理を行うことで、COMブリッジの呼び出し回数を劇的に削減し、処理速度をオーダーレベルで向上させる。
オブジェクトのライフサイクル管理
SolidWorks APIを使用する際、`SldWorks`, `ModelDoc2`, `DrawingDoc`, `CustomPropertyManager` といったオブジェクトが次々と生成される。これらを適切に `Set … = Nothing` で解放しない限り、参照カウントがゼロにならず、メモリリークが発生する。特にバッチ処理においては、この「明示的な解放」がシステムの生存率を決定づける。
2. 実装:高信頼性データ注入エンジンのコード例
以下に、実務に耐えうる堅牢なVBA実装を示す。このコードは、Excelのシートから図面パスと図面番号のペアを読み込み、SolidWorks図面のカスタムプロパティを更新する。
Option Explicit
' ==============================================================================
' Module: DrawingPropertyAutomator
' Description: Excelリストに基づき、SolidWorks図面のカスタムプロパティを高速・安全に更新する
' Author: Chief Architect
' ==============================================================================
Sub UpdateDrawingNumbersFromExcel()
' --- 1. 宣言部 (型定義を厳格に行い、実行時エラーを最小化する) ---
Dim swApp As Object ' SldWorks.SldWorks
Dim swModel As Object ' SldWorks.ModelDoc2
Dim swDraw As Object ' SldWorks.DrawingDoc
Dim swCustPropMgr As Object ' SldWorks.CustomPropertyManager
Dim xlSheet As Worksheet
Dim dataArray As Variant ' 高速化のためのメモリ内配列
Dim i As Long
Dim filePath As String
Dim drawingNo As String
Dim errorCount As Long
Dim successCount As Long
' Windows APIを活用した高度な制御が必要な場合はここに宣言を追加
' (例: Shell系の制御など)
' --- 2. 初期化フェーズ ---
On Error GoTo ErrorHandler
Set xlSheet = ThisWorkbook.Sheets("List") ' 対象シート名を指定
' Excelデータの高速読み込み (A列:パス, B列:図面番号)
' データの最終行を動的に取得
Dim lastRow As Long
lastRow = xlSheet.Cells(xlSheet.Rows.Count, 1).End(-4162).Row ' -4162 = xlUp
dataArray = xlSheet.Range("A2:B" & lastRow).Value ' 配列へ一括格納
' SolidWorksへの接続
On Error Resume Next
Set swApp = GetObject(, "SldWorks.Application")
If swApp Is Nothing Then
MsgBox "SolidWorksが起動していません。プロセスを確認してください。", vbCritical
Exit Sub
End If
On Error GoTo ErrorHandler
' 処理の可視化制御 (パフォーマンス向上のため、必要に応じてVisibleを制御)
' swApp.Visible = True ' デバッグ時はTrue、本番バッチ時はFalseを検討
' --- 3. メインループ (メモリ内配列による高速走査) ---
For i = 1 To UBound(dataArray, 1)
filePath = dataArray(i, 1)
drawingNo = dataArray(i, 2)
If filePath <> "" Then
' 図面ファイルを開く (バックグラウンドでの動作を想定)
' swOpenDocOptions: 1 = swOpenDocOptions_Silent
Set swModel = swApp.OpenDoc6(filePath, 3, 1, "", 0, 0) ' 3 = swDocDRAWING
If Not swModel Is Nothing Then
Set swDraw = swModel
' 図面固有のプロパティマネージャを取得
' 図面ファイル自体のカスタムプロパティにアクセス
Set swCustPropMgr = swModel.Extension.CustomPropertyManager("")
' プロパティの書き込み (DRAWING_NO)
' Add3: 既存の場合は更新、なければ追加
' 戻り値: 0 = 成功, 1 = 既存プロパティを更新
swCustPropMgr.Add3 "DRAWING_NO", 30, drawingNo, 1 ' 30 = swCustomInfoText
' 保存とクローズ
swModel.Save3 1, 0 ' 1 = swSaveAsOptions_Silent
swApp.CloseDoc swModel.GetTitle
successCount = successCount + 1
' --- 重要: オブジェクトの明示的解放 (COM参照カウントの管理) ---
Set swCustPropMgr = Nothing
Set swDraw = Nothing
Set swModel = Nothing
Else
Debug.Print "Failed to open: " & filePath
errorCount = errorCount + 1
End If
End If
' メモリ負荷軽減のためのDoEvents (極めて大規模なループの場合)
If i Mod 10 = 0 Then DoEvents
Next i
' --- 4. 終了フェーズ ---
MsgBox "処理完了" & vbCrLf & _
"成功: " & successCount & " 件" & vbCrLf & _
"失敗: " & errorCount & " 件", vbInformation
CleanUp:
' 全てのオブジェクトを確実に解放
Set swCustPropMgr = Nothing
Set swDraw = Nothing
Set swModel = Nothing
Set swApp = Nothing
Exit Sub
ErrorHandler:
MsgBox "予期せぬエラーが発生しました。" & vbCrLf & _
"Error No: " & Err.Number & vbCrLf & _
"Description: " & Err.Description, vbCritical
errorCount = errorCount + 1
Resume CleanUp
End Sub
3. 極限の知見:プロフェッショナルが守るべき「三原則」
このコードをベースに、さらに高度な運用を行うための設計指針を記す。
① 冪等性(Idempotency)の確保
自動化スクリプトは、「何度実行しても同じ結果になる」必要がある。
`swCustPropMgr.Add3` を使用しているのは、プロパティが存在しない場合は作成し、既に存在する場合は上書きするという挙動(冪等性)を保証するためだ。これにより、中途半端なエラーで停止した後に再実行しても、二重登録やエラーによる停止を防ぐことができる。
② Silent Modeの徹底
`swOpenDocOptions_Silent` (値: 1) を使用することは、単なる親切心ではない。
ダイアログボックス(「読み込みエラーがあります」「参照が見つかりません」等)が背後でポップアップすると、VBAの実行スレッドは完全にブロックされ、プロセスは「応答なし」の状態に陥る。大規模バッチでは、あらゆる対話型ダイアログを抑制するオプションを常に意識せよ。
③ リソース・ガベージコレクションの意識
VBAには、JavaやC#のような高度なガベージコレクタは存在しない。
特に `Set swModel = swApp.OpenDoc6(…)` のように、APIから新しいオブジェクトインスタンスを受け取る場合、そのオブジェクトは呼び出し側の変数がスコープを抜けても、参照が残っていればメモリに居座り続ける。
ループの各ステップにおいて、「使用したものは、直ちにNothingで葬る」。これが、長時間稼働するシステムにおいて、メモリ不足によるクラッシュを回避する唯一の手段である。
結論
図面番号の自動流し込みは、一見すると単純な作業に見える。しかし、その裏側にあるのは、Windowsのメモリ管理、COMの参照カウント、そしてプロセスのライフサイクルという、OSの根幹に関わる技術の積み重ねである。
「動けばいい」という思考を捨て、「いかにエレガントに、いかに堅牢にリソースを管理するか」に注力せよ。それこそが、シニアエンジニアと、単なるスクリプターを分かつ境界線である。
