CATIA

CATScriptでCATIAマクロを作る手順——ツール→マクロから、最初の1本を開いて動かすまで

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

#CATIA#CATIAマクロ#開発の作法#CAD自働化

CATIAのマクロを自分で書いてみようとして、最初に止まるのは文法ではありません。「どこに作るのか」「作ったファイルをどうやって開くのか」「どうやって動かすのか」です。Excel のように、開けばすぐ編集画面が出てくるわけではないからです。この記事では、手で書くなら最も始めやすい CATScript を使って、ツール→マクロの画面から最初の1本を動かすまでを、操作の順番どおりに書きます。

作業中のPC画面Photo: Unsplash
CONTENTS
1. 手で書くなら、最初の1本は CATScript がいちばん始めやすい 2. まず置き場所を作る——マクロ・ライブラリーにフォルダを登録する 3. 新しいマクロを作り、エディターで開く 4. 動かす。動かないときに見る場所は、ほぼ決まっている 5. すでにある .CATScript ファイルを開くには 6. 1本目が動いたら——ボタンに置く、VBA に移る目安

手で書くなら、最初の1本は CATScript がいちばん始めやすい

CATIA V5 でマクロを作るとき、言語は CATScript・MS VBScript・MS VBA から選べます。どれを選んでも CATIA を動かす命令そのものは同じで、違うのは書き方の自由度と、準備の手間です。三つの言語を並べて、どれを選ぶかを整理した記事はCATIA VBAとCATScript・VB.NET——自動化の言語はどれを選ぶべきかにまとめてあります。

はじめての1本に CATScript をすすめる理由は三つあります。ファイル1つで完結するので置き場所に迷わないこと。Dim oPart As Part のように型を書けるので、何を扱っているかがコードに残ること。そして、マクロの記録やネット上の例の多くがこの形で書かれているので、見本をそのまま試せることです。

Excel でマクロを書いたことがある方ほど、VBA を選びたくなると思います。VBA は入力フォームや1行ずつ止めて調べる機能があり、道具が育ってくると確かに便利です。ただ、CATIA 側の VBA は環境によって入っていなかったり、参照設定が必要だったりします。最初の1本で環境の問題に時間を取られるより、CATScript で動くところまで行ってから移るほうが、つまずく場所が少なく済みます。

登録から実行、動かないときの確認までマクロ専用フォルダを作るAlt+F8で画面を開きフォルダを登録CATScriptで作成し名前を付ける編集でCATMainを書く部品を1つ開きAlt+F8を押す一覧にマクロが出る?登録先と拡張子を確かめる選んで実行を押す実行して反応がある?CATMainの名前を確かめるエラーが出る?前のウィンドウと型名のつづりを確認ドキュメント名が表示される出ない出る反応なし反応あり出る出ない
図1: ライブラリー登録→作成→実行の順と、一覧に出ない・反応がない・エラーのときに見る場所。

まず置き場所を作る——マクロ・ライブラリーにフォルダを登録する

CATScript のマクロは、ふつうのフォルダに置いた1つのファイルです。ただし CATIA は、どのフォルダを見に行けばよいかを最初は知りません。そこで最初に、マクロを置くフォルダを「ライブラリー」として登録します。

エクスプローラーで、マクロ専用のフォルダを1つ作っておきます。たとえば C:\CATIA_Macro のように、日本語や空白を含まない短い場所が扱いやすいです。次に CATIA で「ツール」→「マクロ」→「マクロ...」を開きます(英語表示では Tools → Macro → Macros、キーボードなら Alt+F8)。

開いた画面の「マクロ・ライブラリー...」(Macro libraries)を押し、ライブラリーの種類で「ディレクトリー」(Directories)を選びます。「既存のライブラリーを追加...」(Add existing library)で、さきほど作ったフォルダを指定して閉じます。画面の表記は版や言語設定で少し違いますが、並び順はほぼこのとおりです。

この登録は一度やれば残ります。次からは Alt+F8 を押すと、そのフォルダに置いたマクロが一覧に並びます。

ツール→マクロの画面で押す順番1マクロ...を開くツール→マクロ(Alt+F8)2マクロ・ライブラリー種類はディレクトリー3既存のライブラリーを追加作ったフォルダを指定4作成→編集CATScript を選んで開く
図2: 表記は版や言語設定で少し違う。英語表示では Tools → Macro → Macros。

新しいマクロを作り、エディターで開く

マクロの画面に戻り、「作成」(Create)を押します。言語の選択で CATScript を選び、名前を付けます。拡張子は .CATScript になります。名前は、あとで一覧を見て何をするものか分かる英数字にしておくと困りません。

作ったら、一覧でそのマクロを選んで「編集」(Edit)を押します。CATIA に付属しているマクロ・エディターが開き、ここで直接書いて保存できます。慣れてきたら、ファイルをメモ帳や普段使っているエディターで開いて書いてもかまいません。中身はただのテキストです。

CATScript で覚えておくことは一つだけで、処理は CATMain という名前の Sub から始まります。名前が違うと、実行しても何も起きません。最初の1本は、次のように「いま開いているドキュメントの名前を出す」だけで十分です。

最初に止まるのは文法ではなく、
どこに作り、どう開くかだ。

