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

Altium Designerは、接続されたワークスペースと連携して、そのワークスペース内でコンポーネントテンプレート（コンポーネントテンプレートアイテム）の作成と定義をサポートし、コンポーネントの作成を効率化するのに役立ちます。回路図テンプレートがそれを参照する回路図シート上の情報を

事前に定義するのと同様に、コンポーネントテンプレートはワークスペースライブラリコンポーネントによって参照され、そのコンポーネントを定義する際に使用する事前定義された設定を提供します。

特に、コンポーネントテンプレートはパラメトリック情報を念頭に置いて開発されており、参照するコンポーネントに利用可能になるパラメータの「バケットセット」を一か所で定義できます。テンプレートを通じて、どのパラメータを表示するか、デフォルト値を入力し、必須としてマークするパラメータをさえ制御できます。コンポーネントの保存時には、遵守を確保するための検証チェックが行われます。

このようなコンポーネントテンプレートは、ワークスペース内から直接作成されます。コンポーネントテンプレートが作成され（そしてそのリビジョンにデータが保存されると）、一つまたは複数のコンポーネントの作成に再利用できます。

フォルダタイプ

コンポーネントテンプレートを格納するフォルダを作成する際には、フォルダのタイプを指定できます。これはフォルダの内容には影響しません – コンポーネントテンプレートのリリースは常に対応するコンポーネントテンプレートアイテムを結果として生み出します。これは単にフォルダに格納されているものが何かについての視覚的な「手がかり」を提供し、特定のコンテンツをワークスペースで閲覧する際に有益です。フォルダの使用目的をコンポーネントテンプレートのコンテナとして指名するには、Edit Folderダイアログでフォルダのプロパティを定義する際に、そのFolder TypeをComponent Templatesとして設定します。

フォルダタイプを指定する – その使用目的 – は、ワークスペースを閲覧する際にそのフォルダの内容についての視覚的な表示を提供します。

コンテンツタイプ

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

コンポーネントテンプレートフォルダ内にComponent Templatesを作成すると、コンテキストメニューに正しいContent Typeが表示されます。

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

関連ページ：コンテンツの作成と編集

これまで、関連するフォルダーとコンテンツタイプの観点から、ワークスペースにおけるコンポーネントテンプレートのサポートについて議論してきました。このようなコンポーネントテンプレートアイテムのリビジョンに実際に定義されたコンポーネントテンプレートを保存することは、効率的に行うことができます。

コンポーネントテンプレートは編集され、新しく作成されたコンポーネントテンプレートアイテムの初期リビジョンに保存できます。これは、ワークスペースの直接編集のサポートのおかげです。直接編集により、別々のバージョン管理されたソースデータの束縛から解放されます。ワークスペースから直接最新のソースを読み込んだ一時的なエディタを使用して、サポートされているコンテンツタイプを単純に編集できます。そして、編集が完了すると、そのエンティティは親アイテムの次の計画されたリビジョンに保存（または再保存）され、一時的なエディタは閉じられます。ハードドライブ上にファイルはなく、正しいまたは最新のソースで作業しているかどうかを疑問に思うこともなく、別々のバージョン管理ソフトウェアを維持する必要もありません。ワークスペースがすべてを処理し、高い整合性を持って、データの変更を大幅に迅速化する方法で行います。

コンポーネントテンプレートアイテムを作成するとき、作成後にそのアイテムの初期リビジョンにコンポーネントテンプレートを編集して保存するオプションがあります。そのためには、デフォルトで有効になっているOpen for editing after creationオプションをCreate New Itemダイアログの下部で有効にします。アイテムが作成され、一時的なコンポーネントテンプレートエディタが開き、メインデザインウィンドウにアクティブなドキュメントとして.CMPTドキュメントが表示されます。このドキュメントは、<Item><Revision>.CMPTの形式でアイテムリビジョンに従って名前が付けられます（例：CMPT-0001-1.CMPT）。

ワークスペースから直接コンポーネントテンプレートの初期改訂を編集する例 - 一時的なコンポーネントテンプレートエディタは、コンポーネントテンプレートを定義するための文書を提供します。

必要に応じて、ドキュメントを使用してコンポーネントテンプレートを定義します。これを行う方法の詳細については、テンプレートの定義を参照してください。

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

•  – アクティブドキュメントを保存。このボタンを使用して、ドキュメントに加えた変更をローカルに保存します。これにより、後でさらに変更を加えるために戻ってくる場合に、現在の変更を保存できます。最終的にワークスペースに保存する前に。

