バリアント管理ダイアログの使用方法
概略
- ダイアログへのアクセス方法、バリアントの追加・コピー方法、部品を「実装」「未実装」「代替部品」に設定する方法を学びます。
- パラメーターのバリエーションの編集・識別、部品リストの絞り込み、レポートの生成方法を確認します。
- 製造用出力、ペーストマスク、代替部品のシンボルとフットプリントの扱いに関する、新規バリアントのオプションを理解します。
バリアントは、Variant Managementダイアログで作成および設定します。このダイアログを開くには、ProjectメニューからVariantsを選択するか(ショートカット:C、V)、 Projectsパネルでプロジェクト名を右クリックし、 Variantsを選択します。
ダイアログの機能
ダイアログには、主に次の2つの領域があります。
-
上部のComponents for project領域には、基本設計のすべてのコンポーネントと、該当する場合は適用されているバリアントの列が表示されます。
-
下部のComponent Parameters領域には、上部の領域で現在選択されているコンポーネントのすべてのパラメーターと、該当する場合は適用されているバリアントの列が表示されます。

バリアントは、Variant Managementダイアログで作成および設定します。
Variant Managementダイアログのオプションとコントロール
このダイアログのオプションやコントロールの中には、直感的に理解でき、説明を必要としないものもあります。以下では、説明が必要なものについて解説します。
Components |
|
| Project Components | この領域には、プロジェクト内の各コンポーネントが一覧表示されます。各コンポーネントには、Hierarchy PathとLogical デジグネーター、およびName と物理Designatorが表示されます。Document とOriginal Library Link には、ソースドキュメントの保存場所が表示されます。 |
| Variant of | 新しいバリアントを追加すると、Project Components.の右側に列が表示されます。新しいバリアントに付けた名前がタイトルとして表示され、Component Variation列には各コンポーネントの変更内容が表示されます。 バリアントを作成したら、各コンポーネントの状態を設定できます。新しい列のコンポーネントセルをクリックして
|
| Right-click Commands | Components 領域の右クリックメニューで使用できる主なコマンドは、次のとおりです。
|
Component Parameters
ダイアログ内の各コンポーネントには、Parameter Variationsを設定できます。Parameter NameとそのOriginal Value に加えて、追加されたバリアントを表す列のNew Valueが表示されます。表示されるNew Valueは、変更するまでは基本設計のコンポーネントの値をコピーしたものです。この領域では、基本設計から変更されたパラメーターがboldで表示されるため、簡単に識別できます。右クリックメニューから、次の追加オプションにアクセスできます。
| Edit Selected, Reset Selected, Reset All | クリックして、選択したバリアントセルのNew Valueを変更、復元、または(すべて)リセットします。 |
| Update Values From Library | クリックして、代替部品として使用されているライブラリコンポーネントに加えたパラメーターの変更を、バリアント定義に反映します。更新されるのはパラメーターのみで、コンポーネント自体は更新されないことに注意してください。 |
| Only Show Varied Values | クリックして、元の値から変更された値のみを表示します。 |
| Cut | クリックすると、セルの内容が削除されます。削除を実行する前に、確認用のConfirm ダイアログが開きます。 |
| Report | クリックすると、Component Parameters 領域の印刷物を作成するためのReport Previewダイアログが開きます。 |
| Save All, Save Selected | クリックすると、選択したコンポーネントのすべてのパラメーター、または選択したパラメーターを、別の場所に書式付きテキストファイルとして保存するためのダイアログが開きます。 |
| Invert Selection | クリックすると、現在選択されているパラメーター以外のすべてのパラメーターが選択されます。 |
Additional Controls |
|
| Add Variant | クリックすると、基本設計の新しいバリアントを作成するためのプロジェクトバリアントの編集ダイアログが開きます。このダイアログでは、バリアントの追加、編集、削除、および必要なバリアントレベルのパラメーターデータの指定を行えます。このボタンには、Make a copy of the Selected Variantコマンドにアクセスするためのドロップダウンがあります。コピーは、よく似たバリアントを複数定義する必要がある場合に特に便利です。 |
| Delete Variant | クリックすると、選択したバリアントが削除されます。削除を実行する前に、確認用のダイアログが開きます。 |
| Edit Variant | クリックすると、バリアントを編集するためのEdit Project Variant ダイアログが開きます。 |
| Detailed Report | クリックすると、HTML形式の詳細なバリアントレポートを生成するためのバリアントレポートダイアログが開きます。 |
| Drawing Style | クリックすると、バリアントオプションダイアログが開きます。このダイアログでは、回路図のコンパイル済みドキュメントビューと回路図の印刷で、非実装コンポーネントや変更されたパラメーターをどのように表示するかを定義できます。また、PCB組立図でのこれらのコンポーネントの表示方法も定義できます。 |
| Fit To Width | このオプションを有効にすると、内容に応じて列幅が自動的に調整されます。 |
新しいバリアントの作成
Variant Managementダイアログの
ボタンをクリックすると、基本設計の新しいバリアントを作成できます。Edit Project Variantダイアログが開きます。
少なくとも、Descriptionフィールドにバリアント名を入力してください。このフィールドには、デフォルトでVariant of <ProjectName>が入力されています。
設計から製造バリアントを生成する必要がある場合は、Edit Project VariantダイアログのAllow variation of fabrication outputsオプションを有効にします。「非実装」コンポーネントを含むバリアントがある設計で、ペーストマスク出力を生成する必要がある場合は、Allow variation for paste maskオプションを有効にします。これらのコンポーネントのパッドには、ペーストマスクが含まれなくなります。
Edit Project Variantダイアログの次のオプションを使用して、代替部品のシンボルを回路図上で変更するか、またはそのフットプリントをPCBに追加するかを選択できます。
-
Do not overwrite schematic symbol – 有効にすると、バリアントで代替部品が選択されているコンポーネントに対して、変更前のシンボルが使用されます。
-
Do not overwrite PCB footprint – 有効にすると、バリアントで代替部品が選択されているコンポーネントに対して、変更前のフットプリントが使用されます。バリアントに適用された代替部品のフットプリントは、PCB更新時にPCBへ転送されません(フットプリントをPCBに追加するためのECOは生成されません)。
バリアントのパラメーターを定義することもできます。定義方法、およびAltium Designer内のパラメーター階層におけるバリアントレベルのパラメーターの位置付けについては、バリアントパラメーターの操作を参照してください。
バリアントを必要に応じて定義したら、OKをクリックします。Variant Managementダイアログの右側に、新しいバリアント名を列タイトルとする列が追加されます。すべてのセルは空欄になります。空欄のセルは、そのコンポーネントが実装され、基本設計から変更されていないことを示します。これで、新しいバリアント用にコンポーネントを設定できます。下の画像は、BGAとTSOPという2つのバリアントが作成されたプロジェクトを示しています。

