CATIA

CATIAマクロを始める人が最初につまずく5つのこと

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

#CATIA#CATIAマクロ#導入ステップ

CATIAマクロを始めた人の大半は、文法ではないところでつまずきます。記録したマクロが動かない、参照設定が見つからない、他のPCで落ちる。私たちが22年の現場で繰り返し見てきた5つのつまずきと、その回避策を具体的に書きます。結論から言えば、最初の一本は「小さく、止まるように」作るのが正解です。

作業中のPC画面Photo: Unsplash
CONTENTS
1. つまずき1:マクロの記録をそのまま使ってしまう 2. つまずき2:VBAとCATScriptの違いを知らずに書く 3. つまずき3:エラー処理を後回しにする 4. つまずき4:自分のPCでしか動かないコードを書く 5. つまずき5:作る前に「やめる範囲」を決めていない 6. よくある質問——始める前につまずきやすいところ 7. 最初の一本を書き切るための現実的な手順

つまずき1:マクロの記録をそのまま使ってしまう

CATIAマクロの入門でまず教わるのが「マクロの記録」です。操作を記録すればコードが自動で生成される。確かに手軽で、CATScriptの書き方を知る入口としては悪くありません。ただし、記録されたコードをそのまま業務に使うのは危険です。私たちが引き継いだ現場のマクロの中には、記録コードを継ぎ足し続けて2000行を超えたものがありました。誰も中身を説明できない状態です。

記録が生成するのは「そのとき画面に出ていたものへの参照」です。選択していたボディ、アクティブだったパート、開いていたウィンドウ。それらが少しでも違えば落ちます。CATIAの操作を記録した結果は再現手順であって、プログラムではありません。ここを混同したまま進むと、動く日と動かない日があるマクロが出来上がります。

正しい使い方は「調べる道具」としてです。ある機能がどのオブジェクトのどのメソッドを呼んでいるのか分からないとき、一度だけ記録して該当行を読む。そこからオブジェクトの取得経路を自分で書き直す。この手順を踏むだけで、コードの寿命は何倍にも延びます。

私たちがマクロを覚えたい方に最初におすすめするのは、記録したコードを一行ずつ日本語に翻訳する作業です。翻訳できない行が出てきたら、それが理解の穴です。CATIAマクロの使い方を身につける最短ルートは、実はここにあります。

つまずき2:VBAとCATScriptの違いを知らずに書く

CATIA自動化の入門者が最初に混乱するのが、CATScriptとVBAという二つの選択肢です。拡張子が違うだけに見えて、実は動く仕組みが違います。CATScriptはCATIAが内部で解釈するスクリプト、VBAはCATIAに組み込まれたVBA環境で動くプロジェクトです。同じように見えるコードでも、片方では通って片方では通らないことがあります。

実務で効いてくる差は三つです。ひとつはフォーム(ダイアログ)が作れるかどうか。CATScriptには本格的なUIがありません。もうひとつは外部ライブラリの参照設定。Excel連携などをやるならVBA側が圧倒的に楽です。三つ目はデバッグ環境で、VBAにはブレークポイントとウォッチがあります。CATScriptにはMsgBoxしかありません。

では常にVBAかというと、そうでもない。CATScriptは一枚のテキストファイルで完結するので、配布が簡単でバージョン管理と相性がいい。数十人に配る小さなツールならCATScriptの方が運用コストが低いことは珍しくありません。言語の選択は配布方法の選択だと考えると判断を誤りません。

私たちは、社内共有の小道具はCATScript、業務フローに組み込む本番ツールはVBAかVB.NET、という切り分けを基本にしています。最初にここを決めずに書き始めると、途中で全部書き直すことになります。この三つをどう選び分けるかはCATIA VBAとCATScript・VB.NET——自動化の言語はどれを選ぶべきかに、判断の材料を並べてあります。