• / – サーバーに保存。このボタンを使用して、定義されたコンポーネントテンプレートをワークスペースに保存し、対象のコンポーネントテンプレートアイテムの初期（計画中の）リビジョン内に格納します。リビジョンの編集ダイアログが表示され、必要に応じて名前、説明を変更し、リリースノートを追加できます。保存後、ドキュメントとエディタは閉じられます。ソースコンポーネントテンプレートを含むドキュメント、*.CMPTは、アイテムのリビジョンに格納されます。

• ​/ ​ – ローカル変更を破棄。編集をキャンセルし、行われた変更を破棄したい場合はこのボタンを使用します。ドキュメントとエディタは閉じられ、対象のコンポーネントテンプレートアイテムには何もリリースされません。

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

ワークスペースに保存されたデータには、コンポーネントテンプレートファイル（<Item><Revision>.CMPT）で定義されたソースコンポーネントテンプレートが含まれます。

ワークスペースに保存された定義済みコンポーネントテンプレートの例。

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

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

CMPT（コンポーネントテンプレート）エディタ

コンポーネントテンプレート自体は、Component Template Editorを使用して定義されます。この一時的なエディタは、専用の拡張機能 – コComponent Template Editor拡張機能を通じて提供されます。

Component Template Editor拡張機能。

テンプレートの定義

コンポーネントテンプレートエディタは、主に次の画像に示され、その後要約される2つの主要な領域に分かれています。

コンポーネントテンプレートエディタは大まかに2つの主要な領域に分けられます。

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

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

エディタの上半分は、次のコンポーネントプロパティのデフォルト値を定義するために専用されています：

• Lifecycle Definition – テンプレートを使用して作成されたコンポーネントに適用されるライフサイクル定義を選択します。ドロップダウンフィールドには、ワークスペースで定義され、コンポーネントの使用が許可されているすべての定義がリストされます。

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

• Component Naming – このフィールドを使用して、テンプレートを使用して作成されたコンポーネントのデフォルトのアイテム命名スキームを定義し、ワークスペース内の結果コンポーネントに一意のIDを確保します。ここに入力された内容は、コンポーネントの自動命名のテンプレートとして使用されます（Single Component Editingモードでコンポーネントエディタを使用する場合は関連するIdフィールド、Batch Component Editingモードでコンポーネントエディタを使用する場合はItem IDフィールド）。ソフトウェアは、ワークスペース全体と既存コンテンツの識別子をスキャンした後、そのスキームに基づいて次に利用可能な一意のIDを自動的に割り当てます。デフォルトのアイテム命名スキーム - CMP-{00000} - が提供されていますが、もちろん、フィールド内に入力することで独自のスキームを作成することもできます。変数部分は波括弧で囲む必要があります（例：CMP-001-{0000}）。

• Default Folder – 保存されたコンポーネントを格納するためのターゲットワークスペース内のデフォルトフォルダーを指定します。これを行うには、Choose Folderダイアログ（Explorerパネルのインスタンス）にアクセスするためにChooseボタンをクリックし、ワークスペース内の既存のフォルダーを参照して選択するか、その場で新しいフォルダーを作成します。

テンプレートが参照されると、この領域に指定されたエントリが、コンポーネントエディタ内の該当するフィールドに事前に入力されます（利用可能な場合）：

• Single Component Editingモード - Component領域のAdvanced SettingsエリアにあるIdおよびFolderフィールド。

• Batch Component Editingモード – Document OptionsダイアログのDocument Optionsおよびそれに続くItem IDとFolderPathフィールドは、コンポーネント定義領域のComponentエリアにあります。

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

パラメータの定義

エディタの下半分は、参照コンポーネントに提供されるパラメータの定義と管理に専念しています。

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

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

新しいコンポーネントテンプレートを作成する際には、以下の画像に示されているように、さまざまなシステムパラメータがデフォルトで含まれています。

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

• ComponentType – このパラメータを使用すると、コンポーネントの種類を指定できます。これにより、ワークスペースの強力な検索機能を通じてターゲットを絞った検索が容易になります。この機能は、コンポーネントの種類で検索できるだけでなく、サポートされている単位対応のコンポーネントパラメータを使用して、よりスマートに検索できるようにします。Componentsパネルを使用して自分のワークスペースコンポーネントをブラウズする際、コンポーネントのCategoriesグループは、各コンポーネントに関連付けられたComponentTypeパラメータから派生しています。関連するDefault Valueフィールドをクリックし、次にボタンをクリックしてChoose component typeダイアログにアクセスします。これを使用して必要なコンポーネントの種類を選択し、OKをクリックします。選択したタイプは、メインパラメータグリッドのComponentTypeパラメータの値として挿入されます。

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

  

  ComponentTypeシステムパラメータがDiodesに設定された例のコンポーネントテンプレート。

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

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

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

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

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

  これらのパラメーターのデータ型はTextに設定され、変更することはできません。また、これらのパラメーターはコピーまたは削除することができません。

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

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

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

