コンポーネントテンプレート

コンポーネント作成の効率化を支援するために、Altium Designer は connected Workspace と連携し、その Workspace 内で Component Templates （Component Template Item）を作成・定義する機能をサポートしています。参照先の回路図シート上の情報をあらかじめ定義するために回路図テンプレートを使用できるのと同様に、コンポーネントテンプレートは Workspace library component から参照され、そのコンポーネントを定義する際に使用する事前定義済み設定を提供します。

特に、コンポーネントテンプレートはパラメトリック情報を強く意識して設計されており、参照するコンポーネントで利用可能となるパラメータの「ひとまとめのセット」を単一の場所で定義できます。テンプレートを通じて、それらのパラメータのうちどれを表示するかを制御し、デフォルト値を入力し、さらに必須のパラメータを必須項目としてマークすることもできます。コンポーネント保存時には、準拠を確実にするための検証チェックが実行されます。

このようなコンポーネントテンプレートは、Workspace 内から直接作成されます。コンポーネントテンプレートを作成し（そのリビジョンにデータを保存し）た後は、1 つ以上のコンポーネントの作成時に再利用できます。

Folder Type

コンポーネントテンプレートを保存するフォルダを作成する際、そのフォルダのタイプを指定できます。これはフォルダの内容には影響しません。コンポーネントテンプレートをリリースすると、常に対応する Component Template Item が生成されます。これは単に、そのフォルダに何が保存されているかを視覚的に示す「手がかり」を提供するものであり、Workspace 内で特定のコンテンツを参照する際に役立ちます。フォルダをコンポーネントテンプレートの格納先として指定するには、Edit Folder dialog でフォルダのプロパティを定義する際に、その Folder Type を Component Templates に設定します。

フォルダタイプ、つまりその用途を指定することで、Workspace の参照時にそのフォルダの内容を視覚的に把握できます。

Item Naming Scheme

親フォルダに関するもう 1 つの重要な要素は、そのフォルダに適用される Item Naming Scheme です。これは、その特定のフォルダ内で作成される各 Item の一意 ID の形式を定義します。いくつかのデフォルトの命名スキーム例が用意されており、フォルダタイプの短縮コード（CTC – Component Template Collection）またはコンテンツタイプの短縮コード（CMPT – Component Template）を使用します。

• $CONTENT_TYPE_CODE-001-{0000} – 例: CMPT-001-0001。
• $CONTENT_TYPE_CODE-001-{A00} – 例: CMPT-001-A01。
• $FOLDER_TYPE_CODE-001-{0000} – 例: CTC-001-0001。
• $FOLDER_TYPE_CODE-001-{A000} – 例: CTC-001-A001。

デフォルトの命名スキームを使用すると、ソフトウェアは Workspace 全体と既存コンテンツの識別子をスキャンしたうえで、そのスキームに基づく次に利用可能な一意 ID を自動的に割り当てます。これは、コンポーネントテンプレートを手動で作成する際に大きな時間節約になります。

カスタムスキームも、フィールド内に直接入力するだけでフォルダに定義できます。その際、可変部分は中括弧で囲む必要があります（例: CMP-TMP-{0000}）。

親フォルダの Item Naming Scheme は、そのフォルダ内で作成される各 Item の Unique ID に適用されます。

親フォルダに適用される Item Naming Scheme はいつでも変更できます。変更後のスキームは、そのフォルダ内で以後新規作成されるコンテンツに適用されます。

Content Type

コンポーネントテンプレートを保存する対象の Component Template Item を作成する際は、Create New Item dialog でその Content Type が Component Template に設定されていることを確認してください。Component Templates タイプのフォルダ内で Item を作成する場合、このコンテンツタイプは Item 作成時の右クリックコンテキストメニューから利用できます。

Component Templates フォルダ内でコンポーネントテンプレートを作成する場合、正しい Content Type がコンテキストメニューで利用できます。

Item Lifecycle Definition and Revision Naming

Related pages: Defining Revision Naming Schemes for a Workspace, Defining Lifecycle Definitions for a Workspace

コンポーネントテンプレートを定義する際は、そのコンポーネントテンプレートに使用するライフサイクル管理の種類と、そのリビジョンに適用する命名スキームをそれぞれ必ず指定してください。

どのコンテンツタイプが特定のライフサイクル定義またはリビジョン命名スキームを使用できるかの制御は、各スキーマ定義時に Content Types ダイアログからグローバルレベルで定義および有効化できます。コンポーネントテンプレートにデフォルトで割り当てられるスキームは、それぞれ Generic Lifecycle および 1-Level Revision Scheme です。

テンプレート定義が Component Template Item の初期リビジョンに保存された後は、その特定の Item に対してこれらのスキームを変更することはできません。

必要なスキームは、Create New Item ダイアログで、それぞれ Lifecycle Definition フィールドおよび Revision Naming Scheme フィールドを使用して指定します。

