CATIA

現場で本当に使うCATIAマクロ スニペット10選

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

#CATIA#現場主義#CATIAマクロ

「CATIAマクロのサンプルコードを探しても、動くものが出てこない」。私たちが最も多く受ける相談です。ネットに転がるコードは断片的で、現場のファイル構成では動かない。ここでは私たちが実際に98ツールへ組み込み、毎日回っているスニペットを10本、削らずに出します。

作業中のPC画面Photo: Unsplash
CONTENTS
1. サンプルコードが動かない本当の理由 2. スニペット1〜3:ドキュメントとProduct構造を確実に掴む 3. スニペット4〜6:パラメータと属性を読み書きする 4. スニペット7〜8:Selectionを使った一括操作 5. スニペット9〜10:Excel出力とエラーハンドリングの型 6. スニペットを資産に変えるために

サンプルコードが動かない本当の理由

CATIAマクロのサンプルコードをコピーして動かない原因の9割は、構文ではなく前提の欠落です。ActiveDocumentがPartなのかProductなのかDrawingなのかで、その先のオブジェクトモデルは丸ごと変わります。サンプルの多くはその前提を書かないまま本体だけを載せている。だから貼った瞬間に「オブジェクトはこのプロパティまたはメソッドをサポートしていません」で止まります。

私たちは社内スニペットに必ず先頭3行の型チェックを付けています。TypeName(CATIA.ActiveDocument)を見て、想定外なら明示的にMsgBoxで止める。これだけで現場からの「動きません」という問い合わせが体感で半減しました。エラーを出さないことより、正しい場所で止めることを優先する。私たちが「自働化」と呼んでいる考え方の、いちばん小さな実装がこれです。

もう一つの落とし穴が参照設定です。Excel出力を含むスニペットをそのまま貼ると、環境によってはExcelの型ライブラリが無く、コンパイル段階で落ちます。私たちは配布物では原則遅延バインディング(CreateObjectでExcel.Applicationを取る)に統一しています。書き味は落ちますが、配布先の環境を選ばない。数十人に配るツールでは、これが圧倒的に正解でした。

スニペット1〜3:ドキュメントとProduct構造を確実に掴む

最初の3本は土台です。アクティブドキュメントの安全な取得、Product構造の再帰走査、指定パスのドキュメントを非表示で開く。この3つが手元にあるだけで、後続のマクロは大半が書けるようになります。逆にここが雑だと、上に何を積んでも壊れます。

Product構造の走査は再帰が基本です。ただしCATIAのProductは、CATPartを指す末端ノードでもProducts.Countが0になるだけで、同じインタフェースを持ちます。だから型で分岐せず件数で分岐するのが安全です。私たちのスニペットもそうしています。部品点数3000点規模のアセンブリで、この再帰は数秒で回ります。

非表示オープンはCATIA.DisplayFileAlerts = FalseとCATIA.Visible制御の組み合わせが要点です。バッチ処理で50ファイルを開いて閉じる場合、画面描画を止めるだけで処理時間が3〜4割減ることも珍しくありません。ここは体感差が大きいので、最初に入れる価値があります。

VBA弊社共通ライブラリより抜粋(clsCatHelperLib):選択要素から所属Partを特定する
'*********************************************************************************
'*  Part取得
'*  param: oEnt-対象CATIAオブジェクト
'*  return: Part
'*********************************************************************************
Public Function GetPartByEntitiy( _
        ByVal oEnt As AnyObject) As Part

     Set GetPartByEntitiy = GetParent_Of_T(oEnt, "Part")

End Function

SelectedElement から Part を辿る定番の一手。アセンブリ上の選択で頻出します。

スニペット4〜6:パラメータと属性を読み書きする

設計変更の自働化で最も出番が多いのがParametersです。part.Parameters.Item("名前")は存在しないと例外を投げるので、私たちは必ず存在チェック用のラッパー関数を経由させます。On Error Resume Nextを裸で書くと、その後の別のエラーまで飲み込んでしまう。エラー抑止は必ず1行の直後にOn Error GoTo 0で閉じる、を鉄則にしています。

属性(プロパティ)の書き込みでは、Product.UserRefPropertiesが実務でよく効きます。図番、材質、改訂記号といったCADが持つべき情報をCADに持たせる。ここを紙やExcelで持っている限り、BOMの自働化は永久に不可能です。私たちがBOMの案件でまず着手するのは、ほとんどの場合この属性の整備です。

