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

コンポーネント作成の効率化を支援するために、Altium Designer は connected Workspace と連携して、その Workspace 内で Component Templates (Component Template Items) を作成および定義する機能をサポートしています。参照先の回路図シート上の情報をあらかじめ定義するために回路図テンプレートを使用できるのと同様に、コンポーネントテンプレートは 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 内の検索時に使用され、コンポーネントテンプレートの内容を素早く識別するのに役立ちます。

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

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

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

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

Inheriting a Component Template

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

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 – Component 領域の Advanced Settings エリア内にある 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 キーを使用して値をクリアします。

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

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

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

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

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

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

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

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

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

テンプレートに新しいユーザーパラメーターを追加した例。

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

• Name – このフィールドを使用してパラメーター名を設定します。通常は、その用途がわかる意味のある名前にします。追加直後のパラメーターには、デフォルト名（Parameter、Parameter 1、Parameter 2 など）が付けられます。
• Type – パラメーターのタイプです。このエントリは最初は Text に設定されていますが、さまざまな unit-aware data types がサポートされているほか、PCBLIB 型（複数フットプリントの定義 を容易にする）や、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 – パラメーターに関する説明を追加します。たとえば、その内容を簡潔に示す注記などです。テンプレート内のパラメーターに説明が定義されている場合、Description 列が Component Editor の Parameters 領域に 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

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

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

• なお、以下の一覧で太字で示されているデータ型は、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)

• Temperature coefficient (ppm/°C)

• 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 から Add New Dictionary ドロップダウンの Type オプションを選択するか、Parameters 領域の右上にある Manage Dictionaries コントロールをクリックしてアクセスできます。

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

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

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

選択した辞書定義型に対して定義されている値は、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 Mode の場合

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

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

Batch Component Editing Mode の場合

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

• Edit » Document Options（）の Document Options dialog の 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 Models と Parameters への影響

コンポーネントのリビジョンを編集し、コンポーネントテンプレートのリビジョンがリンクまたは参照されている場合、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 モード（右）で使用した場合に、コンポーネントテンプレートのリビジョンへリンクした後のパラメーターの例。

  参照されている component template に由来するすべてのパラメーターは、 アイコン（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 内の component template のどのリビジョンにも戻って直接編集できます。対象のリビジョンを右クリックし、コンテキストメニューから Edit コマンドを選択します。再び一時エディターが開き、そのリビジョンに含まれるテンプレートが編集用に開かれます。必要な変更を行った後、その component template を Item の次のリビジョンとして保存します。

既存の component template のリビジョンを直接編集するためのコマンドにアクセスします。

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

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

ソフト削除

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

component template のソフト削除。テンプレートは Workspace の Trash 領域に移動されます。

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

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

ソフト削除された component template に関して考慮すべき点:

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