CATScriptでCATIAマクロを作る手順——ツール→マクロから、最初の1本を開いて動かすまで
CATIAのマクロを自分で書いてみようとして、最初に止まるのは文法ではありません。「どこに作るのか」「作ったファイルをどうやって開くのか」「どうやって動かすのか」です。Excel のように、開けばすぐ編集画面が出てくるわけではないからです。この記事では、手で書くなら最も始めやすい CATScript を使って、ツール→マクロの画面から最初の1本を動かすまでを、操作の順番どおりに書きます。
Photo: Unsplash手で書くなら、最初の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 で動くところまで行ってから移るほうが、つまずく場所が少なく済みます。
まず置き場所を作る——マクロ・ライブラリーにフォルダを登録する
CATScript のマクロは、ふつうのフォルダに置いた1つのファイルです。ただし CATIA は、どのフォルダを見に行けばよいかを最初は知りません。そこで最初に、マクロを置くフォルダを「ライブラリー」として登録します。
エクスプローラーで、マクロ専用のフォルダを1つ作っておきます。たとえば C:\CATIA_Macro のように、日本語や空白を含まない短い場所が扱いやすいです。次に CATIA で「ツール」→「マクロ」→「マクロ...」を開きます(英語表示では Tools → Macro → Macros、キーボードなら Alt+F8)。
開いた画面の「マクロ・ライブラリー...」(Macro libraries)を押し、ライブラリーの種類で「ディレクトリー」(Directories)を選びます。「既存のライブラリーを追加...」(Add existing library)で、さきほど作ったフォルダを指定して閉じます。画面の表記は版や言語設定で少し違いますが、並び順はほぼこのとおりです。
この登録は一度やれば残ります。次からは Alt+F8 を押すと、そのフォルダに置いたマクロが一覧に並びます。
新しいマクロを作り、エディターで開く
マクロの画面に戻り、「作成」(Create)を押します。言語の選択で CATScript を選び、名前を付けます。拡張子は .CATScript になります。名前は、あとで一覧を見て何をするものか分かる英数字にしておくと困りません。
作ったら、一覧でそのマクロを選んで「編集」(Edit)を押します。CATIA に付属しているマクロ・エディターが開き、ここで直接書いて保存できます。慣れてきたら、ファイルをメモ帳や普段使っているエディターで開いて書いてもかまいません。中身はただのテキストです。
CATScript で覚えておくことは一つだけで、処理は CATMain という名前の Sub から始まります。名前が違うと、実行しても何も起きません。最初の1本は、次のように「いま開いているドキュメントの名前を出す」だけで十分です。
最初に止まるのは文法ではなく、
どこに作り、どう開くかだ。
' 参考実装例:はじめての 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本目は、想定外の状態では何もせずに理由だけを伝える形で書いておくと安心です。
' 参考実装例: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本目が動いたら——ボタンに置く、VBA に移る目安
よく使うようになったマクロは、ツールバーのボタンにしておくと呼び出しが楽になります。「ツール」→「カスタマイズ」のコマンドの中にマクロの項目があり、そこからツールバーへドラッグで置けます。毎回 Alt+F8 を開く手間がなくなります。
VBA へ移るかどうかは、入力欄のある画面が欲しくなったとき、同じ処理を何本ものマクロで使い回したくなったとき、を目安にしてください。移るときの手順はCATIA VBA でマクロを作る手順にまとめてあります。そこまでは CATScript のままで困ることはあまりありません。次に書くものに迷ったら、現場で本当に使うCATIAマクロ スニペット10選から、自分の作業に近いものを1つ選んで写してみるのが近道です。
私たちは、社内に散らばった CATIA マクロの整理や、手作業を道具に置き換える仕組みづくりをお手伝いしています。最初の1本は動いたけれど、そこから先をどう広げるか迷っている方は、声をかけてください。いまの作業を見せていただいたうえで、ヒアリングと自働化設計書の作成を無料でお引き受けしています。
記事一覧をすべて見る →