「動けばいい」はエンジニアの敗北。Excelリストから図面プロパティを書き換える、堅牢な自動化設計論
設計現場における「転記作業」は、単なる時間の浪費ではない。それは「ヒューマンエラーという名の爆弾」を設計図の中に埋め込む行為だ。
図面番号(DRAWING_NO)をExcelの管理リストから図面のカスタムプロパティへ流し込む。一見、初心者向けの簡単なタスクに見えるだろう。しかし、現場で「明日から使ってください」と渡されたマクロが、数分後にExcelのメモリを食いつぶしてフリーズしたり、誤った図面を上書きしてしまい、設計変更の履歴を破壊したりする光景を、私は何度も見てきた。
本記事では、単なる「コピペで動くコード」の提供に留まらない。「業務で耐えうる、堅牢な(Robust)自動化ツール」を設計するための思考プロセスと、その実装コードを伝授する。
1. 初心者が陥る「脆弱な設計」の正体
多くの初心者が書くコードには、共通する致命的な欠陥がある。それは「状態(State)への依存」だ。
- 「現在開いている図面(ActiveDoc)」を対象にする:
ユーザーがマクロ実行中に別のウィンドウをクリックした瞬間、マクロは全く別の図面に対して書き換えを開始する。これは設計変更における致命的な事故に直結する。
- エラーハンドリングの欠如:
「ファイルが見つからない」「プロパティ名が間違っている」「Excelが読み取り専用である」といった、実務で必ず発生する例外事象を無視している。
- オブジェクトの解放漏れ:
ExcelやSolidWorksのプロセスをメモリ上に残したまま終了させる設計。これにより、PCの動作が徐々に重くなり、最終的にはシステムダウンを招く。
プロフェッショナルは、「どのファイルに対して」「どのプロパティを」「どういう手順で」操作するかを、明示的かつ決定論的に記述する。
2. アーキテクチャ設計:Excel ⇄ SolidWorks の連携フロー
堅牢なツールを作るには、以下の3層構造を意識せよ。
1. Data Layer (Excel):
「ファイルパス」と「書き込むべき値」のペアを保持する。
2. Logic Layer (VBA):
Excelからデータを読み込み、SolidWorks APIを介して、ファイルを開き、プロパティを更新し、保存して閉じる。
3. Resource Layer (SolidWorks API):
`OpenDoc6` メソッドを使用して、パスを指定して確実にファイルを開く。
3. 実装例:プロダクション・グレードのマクロ
以下に、実務でそのまま採用できるレベルのコードを示す。このコードは、単に値を書き込むだけでなく、エラー制御とリソース管理を徹底している。
'==============================================================================
' Module: DrawingPropertyUpdater
' Description: Excelリストに基づき、図面ファイルのカスタムプロパティを更新する
' Author: Chief Architect
'==============================================================================
Option Explicit
' 定数定義:マジックナンバーを排除し、保守性を高める
Private Const PROP_NAME As String = "DRAWING_NO" ' 更新対象のプロパティ名
Private Const EXCEL_COL_PATH As Integer = 1 ' ExcelのA列:ファイルフルパス
Private Const EXCEL_COL_VAL As Integer = 2 ' ExcelのB列:図面番号
Sub UpdateDrawingPropertiesFromExcel()
Dim swApp As SldWorks.SldWorks
Dim xlApp As Excel.Application
Dim xlWB As Excel.Workbook
Dim xlSheet As Excel.Worksheet
Dim swModel As SldWorks.ModelDoc2
Dim swCustPropMgr As SldWorks.CustomPropertyManager
Dim filePath As String
Dim drawingNo As String
Dim lastRow As Long
Dim i As Long
Dim errorCount As Long
Dim successCount As Long
' 1. SolidWorksへの接続確認
On Error Resume Next
Set swApp = Application.SldWorks ' SolidWorks内から実行する場合
If swApp Is Nothing Then
Set swApp = GetObject(, "SldWorks.Application")
End If
On Error GoTo 0
If swApp Is Nothing Then
MsgBox "SolidWorksが起動していません。プロセスを起動してから実行してください。", vbCritical
Exit Sub
End If
' 2. Excelオブジェクトの制御
' 現在開いているExcelブックを使用する設計(ユーザーの操作性を考慮)
On Error Resume Next
Set xlApp = GetObject(, "Excel.Application")
If xlApp Is Nothing Then
MsgBox "Excelが起動していません。リストを開いた状態で実行してください。", vbCritical
Exit Sub
End If
Set xlWB = xlApp.ActiveWorkbook
Set xlSheet = xlWB.ActiveSheet
On Error GoTo ErrorHandler
' 3. 処理範囲の特定
lastRow = xlSheet.Cells(xlSheet.Rows.Count, EXCEL_COL_PATH).End(xlUp).Row
' 画面更新停止(パフォーマンス向上とチラつき防止)
' ※SolidWorksの操作時は、API経由の制御が優先される
Debug.Print "--- プロセス開始: " & Now & " ---"
' 4. メインループ:データ駆動型処理
For i = 2 To lastRow ' 1行目はヘッダーと想定
filePath = xlSheet.Cells(i, EXCEL_COL_PATH).Value
drawingNo = xlSheet.Cells(i, EXCEL_COL_VAL).Value
' ファイルの存在確認(FileSystemObjectを使用せず標準関数で軽量化)
If Dir(filePath) <> "" Then
' 【重要】ActiveDocではなく、パスを指定して明示的に開く
' swOpenDocOptions: swOpenDocOptions_Silent (ダイアログを表示させない)
Set swModel = swApp.OpenDoc6(filePath, swDocDRAWING, swOpenDocOptions_Silent, "", 0, 0)
If Not swModel Is Nothing Then
' カスタムプロパティマネージャの取得
Set swCustPropMgr = swModel.Extension.CustomPropertyManager("")
' プロパティの書き込み (Add3: 既存なら更新、なければ追加)
' 第4引数 swCustomInfoText で文字列として格納
Dim res As Long
res = swCustPropMgr.Add3(PROP_NAME, swCustomInfoText, drawingNo, swCustomPropertyReplaceValue)
' 保存とクローズ
swModel.Save3 swSaveAsOptions_Silent, 0, 0
swApp.CloseDoc swModel.GetTitle
successCount = successCount + 1
Debug.Print "Success: " & filePath
Else
errorCount = errorCount + 1
Debug.Print "Error: ファイルを開けませんでした -> " & filePath
End If
Else
errorCount = errorCount + 1
Debug.Print "Error: ファイルが存在しません -> " & filePath
End If
Next i
' 5. 結果報告
MsgBox "処理が完了しました。" & vbCrLf & _
"成功: " & successCount & " 件" & vbCrLf & _
"失敗: " & errorCount & " 件", vbInformation
CleanUp:
' 6. リソースの解放(メモリリーク防止)
' オブジェクトをNothingで明示的に解放する
Set swCustPropMgr = Nothing
Set swModel = Nothing
Set xlSheet = Nothing
Set xlWB = Nothing
Set xlApp = Nothing
Set swApp = Nothing
Exit Sub
ErrorHandler:
MsgBox "予期せぬエラーが発生しました。" & vbCrLf & _
"エラー番号: " & Err.Number & vbCrLf & _
"内容: " & Err.Description, vbCritical
errorCount = errorCount + 1
Resume CleanUp
End Sub
4. 設計の極意:なぜこの書き方なのか?
このコードを単なる「動くコード」としてではなく、「設計書」として読み解いてほしい。
① `OpenDoc6` による明示的制御
`ActiveDoc` を使うのは素人の仕事だ。本コードでは `OpenDoc6` を使い、ファイルパスから直接モデルをインスタンス化している。これにより、ユーザーが作業中に別のファイルをクリックしても、マクロのターゲットがブレることは絶対にない。
② `Add3` メソッドの戦略的利用
`Set2` ではなく `Add3` を使用している。`Add3` は、プロパティが存在しない場合は新規作成し、存在する場合は `swCustomPropertyReplaceValue` フラグによって値を更新する。これにより、「プロパティがあるかないか」を事前にチェックする無駄な条件分岐を排除し、コードをシンプルかつ高速に保っている。
③ エラーハンドリングとリソース管理
`On Error GoTo ErrorHandler` による例外処理、そして `CleanUp` セクションでの `Set … = Nothing`。これは、大規模な自動化システムを運用する上での「最低限のマナー」だ。メモリ上にゴミを残さないことは、長時間のバッチ処理においてシステムの安定性を左右する。
④ パフォーマンスへの配慮
`swOpenDocOptions_Silent` を指定することで、ファイルを開く際の「読み取り専用で開きますか?」といったダイアログを抑制している。対話型操作を排除し、完全な非対話型(Unattended)プロセスに近づけることが、自動化エンジニアの責務である。
5. 実務への導入に向けて
このツールを現場に投入する際は、以下のチェックリストを確認せよ。
- [ ] Excelのパス形式: Windowsのフルパス(`C:\Users\…`)が正しく記載されているか。
- [ ] プロパティ名の不一致: SolidWorks側のプロパティ名が `DRAWING_NO` であるか(大文字小文字の差異に注意)。
- [ ] 権限: 実行ユーザーが、対象の図面ファイルおよび保存先フォルダに対して書き込み権限を持っているか。
自動化とは、単に「楽をするための道具」ではない。「人間が介在すべきではない場所に、人間を配置しないためのシステム設計」である。この思考を持って、次のコードを書き始めてほしい。
