「ただ保存するだけ」から卒業しよう。図面品質を自動で守る、属性バリデーションの実装術
こんにちは。現場の自動化を支えるアーキテクトとして、日々コードと向き合っているエンジニアです。
AutoCAD VBAを学び始め、マクロの記録から一歩踏み出し、「自分でコードを書き始めた」という皆さん。素晴らしい一歩です。マクロの記録は「操作の記録」であって、「思考の記録」ではありません。ここから先は、「AutoCADのオブジェクトがどう動き、どう管理されるべきか」という設計思想の領域に入ります。
今日、皆さんに伝授したいテーマは、実務において極めて重要な「データの品質管理(バリデーション)」です。
なぜ「保存」にロジックが必要なのか?
現場を想像してみてください。
プロジェクトが数百、数千枚という図面規模になったとき、もし「図番」や「設計者名」が空欄の図面が紛れ込んでいたらどうなるでしょうか?
- 図面管理システムへの登録エラー
- 検索時、必要な図面が見つからない
- 誤った図面を最新版だと誤認する
これらはすべて、エンジニアの「うっかり」から生まれる、防げるはずのミスです。
これを個人の注意に頼るのではなく、「ルールに反している図面は、保存させない」というシステム的なガードレール(バリデーション機能)を構築するのが、プロの自動化エンジニアの仕事です。
1. 設計図:バリデーションの仕組み
今回実装するのは、「保存ボタン(あるいはマクロ)を押した際、図枠ブロックの中身をスキャンし、必須項目が埋まっているかチェックする」という仕組みです。
論理的なフローは以下の通りです。
1. ターゲットの特定: 図面内から「図枠(タイトルブロック)」のブロックを探す。
2. 属性の走査: そのブロックに紐付いている「属性(Attribute)」を一つずつ確認する。
3. 条件判定: 「図番」や「設計者」というタグ(Tag)を探し、その値(TextString)が空でないかを判定する。
4. 実行の分岐:
- すべてOK $\to$ 図面を保存する。
- 不備あり $\to$ 警告を表示し、保存を中断する。
ここがプロの視点:オブジェクトの階層構造
初心者が陥りやすいのが、「ブロックを探す」ことと「属性を探す」ことを混同することです。
AutoCADのオブジェクトモデルでは、BlockReference(図面上に置かれたブロックの実体)の中に、AttributeReference(属性値の定義)がぶら下がっています。この「親子関係」を意識することが、美しいコードを書く鍵となります。
2. 実装コード:スマート・セーブ・バリデーター
それでは、実際に使えるコードを見ていきましょう。このコードは、標準モジュールに貼り付けて使用してください。
Option Explicit
' =====================================================================
' 目的: 図面保存時の必須属性チェック機能
' 実装内容: 特定のブロック内の属性が空欄の場合、保存を中断する
' =====================================================================
Sub SmartSaveWithValidation()
Dim acadDoc As AcadDocument
Set acadDoc = ThisDrawing
' --- 設定エリア: ここをプロジェクトに合わせて変更してください ---
Const TARGET_BLOCK_NAME As String = "TITLE_BLOCK" ' 図枠ブロックの名前
Const REQ_TAG_1 As String = "DWG_NO" ' 必須属性1のタグ名
Const REQ_TAG_2 As String = "DESIGNER" ' 必須属性2のタグ名
' ------------------------------------------------------------
Dim isAllValid As Boolean
Dim errorMsg As String
' 1. バリデーション実行
isAllValid = CheckTitleBlockAttributes(acadDoc, TARGET_BLOCK_NAME, REQ_TAG_1, REQ_TAG_2, errorMsg)
' 2. 結果に基づく処理
If isAllValid Then
' 全てのチェックをパスした場合、保存を実行
On Error Resume Next
acadDoc.Save
If Err.Number <> 0 Then
MsgBox "保存中にエラーが発生しました: " & Err.Description, vbCritical, "保存失敗"
Else
MsgBox "図面を正常に保存しました。", vbInformation, "完了"
End If
On Error GoTo 0
Else
' 不備があった場合、警告を表示して中断
MsgBox "【保存中断】以下の項目を入力してください:" & vbCrLf & vbCrLf & errorMsg, _
vbExclamation, "入力漏れあり"
End If
End Sub
' ---------------------------------------------------------------------
' 関数: CheckTitleBlockAttributes
' 引数: ドキュメント, ブロック名, 必須タグ1, 必須タグ2, エラー内容(出力用)
' 戻り値: 全て入力されていればTrue
' ---------------------------------------------------------------------
Private Function CheckTitleBlockAttributes(ByRef doc As AcadDocument, _
ByVal blockName As String, _
ByVal tag1 As String, _
ByVal tag2 As String, _
ByRef outErrorMsg As String) As Boolean
Dim ent As AcadEntity
Dim blockRef As AcadBlockReference
Dim attrRef As AcadAttributeReference
Dim foundBlock As Boolean
Dim missingTags As String
Dim foundTag1 As Boolean, foundTag2 As Boolean
Dim val1 As String, val2 As String
foundBlock = False
missingTags = ""
foundTag1 = False
foundTag2 = False
' モデル空間とペーパー空間の両方を走査(図枠は通常ペーパー空間にある)
Dim layouts As Variant
layouts = Array(doc.ModelSpace, doc.PaperSpace)
Dim i As Integer
For i = LBound(layouts) To UBound(layouts)
For Each ent In layouts(i)
' ブロック参照かどうかを判定
If TypeOf ent Is AcadBlockReference Then
Set blockRef = ent
' 指定した名前のブロックかチェック
If UCase(blockRef.Name) = UCase(blockName) Then
foundBlock = True
' ブロック内の属性をループで確認
For Each attrRef In blockRef.GetAttributes
Select Case UCase(attrRef.TagString)
Case UCase(tag1)
val1 = Trim(attrRef.TextString)
If val1 <> "" Then foundTag1 = True
Case UCase(tag2)
val2 = Trim(attrRef.TextString)
If val2 <> "" Then foundTag2 = True
End Select
Next attrRef
' 図枠が見つかったら、これ以上他の図枠を探す必要はない(通常1枚のため)
Exit For
End If
End If
Next ent
If foundBlock Then Exit For
Next i
' --- 結果判定ロジック ---
If Not foundBlock Then
outErrorMsg = "指定された図枠ブロック (" & blockName & ") が見つかりません。"
CheckTitleBlockAttributes = False
Exit Function
End If
' 必須項目のチェック
If Not foundTag1 Then missingTags = missingTags & "・" & tag1 & vbCrLf
If Not foundTag2 Then missingTags = missingTags & "・" & tag2 & vbCrLf
If missingTags <> "" Then
outErrorMsg = missingTags
CheckTitleBlockAttributes = False
Else
CheckTitleBlockAttributes = True
End If
End Function
3. プロの解説:コードの「急所」を読み解く
このコードには、実務で使うための「知恵」がいくつか詰め込まれています。
① `UCase` による大文字小文字の寛容さ
プログラミングの世界では `”DWG_NO”` と `”dwg_no”` は別物として扱われます。しかし、図面作成者がタグ名をどう入力するかは予測できません。`UCase()` 関数を使い、比較の際にすべて大文字に変換することで、「表記ゆれによる誤判定」を防いでいます。これは堅牢なシステムを作るための鉄則です。
② `Trim` 関数による「見えない空白」の排除
属性の中に、スペース(空白)だけが入っている場合、見た目は空欄に見えますが、プログラム上は「文字が入っている」と判定されてしまいます。`Trim()` を使って前後の空白を除去することで、「スペースだけ入力して済ませる」という手抜きを確実に検知できます。
③ モデル空間とペーパー空間の両方を見る
図枠は通常「レイアウト(ペーパー空間)」に配置されますが、設計者によっては「モデル空間」に直接配置することもあります。`Array(doc.ModelSpace, doc.PaperSpace)` を使って両方の空間を走査することで、「どこに図枠があっても見逃さない」という網羅性を確保しています。
④ エラーハンドリングの重要性
`On Error Resume Next` を使う際は、必ずその直後に「何のためにエラーを無視しているのか」を明確にします。今回は、`Save` メソッドが失敗した場合(例:ファイルが読み取り専用、ネットワーク切断など)に備えて、エラーを捕捉してユーザーに通知する構成にしています。
4. 陥りやすいエラーと回避策
この機能を実装する際に、初心者が躓きやすいポイントをまとめておきます。
- 「ブロックが見つかりません」エラー:
ブロック名が正確か確認してください。また、ブロックが「動的ブロック」の場合、`blockRef.Name` ではなく `blockRef.EffectiveName` を使う必要があります(動的ブロックは内部的に名前が変わるためです)。
- 「属性が見つかりません」エラー:
属性(Attribute)ではなく、単なる文字(Text)として図枠を作っていませんか? 属性として定義されていないと、`GetAttributes` メソッドでは取得できません。
- パフォーマンスの低下:
数万個のオブジェクトがある図面で、毎回全オブジェクトをループするのは重くなります。実務では、あらかじめ図枠のレイヤーを分けておき、そのレイヤーのオブジェクトだけをスキャンするように最適化すると、さらにプロフェッショナルなコードになります。
最後に:ここをクリアすれば、AutoCAD VBAの基本はバッチリですよ
今回のコードは、単なる「保存の自動化」ではありません。「データという資産を守るためのルール」をプログラムに落とし込んだものです。
「動けばいい」というフェーズから、「ミスが起きない仕組みを作る」というフェーズへ。
この視点を持てるようになれば、あなたはもう単なる「マクロ使い」ではなく、「業務プロセスを設計するエンジニア」です。
さあ、まずは自分のプロジェクトの図枠に合わせて、定数(`TARGET_BLOCK_NAME` など)を書き換えて動かしてみてください。その一歩が、あなたのエンジニアとしての価値を大きく変えるはずです。
応援していますよ!