コンテンツタイプごとにライフサイクル定義およびリビジョン命名スキームの使用を制御するオプションが、いずれかの定義/スキームで有効になっていて、かつ Component Template コンテンツタイプが特定の定義/スキームを使用するよう設定されていない場合、その定義/スキームは該当するドロップダウンリストには表示されません。

手動で作成したコンポーネントテンプレートに対して、Lifecycle Definition と Revision Naming スキームを選択している例。

Workspace 内のさまざまな種類の設計コンテンツ全体で、標準的なリビジョン命名スキームとライフサイクル定義を順守することで、これらのコンテンツを円滑かつ一貫して管理できます。

コンポーネントテンプレート定義の一部として、Name と Description を追加することをお勧めします。この情報は Workspace の検索時に使用され、コンポーネントテンプレートが何を提供するかをすばやく識別できます。

コンポーネントテンプレートの保存

Related page: Creating & Editing Content

ここまで、関連するフォルダタイプおよびコンテンツタイプの観点から、Workspace におけるコンポーネントテンプレートのサポートについて説明してきました。実際に定義したコンポーネントテンプレートを、そのような Component Template Item のリビジョンに保存することも、効率的な方法で実行できます。

コンポーネントテンプレートは、Workspace のダイレクト編集機能により、新規作成した Component Template Item の初期リビジョンに対して編集し保存できます。ダイレクト編集により、別個のバージョン管理されたソースデータに縛られる必要がなくなります。Workspace 自体から最新のソースを直接読み込んだ一時エディタを使用して、サポートされているコンテンツタイプをそのまま編集できます。編集完了後、そのエンティティは親 Item の次の予定リビジョンに保存（または再保存）され、一時エディタは閉じられます。ハードドライブ上にファイルは残らず、正しいまたは最新のソースで作業しているかを気にする必要もなく、別途バージョン管理ソフトウェアを維持する必要もありません。Workspace がこれらすべてを高い整合性で処理し、データ変更を大幅に迅速化します。

Component Template Item を作成する際、作成後にその Item の初期リビジョンへコンポーネントテンプレートを編集して保存するオプションがあります。これを行うには、Create New Item dialog の下部にある Open for editing after creation オプションを有効にします（デフォルトで有効）。Item が作成されると、一時的な Component Template Editor が開き、メイン設計ウィンドウで .CMPT ドキュメントがアクティブドキュメントとして表示されます。このドキュメントは、Item-Revision に従って次の形式で命名されます: <Item><Revision>.CMPT（例: CMPT-0001-1.CMPT）。

Workspace から直接コンポーネントテンプレートの初期リビジョンを編集している例。一時的な Component Template Editor により、コンポーネントテンプレートを定義するためのドキュメントが提供されます。

必要に応じて、このドキュメントを使用してコンポーネントテンプレートを定義してください。詳細は、Defining the Template を参照してください。

ダイレクト編集時には、関連する 3 つのコントロールがあり、Quick Access Bar（メインアプリケーションウィンドウ左上）または Component Template Standard ツールバーから簡単に利用できます。

• – Save Active Document。このボタンを使用すると、ドキュメントに加えた変更をローカルに保存できます。これにより、最終的に Workspace に保存する前に、後でさらに変更を加えるために現在の変更内容を保存しておくことができます。

• / – Save to Server。このボタンを使用すると、定義したコンポーネントテンプレートを Workspace に保存し、対象の Component Template Item の初期（予定）リビジョン内に格納できます。Edit Revision ダイアログが表示され、必要に応じて Name、Description の変更やリリースノートの追加を行えます。保存後、ドキュメントとエディタは閉じられます。ソースコンポーネントテンプレートを含むドキュメント *.CMPT は、その Item のリビジョンに保存されます。

  Save to Server コントロールは、Projects panel 内のコンポーネントテンプレートのエントリ右側にも便利に用意されています。
• / – Discard Local Changes。編集をキャンセルして加えた変更を破棄したい場合は、このボタンを使用します。ドキュメントとエディタは閉じられ、対象の Component Template Item には何もリリースされません。

これらのコントロールはコマンドとしても利用でき、メインの File メニューおよび Projects パネル内のコンポーネントテンプレートのエントリの右クリックメニューから、Save（ショートカット: Ctrl+S）、Save to Server（ショートカット: Ctrl+Alt+S）、および Discard Local Changes として使用できます。

Workspace に保存されるデータは、Component Template ファイル（<Item><Revision>.CMPT）で定義されたソースコンポーネントテンプレートで構成されます。

定義済みコンポーネントテンプレートを Workspace に保存した例。

コンポーネントテンプレートの継承

