バリアント管理ダイアログの使用方法

バリアントは Variant Management ダイアログで作成および設定します。ダイアログを開くには、Project メニューから Variants を選択するか（ショートカット: C, V）、または Projects パネルでプロジェクト名を右クリックして Variants を選択します。

ダイアログの機能

このダイアログには、主に 2 つの領域があります。

• 上部の Components for project 領域には、ベース設計内のすべてのコンポーネントが一覧表示され、必要に応じて適用されたバリアントの列も表示されます。

• 下部の Component Parameters 領域には、上部領域で現在選択されているコンポーネントのすべてのパラメータが表示され、必要に応じて適用されたバリアントの列も表示されます。

バリアントは Variant Management ダイアログで作成および設定します。

新しいバリアントの作成

Variant Management ダイアログで ボタンをクリックすると、ベース設計の新しいバリアントを作成できます。Edit Project Variant ダイアログが開きます。

最低限、Description フィールドにバリアント名を入力してください。デフォルトでは Variant of <ProjectName> が入力されています。

設計から製造用バリアントを生成する必要がある場合は、Edit Project Variant ダイアログで Allow variation of fabrication outputs オプションを有効にします。'Not Fitted' コンポーネントを含むバリアントを含んだ設計に対してペーストマスク出力を生成する必要がある場合は、Allow variation for paste mask オプションを有効にします。これらのコンポーネントのパッドには、以後ペーストマスクが含まれなくなります。

次のEdit Project Variantダイアログのオプションを使用すると、代替部品について、回路図上でシンボルを変更するか、あるいはPCBにフットプリントを追加するかを選択できます。

• Do not overwrite schematic symbol – 有効にすると、バリアントで代替部品が選択されているコンポーネントに対して、非変化シンボルが使用されます。

  このオプションは、回路図シート上のシンボル表現にのみ影響する点に注意してください。設計の接続性モデルが構築される際には、代替部品のシンボルが考慮されます。したがって、このオプションを有効にした場合でも、ベース部品と代替部品はピン互換である必要があります。ピン互換性の詳細については、Choosing an Alternate Partのセクションを参照してください。

• Do not overwrite PCB footprint – 有効にすると、バリアントで代替部品が選択されているコンポーネントに対して、非変化フットプリントが使用されます。バリアントに適用された代替部品のフットプリントは、PCB更新の一部としてPCBへ転送されません（PCBにフットプリントを追加するためのECOは生成されません）。

バリアント用のパラメータを定義することもできます。手順およびAltium Designer内のパラメトリック階層におけるバリアントレベル・パラメータの位置づけについては、Working with Variant Parametersを参照してください。

必要に応じてバリアントを定義したら、OKをクリックします。Variant Managementダイアログの右側に追加の列が開き、新しいバリアント名が列タイトルとして表示されます。すべてのセルは空で、空のセルは、そのコンポーネントがFittedであり、ベース設計から変更されていないことを示します。これで、新しいバリアント用にコンポーネントを設定できます。以下の図は、BGAとTSOPという2つのバリアントが作成されたプロジェクトを示しています。

領域1にはベース設計のコンポーネント、領域2にはBGAバリアントのコンポーネント、領域3にはTSOPバリアントのコンポーネントが表示されます。

Variant Managementダイアログには、有用な情報を表示するための複数のインターフェース機能が含まれています。これらは右クリックのコンテキストメニューから設定します。

前述していない便利なコマンドには、次のものがあります。

• Columns

  • Hierarchy Path – 設計階層内でのコンポーネントの場所を表示します。

  • Original Library Link – ベースコンポーネントの取得元を表示します。

• Set Selected As – サブメニューを使用して、変化の種類（Fitted、Not Fitted、Alternate）を選択します。コンポーネントセル内のコントロールをクリックする代わりに使用できます。バリアントのコンポーネントセルを右クリックした場合にのみ使用できます。

• Only Show Varied Parameters – Variant Managementダイアログ内で、何らかの変化が適用されているコンポーネントのみを表示します。

• Filter – サブメニューを使用して、Variant Managementダイアログに表示する変化の種類を制御します（Only Show Varied Parametersコマンドと組み合わせると便利です）。

コンポーネントのバリエーション定義

バリアントを作成すると、各コンポーネントのstateを変更できるようになります。これは、バリアント列のコンポーネントセルをクリックしてコントロールを表示するか、セルを右クリックしてSet Selected Asコンテキストサブメニューから必要な項目を選択することで行えます。

コントロールを使用すると、Edit Component Variationダイアログが開きます。

次の3つの選択肢があります。

•  Fitted – ベース設計で使用されている元のコンポーネントも、この設計バリアントで装着／使用されます。新しく追加されたバリアントでは、すべてのコンポーネントはデフォルトでFittedとなり、装着されているコンポーネントのセルは空になります。なお、ダイアログのComponent Parameters領域で新しいパラメータ値を入力することにより、Fittedコンポーネントに対して個別のパラメータを変更することもできます。