VB参考実装例:はじめての CATScript(開いているドキュメント名を出す)
' 参考実装例:はじめての CATScript。いま開いているドキュメントの名前を出す
' CATScript は CATMain という名前の Sub から動き出す
Sub CATMain()

    ' 何も開いていないと ActiveDocument でエラーになるので、先に確かめる
    If CATIA.Documents.Count = 0 Then
        MsgBox "ドキュメントが開かれていません。部品を開いてから実行してください。"
        Exit Sub
    End If

    Dim oDoc As Document
    Set oDoc = CATIA.ActiveDocument

    MsgBox "いま開いているのは " & oDoc.Name & " です。"

End Sub

動かす。動かないときに見る場所は、ほぼ決まっている

CATIA で部品を1つ開いてから、Alt+F8 でマクロの画面を出し、作ったマクロを選んで「実行」(Run)を押します。メッセージにドキュメント名が出れば、ライブラリーの登録から実行までの流れはすべて通っています。

動かないときに見る場所は、ほとんど次の四つに収まります。一覧にマクロが出てこないならライブラリーの登録先か拡張子。実行しても反応がないなら CATMain の名前。エラーが出るなら、ドキュメントを開いていないか、型名のつづり違い。最後に、前に出ているウィンドウが想定と違うことです。

とくに最後のものは、慣れた人でもよくやります。部品と図面を両方開いていて、図面のウィンドウが前にある状態で部品向けのマクロを走らせると、正しいコードでもエラーになります。だから2本目は、想定外の状態では何もせずに理由だけを伝える形で書いておくと安心です。

動かないときに見る4か所✓一覧に出ない → 登録先と拡張子✓反応がない → CATMain の名前✓エラー → 未オープンか型名のつづり✗前に出ているウィンドウを確かめずに実行する
図3: 最初の数本でつまずく原因は、ほぼこの中にある。
VB参考実装例:CATPart のときだけ動き、ボディの一覧を出す
' 参考実装例:CATPart のときだけ動き、ボディの数と名前を一覧で出す
' 想定外の状態では何もせず、理由だけ伝えて終わる
Sub CATMain()

    If CATIA.Documents.Count = 0 Then
        MsgBox "ドキュメントが開かれていません。"
        Exit Sub
    End If

    If TypeName(CATIA.ActiveDocument) <> "PartDocument" Then
        MsgBox "CATPart を開いて、そのウィンドウを前に出してから実行してください。"
        Exit Sub
    End If

    Dim oPart As Part
    Set oPart = CATIA.ActiveDocument.Part

    Dim i As Integer
    Dim sList As String
    For i = 1 To oPart.Bodies.Count
        sList = sList & oPart.Bodies.Item(i).Name & vbCrLf
    Next

    MsgBox "ボディは " & oPart.Bodies.Count & " 個です。" & vbCrLf & vbCrLf & sList

End Sub

すでにある .CATScript ファイルを開くには

人からもらったマクロや、ネットで見つけた例を試したいときも、やることは同じです。受け取った .CATScript ファイルを、登録したライブラリーのフォルダにコピーします。Alt+F8 の一覧に出てくるので、選んで「編集」で中身を確かめ、「実行」で動かします。

中身を確かめずにいきなり実行するのは避けてください。CATScript はファイルの保存や削除もできます。もらったマクロは、まず編集で開いて、何をするものかを読んでから動かす。読めない部分があるうちは、捨ててもよい部品のコピーで試すのが安全です。

マクロの記録(ツール→マクロ→記録の開始)で作ったファイルも、保存先を同じライブラリーにしておけば、同じ一覧から開けます。記録したコードは、手で書くときの見本としてとても役に立ちます。ただし、そのとき画面で選んでいたものに縛られた書き方になるので、そのまま業務に使うより、読んで書き直す材料にするのが向いています。

1本目から道具になるまで1本目CATScript で名前を出す2本目状態を確かめてから動かすよく使うようになったらツールバーのボタンに置く画面や共通化が要るときVBA へ移る
図4: 言語を変えるのは、画面や使い回しが必要になってからで間に合う。

1本目が動いたら——ボタンに置く、VBA に移る目安

よく使うようになったマクロは、ツールバーのボタンにしておくと呼び出しが楽になります。「ツール」→「カスタマイズ」のコマンドの中にマクロの項目があり、そこからツールバーへドラッグで置けます。毎回 Alt+F8 を開く手間がなくなります。

VBA へ移るかどうかは、入力欄のある画面が欲しくなったとき、同じ処理を何本ものマクロで使い回したくなったとき、を目安にしてください。移るときの手順はCATIA VBA でマクロを作る手順にまとめてあります。そこまでは CATScript のままで困ることはあまりありません。次に書くものに迷ったら、現場で本当に使うCATIAマクロ スニペット10選から、自分の作業に近いものを1つ選んで写してみるのが近道です。

私たちは、社内に散らばった CATIA マクロの整理や、手作業を道具に置き換える仕組みづくりをお手伝いしています。最初の1本は動いたけれど、そこから先をどう広げるか迷っている方は、声をかけてください。いまの作業を見せていただいたうえで、ヒアリングと自働化設計書の作成を無料でお引き受けしています。

Qronix 開発チーム

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

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

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

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