サブタイプにコンポーネントテンプレートがリンクされていない場合、ルートコンポーネントタイプのコンポーネントテンプレートを使用できます。コンポーネントタイプの階層を構築すると、コンポーネントのサブタイプはルート/親コンポーネントタイプに割り当てられたコンポーネントテンプレートを継承します。

The CMPT (Component Template) Editor

テンプレートの定義

Component Template Editor は基本的に 2 つの主要な領域に分かれており、以下の図に示し、その後で概要を説明します。

Component Template Editor は大きく 2 つの主要領域に分けられます。

1. Upper Region – テンプレートを参照するコンポーネントに対するコンポーネントレベルのオプション（ライフサイクル、命名、フォルダーオプション）を定義するための領域です。
2. Lower Region – テンプレートを参照するコンポーネントで使用するパラメーターを定義するための領域です。

コンポーネントオプションの指定

エディターの上半分は、次のコンポーネントプロパティの既定値を定義するための領域です。

• Lifecycle Definition – テンプレートを使用して作成されるコンポーネントに適用するライフサイクル定義を選択します。ドロップダウンフィールドには、Workspace に定義されていて、コンポーネントでの使用が許可されているすべての定義が一覧表示されます。
• Revision Naming – テンプレートを使用して作成されるコンポーネントに適用するリビジョン命名スキームを選択します。ドロップダウンフィールドには、Workspace に定義されていて、コンポーネントでの使用が許可されているすべてのスキームが一覧表示されます。

• Component Naming – このフィールドを使用して、テンプレートを使用して作成されるコンポーネントの既定の Item Naming Scheme を定義し、Workspace 内で生成されるコンポーネントに一意の ID を保証します。ここで入力した内容は、コンポーネントを自動命名するためのテンプレートとして使用されます（関連する Id フィールド内。Component Editor を Single Component Editing モードで使用している場合、または Item ID フィールド内。Component Editor を Batch Component Editing モードで使用している場合）。ソフトウェアは、そのスキームに基づいて、Workspace 全体と既存コンテンツの識別子をスキャンし、次に利用可能な一意 ID を自動的に割り当てます。既定の Item naming scheme – CMP-{00000} – が用意されていますが、もちろんフィールド内に直接入力して独自のスキームを作成することもできます。その際、可変部分は中括弧で囲む必要があります（例: CMP-001-{0000}）。
• Default Folder – 保存したコンポーネントを格納する対象 Workspace 内の既定フォルダーを指定します。これを行うには、Choose ボタンをクリックして Choose Folder ダイアログ（Explorer panel の一形態）を開き、そこから Workspace 内の既存フォルダーを参照して選択するか、その場で新しいフォルダーを作成します。

テンプレートが参照されると、この領域で指定したエントリは、Component Editor 内の該当フィールド（利用可能な場合）に事前入力されます。

• Single Component Editing mode – Advanced Settings 領域の Component リージョン内にある Id フィールドおよび Folder フィールド。
• Batch Component Editing mode – Document Options dialog の Document Options タブ上、およびその結果としてコンポーネント定義領域の Component エリア内にある Item ID フィールドと FolderPath フィールド。

テンプレートが参照されると、これらのエントリは、Component Editor の Single Component Editing モード（左）および Batch Component Editing モード（右）でコンポーネントを編集する際に、該当フィールドへ事前入力するために使用されます。

パラメーターの定義

エディターの下半分は、参照するコンポーネントで利用可能になるパラメーターを定義および管理するための領域です。

コンポーネントテンプレートで定義されたパラメーターの例。

既定のシステムパラメーター

新しいコンポーネントテンプレートを作成すると、既定でさまざまなシステムパラメーターが含まれます。以下の図に示し、その後で詳しく説明します。

新規作成されたコンポーネントテンプレートに含まれる既定のシステムレベルパラメーター。

• ComponentType – このパラメーターではコンポーネントのタイプを指定できます。これにより、Workspace の強力な Search facility を使った対象検索が容易になります。この機能ではコンポーネントタイプによる検索だけでなく、サポートされている unit-aware component parameters を使った、より高度な検索も可能です。Components panel を使用して自分の Workspace コンポーネントを参照する場合、コンポーネントの Categories グループ化は、各コンポーネントに関連付けられた ComponentType パラメーターから導き出されます。関連する Default Value フィールドをクリックし、次に ボタンをクリックして Choose component type ダイアログを開きます。ここで必要なコンポーネントタイプを選択し、OK をクリックすると、選択したタイプがメインのパラメーターグリッドに戻って ComponentType パラメーターの値として挿入されます。

  Choose component type ダイアログには、Preferences ダイアログの Data Management – Component Types page で定義されたコンポーネントタイプのセットが反映されます。Choose component type ダイアログの下部にある ボタンをクリックすると、この設定ページにアクセスできます。ここでは、新しいタイプやサブタイプを追加したり、既存のタイプを編集または削除したりして、この一覧をニーズに合わせて調整できます。

  
  ComponentType システムパラメーターが Diodes に設定された Component Template の例。

  このパラメーターのデータ型は ComponentType に設定されており、変更できません。また、ComponentType パラメーターはコピーまたは削除できません。セルを選択し、Delete キーを使用して値をクリアしてください。