単位の扱いは要注意です。ParameterのValueはmm基準ですが、Angle系はdeg、Massはkgと単位が混在します。ValueAsStringを使えば単位付き文字列で読めますが、ロケール依存で小数点がカンマになる環境があります。私たちは数値はValue、表示はValueAsStringと用途で使い分けて事故を避けています。

AIに書かせるより、選ばせる。
選択肢が同じ作法で書かれているからこそ、選ぶことが安全になる。

VBA弊社共通ライブラリより抜粋(clsCatHelperLib):要素の色・表示プロパティを一括設定
'************************************************************************
'*  要素のグラフィックプロパティを変更する
'*  param: oEnt-対象CATIAオブジェクト
'*  param: lR-赤成分
'*  param: lG-緑成分
'*  param: lB-青成分
'*  param: lTypeIndex-線種インデックス
'*  param: lWidthIndex-線幅インデックス
'*  param: lOpacity-透明度(0~255)
'*  param: lSymbol-点シンボルインデックス
'************************************************************************
Public Sub SetVisProperty( _
    ByVal oEnt As Variant, _
    Optional lR As Long = -1, _
    Optional lG As Long = -1, _
    Optional lB As Long = -1, _
    Optional lTypeIndex As Long = -1, _
    Optional lWidthIndex As Long = -1, _
    Optional lOpacity As Long = -1, _
    Optional lSymbol As Long = -1)

    Dim i As Long
    
    On Error Resume Next
    CATIA.HSOSynchronized = False
    With CATIA.ActiveDocument.Selection

        .Clear
        If TypeName(oEnt) = "Collection" Then
            For i = 1 To oEnt.count
                .Add oEnt.Item(i)
            Next
        Else
            .Add oEnt
        End If

        '引数が入力されている要素のみグラフィックプロパティを変更
        If lR <> -1 And lB <> -1 And lB <> -1 Then
            Call .VisProperties.SetRealColor(lR, lG, lB, 1) '色
        End If
        If lTypeIndex <> -1 Then Call .VisProperties.SetRealLineType(lTypeIndex, 1) '線種
        If lWidthIndex <> -1 Then Call .VisProperties.SetRealWidth(lWidthIndex, 1)  '線幅
        If lOpacity <> -1 Then Call .VisProperties.SetRealOpacity(lOpacity, 1)      '透明度
        If lSymbol <> -1 Then Call .VisProperties.SetSymbolType(lSymbol)            '点シンボル
        .Clear

    End With
    CATIA.HSOSynchronized = True
    On Error GoTo 0
    
End Sub

チェック結果のNG要素を赤にする、対象だけ表示する——ほぼ全ての検査系ツールで使い回しています。

スニペット7〜8:Selectionを使った一括操作

Selectionオブジェクトは、CATIAマクロの中で最も強力で、最も危険な機能です。Search構文を使えば「このPart内のすべての穴」「非表示のすべてのボディ」を一発で拾えます。ループで探索するより1〜2桁速い。3000点のアセンブリで、私たちの計測では手書きループが約40秒、Search構文が2秒でした。

危険なのは、Selectionが状態を持つことです。前のマクロがClearし忘れた選択が残っていると、次のマクロが意図しない対象を巻き込みます。私たちはマクロの入口と出口で必ずClearを書きます。例外で抜けた場合も通るよう、Finally相当の位置に置く。地味ですが、これで防げた事故が実際にあります。

Search構文の文字列は環境の言語設定に依存します。日本語環境と英語環境でキーワードが変わるケースがあるため、配布ツールでは英語キーワードで書いて動作確認を両環境で取るのが安全です。ここを踏まずに配布して、海外拠点だけで動かないという報告を受けたことがあります。

VBA弊社共通ライブラリより抜粋(geoPoint3D):2点間距離
'*********************************************************************************
'*  2点間距離
'*  param: oPoint-ターゲットの点
'*  return: 2点間距離
'*********************************************************************************
Function DistanceTo( _
        ByVal oPoint As geoPoint3D) As Double

    DistanceTo = Sqr( _
        (oPoint.x - m_dX) ^ 2 + (oPoint.Y - m_dY) ^ 2 + (oPoint.Z - m_dZ) ^ 2 _
    )

End Function

幾何計算はクラスに寄せ、呼ぶ側は1行で済ませる方針です。

スニペット9〜10:Excel出力とエラーハンドリングの型

