データ整合性の守護神:AutoCAD VBAによる「属性バリデーション」の実装戦略
エンジニアとして、あるいは自動化ツールの開発者として、君たちは一度でも「不完全なデータ」によって、後続のERP連携や自動帳票出力が炎上する地獄を見たことがあるだろうか?
図面の中に、本来あるべき「図番」や「設計者名」が空欄のまま放置されている。そんな図面が、チェックされることなくサーバーに保存されていく。これは単なる「入力漏れ」ではない。プロセスの設計ミスであり、自動化における致命的な脆弱性だ。
「後で人間が確認すればいい」という甘い考えは捨てろ。自動化の真髄は、「不正な状態では、次の工程へ進ませない」というガードレールを設計することにある。
本稿では、AutoCAD VBAを用い、図面保存時に特定のブロック属性をスキャンし、必須項目が欠落していれば保存を強制的に中断する、極めて堅牢なバリデーション・エンジンの実装方法を伝授する。
1. なぜ「保存後のチェック」では遅すぎるのか
多くの初級者は、保存されたファイルに対して後からバッチ処理でチェックをかける手法を提案する。しかし、これは設計思想として間違っている。
- 修正コストの増大: 保存された後にエラーが判明すると、図面作成者は「どのファイルが、いつ、なぜダメだったのか」を遡る必要がある。
- データの汚染: 不完全なデータが一度データベースや管理サーバーに流れると、その影響範囲は予測不能になる。
我々が目指すべきは、「正しいデータしか、ファイルとして存在を許さない」という、Fail-fast(早期失敗)の原則に基づいた設計だ。
2. アーキテクチャの設計:インターセプト戦略
AutoCAD VBAには、標準の「保存(SAVE)」コマンドそのものを直接フックして動作を差し替える、C# (.NET) のような高度なイベントハンドラは存在しない。
したがって、実務的なアプローチとしては以下の「ラップ(包囲)戦略」を採用する。
1. 標準の `SAVE` コマンドを禁止または推奨しない。
2. 検証ロジックを内包したカスタム `SafeSave` マクロを、業務標準の保存手段として配布する。
このとき、バリデーションエンジンは以下の3つのステップで動く。
1. Target Identification(対象特定): 図面内の「図枠ブロック」を特定する。
2. Attribute Inspection(属性検査): 特定されたブロック内の属性(Tag)を走査し、必須項目を検証する。
3. Decision Logic(判定): 全ての条件を満たした場合のみ、`Document.Save` を実行する。
3. プロダクション・コード:堅牢なバリデーションの実装
以下に、実務に耐えうる設計思想に基づいたコードを示す。単なるループ処理ではない。エラーハンドリングと、パフォーマンスを考慮した設計を施している。
Option Explicit
' ==============================================================================
' 業務標準:図面保存バリデーション・モジュール
' ------------------------------------------------------------------------------
' 概要: 図枠ブロック内の必須属性(図番、設計者名)を検証し、
' 不備がある場合は保存を中断する。
' ==============================================================================
' 必須属性の定義(Tag名を定数化することで保守性を高める)
Private Const TAG_DRAWING_NO As String = "DRAWING_NO"
Private Const TAG_DESIGNER As String = "DESIGNER_NAME"
Private Const BLOCK_NAME As String = "TITLE_BLOCK" ' 図枠ブロックの名前
''' <summary>
''' 業務標準の保存プロセス。
''' ユーザーはこのマクロを通じてのみ保存を行う。
''' </summary>
Public Sub SafeSave()
Dim acadDoc As AcadDocument
Set acadDoc = ThisDrawing
On Error GoTo ErrorHandler
' 1. バリデーションの実行
Dim validationResult As Variant
validationResult = ValidateTitleBlockAttributes(acadDoc)
' 2. 結果判定
If IsArray(validationResult) Then
' エラーが発生した場合(配列でエラーメッセージが返ってくる)
Dim msg As String
msg = "【保存中断】図面に不備があります。以下の項目を入力してください:" & vbCrLf & vbCrLf & _
Join(validationResult, vbCrLf)
MsgBox msg, vbCritical, "データ品質管理エラー"
Exit Sub
End If
' 3. 全てのチェックを通過した場合のみ保存を実行
acadDoc.Save
MsgBox "保存が正常に完了しました。", vbInformation, "Success"
Exit Sub
ErrorHandler:
MsgBox "予期せぬエラーが発生しました: " & Err.Description, vbExclamation, "Error"
End Sub
''' <summary>
''' 図枠ブロック内の属性をスキャンし、必須項目の空欄をチェックする。
''' </summary>
''' <returns>エラーがない場合は Empty、エラーがある場合はエラーメッセージの配列を返す</returns>
Private Function ValidateTitleBlockAttributes(ByRef doc As AcadDocument) As Variant
Dim objEntity As AcadEntity
Dim objBlockRef As AcadBlockReference
Dim varAttributes As Variant
Dim i As Integer
Dim errorList As Collection
Set errorList = New Collection
Dim foundTitleBlock As Boolean
foundTitleBlock = False
' ModelSpace内の全エンティティを走査
' ※大規模図面の場合は、SelectionSetsを使用してフィルタリングするのが定石
For Each objEntity In doc.ModelSpace
' ブロック参照かどうかを判定
If TypeOf objEntity Is AcadBlockReference Then
Set objBlockRef = objEntity
' 指定した図枠ブロック名と一致するか確認
If UCase(objBlockRef.Name) = UCase(BLOCK_NAME) Then
foundTitleBlock = True
' 属性が存在するか確認
If objBlockRef.HasAttributes Then
varAttributes = objBlockRef.GetAttributes
' 属性の走査
For i = LBound(varAttributes) To UBound(varAttributes)
Dim attrRef As AcadAttributeReference
Set attrRef = varAttributes(i)
' 必須項目のチェック
If IsRequiredTagMissing(attrRef.TagString, attrRef.TextString) Then
errorList.Add "- " & attrRef.TagString & " が未入力です。"
End If
Next i
Else
errorList.Add "- 図枠ブロックに属性が定義されていません。"
End If
End If
End If
Next objEntity
' 図枠自体が見つからない場合もエラーとする(設計ミス防止)
If Not foundTitleBlock Then
errorList.Add "- 図枠ブロック (" & BLOCK_NAME & ") が図面内に見つかりません。"
End If
' 結果の集約
If errorList.Count > 0 Then
' Collectionを配列に変換して返す
Dim arrErrors() As String
ReDim arrErrors(errorList.Count - 1)
Dim j As Integer
For j = 1 To errorList.Count
arrErrors(j - 1) = errorList(j)
Next j
ValidateTitleBlockAttributes = arrErrors
Else
ValidateTitleBlockAttributes = Empty
End If
End Function
''' <summary>
''' 特定のタグが必須であり、かつ値が空かどうかを判定する
''' </summary>
Private Function IsRequiredTagMissing(ByVal tag As String, ByVal val As String) As Boolean
' 判定ロジックをここに集約。将来的な拡張(例:特定の文字数以上など)も容易。
Select Case UCase(tag)
Case UCase(TAG_DRAWING_NO), UCase(TAG_DESIGNER)
' 文字列が空、またはスペースのみの場合にTrueを返す
If Trim(val) = "" Then
IsRequiredTagMissing = True
Else
IsRequiredTagMissing = False
End If
Case Else
IsRequiredTagMissing = False
End Select
End Function
4. アーキテクトの視点:実務における「落とし穴」と対策
このコードをそのまま現場に投入する前に、以下の3点を考慮に入れろ。これができるかどうかが、単なるプログラマーとエンジニアの境界線だ。
① パフォーマンスの重み(Complexity O(n))
上記のコードでは `For Each objEntity In doc.ModelSpace` を使用している。数万個のオブジェクトを持つ巨大な図面では、この走査は無視できないコストになる。
対策:
プロフェッショナルな実装では、`SelectionSets` を使い、`FilterType` で `ACAD_BLOCK_REFERENCE` かつ `BLOCK_NAME` を条件に指定して、最初から対象のブロックだけを抽出せよ。これにより、走査時間は劇的に短縮される。
② 属性の「幽霊」問題(Ghost Attributes)
ユーザーが属性を一度入力した後、それを消去したとしても、`TextString` は空文字 `””` になるだけで、属性オブジェクト自体は残り続ける。
対策:
必ず `Trim()` 関数を使用し、半角スペースや全角スペースのみの入力を「未入力」として扱うロジックを組み込め(上記のコードでは実装済みだ)。
③ 階層化されたブロック(Nested Blocks)
図枠が別のブロックの中にネストされている場合、`ModelSpace` を走査するだけでは到達できない。
対策:
より厳格なバリデーションが必要なプロジェクトでは、再帰関数(Recursive Function)を用いて、ブロック定義内のブロック(Block Definition)を探索するロジックが必要になる。これは実装の複雑度を上げるが、データ品質への信頼性は飛躍的に高まる。
結論
自動化ツールとは、人間の作業を「楽にする」ためのものではない。人間のミスを「防ぎ」、業務の「品質を担保する」ためのものである。
今回紹介したバリデーション・エンジンは、一見すると「ユーザーの手間を増やす、厳しい仕組み」に見えるだろう。しかし、システム全体を見渡せば、これこそが最も効率的で、最も低コストな設計であることが理解できるはずだ。
「正しいデータしか通さない。それが、真の自動化エンジニアの責務である。」