• SCHLIBPCBLIB および PCBLIB – これら 2 つのパラメーターでは、それぞれ既定のシンボルモデルとフットプリントモデルを指定できます。各パラメーターに関連付けられた Default Value フィールドをクリックし、次に ボタンをクリックして、必要なモデルを選択するためのダイアログを開きます。

  ここで選択するのはモデルであり、そのモデルの特定のリビジョンではない点に注意してください。このため、テンプレートを使用するコンポーネントは常に選択したモデルの最新リビジョンを使用します。

  
  テンプレートの一部としてシンボルモデルとフットプリント モデルを指定します。

  これらのパラメーターのデータ型はそれぞれ SCHLIB および PCBLIB に設定されており、変更できません。また、モデルパラメーターはコピーまたは削除できません。 セルを選択し、Delete キーを使用して値をクリアしてください。

• NamePCBLIB および Description – これら 2 つのパラメーターでは、それぞれコンポーネントの名前と説明を定義できます。各パラメーターに関連付けられた Default Value フィールドに必要な文字列を入力してください。

  
  テンプレートの一部として Name および Description パラメーターを指定します。

  これら両方のパラメーターのデータ型は Text に設定されており、変更できません。また、これらのパラメーターはコピーまたは削除できません。

新しいユーザーパラメーターの追加

リストに新しいユーザーパラメーターを追加するには、 ボタンをクリックするか（または右クリックのコンテキストメニューから Add コマンドを使用します）、パラメーターが現在のリストの一番下に追加されます。

テンプレートへの新しいユーザーパラメーター追加例。

各パラメーターは、グリッド一覧内で次の情報として表示されます。

• Name – このフィールドを使用してパラメーター名を付けます。通常は、その目的が分かる意味のある名前にします。最初に追加されたとき、パラメーターには既定名（Parameter、Parameter 1、Parameter 2 など）が付けられます。
• Type – パラメーターのタイプです。このエントリは最初は Text が既定になりますが、さまざまな unit-aware data types がサポートされているほか、PCBLIB 型（definition of multiple footprints を容易にする）や、HarnessWiring 型（harness wiring component の定義を容易にする）もサポートされています。利用可能な辞書で定義されたパラメータータイプもサポートされています。– 詳細はこちら。
• Visible – このオプションを有効にすると（新しく追加されたパラメーターでは既定で有効）、Component Editor で 1 つ以上のコンポーネントを編集する際（Batch Component Editing モードに設定時）に、そのパラメーターに対応する Show オプションが有効になります。これにより、Component Editor の下部領域に、そのパラメーターに対応する列が表示されます。そこではコンポーネント定義自体が定義されます。このプロパティは、エディターの Single Component Editing モードを使用してコンポーネントを定義する場合には影響しません。
• Read Only – このオプションを有効にすると、パラメーターは読み取り専用になります。テンプレートを参照するコンポーネントを編集する際、そのパラメーターの値は編集不可になります。
• Required – このオプションを有効にすると、そのパラメータは「必須パラメータ」になります。このテンプレートを参照するコンポーネントを編集する際、そのパラメータには値が定義されている必要があります。そうでない場合、コンポーネントを保存できません。Component Editor では、このようなパラメータは、値が未入力のときに、値セルが赤い枠線で表示される（Batch Component Editing モードの場合）か、 アイコンが表示される（Single Component Editing モードの場合）ことで区別されます。

• Default Value – このフィールドを使用して、パラメータのデフォルト値を入力します。

  • パラメータが必須としてマークされており（Required オプションが有効）、さらに読み取り専用にも設定されている場合（Read Only オプションが有効）、デフォルト値は MUST 入力する必要があります。そうしないと、このテンプレートを参照するコンポーネントを編集する際、そのパラメータは値がないものとしてフラグ付けされますが、読み取り専用で編集できないため解決できません。これが解決されるまで、このコンポーネントテンプレートの新しいリビジョンを Workspace に保存することはできません。
  • コンポーネントのリビジョンを編集する際、リンクされたコンポーネントテンプレート内のパラメータと同じ名前を持つ既存のユーザー定義パラメータは、テンプレート版に置き換えられます。そのパラメータに既存の値がある場合は保持され（テンプレート内のデフォルト値で上書きされません）。
  • デフォルトのハーネス配線モデルは、他のデフォルトモデル（SCHLIB または PCBLIB）がテンプレートに追加されていない場合にのみ追加できます。逆に、デフォルトのハーネス配線モデルがテンプレートに追加されている場合は、SCHLIB および PCBLIB のデフォルトモデルは追加できません。