各パラメーターは、以下の情報に基づいてグリッドリストに表示されます：

• Name – パラメーターの名前をこのフィールドで指定します。通常、その目的を伝える意味のある名前です。最初に追加されたとき、パラメーターにはデフォルト名（Parameter、Parameter 1、Parameter 2など）が与えられます。

• Type – パラメーターのタイプです。このエントリは初期にはTextにデフォルト設定されますが、単位認識データ型の範囲がサポートされており、複数のフットプリントを定義するPCBLIBや、ハーネス配線コンポーネントの定義を容易にするHarnessWiringなどのタイプがあります。利用可能な辞書によって定義されたパラメータータイプもサポートされています – 詳細を学ぶ。

• Visible – このオプションを有効にすると（新しく追加されたパラメーターのデフォルト状態）、コンポーネントエディタで1つ以上のコンポーネントを編集するときに対応するパラメーターのShowオプションが有効になります（Batch Component Editingモードで設定）。これにより、そのパラメーターに対応する列がコンポーネントエディタの下部領域に表示されます。このプロパティは、エディタのSingle Component Editingモードを使用してコンポーネントを定義するときには効果がありません。

• Read Only – このオプションを有効にすると、パラメーターを読み取り専用にします。テンプレートを参照するコンポーネントを編集するとき、パラメーターの値は編集不可になります。

• Required – このオプションを有効にすると、パラメーターを「必須パラメーター」にします。テンプレートを参照するコンポーネントを編集するとき、パラメーターには値が定義されていなければならず、そうでない場合はコンポーネントの保存ができません。コンポーネントエディタでは、このようなパラメーターは値セルが赤い境界線を持っている（Batch Component Editingモードの場合）または ​アイコンを含んでいる（Single Component Editingモードの場合）ことで区別されます。値が入力されていない場合。

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

  • パラメータが必須としてマークされ（Requiredオプションが有効）、かつ読み取り専用に設定されている場合（Read Onlyオプションが有効）、デフォルト値を入力する必要があります。そうでない場合、テンプレートを参照するコンポーネントを編集すると、パラメータが値を持っていないとフラグが立てられますが、これは読み取り専用のため編集できないため解決できません。この問題が解決されるまで、このコンポーネントテンプレートの新しいリビジョンはワークスペースに保存できません。

  • コンポーネントのリビジョンを編集する際、リンクされたコンポーネントテンプレートのパラメータと同じ名前の既存のユーザー定義パラメータは、テンプレートのバージョンに置き換えられます。そのパラメータの既存の値は保持され（テンプレートのデフォルト値で上書きされることはありません）、そのままになります。

  • デフォルトのハーネス配線モデルは、他のデフォルトモデル（SCHLIBまたはPCBLIB）がテンプレートに追加されていない場合にのみ追加できます。逆に、デフォルトのハーネス配線モデルがテンプレートに追加されている場合、SCHLIBおよびPCBLIBのデフォルトモデルは追加できません。

• Description – パラメータの説明を追加します。たとえば、提供する内容についての簡潔なメモです。テンプレート内のパラメータに説明が定義されている場合、Description列はコンポーネントエディタのParameters領域にSingle Component Editingに応じて表示されます。

パラメータリストは、単純なコピーおよびペーストアクションもサポートしており、既存のユーザーパラメータを1つ以上複製することができます。ペーストされたパラメータはリストの下部に追加されます。

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

コンポーネントテンプレートエディタは、コンポーネントテンプレート（*.CMPT）内で定義されたコンポーネントパラメータの明示的なデータ型を定義する機能を提供します。さらに、これらのデータ型は単位を認識しており、一般的な単位接頭辞の範囲がサポートされています。そのため、2.2k、2k2、4M、2.5GHzなど、さまざまな形式でパラメータの値を入力でき、ワークスペースはそれらの入力の背後にある数値を認識するための必要なスマート機能を備えています。