• Not Fitted – ベース設計で使用されている元のコンポーネントは、この設計バリアントでは装着／使用されません。Not Fittedのコンポーネント状態では、セルにNot Fittedというテキストが表示され、ダイアログ下部のComponent Parameters領域は空白になります。

• Alternate Part – このオプションでは、別の（代替）部品を選択できます。ダイアログが展開され、必要な置き換えコンポーネントを参照して見つけるためのコントロールが表示されます。部品を選択すると、セルには代替部品のソースリンクが表示されます。ダイアログのComponent Parameters領域には、代替部品内のすべてのパラメータが表示されます。詳細は次のセクションを参照してください。

代替部品の選択

Alternate Partオプションを選択すると、Edit Component Variationダイアログが展開され、既存部品のベースパラメータが表示されます。ボタンを使用して、Replace Component dialogで必要な代替部品コンポーネントを参照して見つけます。これはComponents panelのモーダルダイアログ版です。独立ライブラリ、データベースライブラリ、Workspace Libraryコンポーネント（以下の例に示すもの）など、Altium Designerのすべてのコンポーネント保存モデルがサポートされています。

Alternate Partバリエーションの例。

新しく適用した代替コンポーネントは設計空間で確認できます。詳細はWorking with Variants in the Designページを参照してください。

バリアントデータのリセットと更新

Variant Managementダイアログで設定した設計バリエーションは、最終的にプロジェクトファイルに保存されます。これには、'Not Fitted'状態、Fittedコンポーネントに対するローカルなパラメータ変更、およびAlternate Partsのパラメータ値が含まれます。実際のAlternate Partsは[ProjectName].PrjPcbVariantsファイルに保存されます。Variant Managementダイアログには、パラメータのリセットおよびコンポーネントの更新のためのコマンドが用意されており、ソースコンポーネントライブラリとの同期を確保するのに役立ちます。

変更されたコンポーネントパラメータの更新

Variant Managementダイアログでローカルに変更したパラメータは、Variant Parameterリスト内の変更済みパラメータ（太字で表示）を右クリックし、コンテキストメニューからReset Selectedを選択することで元の値に戻せます。以下に示すとおりです。複数のパラメータを一度に選択して1回の操作でリセットすることもでき、またはReset Allを使用してそのコンポーネントのすべてのパラメータをリセットすることもできます。

変更されたパラメータは、Reset Selectedコマンドを使用して値を元に戻せます。

代替部品パラメータの更新

Alternate Partとして使用されているライブラリコンポーネントのパラメータがライブラリ内で変更された場合、そのバリアントのParameterリスト内を右クリックし、メニューからUpdate Values from Libraryを選択することで、それらの変更をプロジェクト内のバリアント定義へ直接反映できます（以下に示すとおり）。これはパラメータを更新するものであり、グラフィックを更新する必要がある場合は、以下で説明する方法を使用してください。

ライブラリ内のAlternate Partコンポーネントが変更された場合は、Update Values from Libraryコマンドを使用して、プロジェクトで使用されているコピーを更新してください。

Update Values from Libraryコマンドの実行後、Browse Librariesダイアログでソースライブラリ内のコンポーネントを参照して見つけ、OKをクリックしてUpdate Project Variants From Libraryダイアログを開きます。Parameters from Library ComponentとVariants to Updateを選択／選択解除し、OKをクリックして更新処理を完了します。

ソースライブラリから変更済みコンポーネントを更新しています。ここでは、どのパラメータを更新するか、また更新をどのバリアントに適用するかを設定します。

すべてのパラメーターは Update Project Variants From Library ダイアログの左側に一覧表示され、必要に応じて任意のパラメーターの選択を解除し、更新処理の対象から除外できます。ダイアログの右側では、対象のプロジェクトバリアントを変更できます（Project Variant To Update）。既定では、Update Values from Library コマンドを有効にした時点で選択されていたバリアントが選択されます。

代替部品を完全に更新する

代替部品のソースコンポーネントがライブラリ内で編集された場合、Update from Library dialog を実行して設計内で更新できます。

回路図エディターの Tools メニューから起動されるこのダイアログには、Include Variants のオプションが含まれています。このオプションを有効にすると、コンポーネント一覧が展開され、代替部品として使用されているコンポーネントも含まれるようになります。更新するコンポーネントを一覧でチェックし、その後ウィザードを完了して、必要な部品をソースから更新します。

グラフィックを含めて代替部品を完全に更新するには、Include Variants チェックボックスを有効にし、更新対象の部品を有効にします。

複数コンポーネントの複数パラメーターを変更する

Variant Management ダイアログは複数選択に対応しているため、ダイアログ上部の（コンポーネント）領域で任意の数のコンポーネントを同時に選択し、その後、下部の（パラメーター）領域で選択した任意の数のパラメーターに対して更新を実行できます。また、このダイアログではフィルター（右クリックのコンテキストメニューから）も利用でき、選択内容や表示データをさらに絞り込むことができます。

例として、すべてのバリアントにあるすべてのコンポーネントについて、手動で変更されたパラメーターをリセットするには、次のようにします。