• Description – パラメータの説明を追加します。たとえば、そのパラメータが何を提供するかについての簡潔な注記などです。テンプレート内のパラメータに説明が定義されている場合、Component Editor の Parameters 領域にある Description 列が、その Single Component Editing に応じて表示されます。

パラメータ一覧では、シンプルなコピー＆ペースト操作もサポートされており、既存のユーザーパラメータを 1 つまたは複数複製できます。貼り付けられたパラメータは一覧の末尾に追加されます。

Column Ordering and Sizing

列の順序はカスタマイズできます。列ヘッダーをクリックし、水平方向にドラッグして目的の新しい位置へ移動します。有効な位置は縦方向の位置矢印で強調表示されます。

列の幅は、その列ヘッダー内の右側の区切りをクリックしてドラッグすることで変更できます。

Sorting

パラメータは、特定の列のヘッダーをクリックすることで、その列に基づいて並べ替えることができます。1 回クリックすると昇順（その列の内容に基づく）で並べ替えられます。もう一度クリックすると降順で並べ替えられます。

複数列での並べ替えも可能です。すでに特定の列でパラメータが並べ替えられている状態で、別の列に対して Shift+Click すると、その列の内容による「サブソート」が行われます。

列の並べ替えを解除するには、そのヘッダー上で Ctrl+Click します。

単位対応コンポーネントパラメータのデータ型

Component Template Editor では、コンポーネントテンプレート内で定義されたコンポーネントパラメータ（*.CMPT）に対して、明示的なデータ型を定義できます。さらに、これらのデータ型は単位対応であり、一般的な単位接頭辞を幅広くサポートしています。そのため、2.2k、2k2、4M、2.5GHz など、さまざまな形式でパラメータ値を入力でき、Workspace はそれらの入力の背後にある数値を適切に認識します。

このコンポーネントテンプレートの機能により、サーバーの Advanced Search facility を使用した対象を絞った検索が可能になります。この機能では、コンポーネントタイプによる検索だけでなく、範囲検索によるより高度な検索も行えます。単位対応コンポーネントパラメータの力を利用することで、たとえば静電容量が 47uF ～ 220uF のすべてのコンデンサを見つける検索をすばやく定義できます。

以下の折りたたみ可能なセクションを使用して、単位対応パラメータについて詳しく確認してください。

Supported Units

コンポーネントテンプレートの一部としてユーザーパラメータを定義する際、以下の単位対応データ型がサポートされます。

• ほとんどのデータ型には単位（括弧内）が付いています。パラメータ値の入力時に単位が指定されていない場合は、この単位が適用されます。

• なお、以下の一覧で太字で示されているデータ型は、Altium Platform 上の接続された Workspace 内のコンポーネントテンプレートでのみ使用できます。

 

 

 

 

 

• Integer

• Decimal

• アンペア (A)

• Area (mm²)

• Bit

• Candela (cd)

• 摂氏 (C)

• デシベル (dB)

• ファラド (F)

• グラム (g)

• ヘンリー (H)

• ヘルツ (Hz)

• Joule (J)

• Lumen (lm)

• メートル (m)

• Millimetre (mm)

• オーム

• パーセント (%)

• Pascal (Pa)

• Bar (bar)

• Pounds per square inch (psi)

• Rotations per minute (rpm)

• 秒 (s)

• Siemens (S)

• Tesla (T)

• ボルト (V)

• ワット(W)

Supported Unit Prefixes

以下の表は、単位対応パラメータ型の値を入力する際にサポートされる単位接頭辞を示しています。

接頭辞	名称	値（科学表記）	値（通常表記）
T	テラ	1 x 1012	1,000,000,000,000
G	ギガ	1 x 109	1,000,000,000
M	メガ	1 x 106	1,000,000
k	キロ	1 x 103	1,000
m	ミリ	1 x 10-3	1 / 1,000
u	マイクロ	1 x 10-6	1 / 1,000,000
n	ナノ	1 x 10-9	1 / 1,000,000,000
p	ピコ	1 x 10-12	1 / 1,000,000,000,000
f	フェムト	1 x 10-15	1 / 1,000,000,000,000,000

一部またはすべての単位接頭辞は、パラメータ型によっては適用できない場合があることに注意してください。たとえば、パーセンテージには単位接頭辞は使用できません。単位接頭辞の使用が無効な場合、ソフトウェアが警告を表示します。

Adding a Unit-aware Component Parameter

テンプレートにパラメータを追加する際（Parameters 領域で をクリック）、関連する Type フィールドを使用して、ドロップダウンから必要な単位対応データ型を選択します。

コンポーネントテンプレート内のユーザーパラメータに対して、サポートされている単位対応データ型を選択します。この例では、Ampere がパラメータ型です。