CADから拾った情報の出口は、ほとんどの現場でExcelです。ここで多い失敗が、セルへ1個ずつ書き込むこと。1000行×8列を1セルずつ書くと数十秒かかりますが、2次元配列に溜めて一括代入すれば1秒以下で終わります。COM境界を跨ぐ回数がそのままコストなので、跨ぐ回数を減らす。原則はこれだけです。

エラーハンドリングは、私たちの配布ツールでは型が決まっています。処理単位ごとにOn Error GoTo ERR_HANDLERを置き、ERR_HANDLERではErr.Number、Err.Description、そして失敗した対象のファイル名をログに残す。ユーザーに見せるのは「どのファイルで何が起きたか」だけで十分です。スタックトレースを見せても現場は動けません。

そして最後に、止め方です。50ファイル中3ファイルで失敗したとき、黙って47件を処理して終わるツールは信用を失います。私たちは失敗件数が1件でもあれば完了ダイアログの色を変えるという単純な実装を全ツールに入れています。異常があれば人が気づく形で止まる。これが自働化です。

配布するマクロに、この5つが入っているか✓先頭3行で TypeName(ActiveDocument) を検査し、想定外なら止める✓Excel連携は遅延バインディング(CreateObject)で書く✓Selection は処理の入口と出口で必ず Clear する✓エラー時に Err.Number・Description・対象ファイル名をログに残す✓失敗が1件でもあれば完了ダイアログの色を変える
図1: 10本のスニペットに共通する作法。上の3つが入っていれば、配布先の環境を選ばない。
配布用マクロの処理と止め方マクロを実行ActiveDocumentの型は想定どおり?MsgBoxで明示的に止める入口でSelectionをClearファイルごとに処理On Error GoToエラーが出た?エラー番号・内容・ファイル名をログへ2次元配列に溜めてExcelへ一括代入出口でSelectionをClear失敗が1件でもある?完了ダイアログの色を変える完了想定外想定どおり出た出ないあるない
図2: 型チェックで止め、エラーはファイル名とともにログへ残し、失敗が1件でもあれば完了表示を変える流れ。
VBA弊社共通ライブラリより抜粋(clsCatHelperLib):デバッグ用ダンプ
'*********************************************************************************
'*  ダンプ
'*  param: sTxt-文字
'*********************************************************************************
Public Sub Dump( _
        ByVal sTxt As String)
    
    If Not m_DebugMode Then Exit Sub
    Debug.Print sTxt
End Sub

現場配布ビルドでもログだけは常に残します。再現しない不具合はログでしか追えません。

スニペットを資産に変えるために

10本のスニペットは、単体では便利な断片にすぎません。私たちが創業2年で98ツールを現場実装できたのは、これらを共通モジュールとして一本化し、全ツールが同じ土台を共有しているからです。ログの形式も、エラーの止め方も、Excel出力の作法も全ツールで同一。だから新規ツールの実装が速い。

この共有された土台があることは、特許第7907964号のAIエージェント「Qi」の前提でもあります。Qiはコードを生成しません。検証済みの社内ツールを選択するだけです。選択肢が同じ作法で書かれているからこそ、選ぶという行為が安全になる。AIに書かせるより、選ばせる。私たちがそこに賭けた理由が、ここにあります。

スニペットは公開しました。あとは、あなたの現場の作法に合わせて土台を作るだけです。最初の1本を書く時間より、10本目を書く時間のほうが短くなったら、それは土台ができた証拠です。

手元の作業がこの方法で楽になりそうか、判断が付かないときは相談してください。効果が出そうか出なさそうかを、着手前に金額で見立てるところまでお手伝いします。

3000点アセンブリでの探索方式の比較手書き再帰ループ40秒1要素ずつCOM越しに問い合わせSelection.Search2秒CATIA側で一括評価
手書きの再帰ループとSelection.Search構文の実測差。COM境界を跨ぐ回数がそのまま時間になる。
配布用マクロの標準骨格1型チェックActiveDocumentの種類を確認して想定外なら停止2選択のクリア前処理の残留選択を必ず消す3本処理配列に溜めてCOM越えを最小化4出力Excelへ一括代入、ログを同時生成5結果の告知失敗が1件でもあれば見た目を変えて知らせる
私たちの全ツールが共有する5ステップ。順番が決まっているから、誰が書いても同じ形になる。
Qronix 開発チーム

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

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

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

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