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

親ページ： 管理されたコンポーネントの操作

管理されたコンポーネントの作成を効率化するために、Altium Designerは管理コンテンツサーバーと連携して、コンポーネントテンプレートの作成と定義をサポートします。回路図テンプレートがそれを参照する回路図シート上の情報を事前に定義するのと同様に、コンポーネントテンプレートは管理コンポーネントによって参照され、そのコンポーネントを定義する際に使用するための事前定義された設定を提供します。

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

そのようなアイテムは、サーバー内で直接作成されます。コンポーネントテンプレートアイテムが作成され（そしてそのリビジョンにデータがリリースされ）、そのライフサイクル状態が組織が設計レベルで使用する準備ができたと見なすレベルに設定されると、それは1つ以上の管理されたコンポーネントの作成に再利用することができます。

フォルダタイプ

コンポーネントテンプレートアイテムを保存するフォルダを作成する際には、フォルダのタイプを指定できます。これはフォルダの内容には影響しません - コンポーネントテンプレートをリリースすると、常に対応するコンポーネントテンプレートアイテムが生成されます。これは、フォルダに何が保存されているかについての視覚的な「手がかり」を提供し、サーバーで特定のコンテンツを探す際に便利です。フォルダをコンポーネントテンプレートアイテムのコンテナとして指定するには、フォルダのプロパティを定義する際に、Folder TypeをComponent Templatesに設定します。Edit Folderダイアログでこれを行います。

フォルダの種類 - その使用目的 - を指定することで、サーバーを閲覧する際にそのフォルダの内容の視覚的な表示が可能になります！

アイテムタイプ

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

コンポーネントテンプレートフォルダ内でコンポーネントテンプレートアイテムを作成する - コンテキストメニューで正しいコンテンツタイプが利用可能です。

コンポーネントテンプレートのリリース

これまでに、サーバーでのコンポーネントテンプレートアイテムのサポートについて、関連するフォルダやアイテムタイプの観点から議論してきました。実際に定義されたコンポーネントテンプレートをそのようなアイテムのリビジョンにリリースすることは、合理化された方法で実行できます。

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

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

管理されたコンテンツサーバーから直接、コンポーネントテンプレートアイテムの初期リビジョンを編集する例 - 一時的なコンポーネントテンプレートエディターが、コンポーネントテンプレートを定義するためのドキュメントを提供します。

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

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

•  - アクティブドキュメントを保存。このボタンを使用して、ドキュメントに加えた変更を保存します。これにより、現在の変更を保存し、最終的に管理されたコンテンツサーバーにリリースする前に、後でさらに変更を加えるために戻ってくることができます。

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

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

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

サーバーに再リリースされた定義済みコンポーネントテンプレートの例。

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

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

コンポーネントテンプレートエディタ拡張機能。

テンプレートの定義

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

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

1. 上部領域 - テンプレートを参照するコンポーネントのコンポーネントレベルのオプション（ライフサイクル、命名、フォルダオプション）を定義するため。

2. 下部領域 - テンプレートを参照するコンポーネントに使用されるパラメータを定義するため。

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

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

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

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

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

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

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

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

• Batch Component Editingモード - Document OptionsダイアログのDocument Optionsタブおよびそれに伴うコンポーネント定義領域のComponentエリアのItem IDおよびFolderPathフィールド。

テンプレートが参照されると、Single Component Editingモード（左）およびBatch Component Editingモード（右）でコンポーネントを編集する際に、適用可能なフィールドが事前に入力されます。

パラメータの定義

エディタの下半分は、参照するコンポーネントで利用可能になるパラメータを定義および管理することに専念しています。

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

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

新しいコンポーネントテンプレートアイテムを作成する際に、デフォルトで含まれるさまざまなシステムパラメータがあります。これは、以下の画像で示され、その後詳細に説明されます。

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

• ComponentType - このパラメータを使用すると、コンポーネントのタイプを指定できます。これにより、サーバーの強力な検索機能を通じてターゲットを絞った検索が可能になります。この機能は、コンポーネントのタイプによる検索だけでなく、サポートされている単位認識コンポーネントパラメータを使用して、より賢く検索できます。Default Valueフィールドをクリックし、次に ボタンをクリックして、コンポーネントタイプダイアログにアクセスします。これを使用して必要なコンポーネントのタイプを選択し、OKをクリックします。選択したタイプがメインパラメータグリッドにComponentTypeパラメータの値として挿入されます。

例：コンポーネントテンプレート、ComponentType システムパラメータが Diode に設定されています。

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

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

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

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

テンプレートの一部として名前と説明のパラメータを指定します。

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

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

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

各パラメータは、以下の情報の観点からグリッドリストに表示されます：

• Name- このフィールドを使用してパラメータに名前を付けます。通常、その目的を伝える意味のある名前が使用されます。最初に追加されたとき、パラメータにはデフォルト名（Parameter、Parameter1、Parameter2など）が付けられます。

• Type- パラメータのタイプです。このエントリーは初期状態ではTextになりますが、単位を認識するデータタイプの範囲がサポートされており、またPCBLIBタイプもサポートされています。これは、複数のフットプリントの定義を容易にします。

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

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

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

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

