マクロ記録を卒業しよう:ExcelとSolidWorks図面を「同期」させる真の自動化技術
こんにちは。設計自動化の世界へようこそ。
「マクロの記録」ボタンを押して、生成されたコードを眺めて「うーん、何をやっているのかさっぱりわからない……」と頭を抱えたことはありませんか? もしそうなら、おめでとうございます。あなたは今、「ただの記録係」から「自動化エンジニア」へと脱皮するための境界線に立っています。
今日、私たちが挑むのは、設計現場における「情報の不一致」という、非常に泥臭く、かつ致命的な問題の解決です。
解決したい課題:設計変更の「二重管理」を撲滅する
設計変更が発生したとき、多くの現場では「Excelの変更通知書」に内容を記入し、それとは別に「SolidWorksの図面リビジョンテーブル」にも手入力で情報を書き込みます。
- Excelには「Rev.A」と書いたのに、図面には「Rev.B」と書き間違えてしまった。
- 承認者が変わったのに、図面側の履歴だけ古いままだった。
こうしたヒューマンエラーは、製品の信頼性を揺るがすリスクになります。これを解決するのが、「Excelの変更通知書をマスター(正)とし、図面のリビジョンテーブルを自動的に同期させる」という仕組みです。
単に値を書き込むだけではありません。今回は「新しい行を追加して、履歴を積み上げていく」という、実務に即した高度な処理を実装します。
1. 脳内に描くべき「オブジェクトの階層構造」
コードを書く前に、最も重要な「設計図」を頭に叩き込んでください。SolidWorks VBAで挫折する人の9割は、「今、自分がどのオブジェクトを操作しているのか」を見失っています。
SolidWorksのAPIは、巨大なマトリョーシカのような階層構造になっています。図面のリビジョンテーブルにアクセスするには、以下のルートを辿る必要があります。
1. SldWorks (Application):SolidWorks本体
2. ModelDoc2 (Document):開いているファイルそのもの
3. DrawingDoc (Drawing):図面特有の機能(シートやビュー)を使うための型
4. Sheet (Sheet):図面上の「紙」の概念
5. View (View):図面上の「投影図」や「シート自体」
6. TableAnnotation (Table):ここが目的地! リビジョンテーブルは、実は「テーブル注記」の一種なのです。
この階層を一段ずつ、確実に登っていくイメージを持ってください。
2. 実装の核心:ExcelとSolidWorksの架け橋
それでは、魂を込めたコードを見ていきましょう。このコードは、Excelから「版数」「改訂日」「承認者」を読み取り、SolidWorks図面の末尾に新しい行を追加します。
事前準備
VBAエディタのメニュー [ツール] -> [参照設定] から、「Microsoft Excel 16.0 Object Library」(バージョンは環境によります)にチェックを入れてください。これによって、VBAからExcelを直接、高度に操作できるようになります。
Option Explicit
''
' @description: Excelの変更通知書からリビジョン情報を読み取り、
' 図面のリビジョンテーブルに新しい行として追加する。
' @author: Legendary Chief Architect
''
Sub SyncRevisionTableFromExcel()
' --- 変数定義:SolidWorks関連 ---
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swSheet As SldWorks.Sheet
Dim swView As SldWorks.View
Dim swTable As SldWorks.TableAnnotation
Dim boolstatus As Boolean
' --- 変数定義:Excel関連 ---
Dim xlApp As Excel.Application
Dim xlWB As Excel.Workbook
Dim xlSheet As Excel.Worksheet
Dim nextRow As Long
Dim revNum As String, revDate As String, approver As String
' --- エラーハンドリング ---
On Error GoTo ErrorHandler
' 1. SolidWorksへの接続
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
' 図面が開かれているかチェック
If swModel Is Nothing Then
MsgBox "図面ファイルを開いてから実行してください。", vbCritical
Exit Sub
End If
If swModel.GetType <> swDocDRAWING Then
MsgBox "このマクロは図面ファイル専用です。", vbCritical
Exit Sub
End If
Set swDraw = swModel
' 2. Excelへの接続 (実行中のExcelインスタンスを取得、なければ新規作成)
On Error Resume Next
Set xlApp = GetObject(, "Excel.Application")
If xlApp Is Nothing Then
MsgBox "Excelが起動していません。変更通知書を開いてください。", vbExclamation
Exit Sub
End If
On Error GoTo ErrorHandler
' 現在アクティブなExcelブックの「変更通知書」シートを指定
' ※実務ではファイルパスを固定するのがプロの技です
Set xlWB = xlApp.ActiveWorkbook
Set xlSheet = xlWB.Sheets("変更通知書")
' Excelから最新の変更データを読み取る (例: 最終行のデータを取得)
' ここでは例として、最終行の A列=版数, B列=日付, C列=承認者 と仮定
nextRow = xlSheet.Cells(xlSheet.Rows.Count, "A").End(xlUp).Row
revNum = xlSheet.Cells(nextRow, 1).Value ' A列
revDate = xlSheet.Cells(nextRow, 2).Value ' B列
approver = xlSheet.Cells(nextRow, 3).Value ' C列
If revNum = "" Then
MsgBox "Excelにデータが見つかりません。", vbExclamation
Exit Sub
End If
' 3. SolidWorks図面内のリビジョンテーブルを探す
' 図面内の最初のビューからテーブルを探索するアプローチ
Set swView = swDraw.GetFirstView ' Sheet自体を指す最初のビューを取得
Do While Not swView Is Nothing
' Viewが持つTableAnnotationを取得
Set swTable = swView.GetFirstTableAnnotation
' テーブルが見つかった場合、それがリビジョンテーブルか判定
' 実務ではテーブル名や特定のセル内容で判定するのが確実
If Not swTable Is Nothing Then
' ここでは「最初に見つかったテーブル」をリビジョンテーブルと見なす
' (より厳密にするなら swTable.GetAnnotation は Type で判定可能)
' --- リビジョンテーブルの更新処理 ---
' 新しい行を追加
swTable.InsertRows 1, swTable.RowCount ' 1行追加
' 追加された行(最新行)にデータを書き込む
' ※列番号は図面のテーブル定義に合わせて調整してください
Dim newRowIdx As Long
newRowIdx = swTable.RowCount
swTable.Text(newRowIdx, 1) = revNum ' 1列目: 版数
swTable.Text(newRowIdx, 2) = revDate ' 2列目: 改訂日
swTable.Text(newRowIdx, 3) = approver ' 3列目: 承認者
MsgBox "同期が完了しました!" & vbCrLf & "Rev: " & revNum, vbInformation
' 成功したので処理を抜ける
GoTo CleanUp
End If
' 次のビューへ
Set swView = swView.GetNextView
Loop
MsgBox "図面内にリビジョンテーブルが見つかりませんでした。", vbExclamation
CleanUp:
' オブジェクトの解放(メモリリーク防止の作法)
Set swTable = Nothing
Set swView = Nothing
Set swDraw = Nothing
Set swModel = Nothing
Set xlSheet = Nothing
Set xlWB = Nothing
Set xlApp = Nothing
Exit Sub
ErrorHandler:
MsgBox "予期せぬエラーが発生しました。" & vbCrLf & _
"エラー番号: " & Err.Number & vbCrLf & _
"エラー内容: " & Err.Description, vbCritical
Resume CleanUp
End Sub
3. プロの視点:ここをクリアすれば「使い物になる」
コードを書き終えただけでは、まだ「動くもの」を作ったに過ぎません。実務で運用するためには、以下の3つのポイントを意識してください。
① 「見つからない」への対策(エラーハンドリング)
上記のコードでは、`Do While Not swView Is Nothing` を使って、図面内の全てのビューをループさせています。なぜなら、リビジョンテーブルは「図面シート」に紐付いている場合もあれば、「特定のビュー」に紐付いている場合もあるからです。
「マクロの記録」で作ったコードは、特定のビュー番号を直書きしがちですが、それでは図面の構成が変わった瞬間にエラーで止まります。「探す」というプロセスを入れることが、堅牢なプログラムへの第一歩です。
② オブジェクトの解放(ライフサイクル管理)
コードの最後にある `CleanUp` セクションを見てください。`Set … = Nothing` と記述しています。
VBAは賢い言語ですが、ExcelとSolidWorksという二つの巨大なアプリケーションを跨いで操作する場合、メモリ上に「幽霊」のような参照が残り、Excelが閉じられなくなるトラブルがよく起こります。「使い終わったリソースは明示的に手放す」。これが、伝説のエンジニアが守る鉄則です。
③ 列番号の「マジックナンバー」を避ける
コード内の `swTable.Text(newRowIdx, 1)` の `1` や `2` は、テーブルの列番号です。
もし現場の図面で「列の順番が変わった」場合、この数字を書き直す必要があります。より高度なエンジニアを目指すなら、Excel側に「どの列に何を書くか」の定義を持たせるか、テーブルのヘッダー文字列(”Revision” など)を検索して列番号を特定するロジックを組み込むと、完璧なツールになります。
最後に
いかがでしたか?
「マクロの記録」で得られるコードは、あくまで「答え」の断片です。しかし、今回のように「オブジェクトの階層を辿り、条件に合わせて探し出し、エラーを予見して備える」という構造を理解すれば、あなたはSolidWorks APIという広大な海を自由に航海できるようになります。
一歩ずつ、確実に。
自動化の力で、設計者の時間を「単純作業」から「創造的な思考」へと解放していきましょう。
応援していますよ!
