CATIA

図面の注記を一括で直す——CATIAマクロでテキストを拾って置換する

2026.09.11 / 読了目安 8分 / 執筆: Qronix 開発チーム

#CATIA#自働化思想#CATIAマクロ#CAD自働化

規格番号が改訂された、材質の呼び方が社内で統一された、表面処理の指示が変わった。そのたびに図面を開き、シートを切り替え、ビューの中の注記を目で探して打ち直す。数枚なら手で済みますが、数十枚になると話が変わります。この記事では、CATIAの図面から注記テキストを拾って一覧にし、確認した行だけを一括で置換するマクロを、事故を起こさない順番で組み立てます。

チェックリストPhoto: Unsplash
CONTENTS
1. 注記を直す時間は、ほとんどが「探す時間」 2. CATIAの図面で、注記はどこに入っているのか 3. いきなり置換しない——「一覧→確認→置換」に分ける 4. 一覧を作るマクロ——図面は1文字も変えない 5. 置換するマクロ——前提が崩れていたら止まる 6. 現場に入れる前に決めておく3つのこと

注記を直す時間は、ほとんどが「探す時間」

注記の修正は、作業としては単純です。古い文字列を消して、新しい文字列を書く。それだけです。ところが数十枚の図面を相手にすると、1枚あたりの時間は想像より長くなります。

理由ははっきりしています。どのシートの、どのビューに、その文字が入っているかが分からないからです。図面を開いてシートを切り替え、拡大して目で追い、見つけたら直し、ほかに残っていないかをもう一度見る。注記の修正で時間を食っているのは、文字を打ち直すことではなく、どこにあるかを探すことです。

そして探す作業には、見落としが付いて回ります。1枚に同じ語が2か所あった、背景の図枠の中にも書いてあった、別のシートに同じ注記がコピーされていた。直し漏れは出図のあとで見つかることが多く、そのときの手戻りは修正そのものより重くなります。

逆に言えば、探す部分さえ機械に任せられれば、人は「直してよいか」の判断だけに集中できます。CATIAのマクロで最初に手を付ける価値があるのは、書き換えではなく、この探す部分です。

注記修正の時間のうち「探す・確かめる」が占める割合70%探す・確かめる時間打ち直す時間は残りの一部。探す部分を機械に任せると、判断だけが人に残ります。
図1: 数十枚の図面の注記を手で直すときの時間配分。※比率はイメージです。

CATIAの図面で、注記はどこに入っているのか

マクロで拾うには、まず置き場所を知る必要があります。CATIAの図面(CATDrawing)は、ドキュメントの下にシートがあり、シートの下にビューがあり、ビューの中に注記テキストが入っている、という入れ子の構造です。VBAからは DrawingDocument の Sheets、各シートの Views、各ビューの Texts とたどれば、1件ずつ文字列を取り出せます。

現場では「注記」「注釈」「テキスト」と呼び名がゆれますが、マクロから見るとどれも同じ DrawingText です。社内で呼び方がそろっていなくても、拾う側の書き方は1つで済みます。

注意したいのは、各シートにある背景ビューです。表題欄や図枠の文字は、たいていここに入っています。図番や改訂記号も同じ場所にあるので、本文の注記と同じ感覚で置換すると、表題欄まで書き換わります。

もう1つ、Texts を全部拾っても、図面の文字のすべてではありません。寸法値や公差は寸法側のオブジェクトに、表の中の文字は表側のオブジェクトに属しています。この記事のマクロが対象にするのは注記テキストだけです。表題欄と注記を自働化する位置付けは図面作成の自働化の記事で、3Dモデル側の注記は3D注記(PMI)の記事で扱っています。

いきなり置換しない——「一覧→確認→置換」に分ける

一括置換と聞くと、検索語と置換語を入れてボタンを押す形を想像しがちです。図面の注記でこれをやると、かなりの確率で事故が起きます。

よくあるのが部分一致です。「R5」を「R6」に直したつもりが「R50」まで「R60」になる。旧規格の番号を置換したら、同じ数字を含む部品番号まで変わっていた。文字列としては正しく一致しているので、マクロは何も間違えていません。間違えているのは、一致したものを全部直してよいと決めた手順のほうです。

