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

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

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

このようなコンポーネントテンプレートは、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 の検索時に使用され、コンポーネントテンプレートの内容をすばやく識別できるようになります。

Saving a Component Template

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 には何もリリースされません。

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

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

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

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

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

CMPT（Component Template）エディター

テンプレートの定義

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 を持つようにします。ここでの入力は、コンポーネントの自動命名用テンプレートとして使用されます（Component Editor を Single Component Editing モードで使用している場合は関連する Id フィールド、Batch Component Editing モードで使用している場合は Item ID フィールド）。ソフトウェアは、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 – Component 領域の Advanced Settings エリア内にある Id フィールドおよび Folder フィールド。
• Batch Component Editing mode – Document Options dialog の Document Options タブ上、およびその結果として、コンポーネント定義領域の Component エリア内にある Item ID フィールドと FolderPath フィールド。

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

パラメーターの定義

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

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

デフォルトのシステムパラメーター

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

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

• 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 – これら 2 つのパラメーターでは、それぞれデフォルトのシンボルモデルとフットプリントモデルを指定できます。各パラメーターの関連する Default Value フィールドをクリックし、続いて ボタンをクリックして、必要なモデルを選択するためのダイアログを開きます。

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

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

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

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

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

  これら 2 つのパラメーターのデータ型はいずれも Text に設定されており、変更できません。また、これらのパラメーターはコピーや削除ができません。

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

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

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

各パラメーターは、グリッド一覧で次の情報に基づいて表示されます。

• Name – このフィールドを使用してパラメーターに名前を付けます。通常は、その目的がわかる意味のある名前にします。追加直後のパラメーターには、デフォルト名（Parameter、Parameter 1、Parameter 2 など）が付与されます。
• Type – パラメーターのタイプです。初期状態ではこの項目は Text になりますが、さまざまな unit-aware data types がサポートされています。また、複数のフットプリントの definition of multiple footprints を容易にする PCBLIB 型や、harness wiring component の定義を容易にする HarnessWiring もサポートされています。利用可能な辞書で定義されたパラメータータイプもサポートされています。詳細はこちら。
• 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 回クリックすると昇順（その列の内容に基づく）でソートされ、もう 1 回クリックすると降順でソートされます。

複数列でソートすることもできます。すでに特定の列でソートされている状態で、別の列に対して Shift+Click すると、その列の内容に基づいて「サブソート」できます。

列のソートを解除するには、そのヘッダー上で Ctrl+Click します。

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

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

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

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

Supported Units

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

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

• 整数

• 小数

• アンペア (A)

• 面積 (mm²)

• ビット

• カンデラ (cd)

• 摂氏 (C)

• デシベル (dB)

• ファラド (F)

• グラム (g)

• ヘンリー (H)

• ヘルツ (Hz)

• ジュール (J)

• ルーメン (lm)

• メートル (m)

• ミリメートル (mm)

• オーム

• パーセント (%)

• パスカル (Pa)

• バール (bar)

• ポンド毎平方インチ (psi)

• 毎分回転数 (rpm)

• 秒 (s)

• ジーメンス (S)

• 温度係数 (ppm/°C)

• テスラ (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 コントロールをクリックしてアクセスできます。

Component Template Editor から、Workspace のブラウザーインターフェース内で辞書を管理するページにアクセスします。

定義済みの辞書は、Type ドロップダウンでパラメーター型として使用できます。

Type ドロップダウンで辞書定義パラメーター型を選択します。

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

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

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

Component Template Editor では、コンポーネントテンプレートの一部として複数の PCB フットプリントを定義することもサポートされています。任意の数のフットプリントモデルリンクを指定できるため、異なる密度レベルに対する IPC 要件を満たす 3 種類のフットプリントを参照するコンポーネントを作成したい場合に便利です。すなわち、L（最小、または minimum copper）、M（最大、または maximum copper）、および N（標準、または median copper）です。

テンプレートに追加のフットプリントモデル定義を追加するには、 をクリックして新しいパラメーターを追加し、次に 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 Mode の場合

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

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

Batch Component Editing Mode の場合

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

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

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

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

• コンポーネントエディターの 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 モード）で区別されます。さらに、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 ページからコンポーネントテンプレートを復元することも、完全削除することもできます。完全削除は、親 Item によって使用されていない場合にのみ可能です。