CATIA

PowerCopyとUDFを使い倒す——マクロを書く前にできること

2026.06.18 / 読了目安 7分 / 執筆: Qronix 開発チーム

#CATIA#CATIAマクロ

自働化の相談を受けたとき、私たちが最初に確認するのは「それ、PowerCopyで足りませんか」です。マクロを書けば何でもできますが、書いた瞬間に保守の責任が発生します。CATIA標準のPowerCopyとUDFで到達できる範囲を正確に知ることが、結果的に一番速い道です。

作業中のPC画面Photo: Unsplash
CONTENTS
1. マクロを書かないという選択肢を最初に検討する 2. PowerCopyとUDFの違いを実務目線で押さえる 3. PowerCopyを実際に作る——最小の手順と、つまずく一点 4. テンプレートが壊れる原因はほぼ「参照の取り方」 5. PowerCopyで届かない線と、そこからマクロを足す設計 6. テンプレート資産を組織で運用するためのルール

マクロを書かないという選択肢を最初に検討する

私たちはCATIAマクロ開発を生業にしています。それでも、案件の入口で必ず「マクロを書かずに済む方法」を検討します。理由は単純で、コードは資産であると同時に負債だからです。書いた瞬間から、CATIAのバージョンが上がるたびに動作確認が必要になり、担当者が変われば引き継ぎが必要になります。

PowerCopyとUDFは、CATIA標準のテンプレート再利用機能です。作った形状のかたまりを、参照する要素を差し替えながら別の場所へ貼り付けられる。マクロと違ってコードがなく、CATIAの機能として素直にバージョンアップに追随します。保守コストの観点では圧倒的に有利です。

実際の案件で、当初「マクロで自動化したい」と依頼された作業が、PowerCopyの整備と運用ルールの見直しだけで所要時間が3分の1になったことがあります。マクロは1行も書きませんでした。お客様には「今回はツール開発の必要がありません」とお伝えしました。目的は自働化であって、コードを納品することではありません。

とはいえPowerCopyには明確な限界があります。境界を知らずに適用すると、かえって複雑で壊れやすい仕組みができあがります。以下、その境界と設計ルールを具体的に書きます。

PowerCopyとUDFの違いを実務目線で押さえる

教科書的な違いは「PowerCopyは貼り付けた形状の中身が展開される、UDFは中身が隠蔽されて1つの要素になる」です。実務ではこの差が、誰が触るかの設計に直結します。

貼り付けた後に微調整したい、現場の設計者が中身を見て理解する必要がある——そういう用途にはPowerCopyです。ツリーに全部展開されるので、後から個別のスケッチを直せます。設計の自由度を残したいときの選択肢です。

逆に、中身を絶対に触らせたくない、社内標準として形状の作り方を固定したい——そういう用途にはUDFです。1つの要素として振る舞うので、ツリーが汚れず、誤って中間形状を消される事故も防げます。ただし、修正が必要になったら定義元に戻る必要があります。運用の窓口を決めておかないと、誰も直せないブラックボックスになります。

私たちの経験則では、設計意図が固まっている定型形状はUDF、まだ揺れているものはPowerCopyです。そして最初はPowerCopyで運用し、使われ方が安定してきたらUDF化する。この順番が失敗しません。いきなりUDFで固めると、想定していなかった使い方が出てきたときに全部作り直しになります。

PowerCopyとUDFの使い分けUDF社内標準として作り方を固定PowerCopy+運用ルール固定しつつ微調整を許す時期尚早まず数を集めて数えるPowerCopyまだ揺れている形状設計意図が固まっているか ↑貼り付け後に中身を触らせるか →
教科書的な違いより、「誰が触るか」で決める。まずPowerCopyで運用し、使われ方が安定してからUDF化する順番が失敗しない。

PowerCopyを実際に作る——最小の手順と、つまずく一点