CATScriptとVBAはどちらを選ぶかCATScript社内共有の小道具無理をするとMsgBoxだけで破綻する記録コードの継ぎ足し属人化して読めなくなるVBA業務フローに組み込む本番ツール配布のしやすさUI・外部連携の必要性
言語の選択は配布方法の選択。配布のしやすさと、UI・外部連携の必要性で置き場所が決まる。
VBA弊社共通ライブラリより抜粋(clsCatHelperLib):実行前のドキュメント型チェック
'*****************************************************************************
'*  マクロスタートチェック
'*  主にアクティブドキュメントの型チェック
'*  param: arrDocTypes-許可するアクティブなドキュメントの型
'*      単体文字列OK, カンマ区切りの文字列OK, 文字の配列OK
'*  return: OKならTrue
'*****************************************************************************
Public Function CanExecute( _
        ByVal arrDocTypes As Variant) As Boolean

    CanExecute = False

    'MAP
    Dim oDocTypeMap As Object
    Set oDocTypeMap = CreateObject("Scripting.Dictionary")
    With oDocTypeMap
        Call .Add("PartDocument", "CATPart")
        Call .Add("ProductDocument", "CATProduct")
        Call .Add("DrawingDocument", "CATDrawing")
        Call .Add("AnalysisDocument", "CATAnalysis")
        Call .Add("ProcessDocument", "CATProcess")
    End With

    'ウィンドウ数チェック
    If CATIA.Windows.count < 1 Then
        MsgBox "ファイルが開かれていません"
        Exit Function
    End If
    
    'カンマ区切りの文字列
    If VarType(arrDocTypes) = vbString Then
        arrDocTypes = Split(arrDocTypes, ",")
    End If
    
    'エラー時のメッセージ
    Dim arrFileExts() As Variant
    ReDim arrFileExts(UBound(arrDocTypes))
    
    Dim i As Long
    For i = 0 To UBound(arrDocTypes)
        arrFileExts(i) = oDocTypeMap(arrDocTypes(i))
    Next
    
    Dim ErrMsg As String
    ErrMsg = "ファイルのタイプが異なります。" + vbCrLf + "(" + Join(arrFileExts, ",") + " のみです)"
    
    'ドキュメントかチェック
    Dim ActDoc As Document
    On Error Resume Next
        Set ActDoc = CATIA.ActiveDocument
    On Error GoTo 0
    If ActDoc Is Nothing Then
        MsgBox ErrMsg, vbExclamation + vbOKOnly
        Exit Function
    End If
    
    If UBound(Filter(arrDocTypes, TypeName(ActDoc))) < 0 Then
        MsgBox ErrMsg, vbExclamation + vbOKOnly
        Exit Function
    End If
    
    CanExecute = True

End Function

全ツール共通で最初に呼ぶ関数です。開いているドキュメントの型が想定と違えば、処理に入る前に止めます。「異常があれば止まる」はこの1行目から始まっています。

つまずき3:エラー処理を後回しにする

入門記事のサンプルコードには、たいていエラー処理が書かれていません。短く読みやすくするためです。しかしCATIAマクロは、必ず想定外に出会います。パートが開いていない、選択が空、リンク切れ、非表示のジオメトリ、読み取り専用ファイル。現場のデータは教科書通りではありません。

多くの人はOn Error Resume Nextを書いて先に進みます。これが最悪の選択です。エラーが無視されると、間違った結果が「正常終了」として出力される。図面が一枚静かに間違ったまま出図されます。止まってくれた方が百倍ましです。

私たちは「異常があれば止まる」という考え方を自働化と呼んでいます。トヨタ生産方式の、ニンベンのついた自働化です。機械が異常を検知して自分で止まる。自動で最後まで走り切ることより、間違ったまま走り続けないことを優先する。CADマクロでもこの原則はそのまま通用します。

実装は難しくありません。処理の入口で前提条件を検査し、満たさなければメッセージを出して終了する。ドキュメントの種類、選択数、必要なパラメータの存在。この検査を10行書くだけで、事故の大半は防げます。最初の一本からこれを習慣にしてください。

自動で最後まで走り切ることより、
間違ったまま走り続けないことを優先する。

最初の一本から入れておく「止まる」構造前提条件を検査ドキュメント種別・選択数・必要パラメータ満たさなければ終了メッセージを出して即停止本処理を実行対象を一つのパートに絞る結果を確認件数と値を人が読める形で出す
自動で最後まで走り切ることより、間違ったまま走り続けないことを優先する。

つまずき4:自分のPCでしか動かないコードを書く

自席では完璧に動いたマクロが、隣の席で落ちる。CATIAマクロ入門者が最も心を折られる瞬間です。原因のほとんどは環境依存です。ハードコードされたファイルパス、特定のバージョンにしかないメソッド、参照設定の有無、そしてCATIA設定の差です。

特に見落とされがちなのが単位系と表示設定です。パラメータの値を文字列で取得すると、環境によって「10mm」だったり「10」だったりします。数値として扱うならValueプロパティを使う。文字列の切り出しで単位を剥がすコードは、いつか必ず壊れます。

パスの扱いも同じです。Cドライブ直下の作業フォルダを前提にしたコードは配布できません。ドキュメントのFullNameから相対的に解決するか、設定ファイルを外に出す。参照設定に依存しない遅延バインディングを使うのも有効な手です。ExcelをCreateObjectで呼ぶ形にしておけば、参照設定なしで動きます。

私たちが98本のツールを現場実装する中で作った検収チェックリストの筆頭項目が「開発者以外のPCで、開発者が触らずに動くこと」です。ここを通らないものはツールとして数えません。

つまずき5:作る前に「やめる範囲」を決めていない

最後は技術ではなく設計の話です。CATIAマクロが失敗する最大の原因は、対象範囲を決めずに書き始めることにあります。「図面作成を自動化したい」という要望をそのまま受けると、例外処理が無限に増えて完成しません。全体の8割を占める定型パターンに絞り、残り2割は人がやる。この線引きを先に引くことです。

私たちは案件の最初に必ず自働化設計書を作ります。何を自動化し、何を自動化しないかを一枚に書く。ツールが止まる条件も先に決めておく。この紙があるだけで、開発中の手戻りが劇的に減ります。ヒアリングとこの設計書の提案までは無料でやっています。