そこで処理を3段に分けます。まず図面から注記をすべて読み出し、Excelの一覧に書き出す。この段階では図面を1文字も変えません。次に、人が一覧を見て、置換してよい行にだけ印を付ける。最後に、印の付いた行だけを図面に書き戻す。

置換そのものより、置換してよい行を人が選べる形にすることが、このマクロの本体です。一覧は Excel なので、並べ替えも絞り込みも普段どおりに使えます。何十枚分の注記でも、見るのは該当した行だけで済みます。

置換してよい行は人が選び、
前提が崩れていたらマクロが止まる。

注記を一覧にしてから置換する注記を一括で直したいアクティブな文書が図面?何もせずに終わるシート→ビュー→Textsを辿り読み出すExcelの一覧に書き出す図面は変えない背景ビュー・複数回の語に要確認を付ける人が一覧を見て採用欄に○を付ける同じ図面・注記が実在・文字列も不変?その行は置換せず理由を書いて止まる○の行だけを書き戻す人が目で確かめて保存いいえはいいいえはい
図2: 図面を変えずに一覧を作り、人が選んだ行だけを、前提を確かめてから書き戻す流れ。

一覧を作るマクロ——図面は1文字も変えない

1本目は、開いている図面から注記を読み出して、Excelのシートに並べるマクロです。Excel側から起動し、実行中のCATIAにつないで、アクティブな文書が図面でなければ何もせずに終わります。

検索語を入れると、その語を含む行にだけ「置換後(候補)」が出ます。背景ビューに入っている注記と、1つの注記に複数回出てくる語には、結果欄に「要確認」の目印を付けます。どちらも、機械的に置換すると事故になりやすい場所だからです。

一覧には図面のフルパスも書いておきます。2本目のマクロが、別の図面に書き戻してしまうのを防ぐためです。注記の文字列は先頭にアポストロフィを付けて書き込み、「001」のような数字だけの注記が数値に化けないようにしています。

この一覧は、置換をしない日にも使えます。古い規格番号がどの図面の何か所に残っているかを数えるだけでも、改訂の影響範囲を見積もる材料になります。

直し漏れ・直しすぎの発生(手作業を100とした場合)目で探して手で直す100枚数が増えるほど見落としが増える一覧で確認してから置換20該当箇所は機械が全件拾う
図3: 同じ枚数の図面を直したときの比較。※数値はイメージです。
VB参考実装例:図面の注記を全シートから一覧に書き出す(Excel VBA)
' 図面の注記テキストを、全シート・全ビューから Excel の一覧に書き出す。
'   この段階では図面を一切変更しない(読むだけ)。
'   検索語を入れた場合は、該当行にだけ「置換後(候補)」を出す。
Option Explicit