ここまで判断の話を書いてきたので、実際に作る手順も残しておきます。PowerCopyは、再利用したい形状を選んで「挿入」→「ナレッジ・テンプレート」→「パワーコピー」で定義します。ジオメトリカルセットやボディの単位でまとめておくと、選択が一度で済みます。定義したものはツリーに収まり、カタログに登録しておけば別のパートからも呼び出せます。貼り付け側では、入力に指定された要素を順番に選ぶだけで形状が生成されます。

つまずくのはほぼ一点で、入力に名前を付けないまま定義してしまうことです。既定の名前のままだと、貼り付けのダイアログに「平面」「点」と並ぶだけになり、どれに何を渡すのか作った本人以外に分かりません。定義に入る前に、入力になる基準要素へ用途が読める名前を付けておく。順番はこれが先です。前の節で書いた「入力は3つ以内」とあわせると、貼り付け作業そのものが説明不要になります。

なお、メニューの表記はCATIAの版と言語設定で違うことがあります。手元の環境で「ナレッジ・テンプレート」が見つからない場合は、ワークベンチが対応しているか(Part Design/GSDなど)を先に確認してください。UDFを作る手順も入口は同じで、定義の種類が変わるだけです。

コードは資産であると同時に負債である。
書かずに済むなら、書かないほうが速い。

テンプレートが壊れる原因はほぼ「参照の取り方」

PowerCopyやUDFが「貼り付けたら壊れた」となる原因は、9割が入力参照の設計にあります。テンプレートは、貼り付け先で何を参照するかを指定して使います。この参照の粒度と種類が適切でないと、少し形が違うだけで破綻します。

最も避けるべきは、面やエッジを直接参照させることです。貼り付け先のモデルで面の分割が変わると、参照が外れます。CATIAが持つ形状要素の識別は、モデルの作られ方に依存するからです。私たちは原則として、点・線・平面といった抽象度の高い要素を入力に取ります。

具体的には、貼り付け先に「接続用の基準要素」をあらかじめ用意させる設計にします。テンプレート側は必ずその基準要素だけを見る。現物の面ではなく、契約された基準を見る。ソフトウェア設計でいうインターフェースの考え方と同じです。これだけで、テンプレートの寿命が桁で変わります。

入力の数も重要です。参照が10個あるテンプレートは、使う側が10回正しく指定しなければならない。人間は間違えます。私たちは入力を3つ以内に収めることを目標にし、収まらない場合は「基準となる軸系を1つ渡す」形に集約します。使いやすさは正確さに直結します。

テンプレートを壊さない参照設計1貼り付け先に接続用の基準要素を用意させる軸系・点・平面をあらかじめ置く2テンプレートは基準要素だけを見る面やエッジの直接参照は禁止3入力は3つ以内に収める収まらなければ軸系1つに集約する41テンプレート1枚の説明を添える入力・出力・想定していない使い方
「貼り付けたら壊れた」の9割は入力参照の設計。現物の面ではなく、契約された基準を見せる。

PowerCopyで届かない線と、そこからマクロを足す設計

PowerCopyとUDFには、はっきり届かない領域があります。ひとつは繰り返しです。同じテンプレートを条件に応じて15回貼る、という処理はテンプレート自身にはできません。人が15回貼るか、マクロに貼らせるかです。

ふたつめは判断です。板厚が2.0以下ならAパターン、超えるならBパターン。この分岐はテンプレートの外側にしか置けません。みっつめは外部データとの連携。Excelの一覧を読んで、その内容に応じて配置を決めるといった処理です。

ここで私たちが取るのは、テンプレートを組み合わせる薄いマクロという構成です。形状を作るロジックは全部PowerCopy/UDF側に持たせ、マクロは「どれを、どこに、何回貼るか」だけを担当する。マクロのコード量は驚くほど小さくなり、形状の作り方を変えたいときはテンプレートを直すだけで済みます。

この構成の利点は保守の分担です。形状の知識を持つ設計者がテンプレートを管理し、私たちのようなツール側が制御部分を管理する。役割が分かれるので、どちらの側も自分の担当範囲だけを理解すれば済みます。数年後にツールを引き継ぐ人にとっても、読む量が圧倒的に少ない。

