現場で本当に使うCATIAマクロ スニペット10選
「CATIAマクロのサンプルコードを探しても、動くものが出てこない」。私たちが最も多く受ける相談です。ネットに転がるコードは断片的で、現場のファイル構成では動かない。ここでは私たちが実際に98ツールへ組み込み、毎日回っているスニペットを10本、削らずに出します。
Photo: Unsplashサンプルコードが動かない本当の理由
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割減ることも珍しくありません。ここは体感差が大きいので、最初に入れる価値があります。
'*********************************************************************************
'* Part取得
'* param: oEnt-対象CATIAオブジェクト
'* return: Part
'*********************************************************************************
Public Function GetPartByEntitiy( _
ByVal oEnt As AnyObject) As Part
Set GetPartByEntitiy = GetParent_Of_T(oEnt, "Part")
End FunctionSelectedElement から 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に書かせるより、選ばせる。
選択肢が同じ作法で書かれているからこそ、選ぶことが安全になる。
'************************************************************************
'* 要素のグラフィックプロパティを変更する
'* 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構文の文字列は環境の言語設定に依存します。日本語環境と英語環境でキーワードが変わるケースがあるため、配布ツールでは英語キーワードで書いて動作確認を両環境で取るのが安全です。ここを踏まずに配布して、海外拠点だけで動かないという報告を受けたことがあります。
'*********************************************************************************
'* 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件でもあれば完了ダイアログの色を変えるという単純な実装を全ツールに入れています。異常があれば人が気づく形で止まる。これが自働化です。
'*********************************************************************************
'* ダンプ
'* 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本目を書く時間のほうが短くなったら、それは土台ができた証拠です。
手元の作業がこの方法で楽になりそうか、判断が付かないときは相談してください。効果が出そうか出なさそうかを、着手前に金額で見立てるところまでお手伝いします。