コンポーネントテンプレートのこの機能は、サーバーの高度な検索機能を通じてターゲットを絞った検索を容易にします。この機能は、コンポーネントタイプによる検索だけでなく、範囲検索を使用してより賢く検索することも可能にします。ユニットを考慮したコンポーネントパラメータの力を利用することで、例えば47uFから220uFの間のすべてのコンデンサを見つけるための検索を迅速に定義できます。

以下の折りたたみセクションを使用して、単位を意識したパラメータについて詳しく学んでください。

事前に定義するのと同様に、コンポーネントテンプレートはワークスペースライブラリコンポーネントによって参照され、そのコンポーネントを定義する際に使用する事前定義された設定を提供します。

特に、コンポーネントテンプレートはパラメトリック情報を念頭に置いて開発されており、参照するコンポーネントに利用可能になるパラメータの「バケットセット」を一か所で定義できます。テンプレートを通じて、どのパラメータを表示するか、デフォルト値を入力し、必須としてマークするパラメータをさえ制御できます。コンポーネントの保存時には、遵守を確保するための検証チェックが行われます。

このようなコンポーネントテンプレートは、ワークスペース内から直接作成されます。コンポーネントテンプレートが作成され（そしてそのリビジョンにデータが保存されると）、一つまたは複数のコンポーネントの作成に再利用できます。

フォルダタイプ

コンポーネントテンプレートを格納するフォルダを作成する際には、フォルダのタイプを指定できます。これはフォルダの内容には影響しません – コンポーネントテンプレートのリリースは常に対応するコンポーネントテンプレートアイテムを結果として生み出します。これは単にフォルダに格納されているものが何かについての視覚的な「手がかり」を提供し、特定のコンテンツをワークスペースで閲覧する際に有益です。フォルダの使用目的をコンポーネントテンプレートのコンテナとして指名するには、Edit Folderダイアログでフォルダのプロパティを定義する際に、そのFolder TypeをComponent Templatesとして設定します。

フォルダタイプを指定する – その使用目的 – は、ワークスペースを閲覧する際にそのフォルダの内容についての視覚的な表示を提供します。

コンテンツタイプ

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

コンポーネントテンプレートフォルダ内にComponent Templatesを作成すると、コンテキストメニューに正しいContent Typeが表示されます。

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

関連ページ：コンテンツの作成と編集

これまで、関連するフォルダーとコンテンツタイプの観点から、ワークスペースにおけるコンポーネントテンプレートのサポートについて議論してきました。このようなコンポーネントテンプレートアイテムのリビジョンに実際に定義されたコンポーネントテンプレートを保存することは、効率的に行うことができます。

コンポーネントテンプレートは編集され、新しく作成されたコンポーネントテンプレートアイテムの初期リビジョンに保存できます。これは、ワークスペースの直接編集のサポートのおかげです。直接編集により、別々のバージョン管理されたソースデータの束縛から解放されます。ワークスペースから直接最新のソースを読み込んだ一時的なエディタを使用して、サポートされているコンテンツタイプを単純に編集できます。そして、編集が完了すると、そのエンティティは親アイテムの次の計画されたリビジョンに保存（または再保存）され、一時的なエディタは閉じられます。ハードドライブ上にファイルはなく、正しいまたは最新のソースで作業しているかどうかを疑問に思うこともなく、別々のバージョン管理ソフトウェアを維持する必要もありません。ワークスペースがすべてを処理し、高い整合性を持って、データの変更を大幅に迅速化する方法で行います。

コンポーネントテンプレートアイテムを作成するとき、作成後にそのアイテムの初期リビジョンにコンポーネントテンプレートを編集して保存するオプションがあります。そのためには、デフォルトで有効になっているOpen for editing after creationオプションをCreate New Itemダイアログの下部で有効にします。アイテムが作成され、一時的なコンポーネントテンプレートエディタが開き、メインデザインウィンドウにアクティブなドキュメントとして.CMPTドキュメントが表示されます。このドキュメントは、<Item><Revision>.CMPTの形式でアイテムリビジョンに従って名前が付けられます（例：CMPT-0001-1.CMPT）。

ワークスペースから直接コンポーネントテンプレートの初期改訂を編集する例 - 一時的なコンポーネントテンプレートエディタは、コンポーネントテンプレートを定義するための文書を提供します。

必要に応じて、ドキュメントを使用してコンポーネントテンプレートを定義します。これを行う方法の詳細については、テンプレートの定義を参照してください。

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

•  – アクティブドキュメントを保存。このボタンを使用して、ドキュメントに加えた変更をローカルに保存します。これにより、後でさらに変更を加えるために戻ってくる場合に、現在の変更を保存できます。最終的にワークスペースに保存する前に。

