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

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

整合性の極致:Excel変更通知書とSolidWorksリビジョンテーブルの完全同期アーキテクチャ

設計変更(ECN/ECR)のプロセスにおいて、最も致命的なミスは「情報の不一致」である。
Excelで管理されている変更通知書の「版数」と、図面内に刻まれた「リビジョン履歴」が食い違った瞬間、製造現場には誤った図面が流出し、莫大な手戻りコストが発生する。

多くのエンジニアは、この問題を「手入力」という、極めて脆弱なヒューマンプロセスに委ねている。あるいは、単純なコピー&ペーストのマクロを作成して満足している。だが、それは「自動化」ではない。単なる「作業の置き換え」に過ぎない。

真の自動化とは、データの信頼性(Data Integrity)を担保するための、堅牢な同期エンジンを構築することである。

本稿では、Excelの変更通知書を「Single Source of Truth(信頼できる唯一の情報源)」とし、SolidWorks図面内のリビジョンテーブルを、メモリ管理とエラーハンドリングの極限まで突き詰めた手法で同期させる、プロフェッショナル向けの設計指針を解説する。

1. アーキテクチャの設計思想:COMオブジェクトのライフサイクル管理

SolidWorksとExcelという、巨大なCOM(Component Object Model)アプリケーションを跨ぐ開発において、初心者が陥る最大の罠は「ゾンビプロセス」である。

VBAのスクリプトが終了しても、バックグラウンドで `Excel.exe` や `SLDWORKS.exe` がメモリ上に居座り続ける現象だ。これは、オブジェクトの参照カウントが正しくゼロになっていない場合に発生する。

我々が構築する同期エンジンでは、以下の3原則を徹底する。
1. Explicit Release(明示的解放): すべてのオブジェクト変数に対し、使用直後に `Set obj = Nothing` を実行する。
2. Late Binding vs Early Binding: 実行速度と配布の容易性のトレードオフを理解し、本番環境では参照設定を前提とした Early Binding を選択して、IntelliSenseの恩恵と型安全性を確保する。
3. Error Trapping: Windows APIレベルの致命的なエラーを想定し、エラー発生時でも必ずクリーンアップ処理(オブジェクト解放)へジャンプする構造を持たせる。

2. 実装:リビジョン同期エンジンのコアロジック

以下に、Excelの変更通知書からデータを読み取り、SolidWorksの図面シート上にあるリビジョンテーブルへ、重複を避けつつ行を追加する実装例を示す。

実装上の重要ポイント

  • 重複チェック: すでに同じリビジョン番号が存在する場合、二重に書き込まないロジックを組み込む。
  • テーブルの特定: 図面内の `RevisionTable` オブジェクトを、シート上の `TableAnnotation` から特定する。
  • メモリ最適化: `Excel.Application` を明示的に制御する。
' ======================================================================================
' Module: RevisionSyncEngine
' Description: Excel Change Notice to SolidWorks Revision Table Synchronizer
' Author: Chief Architect
' ======================================================================================

Option Explicit

' Windows API: ファイル選択ダイアログを利用するための宣言
' (VBA標準のGetOpenFilenameでも可能だが、より高度な制御を行う場合に備える)
Private Declare PtrSafe Function MsgBox Lib "user32" Alias "MessageBoxA" ( _
    ByVal hwnd As LongPtr, ByVal lpText As String, _
    ByVal lpCaption As String, ByVal uType As Long) As Long