領域1には基本設計のコンポーネントの詳細、領域2にはBGAバリアントのコンポーネントの詳細、領域3にはTSOPバリアントのコンポーネントの詳細が表示されます。
Variant Managementダイアログには、有用な情報を表示するためのインターフェース機能がいくつか用意されています。これらは、右クリックのコンテキストメニューから設定できます。
これまでに説明していない便利なコマンドには、次のものがあります。
-
Columns
-
Hierarchy Path – 設計階層内のコンポーネントの位置を表示します。
-
Original Library Link – 元のコンポーネントの取得元の詳細を表示します。
-
-
Set Selected As – サブメニューを使用して、変更の種類(実装、非実装、代替)を選択します。コンポーネントのセルにある
コントロールをクリックする代わりに使用できます。バリアントのコンポーネントセルを右クリックした場合にのみ使用できます。
-
Only Show Varied Parameters – Variant Managementダイアログで、何らかの変更が適用されたコンポーネントのみを表示します。
-
Filter – サブメニューを使用して、Variant Managementダイアログに表示する変更の種類を制御します。(Only Show Varied Parametersコマンドと組み合わせると便利です。)
コンポーネントの変更の定義
バリアントを作成すると、各コンポーネントの状態を変更できるようになります。バリアント列のコンポーネントセルをクリックして
コントロールを表示するか、セルを右クリックしてSet Selected Asコンテキストサブメニューから必要な項目を選択します。
コントロールをクリックすると、Edit Component Variationダイアログが開きます。
次の3つの選択肢があります。
-
Fitted – 基本設計で使用されている元のコンポーネントを、この設計バリアントでも実装/使用します。新しく追加されたバリアントでは、デフォルトですべてのコンポーネントが実装され、実装されるコンポーネントのセルは空欄になります。実装されるコンポーネントについても、ダイアログのそのバリアントのComponent Parameters領域に新しいパラメーター値を入力することで、個々のパラメーターを変更できます。
-
Not Fitted – ベース設計で使用されている元のコンポーネントは、この設計バリアントでは実装/使用されません。コンポーネントのステータスが未実装(Not Fitted)の場合、セルにはテキスト Not Fitted が表示され、ダイアログ下部の Component Parameters 領域は空白になります。
-
Alternate Part – このオプションでは、別の(代替)部品を選択できます。ダイアログが拡張され、必要な代替コンポーネントを参照して検索するためのコントロールが表示されます。 部品を選択すると、セルには代替部品のソースリンクが表示されます。ダイアログの Component Parameters 領域には、代替部品のすべてのパラメーターが表示されます。詳細は次のセクションを参照してください。
代替部品の選択
Alternate Part オプションを選択すると、Edit Component Variation ダイアログが拡張され、既存部品の基本パラメーターが表示されます。
ボタンを使用して、Replace Componentダイアログで必要な代替部品コンポーネントを参照して検索します。このダイアログは、Componentsパネルのモーダルダイアログ版です。独立したライブラリ、データベースライブラリ、Workspace Libraryコンポーネント(以下の例を参照)など、Altium Designerのすべてのコンポーネント格納モデルに対応しています。