• / – サーバーに保存。このボタンを使用して、定義されたコンポーネントテンプレートをワークスペースに保存し、対象のコンポーネントテンプレートアイテムの初期（計画中の）リビジョン内に格納します。リビジョンの編集ダイアログが表示され、必要に応じて名前、説明を変更し、リリースノートを追加できます。保存後、ドキュメントとエディタは閉じられます。ソースコンポーネントテンプレートを含むドキュメント、*.CMPTは、アイテムのリビジョンに格納されます。

• ​/ ​ – ローカル変更を破棄。編集をキャンセルし、行われた変更を破棄したい場合はこのボタンを使用します。ドキュメントとエディタは閉じられ、対象のコンポーネントテンプレートアイテムには何もリリースされません。

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

ワークスペースに保存されたデータには、コンポーネントテンプレートファイル（<Item><Revision>.CMPT）で定義されたソースコンポーネントテンプレートが含まれます。

ワークスペースに保存された定義済みコンポーネントテンプレートの例。

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

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

CMPT（コンポーネントテンプレート）エディタ

コンポーネントテンプレート自体は、Component Template Editorを使用して定義されます。この一時的なエディタは、専用の拡張機能 – コComponent Template Editor拡張機能を通じて提供されます。

Component Template Editor拡張機能。

テンプレートの定義

コンポーネントテンプレートエディタは、主に次の画像に示され、その後要約される2つの主要な領域に分かれています。

コンポーネントテンプレートエディタは大まかに2つの主要な領域に分けられます。

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

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

エディタの上半分は、次のコンポーネントプロパティのデフォルト値を定義するために専用されています：

• Lifecycle Definition – テンプレートを使用して作成されたコンポーネントに適用されるライフサイクル定義を選択します。ドロップダウンフィールドには、ワークスペースで定義され、コンポーネントの使用が許可されているすべての定義がリストされます。

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

• Component Naming – このフィールドを使用して、テンプレートを使用して作成されたコンポーネントのデフォルトのアイテム命名スキームを定義し、ワークスペース内の結果コンポーネントに一意のIDを確保します。ここに入力された内容は、コンポーネントの自動命名のテンプレートとして使用されます（Single Component Editingモードでコンポーネントエディタを使用する場合は関連するIdフィールド、Batch Component Editingモードでコンポーネントエディタを使用する場合はItem IDフィールド）。ソフトウェアは、ワークスペース全体と既存コンテンツの識別子をスキャンした後、そのスキームに基づいて次に利用可能な一意のIDを自動的に割り当てます。デフォルトのアイテム命名スキーム - CMP-{00000} - が提供されていますが、もちろん、フィールド内に入力することで独自のスキームを作成することもできます。変数部分は波括弧で囲む必要があります（例：CMP-001-{0000}）。

• Default Folder – 保存されたコンポーネントを格納するためのターゲットワークスペース内のデフォルトフォルダーを指定します。これを行うには、Choose Folderダイアログ（Explorerパネルのインスタンス）にアクセスするためにChooseボタンをクリックし、ワークスペース内の既存のフォルダーを参照して選択するか、その場で新しいフォルダーを作成します。

テンプレートが参照されると、この領域に指定されたエントリが、コンポーネントエディタ内の該当するフィールドに事前に入力されます（利用可能な場合）：

• Single Component Editingモード - Component領域のAdvanced SettingsエリアにあるIdおよびFolderフィールド。

• Batch Component Editingモード – Document OptionsダイアログのDocument Optionsおよびそれに続くItem IDとFolderPathフィールドは、コンポーネント定義領域のComponentエリアにあります。

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

パラメータの定義

エディタの下半分は、参照コンポーネントに提供されるパラメータの定義と管理に専念しています。

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

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

新しいコンポーネントテンプレートを作成する際には、以下の画像に示されているように、さまざまなシステムパラメータがデフォルトで含まれています。

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

• ComponentType – このパラメータを使用すると、コンポーネントの種類を指定できます。これにより、ワークスペースの強力な検索機能を通じてターゲットを絞った検索が容易になります。この機能は、コンポーネントの種類で検索できるだけでなく、サポートされている単位対応のコンポーネントパラメータを使用して、よりスマートに検索できるようにします。Componentsパネルを使用して自分のワークスペースコンポーネントをブラウズする際、コンポーネントのCategoriesグループは、各コンポーネントに関連付けられたComponentTypeパラメータから派生しています。関連するDefault Valueフィールドをクリックし、次にボタンをクリックしてChoose component typeダイアログにアクセスします。これを使用して必要なコンポーネントの種類を選択し、OKをクリックします。選択したタイプは、メインパラメータグリッドのComponentTypeパラメータの値として挿入されます。

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

  

  ComponentTypeシステムパラメータがDiodesに設定された例のコンポーネントテンプレート。

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

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

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

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

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

  これらのパラメーターのデータ型はTextに設定され、変更することはできません。また、これらのパラメーターはコピーまたは削除することができません。

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

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

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