単位対応データ型を使用するコンポーネントパラメータの値を入力する際は、コンポーネントテンプレート内の Default Value として入力する場合でも、コンポーネント定義内の必要な値として入力する場合でも、以下の点を考慮してください。

• 値はさまざまな形式で入力できます。
  • 数値のみ（例: 10）。データ型に単位がある場合、その単位は自動的に適用されます。単位を持つ型では、型名の後ろの括弧内に単位が示されています。
  • 科学表記による数値（例: 1e10, 1E6)。
  • 数値と単位（例: 10F)）。
  • 接頭辞付きの数値（例: 10k）。適切な単位は自動的に追加されます（該当する場合）。
  • 接頭辞と単位付きの数値（例: 10kF）。
  • 一般的なエンジニアリング表記の接頭辞付き数値（例: 抵抗値の場合: 2k2、2K2、10r2、10R2）。値はそれに応じて自動的に正規化されます（例: 2K2 は 2.2k になります）。
• 数値の後にスペースを入れても入れなくても、接頭辞や単位を入力できます（例: 10uF、または 10 uF）。スペースは自動的に削除されます。

エンジニアリングの略記は大文字・小文字を区別しないため、2k2 を入力しても 2K2 を入力した場合と同じであり、100R を入力しても 100r を入力した場合と同じです。唯一の例外は M（Mega）と m（milli）です。

Data Validation

コンポーネントパラメータに単位対応データ型が使用されている場合、入力された値は指定されたデータ型に対して検証されます。これにより、そのデータ型に対して正しい測定単位が使用されていることが保証されます。たとえば、型 Celsius のパラメータに 10V という値を設定することはできません。

検証は、単位対応データ型を持つコンポーネントパラメータが使用され、そのパラメータに値が指定されるあらゆる場所で実行されます。

• コンポーネントテンプレートでパラメータのデフォルト値を定義するとき。
• Component Editor でコンポーネント定義の一部としてパラメータ値を定義するとき。
• 保存済み検索スキームの一部として、パラメータ値に基づく範囲検索を設定するとき。

Component Template Editor におけるデータ検証の動作例。

辞書定義パラメータデータ型

辞書は、複数の定義済み値を持つカスタムパラメータ型です。辞書は Workspace 管理者によって、Workspace のブラウザインターフェースの Settings – Vault – Dictionaries ページで管理されます。このページには、Component Template editor から Type ドロップダウンで Add New Dictionary オプションを選択するか、Parameters 領域右上の Manage Dictionaries コントロールをクリックしてアクセスできます。

選択した辞書定義型に対して定義されている値は、Default Value ドロップダウンで利用できます。必要な値を選択してパラメータのデフォルトとして使用するか、<None> を選択します。

選択した辞書定義型に対して定義されている値の中からデフォルト値を選択します。

複数フットプリントの定義

Component Template Editor は、コンポーネントテンプレートの一部として複数の PCB フットプリントを定義する機能も提供します。フットプリントモデルリンクはいくつでも指定でき、異なる密度レベルに対する IPC 要件を満たす 3 種類のフットプリントを参照するコンポーネントを作成したい場合に便利です: L（最小、または最少銅量）、M（最大、または最多銅量）、および N（公称、または中間銅量）。

テンプレートに追加のフットプリントモデル定義を追加するには、 をクリックして新しいパラメータを追加し、次に Type フィールドに関連付けられたドロップダウンメニューで PCBLIB エントリを選択します。

新しく追加したパラメータの Type を PCBLIB に設定して、フットプリントモデル定義にします。

参照された Component Template を使用して Component Editor（Single Component Editing モード）で定義されたコンポーネントの例。テンプレートには 3 つのフットプリントモデルが定義されており、それらがコンポーネント定義に取り込まれています。コンポーネント定義時には、テンプレート内の PCBLIB モデルエントリがデフォルトのフットプリントモデルとして使用されていることに注目してください（左上のアイコンで識別されます）。画像にカーソルを合わせると、同じコンポーネントが Component Editor の Batch Component Editing モードで定義されている様子を確認できます。この場合、デフォルトのフットプリントは PCBLIB (default) と呼ばれます。

コンポーネントテンプレートのインポートとエクスポート

既存のコンポーネントテンプレートファイル（*.CMPT）またはコンポーネントライブラリファイル（*.CMPLIB）は component template editor にインポートでき、編集中のコンポーネントテンプレートはコンポーネントテンプレートファイル（*.CMPT）としてエクスポートできます。目的の操作を選択するには、component editor のメインメニューにある File » Import » Component Template、File » Import » Component Library、および File » Export コマンドを使用し、開いた標準 Windows ダイアログで必要な場所を参照して、インポートするファイルを選択するか、エクスポートするファイル名を指定します。

コンポーネントテンプレートの再利用