代替部品を使用したバリエーションの例。
新しく適用した代替コンポーネントは、デザインスペースで確認できます。詳細は、 設計でのバリアントの操作ページを参照してください。
バリアントデータのリセットと更新
Variant Management ダイアログで設定した設計バリエーションは、最終的にプロジェクトファイルに保存されます。これには、「未実装(Not Fitted)」の状態、実装するコンポーネントのローカルなパラメーター変更、および代替部品のパラメーター値が含まれます。代替部品の実体は [ProjectName].PrjPcbVariants ファイルに保存されます。Variant Management ダイアログには、パラメーターのリセットとコンポーネントの更新を行うコマンドが用意されており、ソースのコンポーネントライブラリとの同期を維持するのに役立ちます。
変更したコンポーネントパラメーターの更新
Variant Management ダイアログでローカルに変更したパラメーターは、以下に示すように、バリアントのパラメーターリストで変更済みのパラメーター(太字で表示)を右クリックし、コンテキストメニューから Reset Selected を選択すると、元の値に戻すことができます。複数のパラメーターを一度に選択して1回の操作でリセットすることも、Reset All を使用してそのコンポーネントのすべてのパラメーターをリセットすることもできます。

変更したパラメーターの値は、Reset Selected コマンドを使用して元に戻すことができます。
代替部品のパラメーターの更新
代替部品として使用しているライブラリコンポーネントのパラメーターがライブラリ内で変更された場合、以下に示すように、そのバリアントのパラメーターリスト内を右クリックし、メニューから Update Values from Library を選択することで、その変更をプロジェクトのバリアント定義に直接取り込むことができます。この操作で更新されるのはパラメーターです。 グラフィックを更新する必要がある場合は、以下で説明する方法を使用してください。

代替部品コンポーネントがライブラリ内で変更された場合は、Update Values from Library コマンドを使用して、プロジェクトで使用されているコピーを更新します。
Update Values from Library コマンドを実行した後、Browse Libraries ダイアログでソースライブラリ内のコンポーネントを参照して検索し、 OK をクリックして Update Project Variants From Library ダイアログを開きます。Parameters from Library Component と Variants to Update を選択/選択解除し、OK をクリックして更新処理を完了します。