範囲を絞ると効果が下がると思われがちですが、逆です。3日かかっていた作業のうち、8割の定型部分を15分にできれば、残り2割に人の時間を集中できる。100%の自動化を狙って未完成のまま放置されたツールより、80%で確実に動くツールの方が現場を変えます。

CATIAマクロの入門でVBAやCATScriptの使い方を学ぶことは大事です。ただ、本当に効くのは書き方より決め方です。最初の一本は、対象を一つのパートに絞り、前提条件を検査して、異常なら止まる。それだけで十分実務の役に立ちます。

よくある質問——始める前につまずきやすいところ

Q. マクロはどこから作るのですか。
A. CATIA V5では、メニューの[ツール]-[マクロ]-[マクロ...]、またはAlt+F8でマクロ操作のウィンドウが開きます。ここで「マクロライブラリー...」を押すと、マクロを入れておく場所を指定する画面になります。VBAで書くならこの画面で.catvbaのプロジェクトを1つ作り、その中にマクロを足していきます。CATScriptで書くなら、ライブラリーとしてフォルダを指定して、その中に.CATScriptのファイルを置きます。最初につまずくのはコードではなく、この「置き場所を先に決める」という一手間です。ここから先の、.catvbaを新しく作るときの画面の順番と、人から受け取った.catvbaを開く手順はCATIA VBAでマクロを作る手順に分けて書いています。

Q. 最初はCATScriptとVBA、どちらで書けばいいですか。
A. 自分ひとりで使う小さなものならCATScriptで構いません。1ファイルで完結するので、作って渡して終われます。ダイアログを出したい、Excelと行き来したい、あとで人に引き継ぐ、のいずれかが見えているならVBAにしてください。つまずき2に書いたとおり、これは言語の好みではなく配布方法の選択です。途中で変えると書き直しになります。

Q. 記録したマクロが一覧に出てきません。
A. ほとんどの場合、見ているライブラリーが記録先と違っています。マクロ操作のウィンドウで、いま選ばれているライブラリーがどこを指しているかを確認してください。VBAのプロジェクトとCATScriptのフォルダは別々に登録するものなので、CATScriptで記録したものがVBAプロジェクトの一覧に並ぶことはありません。

Q. マクロを使うのに、別のライセンスを買う必要はありますか。
A. 私たちがこれまで入った現場の範囲では、マクロの記録・編集・実行のためにライセンスを追加した例はありません。CATIA V5の標準の機能として入っています。ただしライセンスの構成は契約によって差があるので、導入前に自社の構成を確認されるのが確実です。構成ごとにマクロで手が届く範囲はCATIAのライセンスとマクロの関係にまとめています。

Q. どのくらいで最初の一本が動きますか。
A. 5分以内で終わる定型操作を選べば、調べる時間を入れて半日から1日というのが、私たちが見てきた実感です。逆に「図面作成を丸ごと」のような題材を最初に選ぶと、何週間かけても動くものになりません。つまずき5の範囲決めが、そのまま最初の一本が動くかどうかを分けます。

最初の一本を書き切る手順1対象を1つ選ぶ所要5分以内・判断がほぼ不要な操作2記録して読む登場するオブジェクトを把握する調査工程3白紙から書き直す取得・特定・処理・確認の四段構成で50行前後4意地悪なデータで試す未選択・空パート・想定外の名前
この往復を3回やれば、配れる品質になる。

最初の一本を書き切るための現実的な手順

順序を示します。まず、自分が毎日繰り返している操作を一つ選ぶ。所要時間5分以内、判断がほぼ不要なものが理想です。次にその操作を記録し、生成されたコードを読んで、どのオブジェクトが登場するかを把握します。ここまでが調査です。

次に白紙のファイルを開いて、記録コードを見ずに書き直します。ドキュメントの取得、対象の特定、処理、結果の確認。この四段構成で書く。前提条件の検査を先頭に入れて、満たさなければ終了する。ここまでで50行前後になるはずです。

最後に、意地悪なデータで試します。何も選択していない状態、空のパート、想定外の名前。落ちたら、落ちた場所に検査を足す。この往復を3回やれば、配れる品質になります。

私たちは創業2年で98ツールを現場に入れ、累計では500本を超えました。その全部が、この地味な手順の繰り返しです。最初の一本が動いた日から、CATIAの見え方が変わります。

同じような自働化を検討中でしたら、一度話を聞かせてください。ヒアリングと自働化設計書の提案までは無料で行っています。使えるものが無ければ、無いとお伝えします。

最初の一本を配れる品質にするまで繰り返す操作を選ぶ5分以内・判断不要記録したコードを読みオブジェクトを把握白紙から書き直す取得・特定・処理・確認先頭に前提条件の検査を入れる意地悪なデータで試す未選択・空のパート等落ちた?落ちた場所に検査を足す配れる品質になる最初の一本が完成落ちた落ちない
図4: 記録は調査にだけ使って書き直し、意地悪なデータで落ちた場所に検査を足す往復で品質を上げる。

▶ 実際の動作は動画でご確認いただけます(QRONIX 公式チャンネル)

Qronix 開発チーム

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

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

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

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