コンポーネントテンプレートのリビジョンを使用する、より正確には現在編集中のコンポーネントのリビジョンからそれを参照する方法には、以下のものがあります。

新しいコンポーネントを作成するとき

メインメニューの File » New » Component コマンドを使用して新しいコンポーネントを作成する際、Create new component ダイアログでテンプレートを選択できます。

新しいコンポーネントを作成する際、利用可能なすべてのテンプレートの一覧からコンポーネントテンプレートをすばやくリンクできます。

Component Editor 内から手動で

Component Editor からコンポーネントテンプレートのリビジョンを再利用する方法は、Editor の動作モードによって異なります。

Single Component Editing モードの場合

Component Editor のこのモードで単一コンポーネントを編集する場合は、Editor の Component 領域にある Advanced Settings グループ内の Template フィールドに関連付けられたドロップダウンメニューから、必要な Component Template を選択します。コンポーネント自体が存在するのと同じ Workspace で現在利用可能なすべてのコンポーネントテンプレートが、名前と最新リビジョン（括弧内）付きで一覧表示されます。必要なテンプレートを選択して適用します。

Component Editor の Single Component Editing モードでコンポーネントのリビジョンを編集する際に、利用可能なすべてのテンプレートのメニューからコンポーネントテンプレートをすばやくリンクする。

バッチコンポーネント編集モードの場合

現在編集中のコンポーネントリビジョンに Component Template のリビジョンを「関連付ける」方法は 2 つあります。

• Document Options dialog（Edit » Document Options）の Template タブから行う方法。Item Revision フィールドの右側にある Choose ボタンをクリックします。これにより Choose Item ダイアログ（Explorer panel の一形態）にアクセスできます。このダイアログを使用して、必要なコンポーネントテンプレートのリビジョンを参照して選択します。OK をクリックすると、コンポーネントのリビジョンと対象のコンポーネントテンプレートのリビジョンの間にリンクが作成されます。このリンクは、Document Options ダイアログの Template タブに戻ることで確認できます。

  
  対象 Workspace で、コンポーネントをコンポーネントテンプレートのリビジョンに手動でリンクする。

  使用するコンポーネントテンプレートはいつでも変更できます。Choose をクリックし、別のコンポーネントテンプレートのリビジョンを選択してください。
  リンクされた Component Template Item Revision のステータスは、Document Options ダイアログの Template タブに反映されます。リンク先 Item のより新しいリビジョンが利用可能な場合は、 ボタンをクリックしてその最新リビジョンを使用します。

• Component Editor の Required Models/Parameters 領域に関連付けられた Add メニューから行う方法。Templates サブメニューには、コンポーネント自体が存在するのと同じ Workspace で現在利用可能なすべてのコンポーネントテンプレートが、名前と最新リビジョン（括弧内）付きで一覧表示されます。項目をクリックすると、そのコンポーネントテンプレートの最新リビジョンへのリンクが作成されます。ここでも、リンクは Document Options ダイアログの Templates タブで確認できます。

  
  利用可能なすべてのテンプレートのメニューからコンポーネントテンプレートをすばやくリンクする。

Components Workspace Folder から継承

Workspace 内の Components フォルダーに保存されるすべてのコンポーネント（およびそのリビジョン）に対して、自動的に使用するコンポーネントテンプレートを指定できます。

Edit Folder dialog でフォルダーのプロパティを定義する際に、Component Template フィールドを使用して必要なテンプレートを指定します。このフィールドに関連付けられたドロップダウンには、Components フォルダー自体が存在するのと同じ Workspace で現在利用可能なすべてのコンポーネントテンプレートが、名前と最新リビジョン（括弧内）付きで一覧表示されます。項目を選択すると、そのフォルダー内で以後作成される各コンポーネントについて、そのコンポーネントテンプレートの最新リビジョンへのリンクが作成されます。

親 Components フォルダー内で作成されるすべてのコンポーネントに適用される、デフォルトのコンポーネントテンプレートを指定する。

フォルダーレベルで Component Template を選択すると、下位の子サブフォルダーでコンポーネントを作成する際にも、デフォルトで同じテンプレートが使用されます。これにより、子フォルダー内のすべてのコンポーネントへテンプレートをすばやく継承できます。

Component Template 使用時のコンポーネントモデルおよびパラメーターへの影響

コンポーネントのリビジョンを編集していて、コンポーネントテンプレートのリビジョンがリンクまたは参照されている場合、モデルおよびパラメーターに関して Component Editor 内では次のようになります。

• 参照されているテンプレート内で定義されたモデルは、Models 領域（Single Component Editing モード）および Model Links 領域（Batch Component Editing モード）に追加されます。
• 既存の参照モデルは保持され、意図的に手動変更しない限り、コンポーネントはそのモデルを引き続き使用します。