変更したコンポーネントをソースライブラリから更新します。ここでは、更新するパラメーターと、更新を適用するバリアントを設定します。
Browse Librariesダイアログのオプションとコントロール
-
Libraries - 現在のライブラリを表示します。ドロップダウン矢印を使用して利用可能なライブラリのリストを表示し、目的の 対象ライブラリを選択します。
ボタンをクリックすると、ライブラリを追加または削除できる Available File-based Libraries ダイアログが開きます。
- Find - クリックすると、追加のライブラリを検索するための File-based Libraries Search ダイアログが開きます。
- Mask - キーワードを入力して、Component Name リストの結果を絞り込みます。ドロップダウンには、以前に使用したキーワードが表示されます。
上部グリッド
- Component Name - コンポーネントの名前を表示します。
- Library - コンポーネントが格納されているライブラリを表示します。
- Description - コンポーネントの簡単な説明です。
- Footprint - 関連付けられているフットプリントを表示します(存在する場合)。
- <nn> components - コンポーネントの総数(nn)を表示します。
下部グリッド
- Model Name - 上部グリッドで現在選択されているコンポーネントのモデル名を表示します。
- Type - 上部グリッドで現在選択されているコンポーネントのモデルタイプを表示します。
プレビューウィンドウ
- Upper Window - 上部グリッドで現在選択されているコンポーネントの回路図シンボルを表示します。
-
Lower Window - 上部グリッドで現在選択されているコンポーネントのフットプリントを表示します。
- 2D/3D - 2Dと3Dのプレビュー画像を切り替えるために使用します。
Update Project Variants From Libraryダイアログのオプションとコントロール
- Parameters from Grid - 選択したコンポーネントのすべてのパラメーターとその値を一覧表示します。チェックボックスをオンにして、 更新するパラメーターを選択します。更新に使用できないパラメーターはグレー表示されます(例: その名前のパラメーターを含むコンポーネントがない場合)。
- Project Variants To Update Grid - プロジェクト内に現在存在するすべてのバリアントのリストです。チェックボックスをオンにして、 更新するバリアントを選択します。
- Choose Component - クリックすると、コンポーネントを検索できるダイアログが開きます。
Update Project Variants From Library ダイアログの左側には、すべてのパラメーターが表示されます。必要に応じて、任意のパラメーターの選択を解除し、更新処理から除外できます。ダイアログの右側では、対象のプロジェクトバリアントを変更できます(Project Variant To Update)。デフォルトでは、Update Values from Library コマンドを実行したときに選択されていたバリアントが選択されます。
代替部品の完全な更新
代替部品のソースコンポーネントがライブラリ内で編集されている場合は、ライブラリから更新ダイアログを使用して、設計内の代替部品を更新できます。
回路図エディターのToolsメニューから開くこのダイアログには、Include Variantsオプションがあります。このオプションを有効にすると、コンポーネントリストが展開され、代替部品として使用されているコンポーネントも表示されます。リスト内で更新するコンポーネントにチェックを入れ、ウィザードを最後まで進めると、必要な部品がソースから更新されます。

グラフィックも含めて代替部品を完全に更新するには、Include Variantsチェックボックスをオンにし、更新する部品を有効にします。
複数コンポーネントの複数パラメーターの変更
Variant Managementダイアログは複数選択に対応しています。ダイアログ上部のコンポーネント領域で任意の数のコンポーネントを同時に選択し、下部のパラメーター領域で選択した任意の数のパラメーターを更新できます。また、右クリックのコンテキストメニューからフィルターを使用して、選択対象や表示データをさらに絞り込むこともできます。
たとえば、すべてのバリアントのすべてのコンポーネントについて、手動で変更したパラメーターをリセットするには、次の手順を実行します。
-
ダイアログ上部のコンポーネント領域で、右クリックメニューのOnly Show Varied ComponentsオプションとFilterオプションを組み合わせて使用し、Show Fitted with Varied Parametersのみに絞り込みます。これで、手動で変更したパラメーターを持つコンポーネントだけがコンポーネントリストに表示されます。
-
コンポーネントリスト内で右クリックし、コンテキストメニューからSelect Allを選択します。ダイアログ上部に現在表示されているすべてのコンポーネントが選択されます。
-
次に、ダイアログ下部のパラメーター領域で右クリックし、コンテキストメニューからSelect Allを選択します。すべてのコンポーネントのすべてのパラメーターが選択されます。代わりにSelect Columnコマンドを選択すると、特定のバリアント(列)のコンポーネントに対して、リセットなどの操作を適用できます。
-
パラメーターリスト内でもう一度右クリックし、コンテキストメニューからReset Selectedを選択します。下の画像にカーソルを合わせると、手順2、3、4が表示されます。

すべてのバリアントのすべてのコンポーネントについて、手動で変更したすべてのパラメーターをリセットします。画像にカーソルを合わせると、手順2、3、4が表示されます。
フィルターオプションを試してさまざまなフィルターを適用した場合は、別の更新を行う前にフィルターのリセットが必要になることがあります。その場合は、Only Show Varied Componentsオプションを無効にしてフィルターシステムをクリアし、再度有効にしてから、必要に応じてFilterオプションを解除してください。
バリアントパラメーターの操作
Altium Designerは、プロジェクトのさまざまなレベルのパラメーターに対応しています。たとえば、回路図エディターのPropertiesパネル(何も選択していないときに使用可能)のParametersタブでは、各回路図シートにドキュメントレベルのパラメーターを追加できます。また、プロジェクトオプション ダイアログ(Project » Options)のParametersタブでは、プロジェクトレベルのパラメーターをプロジェクトに追加できます。
さらに、プロジェクトバリアントの編集ダイアログから、バリアントにパラメーターを追加することもできます。このダイアログを開くには、Variant Managementダイアログでバリアントの列を選択し、Edit Variantボタンをクリックします。 新しいパラメーターを追加するには、 Add ボタンをクリックします。開いた Parameter Properties ダイアログで、新しいパラメーターの Name を入力し、 Value を設定してから、 OKをクリックします。新しいパラメーターが Edit Project Variant ダイアログに表示されます。
以下の画像では、ProjectTitleという名前のパラメーターが、プロジェクトと各バリアントに定義されています。動画では、Variantsセレクターを使用して基本設計、続いて各バリアントを表示したときのPCB上の動作を示しています。