• Description - パラメータについての説明を追加します。例えば、それが何を提供するかについての簡潔なメモです。

パラメータリストは、シンプルなコピー＆ペーストアクションもサポートしており、1つ以上の既存のユーザーパラメータを複製することができます。貼り付けられたパラメータはリストの最後に追加されます。

単位を認識するコンポーネントパラメータデータタイプ

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

このコンポーネントテンプレートの機能は、サーバーの高度な検索機能を通じてターゲットを絞った検索を容易にします。この機能は、コンポーネントタイプによる検索だけでなく、範囲検索を使ったより賢い検索を可能にします。単位を認識するコンポーネントパラメータの力を使って、例えば、47uFから220uFの間のすべてのキャパシターを見つけるような検索をすぐに定義できます。

単位を認識するパラメータについてもっと学ぶために、以下の折りたたみセクションを使用してください。

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

コンポーネントテンプレートエディターは、コンポーネントテンプレートの一部として複数のPCBフットプリントを定義するサポートも提供します。任意の数のフットプリントモデルリンクを指定でき、IPCの異なる密度レベル（L（最小または最少銅）、M（最大または最多銅）、N（標準または中間銅））に対応する3つのフットプリントを参照するコンポーネントを作成したいと考えている方々にとっては歓迎される機能です。

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

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

コンポーネントエディターで定義された例示コンポーネント（Single Component Editingモード）、参照されたコンポーネントテンプレートを使用しています。テンプレートには3つのフットプリントモデルが定義されており、それらがコンポーネント定義に取り込まれます。テンプレート内のPCBLIBモデルエントリーが、コンポーネントを定義する際のデフォルトフットプリントモデル（左上のアイコンで区別される）として使用されます。

画像にマウスを合わせると、Batch Component Editingモードで同じコンポーネントがコンポーネントエディターで定義されているのが見えます。この場合、デフォルトフットプリントはPCBLIB (default)と呼ばれます。

管理されたコンポーネントテンプレートアイテムの再利用

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

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

コンポーネントエディタからコンポーネントテンプレートアイテムのリビジョンを再利用することは、エディタの動作モードに依存します。

Single Component Editingモードで

このモードのコンポーネントエディタで単一のコンポーネントを編集する際には、エディタのComponent領域にあるAdvanced SettingsグループのTemplateフィールドに関連付けられたドロップダウンメニューから必要なコンポーネントテンプレートを選択します。コンポーネントアイテム自体が存在する同じ管理コンテンツサーバー内で現在利用可能なすべてのコンポーネントテンプレートアイテムが、その最新のリビジョンが括弧内に示される形で名前でリストアップされます。必要なテンプレートを選択して適用してください。

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

Batch Component Editingモード

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

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

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

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

利用可能なテンプレートのメニューからコンポーネントテンプレートアイテムを迅速にリンクする。

コンポーネントサーバーフォルダから継承

サーバー内のコンポーネントフォルダ内に格納されているすべてのコンポーネントアイテム（およびそのリビジョン）に対して、自動的にコンポーネントテンプレートアイテムが使用されるように指定できます。

Component Templateフィールドを使用して、必要なテンプレートを指定します。これは、フォルダのプロパティを定義する際に、Edit Folderダイアログで行います。このフィールドに関連するドロップダウンは、コンポーネントフォルダ自体が存在する同じ管理コンテンツサーバー内で現在利用可能なすべてのコンポーネントテンプレートアイテムを名前でリストアップし、その最新のリビジョンを括弧内に表示します。エントリーを選択すると、そのフォルダ内で作成される各後続のコンポーネントアイテムに対して、そのコンポーネントテンプレートアイテムの最新リビジョンへのリンクが作成されます。

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

フォルダレベルでコンポーネントテンプレートが選択されている場合、そのテンプレートはデフォルトで、下位の子フォルダ内で作成されるコンポーネントアイテムに使用されます。これにより、子フォルダ内のすべてのアイテムに迅速にテンプレートの継承が行われます。

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

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

• 参照されたテンプレート内で定義されたモデルは、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モード（右）。

• リンクされたコンポーネントテンプレートアイテムにあるパラメータと同じ名前の既存のユーザー定義パラメータは、テンプレートバージョンに置き換えられます。そのパラメータの既存の値は保持されます（テンプレートの値で上書きされません）。
• Batch Component Editingモードのみで、表示設定されているテンプレートベースのパラメータは、エディタのコンポーネント定義エリアでグループ化され、「テンプレートパラメータ」というヘッダーテキストが使用されます。

コンポーネントエディタをBatch Component Editingモードで使用している際に、コンポーネント定義自体が定義されているエリアでの、例示されたテンプレートベースのパラメータの外観。

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

• テンプレートベースのパラメータが必須としてマークされているが、テンプレート内で値が指定されていない場合、その値のフィールドは（Batch Component Editingモードでは）赤い枠で表示されるか、（シングルコンポーネント編集モードでは） アイコンが含まれており、このパラメータには値が必要であることを警告します。必須パラメータすべてに値が定義されるまで、コンポーネントをリリースすることはできません。

コンポーネントテンプレートアイテムの再リリース

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

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

リリースデータのダウンロード

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