【入門編】【中級者向け】図面リビジョンテーブルの「版数・改訂日・承認者」を外部Excelの変更通知書から読み込んで完全同期するVBA – SolidWorks VBA解析バイブル

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

マクロ記録を卒業しよう: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という広大な海を自由に航海できるようになります。

一歩ずつ、確実に。
自動化の力で、設計者の時間を「単純作業」から「創造的な思考」へと解放していきましょう。

応援していますよ!

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