プロジェクトに(Project Options ダイアログから)追加したProjectTitleパラメーターを、各設計バリアントにも追加し、それぞれ異なる値を設定しています。
PCBのオーバーレイには特殊文字列.ProjectTitleが配置されており、同じ名前のプロジェクトパラメーターとバリアントパラメーターに自動的にリンクされます。
DbLinkファイルを使用する場合のバリアント
Altium Designerは、プロジェクトでのDBLinkファイルの使用を含め、コンポーネントの保存と操作を行う複数の方法に対応しています。DBLinkファイルは、回路図上のコンポーネントと企業のデータベースをつなぐインターフェースです。
DBLibタイプのライブラリからコンポーネントを配置する際に一般的に行われるように、各コンポーネントから特定のデータベースレコードへの参照を作成するだけではなく、DBLinkモデルでは、1つ以上のコンポーネントパラメーターに基づいてユーザーがクエリ操作を開始する必要があります。すると、ソフトウェアは、一致する値を持つフィールドを含むレコードをデータベース内で検索します。一致するレコードが見つかると、そのレコードの他のフィールド値(部品番号など)をAltium Designerのコンポーネントに取り込むことができます。component parameter-to-database fieldのマッピングは、対象データベースとともにDBLinkドキュメントで定義します。
► 詳細については、データベースライブラリを参照してください。
バリアントを使用しない設計では、データベースからパラメーターを更新コマンドを使用してクエリ操作を実行します。また、BOM生成時にInclude Parameters from Databaseオプション(以下を参照)を有効にして実行することもでき、価格など、BOM固有のコンポーネントデータを抽出できます。
バリアントを含む設計では、データベースへのクエリに使用するパラメーターを Variant Management ダイアログで変更します。これらのパラメーター値は Variant Management ダイアログ内にのみ存在するため、データベース情報の取得に Update Parameters from Database コマンドは使用しません。代わりに、BOM の生成時にデータベースからパラメーターが抽出されます。
バリアントレポートの生成
Variant Management ダイアログの下部にある Detailed Report ボタンをクリックして開く Variant Report ダイアログでは、定義済みのプロジェクトバリアントに関する詳細な HTML 形式のレポートを設定し、生成できます。

Variant Report ダイアログ
Variant Report ダイアログのオプションとコントロール
-
Report Only Varied Components - このオプションを使用して、レポートに含める情報を指定します。
- Full Non-Varied Information(オプション無効)- すべてのコンポーネントが一覧表示され、有効な各バリアントでの実装状態が示されます。各コンポーネントについて、すべてのパラメーターとその値が一覧表示されます。
- Full Varied Information(オプション有効)- 有効なバリアント間で何らかの違いがあるコンポーネントのみが一覧表示され、各バリアントでの実装状態が示されます。各コンポーネントについて、バリアント間で何らかの違いがあるパラメーターのみが、その値とともに一覧表示されます。
- Project Variants - この領域には、元のベース設計(<Original Base>)と定義済みのすべてのバリアントが一覧表示されます。生成するレポートでは、特定のバリアントとベース設計、バリアント同士、またはすべてのバリアントとベース設計を比較できます。デフォルトでは、定義済みのすべてのバリアントと元のベース設計が、レポートに含まれるように有効になっています。必要に応じて、対応するチェックボックスで対象を含めるか除外するかを指定します。
- Run - このボタンをクリックすると、レポートが生成されます。作成されたレポートは、メイン設計ウィンドウ内でアクティブなドキュメントとして開きます。
バリアントのエラー
バリアント設定はプロジェクトファイル(*.PrjPcb)に保存されており、Variant Management ダイアログを開くと、このデータが読み取られ、解析されてダイアログに読み込まれます。データの読み込み時に、コンポーネントのデジグネーターやコンポーネント UID の不一致などの問題が検出されると、Information ダイアログが開き、問題の概要が表示されます。

設計作業を続ける前に、デジグネーターと UID の不一致を解決してください。
コンポーネント UID の不一致は自動的に解決され、修正内容はプロジェクトの保存時に保持されます。重複したデジグネーターは、回路図上で修正する必要があります。これらを解決するには、プロジェクトを検証(Project » Validate <project name>)し、Messages パネルで警告やエラーの詳細を確認してください。