各パラメーターは、以下の情報に基づいてグリッドリストに表示されます：

• Name – パラメーターの名前をこのフィールドで指定します。通常、その目的を伝える意味のある名前です。最初に追加されたとき、パラメーターにはデフォルト名（Parameter、Parameter 1、Parameter 2など）が与えられます。

• Type – パラメーターのタイプです。このエントリは初期にはTextにデフォルト設定されますが、単位認識データ型の範囲がサポートされており、複数のフットプリントを定義するPCBLIBや、ハーネス配線コンポーネントの定義を容易にするHarnessWiringなどのタイプがあります。利用可能な辞書によって定義されたパラメータータイプもサポートされています – 詳細を学ぶ。

• Visible – このオプションを有効にすると（新しく追加されたパラメーターのデフォルト状態）、コンポーネントエディタで1つ以上のコンポーネントを編集するときに対応するパラメーターのShowオプションが有効になります（Batch Component Editingモードで設定）。これにより、そのパラメーターに対応する列がコンポーネントエディタの下部領域に表示されます。このプロパティは、エディタのSingle Component Editingモードを使用してコンポーネントを定義するときには効果がありません。

• Read Only – このオプションを有効にすると、パラメーターを読み取り専用にします。テンプレートを参照するコンポーネントを編集するとき、パラメーターの値は編集不可になります。

• Required – このオプションを有効にすると、パラメーターを「必須パラメーター」にします。テンプレートを参照するコンポーネントを編集するとき、パラメーターには値が定義されていなければならず、そうでない場合はコンポーネントの保存ができません。コンポーネントエディタでは、このようなパラメーターは値セルが赤い境界線を持っている（Batch Component Editingモードの場合）または ​アイコンを含んでいる（Single Component Editingモードの場合）ことで区別されます。値が入力されていない場合。

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

  • パラメータが必須としてマークされ（Requiredオプションが有効）、かつ読み取り専用に設定されている場合（Read Onlyオプションが有効）、デフォルト値を入力する必要があります。そうでない場合、テンプレートを参照するコンポーネントを編集すると、パラメータが値を持っていないとフラグが立てられますが、これは読み取り専用のため編集できないため解決できません。この問題が解決されるまで、このコンポーネントテンプレートの新しいリビジョンはワークスペースに保存できません。

  • コンポーネントのリビジョンを編集する際、リンクされたコンポーネントテンプレートのパラメータと同じ名前の既存のユーザー定義パラメータは、テンプレートのバージョンに置き換えられます。そのパラメータの既存の値は保持され（テンプレートのデフォルト値で上書きされることはありません）、そのままになります。

  • デフォルトのハーネス配線モデルは、他のデフォルトモデル（SCHLIBまたはPCBLIB）がテンプレートに追加されていない場合にのみ追加できます。逆に、デフォルトのハーネス配線モデルがテンプレートに追加されている場合、SCHLIBおよびPCBLIBのデフォルトモデルは追加できません。

• Description – パラメータの説明を追加します。たとえば、提供する内容についての簡潔なメモです。テンプレート内のパラメータに説明が定義されている場合、Description列はコンポーネントエディタのParameters領域にSingle Component Editingに応じて表示されます。

パラメータリストは、単純なコピーおよびペーストアクションもサポートしており、既存のユーザーパラメータを1つ以上複製することができます。ペーストされたパラメータはリストの下部に追加されます。

辞書定義パラメータデータタイプ

辞書は、いくつかの定義された値を持つカスタムパラメータタイプです。辞書は、コンポーネントテンプレートエディタからTypeドロップダウンのAdd New Dictionaryオプションを選択するか、Parameters領域の右上にあるManage DictionariesコントロールをクリックすることでアクセスできるワークスペースのブラウザインターフェースのSettings – Vault – Dictionariesページでワークスペース管理者によって管理されます。

