図面データの「真実」を同期せよ:Excel変更通知書とSolidWorksリビジョンテーブルの完全同期アーキテクチャ
設計変更(ECN/ECR)のプロセスにおいて、最も発生しやすいヒューマンエラーは何か? それは「Excel上の変更指示書」と「図面上のリビジョン履歴」の不一致だ。
リビジョン番号の打ち間違い、日付のフォーマットミス、承認者の転記漏れ。これらは単なる事務的ミスではない。設計意図が正しく伝わらないという、製造工程における致命的なリスクを孕んでいる。
多くの初級者が書くマクロは、「Excelから値を読み取り、テーブルの末尾に `InsertRow` する」という単純な「追記型」だ。しかし、実務で求められるのは「同期(Synchronization)」である。変更があったものは更新し、新しいものは追加し、整合性を担保する。
本稿では、単なる自動化を超えた、「Single Source of Truth(信頼できる唯一の情報源)」を構築するための、堅牢な同期アルゴリズムとその実装手法を伝授する。
1. 設計思想:なぜ「追記型」ではいけないのか
プロフェッショナルな自動化エンジニアが真っ先に考えるのは、コードを書くことではなく、データのライフサイクルだ。
追記型マクロの限界
従来の「末尾に追加するだけ」のマクロには、以下の脆弱性がある。
1. 重複の発生: マクロを二回実行すると、同じリビジョンが二行できてしまう。
2. 修正への無力さ: Excel側で日付が修正されても、図面側は古いまま残る。
3. 整合性の欠如: どの行がどの変更に対応しているのか、ロジックで判別できない。
採用すべき「同期型」アーキテクチャ
我々が実装すべきは、「Key(リビジョン番号)による照合ロジック」だ。
1. Excelをマスター(Master)、SolidWorksをスレーブ(Slave)と定義する。
2. リビジョン番号を「ユニークキー」として扱う。
3. 図面テーブルの各行を走査し、キーがExcelに存在すれば「Update」、存在しなければ「Append」を実行する。
この設計により、マクロの実行回数に依存しない「冪等性(Idempotency)」が確保される。
2. 実装における技術的急所
実装に入る前に、SolidWorks API特有の挙動と、パフォーマンスへの配慮について触れておく。
オブジェクトのライフサイクル
`RevisionTableAnnotation` オブジェクトへのアクセスは、図面シート内のビューを介して行われる。図面内に複数のシートがある場合、どのシートの、どのビューのリビジョンテーブルを対象にするのかを明確に定義しなければならない。
パフォーマンスの最適化
Excelのセルを一つずつループしてSolidWorksのテーブルを探すような $O(n^2)$ のアルゴリズムは、設計者が大量の図面を処理する際に致命的な遅延を招く。
Excelのデータを、あらかじめ `Scripting.Dictionary` に格納し、メモリ上で高速に検索できるように設計するのが定石だ。
3. プロダクション・コード:リビジョン同期エンジン
以下に、実務に耐えうる堅牢なコードを示す。このコードは、Excelの変更通知書からデータを読み込み、SolidWorks図面内のリビジョンテーブルを「完全同期」させる。
前提条件:
- Excelのシート構成:A列=リビジョン, B列=改訂日, C列=承認者
- SolidWorksのリビジョンテーブル:1列目=リビジョン, 2列目=日付, 3列目=承認者
' ==============================================================================
' Module: RevisionSyncEngine
' Description: Excelの変更通知書に基づき、SolidWorks図面のリビジョンテーブルを
' 完全同期させる。
' Author: Chief Architect
' ==============================================================================
Option Explicit
' 外部参照: Microsoft Scripting Runtime (Dictionary用)
' 外部参照: Microsoft Excel Object Library
Sub SyncRevisionTableFromExcel()
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 swTableAnn As SldWorks.RevisionTableAnnotation
Dim xlApp As Excel.Application
Dim xlWB As Excel.Workbook
Dim xlSheet As Excel.Worksheet
Dim dict As Scripting.Dictionary
Dim targetExcelPath As String
Dim revKey As String
Dim i As Long, rowIdx As Long
Dim lastRow As Long
' --- 1. 環境設定 ---
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
' 図面ファイルが開かれているかチェック
If swModel Is Nothing Then GoTo ErrorHandler
If swModel.GetType <> swDocDRAWING Then
MsgBox "図面ファイルを開いた状態で実行してください。", vbCritical
Exit Sub
End If
Set swDraw = swModel
' Excelファイルのパス(実務ではダイアログで選択させるのがベスト)
targetExcelPath = "C:\DesignData\ChangeNotice.xlsx"
' --- 2. Excelデータのメモリロード (Dictionary化) ---
' Dictionaryを使用することで、検索コストを O(1) に抑える
Set dict = New Scripting.Dictionary
On Error Resume Next
Set xlApp = GetObject(, "Excel.Application")
If xlApp Is Nothing Then
Set xlApp = New Excel.Application
End If
On Error GoTo ErrorHandler
Set xlWB = xlApp.Workbooks.Open(targetExcelPath, ReadOnly:=True)
Set xlSheet = xlWB.Sheets(1) ' 1番目のシートを対象
lastRow = xlSheet.Cells(xlSheet.Rows.Count, 1).End(xlUp).Row
' ExcelデータをDictionaryに格納 [Key: Revision, Value: Array(Date, Approver)]
For i = 2 To lastRow ' 1行目はヘッダーと想定
revKey = Trim(CStr(xlSheet.Cells(i, 1).Value))
If revKey <> "" Then
' 配列として日付と承認者を保持
dict.Add revKey, Array(xlSheet.Cells(i, 2).Value, xlSheet.Cells(i, 3).Value)
End If
Next i
xlWB.Close SaveChanges:=False
' xlApp.Quit ' 必要に応じて
' --- 3. SolidWorksリビジョンテーブルの取得 ---
' アクティブシートの最初のビューからリビジョンテーブルを探す
Set swView = swDraw.GetFirstView ' Sheet自体が最初のView
Set swView = swView.GetNextView ' Sheet上の最初の図面ビューへ
If swView Is Nothing Then
MsgBox "図面内にビューが見つかりません。", vbExclamation
GoTo ErrorHandler
End If
' リビジョンテーブルの取得(存在しない場合はエラーになるため注意)
Set swTableAnn = swView.GetFirstRevisionTableAnnotation
If swTableAnn Is Nothing Then
MsgBox "リビジョンテーブルが見つかりません。先にテーブルを作成してください。", vbExclamation
GoTo ErrorHandler
End If
' --- 4. 同期ロジック (Sync Engine) ---
' A. 既存行の更新 (Update)
Dim tableRowCount As Long
tableRowCount = swTableAnn.RowCount
' テーブルのヘッダーを除いたデータ行を走査
' Note: Row 0 はヘッダー。Row 1 からがデータ。
For i = 1 To tableRowCount - 1
revKey = Trim(CStr(swTableAnn.Text(i, 0))) ' 0列目がリビジョン番号
If dict.Exists(revKey) Then
' Excel側にデータが存在する場合、値を更新
swTableAnn.Text(i, 1) = Format(dict(revKey)(0), "yyyy-mm-dd") ' 1列目: 日付
swTableAnn.Text(i, 2) = dict(revKey)(1) ' 2列目: 承認者
' 処理済みとしてDictionaryから削除(残ったものが「新規」となる)
dict.Remove revKey
End If
Next i
' B. 新規行の追加 (Append)
' Dictionaryに残っているものは、図面側に存在しない新しいリビジョン
Dim keys As Variant
keys = dict.keys
For i = 0 To dict.Count - 1
revKey = keys(i)
' 行を追加して書き込み
swTableAnn.InsertRow swTableAnn.RowCount
Dim newRow As Long
newRow = swTableAnn.RowCount - 1
swTableAnn.Text(newRow, 0) = revKey
swTableAnn.Text(newRow, 1) = Format(dict(revKey)(0), "yyyy-mm-dd")
swTableAnn.Text(newRow, 2) = dict(revKey)(1)
Next i
MsgBox "リビジョン同期が完了しました。", vbInformation
CleanUp:
Set dict = Nothing
Set xlWB = Nothing
Set xlApp = Nothing
Exit Sub
ErrorHandler:
MsgBox "エラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
4. プロフェッショナルのための解説:なぜこのコードは「強い」のか
① 冪等性(Idempotency)の確保
このコードの核心は、`dict.Remove revKey` の部分にある。
既存の行を更新するたびに、Dictionaryからそのキーを消していく。最後にDictionaryに残っている要素だけを「新規行」として追加する。これにより、「何度実行しても、最終的な図面の状態はExcelと一致する」という数学的な保証が得られる。
② 検索アルゴリズムの最適化
`swTableAnn.Text(i, 0)` を取得し、それを `dict.Exists` で判定する。これは、テーブルの行数 $N$、Excelの行数 $M$ に対して、最悪でも $O(N+M)$ の計算量で済む。二重ループ($O(N \times M)$)を避けることは、大規模な図面管理において必須のスキルだ。
③ 型の安全性とフォーマット制御
`Format(…, “yyyy-mm-dd”)` を明示的に使用している。Excelのシリアル値(日付)が、SolidWorksのテキストセルに書き込まれる際、意図しない数値(例: 45231)に化けるのを防ぐためだ。これは実務における「地味だが最も重要な」防御策である。
5. 結論:自動化エンジニアの責務
自動化とは、単に「作業を楽にする」ことではない。「人間が介在することで発生する不確実性を排除する」ことだ。
今回示した同期型アーキテクチャは、設計変更という動的なプロセスに対し、静的な図面データを強固に結びつける。このレベルの設計思想を持ってコードを書くか、単なる「操作の記録」を書くか。その差が、システムとしての信頼性を決定づける。
現場に投入するコードを書くときは、常に自分に問いかけてほしい。
「このマクロを、間違った手順で二回実行したらどうなるか?」
その答えが「問題ない」と言える設計こそが、真のプロフェッショナルによる仕事である。