Public Sub ListDrawingTexts()
    Dim cat As Object, doc As Object
    On Error Resume Next
    Set cat = GetObject(, "CATIA.Application")
    If Not cat Is Nothing Then Set doc = cat.ActiveDocument
    On Error GoTo 0

    If doc Is Nothing Then
        MsgBox "CATIAで図面が開かれていないため、何もしません。", vbExclamation
        Exit Sub
    End If
    If TypeName(doc) <> "DrawingDocument" Then
        MsgBox "アクティブな文書が図面(CATDrawing)ではないため、何もしません。", vbExclamation
        Exit Sub
    End If

    Dim findText As String, replText As String
    findText = InputBox("置換したい文字列(空欄なら一覧だけ作ります)")
    If Len(findText) > 0 Then replText = InputBox("置換後の文字列")

    Dim ws As Worksheet
    Set ws = ThisWorkbook.Worksheets.Add
    ws.Range("A1:I1").Value = Array("シート", "ビュー", "番号", "現在のテキスト", _
                                    "置換後(候補)", "採用", "結果", "X", "Y")
    ws.Range("J1").Value = "対象図面"
    ws.Range("K1").Value = doc.FullName      ' 書き戻し時の取り違え防止

    Dim r As Long, s As Long, v As Long, t As Long, hits As Long
    Dim sh As Object, vw As Object, tx As Object, cur As String
    r = 2
    For s = 1 To doc.Sheets.Count
        Set sh = doc.Sheets.Item(s)
        For v = 1 To sh.Views.Count
            Set vw = sh.Views.Item(v)
            For t = 1 To vw.Texts.Count
                Set tx = vw.Texts.Item(t)
                cur = tx.Text
                ws.Cells(r, 1).Value = sh.Name
                ws.Cells(r, 2).Value = vw.Name
                ws.Cells(r, 3).Value = t
                ws.Cells(r, 4).Value = "'" & cur     ' 「001」などを数値に化けさせない
                ws.Cells(r, 8).Value = tx.x
                ws.Cells(r, 9).Value = tx.y

                If Len(findText) > 0 And InStr(1, cur, findText, vbBinaryCompare) > 0 Then
                    ws.Cells(r, 5).Value = "'" & Replace(cur, findText, replText)
                    hits = hits + 1
                    ' 通常、Views の2番目は背景ビュー(表題欄・図枠)。機械的に置換しない
                    If v = 2 Then ws.Cells(r, 7).Value = "要確認:背景ビュー"
                    ' 1つの注記に複数回出てくる語は、部分一致の事故が起きやすい
                    If (Len(cur) - Len(Replace(cur, findText, ""))) \ Len(findText) > 1 Then
                        ws.Cells(r, 7).Value = Trim$(ws.Cells(r, 7).Value & " 要確認:複数箇所")
                    End If
                End If
                r = r + 1
            Next t
        Next v
    Next s

    ws.Columns("A:I").AutoFit
    MsgBox (r - 2) & " 件の注記を書き出しました(該当 " & hits & " 件)。" & vbLf & _
           "図面は変更していません。置換してよい行の「採用」欄に ○ を付けてください。", vbInformation
End Sub

置換するマクロ——前提が崩れていたら止まる

2本目は、一覧の「採用」欄に○を付けた行だけを図面に書き戻すマクロです。大事なのは、書き戻す前に3つの前提を確かめることです。

1つ目は、一覧を作った図面と、いま開いている図面が同じであること。2つ目は、指定したシート・ビュー・番号の注記が実在すること。3つ目は、その注記の中身が、一覧を作ったときの文字列から変わっていないこと。一覧を作ったあとに誰かが注記を足したり消したりすると、番号がずれて別の注記を指すことがあるからです。

どれか1つでも崩れていたら、その行は置換しません。条件が合わない行は、黙って進めずに理由を書いて止まります。止まった行は結果欄に理由が残るので、人はその行だけを見直せば済みます。

トヨタ生産方式でいう自働化は、異常があれば機械が自ら止まる仕組みを指します(「自動化」と「自働化」の違い)。注記の置換も同じで、全部を置換し切ることより、おかしいときに止まれることのほうに価値があります。

最後に、マクロは図面を保存しません。書き戻したあとの図面を目で確かめてから、人が保存します。取り消しの効かない操作は、最後まで人の手に残しておく設計です。

一括置換を入れる前に見ておく危険信号✓置換前の一覧を残している✓保存は図面を目で見てから人が行う✗部分一致を確認せずに全件置換している✗表題欄の図番まで同じ語で置換している✗属性と連動した注記を文字で上書きしている✗置換した結果を誰も見返していない
図4: ✕が1つでもあれば、置換の前に手順を見直す合図です。
VB参考実装例:確認した行だけを書き戻し、前提が崩れたら止める(Excel VBA)
' 一覧で「採用」に ○ を付けた行だけを、図面の注記に書き戻す。
'   前提が1つでも崩れていたら、その行は置換せず、理由を「結果」欄に残す。
'   図面の保存はしない。目で確かめてから人が保存する。
Option Explicit