Sub SynchronizeRevisionTable()
    ' --- SolidWorks API Variables ---
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swSheet As SldWorks.Sheet
    Dim swTable As SldWorks.TableAnnotation
    Dim swRevTable As SldWorks.RevisionTableAnnotation
    
    ' --- Excel API Variables ---
    Dim xlApp As Excel.Application
    Dim xlWB As Excel.Workbook
    Dim xlSheet As Excel.Worksheet
    Dim lastRow As Long, i As Long
    
    ' --- Data Variables ---
    Dim targetRev As String
    Dim targetDate As String
    Dim targetDesc As String
    Dim targetAuth As String
    Dim isDuplicate As Boolean
    Dim rowCount As Long, colCount As Long
    Dim targetRow As Long
    
    ' --- Error Handling ---
    On Error GoTo ErrorHandler

    ' 1. SolidWorksへの接続
    Set swApp = Application.SldWorks
    If swApp Is Nothing Then
        MsgBox "SolidWorksが起動していません。", vbCritical
        Exit Sub
    End If

    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Or swModel.GetType <> swDocDRAWING Then
        MsgBox "図面ファイルを開いた状態で実行してください。", vbExclamation
        Exit Sub
    End If
    Set swDraw = swModel

    ' 2. Excelファイルの選択とオープン
    ' 本来はWindows APIを用いてファイル選択を行うのが理想的
    Dim excelPath As Variant
    excelPath = Application.GetOpenFilename("Excel Files (*.xlsx), *.xlsx", , "変更通知書を選択してください")
    If excelPath = False Then Exit Sub

    Set xlApp = New Excel.Application
    xlApp.Visible = False ' バックグラウンドで実行
    Set xlWB = xlApp.Workbooks.Open(excelPath, ReadOnly:=True)
    Set xlSheet = xlWB.Sheets(1) ' 最初のシートを対象とする

    ' 3. SolidWorks 図面内のリビジョンテーブルの取得
    ' 図面シート上の最初のテーブルを探索
    Set swSheet = swDraw.GetCurrentSheet
    ' 注: 実際にはシート内のすべてのAnnotationを走査し、RevisionTableを特定するロジックが堅牢
    Set swTable = swDraw.GetFirstTableAnnotation
    
    Do While Not swTable Is Nothing
        If swTable.Type = swTableAnnotation_RevisionTable Then
            Set swRevTable = swTable.GetRevisionTableAnnotation
            Exit Do
        End If
        Set swTable = swTable.GetNext brother ' 実際にはNextを使用
        ' ※注: APIの仕様に基づき、正しいループ処理を実装すること
    Loop

    If swRevTable Is Nothing Then
        MsgBox "図面にリビジョンテーブルが見つかりません。", vbCritical
        GoTo CleanUp
    End If

    ' 4. 同期処理 (Excelから読み込み、SWへ書き込み)
    lastRow = xlSheet.Cells(xlSheet.Rows.Count, 1).End(xlUp).Row
    
    ' テーブルの列数を確認 (Revision, Date, Description, Author 等)
    colCount = swRevTable.ColumnCount

    ' Excelの2行目から最終行までループ
    For i = 2 To lastRow
        targetRev = CStr(xlSheet.Cells(i, 1).Value)  ' A列: 版数
        targetDate = CStr(xlSheet.Cells(i, 2).Value) ' B列: 改訂日
        targetDesc = CStr(xlSheet.Cells(i, 3).Value) ' C列: 内容
        targetAuth = CStr(xlSheet.Cells(i, 4).Value) ' D列: 承認者

        ' --- 重複チェック ---
        isDuplicate = False
        rowCount = swRevTable.RowCount
        For targetRow = 0 To rowCount - 1
            If swRevTable.Text(targetRow, 0) = targetRev Then
                isDuplicate = True
                Exit For
            End If
        Next targetRow

        ' --- 書き込み実行 ---
        If Not isDuplicate Then
            ' 新しい行を末尾に追加
            swRevTable.InsertRow
            ' 追加された行のインデックスは、以前のRowCountと同じになる
            ' 列インデックスは0から始まる
            swRevTable.Text(rowCount, 0) = targetRev
            swRevTable.Text(rowCount, 1) = targetDate
            swRevTable.Text(rowCount, 2) = targetDesc
            swRevTable.Text(rowCount, 3) = targetAuth
        End If
    Next i

    MsgBox "リビジョンの同期が完了しました。", vbInformation

CleanUp:
    ' 5. メモリの明示的解放 (極めて重要)
    On Error Resume Next
    If Not xlWB Is Nothing Then xlWB.Close SaveChanges:=False
    If Not xlApp Is Nothing Then xlApp.Quit
    
    Set xlSheet = Nothing
    Set xlWB = Nothing
    Set xlApp = Nothing
    
    Set swRevTable = Nothing
    Set swTable = Nothing
    Set swSheet = Nothing
    Set swDraw = Nothing
    Set swModel = Nothing
    Set swApp = Nothing
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
    Resume CleanUp
End Sub

3. プロフェッショナルが意識すべき「極限の知見」

A. テーブル探索の堅牢性

上記のコードでは簡略化しているが、実務環境では「リビジョンテーブルがどのビューにあるか」あるいは「シートに直接配置されているか」を厳密に判定しなければならない。`swDraw.GetFirstTableAnnotation` を使用して、全 `TableAnnotation` を走査し、その `Type` プロパティが `swTableAnnotation_RevisionTable` であることを確認するループは、設計変更時のエラーを未然に防ぐ生命線となる。

B. データ型の厳密なハンドリング

Excelから読み込む際、日付型 (`Date`) が文字列として正しくフォーマットされていないと、SolidWorks上のテーブルで意図しない形式(例:`45231` のようなシリアル値)で表示される。`Format(xlSheet.Cells(i, 2).Value, “yyyy/mm/dd”)` のように、明示的な書式指定を行うことが、システム間連携の作法である。

C. トランザクション思考

大量のデータを同期する場合、途中でエラーが発生すると「半分だけ更新された」という中途半端な状態(Partial Update)に陥る。実務レベルのシステムでは、同期開始前に現在のテーブル状態をバックアップ(一時的なコピー)するか、エラー発生時にロールバック(元の状態に戻す)できる仕組みを検討すべきである。

結論

VBAによる自動化の真価は、単に「ボタン一つで動く」ことではない。「どんなに過酷な運用環境においても、データの整合性を崩さない」という信頼性にこそある。

オブジェクトの解放、エラーハンドリング、そしてデータ型の整合性。これら一つひとつの「重み」を理解し、実装に落とし込める者だけが、真のエンジニアリング・オートメーションを掌握することができる。

次に君がコードを書くとき、そのオブジェクトのライフサイクルを、君の呼吸と同じくらい意識していることを願う。

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