Settings – Vault – Dictionariesページは、PreferencesダイアログのData Management – Dictionariesページから、Manage Dictionariesコントロールをクリックすることで、また、PreferencesダイアログのData Management – Serversページから、アクティブまたは既知のワークスペースのプロパティコントロールをクリックし、メニューからDictionariesエントリを選択することでアクセスできます。

コンポーネントエディタからワークスペースのブラウザインターフェースで辞書を管理するページにアクセスします。

定義された辞書は、Typeのドロップダウンでパラメータータイプとして利用可能です。

タイプのドロップダウンで辞書で定義されたパラメータータイプを選択します。

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

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

複数の足跡を定義する

コンポーネントテンプレートエディタは、コンポーネントテンプレートの一部として複数のPCBフットプリントを定義するためのサポートも提供します。任意の数のフットプリントモデルリンクを指定でき、これは3つのフットプリントを参照するコンポーネントを作成したいと考えている人々にとって歓迎される機能となるでしょう。これは、異なる密度レベルのIPC要件を満たすためのもので、L（最小銅）、M（最大銅）、N（中央値銅）があります。

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

新しく追加されたパラメータを、TypeをPCBLIBに設定することでフットプリントモデル定義に変換します。

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

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

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

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

コンポーネントテンプレートのリビジョンを使用する、または現在編集中のコンポーネントのリビジョンから参照することは、以下の方法で実行できます。

新しいコンポーネントを作成する場合

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

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

コンポーネントエディタ内で手動で

コンポーネントエディタの操作モードに依存して、コンポーネントエディタからコンポーネントテンプレートのリビジョンを再利用することができます。

単一コンポーネント編集モード

コンポーネントエディタのこのモードで単一のコンポーネントを編集する際は、エディタのComponent領域にあるAdvanced SettingsグループのTemplateフィールドに関連付けられたドロップダウンメニューから必要なコンポーネントテンプレートを選択します。同じワークスペースに存在するすべてのコンポーネントテンプレートが名前でリストされており、最新の改訂版が括弧内に示されています。必要なテンプレートを選択して適用します。

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

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

コンポーネントテンプレートのリビジョンを、現在編集中のコンポーネントのリビジョンに「接続」する方法は2つあります：

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

  

  ターゲットワークスペースで、コンポーネントをコンポーネントテンプレートのリビジョンに手動でリンクします。

  使用中のコンポーネントテンプレートはいつでも変更できます。Chooseをクリックして、別のコンポーネントテンプレートのリビジョンを選択してください。

  リンクされたコンポーネントテンプレートアイテムのリビジョンのステータスは、Document OptionsダイアログのTemplateタブに反映されます。リンクされたアイテムの新しいリビジョンが利用可能な場合は、最新のリビジョンを使用するために ​ボタンをクリックしてください。

• コンポーネントエディタのRequired Models/Parameters領域に関連付けられたAddメニューから。Templatesサブメニューには、コンポーネント自体が存在する同じワークスペースで現在利用可能なすべてのコンポーネントテンプレートが名前別にリストされており、最新の改訂版が括弧内に示されています。エントリをクリックすると、そのコンポーネントテンプレートの最新の改訂版へのリンクが作成されます。再度、リンクの確認はDocument OptionsダイアログのTemplatesタブで見ることができます。

  

  すべての利用可能なテンプレートのメニューからコンポーネントテンプレートを迅速にリンクします。

コンポーネントワークスペースフォルダーからの継承

ワークスペース内のコンポーネントフォルダーに保存されているすべてのコンポーネント（およびその改訂）に自動的に使用されるコンポーネントテンプレートを指定できます。

デフォルトコンポーネントテンプレートは、Componentsタイプのフォルダーにのみ定義できます。

フォルダーのプロパティを定義する際に、Edit FolderダイアログでComponent Templateフィールドを使用して必要なテンプレートを指定します。このフィールドに関連付けられたドロップダウンには、コンポーネントフォルダー自体が存在する同じワークスペースで現在利用可能なすべてのコンポーネントテンプレートが名前で表示され、最新の改訂版が括弧内に示されています。そのフォルダー内で作成される各コンポーネントについて、そのコンポーネントテンプレートの最新の改訂版へのリンクを作成するために、エントリを選択します。

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

フォルダー階層でコンポーネントテンプレートが選択されると、そのテンプレートはデフォルトで下位のサブフォルダーでコンポーネントが作成される際に使用されます。これにより、子フォルダー内のすべてのコンポーネントへの迅速なテンプレート継承が促進されます。

コンポーネントテンプレートを使用する際のコンポーネントモデルとパラメータへの影響