1. ダイアログ上部の（コンポーネント）領域で、右クリックメニューの Only Show Varied Components オプションを、右クリックの Filter オプションと組み合わせて使用し、Show Fitted with Varied Parameters のみを表示します。これでコンポーネント一覧には、手動で変更されたパラメーターを持つコンポーネントだけが表示されるはずです。

2. コンポーネント一覧内で右クリックし、コンテキストメニューから Select All を選択します。これで、ダイアログ上部に現在表示されているすべてのコンポーネントが選択されます。

3. 次に、ダイアログ下部の（パラメーター）領域で右クリックし、そのコンテキストメニューから Select All を選択します。これで、すべてのコンポーネントのすべてのパラメーターが選択されます。なお、代わりに Select Column コマンドを選択することもでき、その場合は特定のバリアント（列）内のコンポーネントに対してアクション（リセットなど）を適用できます。

4. パラメーター一覧で再度右クリックし、コンテキストメニューから Reset Selected を選択します。以下の画像にカーソルを合わせると、手順 2、3、4 が表示されます。

すべてのバリアント内のすべてのコンポーネントについて、手動で変更されたすべてのパラメーターをリセットします。画像にカーソルを合わせると、手順 2、3、4 が表示されます。

バリアントパラメーターの操作

Altium Designer は、プロジェクトのさまざまなレベルのパラメーターをサポートしています。たとえば、ドキュメントレベルのパラメーターは、回路図エディターの Properties パネルの Parameters タブに各回路図シートごとに追加できます（何も選択されていない場合に利用可能）。また、プロジェクトレベルのパラメーターは、Project Options ダイアログの Parameters タブでプロジェクトに追加することもできます（Project » Options）。

さらに、パラメーターは Edit Project Variant ダイアログを使用してバリアントにも追加できます。Variant Management ダイアログでバリアント列を選択し、Edit Variant ボタンをクリックしてこのダイアログを開きます。 新しいパラメーターを追加するには、Add  ボタンをクリックします。開いた Parameter Properties ダイアログで Name  を入力し、新しいパラメーターの Value  を設定してから OK をクリックします。新しいパラメーターが  Edit Project Variant  ダイアログに表示されます。

以下の画像では、ProjectTitle という名前のパラメーターがプロジェクトと各バリアントの両方に定義されています。動画では、Variants セレクターを使用してベース設計を表示し、その後各バリアントを表示したときの PCB 上での動作を示しています。

ProjectTitle パラメーターがプロジェクトに追加され（Project Options ダイアログ経由）、さらに各設計バリアントにも追加されていますが、それぞれ異なる値が設定されています。

特別な文字列 .ProjectTitle が PCB オーバーレイ上に配置されており、同じ名前のプロジェクトパラメーターおよびバリアントパラメーターに自動的にリンクされます。

DBLink ファイル使用時のバリアント

Altium Designer は、コンポーネントの保存および操作に関する複数の方法をサポートしており、その中にはプロジェクトで DBLink ファイルを使用する方法も含まれます。DBLink ファイルは、回路図上のコンポーネントと社内データベースとの間のインターフェースです。

各コンポーネントから特定のデータベースレコードへの参照を作成するだけではなく（通常、DBLib タイプのライブラリからコンポーネントを配置する際に行われる方法）、DBLink モデルでは、1 つ以上のコンポーネントパラメーターに基づいてクエリアクションを開始します。するとソフトウェアは、値が一致するフィールドを含むレコードをデータベース内で検索します。一致が見つかると、そのレコードの他のフィールド値（部品番号など）を Altium Designer のコンポーネントに返すことができます。component parameter-to-database field マッピングは DBLink ドキュメント内で定義され、対象データベースも同様に定義されます。

► Database Libraries

の詳細はこちら。バリアントを使用しない設計では、クエリアクションは Update Parameters from Database コマンドを使用して実行され、BOM 生成時にも Include Parameters from Database オプション（下記参照）を有効にすることで実行できます。これにより、価格などの BOM 固有のコンポーネントデータを取得できます。

バリアントを含む設計では、データベースの検索に使用するパラメーターが Variant Management ダイアログで変更されます。これらのパラメーター値は Variant Management ダイアログ内にのみ存在するため、データベース情報の取得に Update Parameters from Database コマンドは使用されません。代わりに、BOM 生成時にデータベースからパラメーターが抽出されます。

バリアントレポートを生成する

Variant Management ダイアログの下部にある Detailed Report ボタンをクリックしてアクセスする Variant Report ダイアログでは、定義されたプロジェクトバリアントの詳細な HTML 形式レポートを設定して生成できます。

Variant Report ダイアログ

バリアントエラー

バリアント設定はプロジェクトファイル（*.PrjPcb）に保存されており、このデータはダイアログを開いた際に読み込まれ、解析され、Variant Management ダイアログにロードされます。データの読み込み時に、コンポーネントのデジグネータやコンポーネントUIDの不一致などの問題が検出されると、問題の内容を示す Information ダイアログが開きます。

設計プロセスを続行する前に、デジグネータおよびUIDの不一致を解消してください。

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