• 参照されているテンプレート内で定義されたパラメーターは、Parameters 領域（Single Component Editing モード）および Required Models/Parameters 領域（Batch Component Editing モード）に追加されます。

  
  Component Editor を Single Component Editing モード（左）および Batch Component Editing モード（右）で使用した際に、コンポーネントテンプレートのリビジョンへリンクした後のパラメーター例。

  参照されているコンポーネントテンプレートに由来するすべてのパラメーターは、 アイコン（Single Component Editing モード）および アイコン（Batch Component Editing モード）によって区別されます。さらに、バッチコンポーネント編集モードに限り、各テンプレートベースのパラメーターの Show オプションは、テンプレート内の対応する Visible オプションの状態に従います。
  テンプレートベースのパラメーターは削除できません。
  必要に応じて追加のユーザーパラメーターを自由に追加できます。

• Batch Component Editing モードのみでは、表示するよう設定されたテンプレートベースのパラメーターはエディターのコンポーネント定義領域内でまとめてグループ化され、見出しテキストとして Template Parameters が使用されます。

  
  Component Editor の Batch Component Editing モード使用時に、コンポーネント定義そのものを定義する領域に表示されるテンプレートベースのパラメーターの例。

• 読み取り専用としてマークされたテンプレートベースのパラメーターの値フィールドは編集できません。読み取り専用としてマークされていないその他のテンプレートベースのパラメーターについては、必要に応じて自由に値を変更できます。

  Component Editor が Single Component Editing モードの場合、読み取り専用テンプレートパラメーターは Parameters 領域で アイコンによって区別されます。

• テンプレートベースのパラメーターが必須としてマークされているにもかかわらず、テンプレート内で値が設定されていない場合、その値フィールドは赤い枠で表示される（Batch Component Editing モード）か、 アイコンを含んで表示されます（Single Component Editing モード）。これにより、このパラメーターには値が必要であることが通知されます。必須パラメーターすべてに値が定義されるまで、コンポーネントを Workspace に保存することはできません。

  Component Editor が Single Component Editing モードの場合、必須テンプレートパラメーターは Parameters 領域で アイコンによって区別されます。

Component Template の再保存

どの段階でも、Workspace 内のコンポーネントテンプレートの任意のリビジョンに戻って、それを直接編集できます。リビジョンを右クリックし、コンテキストメニューから Edit コマンドを選択します。再び一時エディターが開き、そのリビジョンに含まれるテンプレートが編集用に開かれます。必要に応じて変更を加え、その後コンポーネントテンプレートを Item の次のリビジョンとして保存します。

既存のコンポーネントテンプレートのリビジョンを直接編集するコマンドにアクセスする。

保存済みデータのダウンロード

コンポーネントテンプレートのリビジョンに保存されているデータをダウンロードするには、（Explorer パネル内で）そのリビジョンを右クリックし、コンテキストメニューから Operations » Download コマンドを選択します。コンポーネントテンプレートファイルは、選択したディレクトリ配下のサブフォルダーにダウンロードされ、その名前には Item Revision ID が使用されます。ファイルはその中の Released フォルダーにあります。

ソフト削除

Workspace に接続している場合、Altium Designer 内の Explorer panel から直接コンポーネントテンプレートを削除するための柔軟な機能を利用できます。パネル内のコンポーネントテンプレートのエントリーを右クリックし、コンテキストメニューから Delete Item コマンドを選択します。削除を確認するための Delete Items ダイアログが表示されます。この操作は実際には「ソフト削除」であり、コンポーネントテンプレートは Workspace の Trash 領域へ移動されます。Trash は本質的にはごみ箱であり、Workspace 内のあらゆるコンテンツを（ソフト削除操作によって）移動できます。これは Workspace の他の部分から分離されています。

コンポーネントテンプレートのソフト削除。テンプレートは Workspace の Trash 領域へ移動されます。

削除を実行するには、 ボタンをクリックします。アイテムは削除され、Deletion Summary ダイアログで削除成功が確認されます。削除に問題があった場合は、その旨が通知されます。

この方法で削除されたすべてのコンテンツは、Workspace のブラウザーインターフェースの Trash ページで確認できます。なお、表示できるのは自分自身がソフト削除したコンテンツのみです。管理者は Trash ページの全コンテンツ、つまりソフト削除されたすべてのコンテンツを確認できます。

ソフト削除されたコンポーネントテンプレートに関して考慮すべき点:

• そのコンポーネントテンプレートは、設計ソフトウェアからも Web インターフェース内からも利用できなくなります。
• そのコンポーネントテンプレートが使用されていた箇所では、コンポーネントテンプレートが削除されたことが反映されます。
• コンポーネントテンプレートは、編集権限があれば Trash ページから復元することも、完全に削除することもできます。完全削除は、そのテンプレートが親アイテムによって使用されていない場合にのみ可能です。