コンポーネントのリビジョンを編集する際に、コンポーネントテンプレートのリビジョンがリンクまたは参照されている場合、コンポーネントエディタ内でモデルとパラメータに関して次のことが発生します：

• 参照されたテンプレート内で定義されたモデルは、Models領域（Single Component Editingモード）およびModel Links領域（Batch Component Editingモード）に追加されます。

• 既存の参照モデルは保持され、そのコンポーネントは意図的に手動で変更されない限り、そのモデルを使用し続けます。

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

  

  コンポーネントテンプレートのリビジョンにリンクした後のパラメータの例。Single Component Editingモード（左）とBatch Component Editingモード（右）を使用しているとき。

  参照されたコンポーネントテンプレートから派生したすべてのパラメーターは、 ​アイコン（Single Component Editingモード）と ​アイコン（Batch Component Editingモード）を使用して区別されます。さらに、バッチコンポーネント編集モードのみの場合、各テンプレートベースのパラメーターのShowオプションは、テンプレート内の対応するVisibleオプションの状態に従います。

  テンプレートベースのパラメータは削除できません。

  必要に応じて追加のユーザーパラメータを追加しても構いません。

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

  

  コンポーネントエディタのBatch Component Editingモードを使用する際に、コンポーネント定義自体が定義されている領域に例のテンプレートベースのパラメータが表示されます。

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

  Single Component Editingモードのコンポーネントエディタでは、Parameters領域で読み取り専用テンプレートパラメータがアイコンを使用して区別されます。

• テンプレートベースのパラメータが必須としてマークされているが、テンプレート内で値が指定されていない場合、その値フィールドは赤い境界線で表示されます（Batch Component Editingモード）またはアイコンが含まれます（Single Component Editingモード）。これは、このパラメータに値が必要であることを警告しています。すべての必須パラメータに対して値が定義されるまで、コンポーネントをワークスペースに保存することはできません。

  コンポーネントエディタを単一コンポーネント編集モードで使用する場合、必須テンプレートパラメータはParameters領域でアイコンを使用して区別されます。

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

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

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

保存されたデータのダウンロード

コンポーネントテンプレートのリビジョン上で右クリックし（エクスプローラパネル内）、コンテキストメニューからOperations » Downloadコマンドを選択して、リビジョンに保存されたデータをダウンロードします。コンポーネントテンプレートファイルは、選択したディレクトリの下のサブフォルダにダウンロードされ、アイテムリビジョンIDを使用して名前が付けられます。ファイルはReleasedフォルダ内で見つけることができます。

ソフト削除

ワークスペースに接続している場合、Explorerパネル内から直接コンポーネントテンプレートをAltium Designerから削除するための柔軟な機能が利用可能です。パネル内のコンポーネントテンプレートのエントリを右クリックし、コンテキストメニューからDelete Itemコマンドを選択します。Delete Itemsダイアログが表示され、削除を確認します。実際のアクションは「ソフト削除」であり、コンポーネントテンプレートはワークスペースのTrashエリアに移動されます。Trashは、ワークスペース内の任意のコンテンツを（ソフト削除アクションを通じて）移動できるリサイクルビンのようなものです。それはワークスペースの残りの部分から隔離されています。

コンポーネントテンプレートのソフト削除。テンプレートはワークスペースのTrashエリアに移動されます。

削除を進めるには、ボタンをクリックします。アイテムが削除され、削除サマリーダイアログが削除の成功を確認します。削除に問題があった場合、フラグとして示されます。

この方法で削除されたすべてのコンテンツは、ワークスペースのブラウザインターフェースのTrashページで見つけることができます。自分がソフト削除したコンテンツのみを表示できることに注意してください。管理者はTrashページの完全なコンテンツを見ることができます – つまり、ソフト削除されたすべてのコンテンツです。

ソフト削除されたコンポーネントテンプレートに関連する考慮事項：

• コンポーネントテンプレートは、設計ソフトウェアやWebインターフェース内から利用できなくなります。

• コンポーネントテンプレートが使用されていた場所では、そのコンポーネントテンプレートが削除されたことが反映されます。

• コンポーネントテンプレートは、編集権限がある場合、Trashページから復元するか、完全に削除することができます。完全削除は、親アイテムによって使用されていない場合にのみ可能です。

  ソフト削除したコンポーネントテンプレートをTrashに移動した場合、同じ名前の新しいコンポーネントテンプレートを再作成できます。元のコンポーネントテンプレートをその後復元し、元の名前がすでに使用されている場合、整数のサフィックスが使用され、ワークスペース内で名前が一意になるようにします。