テンプレート+薄いマクロの構成外部データを読むExcelの一覧や仕様値条件で貼るテンプレートを選ぶ板厚2.0以下ならA、超えるならB基準要素を渡して繰り返し貼る15回でも人は間違えない結果を検証して異常なら止める生成数・更新状態を確認
形状を作るロジックはテンプレート側に全部持たせ、マクロは「どれを、どこに、何回貼るか」だけを担当する。
テンプレートとマクロの使い分け繰り返しの形状作業があるマクロを書かずに済むか先に検討する設計意図は固まっている?PowerCopy後から中身を直せるUDF中身を触らせない入力は基準要素だけ3つ以内に絞る繰り返し・判断・外部データが要る?薄いマクロを足すどれを・どこに・何回置き場・命名・説明1枚変更履歴をそろえるPowerCopyの使われ方が安定した?UDF化するテンプレート資産として運用いいえはいはいいいえはいいいえ
図4: 書かずに済むかを先に見て、テンプレートの種類と参照を決め、届かない部分だけ薄いマクロで補う。
VBA参考実装例:PowerCopy/UDFをマクロからインスタンス化する
' カタログからテンプレートを取り出し、基準要素を渡して繰り返し貼る
Sub InstantiateTemplate(catalogPath As String, tmplName As String, cnt As Integer)
  Dim part1 As Part
  Set part1 = CATIA.ActiveDocument.Part

  Dim factory As Object
  Set factory = part1.GetCustomerFactory("InstanceFactory")
  factory.BeginInstanceFactory tmplName, catalogPath   ' テンプレート名とカタログ

  ' 入力参照は面やエッジではなく、貼り付け先に用意した基準要素を渡す
  Dim ax As Object, pt As Object, inst As Object
  Set ax = part1.AxisSystems.Item("基準軸系")

  Dim i As Integer
  For i = 1 To cnt
    Set pt = part1.HybridBodies.Item("基準要素").HybridShapes.Item("配置点" & Format(i, "00"))

    factory.BeginInstantiate
    factory.PutInputData "基準軸系", ax     ' 入力名はテンプレート定義と一致させる
    factory.PutInputData "配置点", pt
    Set inst = factory.Instantiate
    inst.Name = "PC_" & tmplName & "_" & Format(i, "00")  ' 生成物と分かる命名
    factory.EndInstantiate
  Next

  factory.EndInstanceFactory
  part1.Update
End Sub

マクロ側のコード量は驚くほど小さくなります。形状の作り方を変えたいときは、このコードに触らずテンプレートを直すだけで済みます。

テンプレート資産を組織で運用するためのルール

PowerCopyとUDFは作るより運用のほうが難しいのが実態です。個人のフォルダに散らばったテンプレートは、半年で誰も使わなくなります。作った人しか使い方を知らないからです。私たちが必ず整備を提案する項目を挙げます。

第一に、格納場所の一元化と命名規則。用途と版が名前から分かること。第二に、1テンプレート1枚の説明。入力に何を渡すか、出力に何ができるか、想定していない使い方は何か。長い手順書は誰も読みません。1枚です。第三に、変更履歴。誰がいつ何を変えたか。

そして最も重要なのが、更新したときに既存の貼り付け済みモデルがどうなるかを明記することです。テンプレートを更新しても、過去に貼ったものは自動では変わりません。ここを理解せずに運用すると、同じ社内標準のはずの形状が世代ごとに違う、という管理不能な状態に陥ります。

私たちは自動車ボデー、建材、スポーツ用品、金型と、領域を問わずCAD自働化に関わってきました。分野が違っても、テンプレート運用が失敗する原因はほぼ同じです。作る技術ではなく、使い続ける仕組みが足りない。CATIAのPowerCopyとUDFは強力な機能ですが、それを資産にできるかは組織側の設計次第です。

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

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

Qronix 開発チーム

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

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

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

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