Public Sub ApplyReviewedTexts()
    Dim ws As Worksheet
    Set ws = ActiveSheet

    Dim cat As Object, doc As Object
    On Error Resume Next
    Set cat = GetObject(, "CATIA.Application")
    If Not cat Is Nothing Then Set doc = cat.ActiveDocument
    On Error GoTo 0

    ' 前提1: 一覧を作った図面と、いま開いている図面が同じであること
    If doc Is Nothing Then
        MsgBox "CATIAで図面が開かれていないため、実行しません。", vbExclamation
        Exit Sub
    End If
    If doc.FullName <> CStr(ws.Range("K1").Value) Then
        MsgBox "一覧を作った図面と、いま開いている図面が違うため実行しません。", vbExclamation
        Exit Sub
    End If

    Dim r As Long, lastRow As Long, done As Long, stopped As Long, res As String
    lastRow = ws.Cells(ws.Rows.Count, 1).End(xlUp).Row
    For r = 2 To lastRow
        If Trim$(CStr(ws.Cells(r, 6).Value)) = "○" Then
            res = ApplyOne(doc, ws, r)
            ws.Cells(r, 7).Value = res
            If res = "置換しました" Then done = done + 1 Else stopped = stopped + 1
        End If
    Next r

    MsgBox done & " 件を置換し、" & stopped & " 件は前提が合わず止めました。" & vbLf & _
           "図面は保存していません。確認してから保存してください。", vbInformation
End Sub

Private Function ApplyOne(doc As Object, ws As Worksheet, ByVal r As Long) As String
    Dim oldText As String, newText As String
    oldText = CStr(ws.Cells(r, 4).Value)
    newText = CStr(ws.Cells(r, 5).Value)
    If Len(newText) = 0 Then
        ApplyOne = "止めました:置換後が空"
        Exit Function
    End If

    ' 前提2: 指定したシート・ビュー・番号の注記が実在すること
    Dim sh As Object, vw As Object, tx As Object
    On Error Resume Next
    Set sh = doc.Sheets.Item(CStr(ws.Cells(r, 1).Value))
    If Not sh Is Nothing Then Set vw = sh.Views.Item(CStr(ws.Cells(r, 2).Value))
    If Not vw Is Nothing Then Set tx = vw.Texts.Item(CLng(ws.Cells(r, 3).Value))
    On Error GoTo 0
    If tx Is Nothing Then
        ApplyOne = "止めました:対象の注記が見つからない"
        Exit Function
    End If

    ' 前提3: 一覧を作ったときから中身が変わっていないこと(番号ずれの検出)
    '   改行を含む注記などで一致しない場合も、進まずに止まる側に倒す
    If tx.Text <> oldText Then
        ApplyOne = "止めました:一覧作成後に内容が変わっている"
        Exit Function
    End If

    tx.Text = newText
    ApplyOne = "置換しました"
End Function

現場に入れる前に決めておく3つのこと

マクロそのものは数十行ですが、現場に入れる前に決めておくことがあります。1つ目は、背景ビューを置換の対象に含めるかどうかです。表題欄を別のマクロやテンプレートで管理しているなら、注記の置換からは外しておくほうが安全です。

2つ目は、パラメータや属性と連動させている注記の扱いです。部品番号や材質を属性から表示している注記を文字列で上書きすると、連動が切れて、以後はモデルを直しても図面が追従しなくなることがあります。どの注記を連動させているかを社内でそろえておき、一覧を見る段階で外せるようにしておくと安心です。

3つ目は、寸法値や表の中の文字をどうするかです。この記事のマクロは注記テキストだけを扱うので、同じ語が表や寸法に入っている場合は別の手当てが要ります。対象を広げるなら、一覧→確認→置換の3段はそのままに、読み出す側を足していくのが崩れにくいやり方です。

注記の修正は、1回あたりは小さな作業です。ただ、設計変更や規格改訂のたびに発生し、見落としは出図後の手戻りにつながります。一日の中で目立たない作業ほど、年間で積み上げると大きな時間になっています。

あなたの現場では、注記の修正に年に何時間を使っているでしょうか。どの注記をどこまで一括で直せるのか、背景ビューや連動した注記をどう扱うべきか。図面の運用をお聞きしたうえで、対象範囲と止まる条件を整理した自働化設計書を無料でご提案しています。まずは、いま手で直している作業の話からお聞かせください。

Qronix 開発チーム

CATIA歴22年超・愛知県の大手自動車メーカー及びグループ各社でCATIAツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →