バリアントマネージャーの使用方法

Variant Manager はドキュメントベースのユーザーインターフェースで、PCB 設計プロジェクトの設計バリアントを表示、作成、管理できます。Variant Manager にアクセスするには、Projects パネルでプロジェクト項目を右クリックして Variants を選択するか、回路図エディタまたは PCB エディタのメインメニューから Project » Variants を選択します。

バリアントの操作

新しいバリアントの作成

新しいバリアントを追加するには、Variants タブがアクティブなときに Variant Manager の左上にある Add Variant ボタンを使用します。下の画像のように、グリッド領域にデフォルトのタイトルを持つ追加のバリアント列が表示されます。新しい列のセルはすべて空で、空のセルはそのコンポーネントが Fitted（実装）で、ベース設計から変更されていないことを示します。

新しいバリアントは、デフォルトで全コンポーネントが Fitted の状態で追加されます。

Variant Manager に表示するバリアントは、右上の   をクリックして開く Variants Filter ダイアログでフィルタできます。表示したいバリアントに対応するチェックボックスを有効にしてください。ダイアログで OK をクリックすると、有効化されたチェックボックスに従ってバリアントがフィルタされます。フィルタが適用されている場合、フィルタボタンは として表示されます。フィルタを解除または変更するには、フィルタボタンをクリックして Variants Filter ダイアログを再度開き、チェックボックスを更新します。Project Variants  チェックボックスが有効な場合、プロジェクト内のすべてのバリアントが表示されます。 

バリアントプロパティの設定

バリアントのオプションを変更するには、Properties パネルを Variant モードで使用します。これは、対象バリアントの列ヘッダーを右クリックして Properties を選択するとアクセスできます。

Properties パネルを Variant モードで開き、バリアントのオプションを変更します。

• Name フィールドで、バリアントに意味のある名前を設定してください。

  バリアント名は、バリアント列ヘッダーをクリックして選択し、Variant Manager の左上にある   をクリックして開く Rename Variant ダイアログ、またはバリアント列ヘッダーを右クリックして Rename Variant を選択することでも変更できます。

• 代替部品について、回路図上でシンボルを変更する必要があるか、PCB にフットプリントを追加する必要があるかは、次のオプションで選択できます。

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

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

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

  これら 2 つのパラメータが有効かどうかに関わらず、選択した代替部品のパラメータは ActiveBOM に正確に反映されます。

• 設計から製造用バリアントを生成する必要がある場合は、Allow variation of fabrication outputs オプションを有効にします。出力ジョブで製造出力にバリアントが指定されていて、そのバリアントで not オプションが有効になっていない場合、ジョブのバリアント名が赤で表示されます。赤いバリアント名は警告フラグに過ぎず、バリアント固有の出力ファイルは引き続き生成されます。

  「Not Fitted」コンポーネントを含むバリアントがある設計でペーストマスク出力を生成する必要がある場合は、Allow variation for paste mask  オプションを有効にします。これらのコンポーネントは、パッド上にペーストマスクが含まれなくなります。

  Output Job ファイルにバリアントを追加して表示する方法については、Preparing Manufacturing Data with Output Jobs ページを参照してください。

• パネルの Variant's Parameters 領域を使用して、バリアントレベルのパラメータ一覧を定義します。

  バリアントパラメータは、特殊文字列を配置することで回路図または PCB ドキュメントに表示できます。詳細は Special Strings on a Schematic  および Special Strings on a PCB を参照してください。

  Altium Designer は、プロジェクト、回路図ドキュメント、バリアントなど、プロジェクトのさまざまなレベルのパラメータをサポートします。プロジェクト内の各レベルに含まれるパラメータは階層構造になっているため、同じ名前のパラメータを異なるレベルで作成し、それぞれに異なる値を設定できます。Altium Designer は次の優先順位でこの状況を解決します。

  1. バリアント（最優先）
  2. 回路図ドキュメント
  3. プロジェクト

  この構成により、回路図ドキュメントで定義されたパラメータ値は Project options で定義された値を上書きし、バリアントで定義されたパラメータ値は回路図ドキュメントで定義された値を上書きします。

バリアントのプロパティ

セルを右クリックし、Properties を選択すると、選択した Component/Group の詳細を表示する Properties パネルが開きます。必要に応じて、バリアントの Component Parameters を編集できます。 

パラメータは、グリッド内でコンポーネントを選択し、グリッド下部に表示される Parameter 領域を展開することでも表示・編集できます。

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

ベース設計内の各コンポーネントは、次のように設定できます。

• Fitted – 新しいバリアント作成時のデフォルト設定です。
• Not Fitted – ベース設計で使用されている元のコンポーネントは、この設計のバリアントでは実装/使用されません。
• コンポーネントの値など、コンポーネントパラメータを変更した状態で実装。
• Alternate Part – あるコンポーネントを別のコンポーネントに完全に置き換えます。

設計バリアント内でコンポーネントの状態を変更するには、バリアント列のコンポーネントセルをクリックし、セルのドロップダウンから次の 3 つの選択肢を選びます。

• (Fitted) – ベース設計で使用されている元のコンポーネントは、この設計のバリアントでも実装/使用されます。なお、実装されているコンポーネントでも個別パラメータをバリエーションさせることができます。下記参照。

• Not Fitted – ベース設計で使用されている元のコンポーネントは、この設計のバリアントでは実装/使用されません。

• Alternate Part – このオプションでは、別の（代替）部品を選択できます。Replace ダイアログ（Components  パネルのモーダルダイアログ版）を使用して、必要な代替部品を選択します。部品を選択すると、セルには代替部品の ID が表示されます。

  代替部品を選択すると、ソフトウェアは選択した代替コンポーネントと元のベース設計コンポーネントのピン互換性をチェックします。ピン互換であるためには、代替部品は元のコンポーネントと同じピン数を持ち、それらのピンが位置および電気タイプにおいて同一である必要があります。2 つのコンポーネントのシンボルで使用されるグラフィカルプリミティブが一致している必要はありません。ソフトウェアが代替コンポーネントがピン互換でないことを検出した場合、置換が受け入れられる前に Confirm  ダイアログを閉じる必要があります。この場合、配線への潜在的な影響に注意してください。

回路図上のシンボル変更や PCB へのフットプリント追加を行わずに代替部品を選択することもできます。Properties パネルで、必要に応じて Do not overwrite schematic symbol  および/または Do not overwrite PCB footprint  オプションを有効にしてください。後者を有効にすると、バリアントに適用された代替コンポーネントのフットプリントは PCB 更新の一部として PCB に転送されません（PCB にフットプリントを追加する ECO は生成されません）。選択した代替部品のパラメータは ActiveBOM に正確に反映されます。

上記のコンポーネント状態は、グリッド内で右クリックし、Set Selected As を選択してから、下図のように関連メニューから目的の状態を選択することでも設定できます。

必要なバリアント列のセルにあるドロップダウンを使用して、コンポーネントのバリエーションを定義します。Alternate Part オプションを選択する場合は、Replace ダイアログを使用して代替部品を選択します。

実装（Fitted）または代替（Alternate）のコンポーネントについて、個々のパラメータは Properties パネルで新しいパラメータ値を入力することで変更できます。必要なバリアント列でコンポーネントのセルをクリックし、Properties パネルを Component for variant モードにした状態で、Component Parameters 領域にある選択中バリアントの列を使って、変更後のパラメータ値を入力します。Footprint パラメータについては、複数のフットプリントモデルがコンポーネントに割り当てられている場合、セルのドロップダウンをクリックしてフットプリントを選択します。ベース設計と異なるパラメータ値は黄色で表示され、グリッド領域のコンポーネントセルにはコンポーネント名が表示されます。

実装コンポーネントの代替パラメータを定義する例。画像のように新しいパラメータ値を入力します。画像にカーソルを合わせると、新しいパラメータ値を定義した後のコンポーネントセルを確認できます。

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

Alternate Part として使用されているライブラリコンポーネントのパラメータがライブラリ側で変更された場合、その変更をプロジェクト内のバリアント定義へ直接取り込むことができます。メインのグリッド領域で必要な代替コンポーネントを選択した状態で、Variant Manager 下部の Parameter 領域の右クリックメニュー、または Properties パネルの Component Parameters 領域から Update Values from Library コマンドを選択し、ライブラリコンポーネントに対して行われたパラメータ変更を取り込みます。

Variant Manager で Update Values from Library コマンドにアクセスします。ここでは、必要なコンポーネントのエントリを選択した状態で Parameter 領域の右クリックメニューからアクセスしています。画像にカーソルを合わせると、代替部品のエントリを選択した状態で Properties パネルからアクセスする方法を確認できます。

Replace ダイアログでソースライブラリ内のコンポーネントを参照して見つけ、OK をクリックして Update Project Variants From Library ダイアログを開きます。Update Project Variants From Library ダイアログの左側にはすべてのパラメータが一覧表示されます。必要に応じて、任意のパラメータを選択解除して更新プロセスから除外できます。ダイアログ右側では、対象の Project Variant を変更できます（Project Variant To Update）。これは、Update Values from Library コマンドを起動した時点で選択されていたバリアントが既定で選択されます。OK をクリックして更新プロセスを完了します。

バリアントのコピー

Make a copy コマンドを使用してバリアントをコピーできます。バリアント名列のヘッダーを右クリックし、Make a copy  オプションを選択します。同じデータと名前（末尾に「Copy」が付加されます）を持つ新しい列が追加されます。Rename オプションを使用して、新しい列に適切なタイトルを付けることができます。

バリアントの削除

バリアントを削除するには、ヘッダーを選択してから アイコンを使用します。下図のように、右クリックのコンテキストメニューにも、このバリアントまたはすべてのバリアントを削除する機能が含まれています。削除が実行される前に確認用ダイアログが開きます。

グループの操作

多数の設計バリアントの管理を容易にするため、Variant Manager では、選択した回路図シート、選択したシートシンボルが参照するシート、または選択したコンポーネントクラスからコンポーネントのグループを作成し、コンポーネントのバリエーションを機能ベースで表示できます。各グループに対して、1つ以上の「オプション」を定義できます。これは、グループ内の1つ以上のコンポーネントの何らかのバリエーションを実質的に反映するものです。これらの定義済みグループとオプションに基づいてバリアントを作成でき、バリアントの階層作成もサポートされます。変更が必要になった場合、グループオプション内の値を編集すると、そのグループオプションを使用しているすべてのバリアントに即座に反映されます。

グループを使用するワークフローは次のとおりです。

1. Variant Manager 上部のコントロールを使用して Groups タブに切り替えます。

2. Add Group ボタンのドロップダウンメニューを使用して、グループを作成する対象の回路図ドキュメント、シートシンボル、またはコンポーネントクラスを選択します。

   
   このグループに基づく以降のバリアント管理を容易にするため、グループを追加します。

3. 新しいグループは Variant Manager の左側ペインに一覧表示され、選択したグループのコンポーネントは右側に一覧表示されます。

   既定では、選択した回路図シート／シートシンボル／コンポーネントクラスの名前が、新しく作成されたグループに割り当てられます。必要に応じて、グループ一覧領域の下部にある Rename ボタンを使用してグループ名を変更します。

   Add Option ボタンを使用して、現在選択されているグループにオプションを追加します。グリッド領域に既定タイトルの追加オプション列が表示されます。新しい列のすべてのセルは空で、空のセルはそのコンポーネントが Fitted であり、ベース設計から変更されていないことを示します。

   
   画像のように、選択したグループにオプションを追加します。画像にカーソルを合わせると、既定のオプション列を確認できます。

4. 既定名を変更して、新しく作成したオプションに意味のある名前を割り当てます。オプションの列ヘッダーをクリックして選択し、グリッド領域下部の Rename ボタンをクリックするか、ヘッダーを右クリックして Rename を選択し、ダイアログを開いて新しい名前を入力します。

   
   オプションに意味のある名前を設定します。

5. 必要なオプションの列にあるコンポーネントセルを使用して、コンポーネントのバリエーションを設定します。手順は、バリアントのコンポーネントバリエーションを定義する場合 と同じです。

   
   選択したオプションのコンポーネントバリエーションを設定します。

   コンポーネントパラメータを手動で変更することは推奨されません。また、代替コンポーネントの使用を強く推奨します。グループで作業する際に代替フットプリントを使用する場合は、別のコンポーネントを使用してください。
   バリアントグループオプションのセル内容は、右クリックのコンテキストメニューの各コマンド、または適切なショートカット（それぞれ Ctrl+C、Ctrl+V、Ctrl+X）を使用してコピー／貼り付け／切り取りできます。

6. グリッド領域で右クリックして Add Option を選択し、選択したグループにさらにオプションを追加します。必要に応じて新しいオプションを設定します。

   
   必要に応じて、さらにオプションを追加して設定します。

7. Variant Manager の Variants タブでは、グループが作成されたコンポーネントが、グリッド領域の該当エントリの下に表示されます。グループエントリのセルのドロップダウンを使用して、Groups タブでこのグループ用に作成したオプションを選択します。このグループ内のコンポーネントに設定されたバリエーションが適用されます。

   
   画像のように、選択したグループにオプションを追加します。画像にカーソルを合わせると、既定のオプション列を確認できます。

グループオプションのコピー

バリアントグループのオプションをコピーするには、Groups タブで <New Option> 列見出しを右クリックし、Make a copy を選択します。同じデータと名前（末尾に「Copy」が付加されます）を持つ新しい列が追加されます。Rename オプションを使用して、新しい列に適切なタイトルを付けることができます。

注記

• バリアントを設定すると、その設定はプロジェクトファイルに保存されます。これには Not Fitted の状態、Fitted コンポーネントに対するローカルなパラメータ変更、Alternate Parts のパラメータ値が含まれます。Alternate Parts は <ProjectName>.PrjPcbVariants ファイルに保存されます。
• バリアント列はピン留めして、ピン留めされていない列の左側に先頭表示できます。バリアント列をピン留めするには、ヘッダーにカーソルを合わせて をクリックします。
• コンポーネントをダブルクリックするか、右クリックして Cross Probe オプションを選択すると、回路図上の該当コンポーネントへジャンプできます。
• Variants タブのグリッド領域、または Parameter 領域の右クリックメニューから Select All コマンドを使用して、グリッド内容をすべて素早く選択できます。
• Variants タブのグリッド領域、または Parameter 領域の右クリックメニューから Invert Selection コマンドを使用して、未選択のエントリを素早く選択し、選択済みのエントリを解除できます。
• Variant Manager の左下にある View Report ボタンをクリックすると、開いた Variants Report ダイアログを使用して HTML 形式の詳細なバリアントレポートを生成できます。
• VariantsタブまたはParameter 領域のグリッドエリアで右クリックし、コンテキストメニューの以下のコマンドを使用してレポートファイルを生成します。
  • Report：クリックするとReport Previewダイアログが開き、グリッドの印刷出力を作成します。
  • Save All：クリックするとダイアログが開き、すべてのコンポーネント／選択したコンポーネントのすべてのパラメータの一覧を、タブ区切りのテキストファイル（*.txt）として保存します。
  • Save Selected：クリックするとダイアログが開き、選択したコンポーネント／選択したパラメータの一覧を、タブ区切りのテキストファイル（*.txt）として保存します。
• 回路図が変更されると、Variant Managerの上部に適切な通知が表示されます。通知の横にあるRefreshコントロールをクリックして、Variant Manager内のデータを更新します。
• セル上で右クリックしたときに表示されるDeleteオプションを使用して、バリアント、グループ、またはオプションを削除できます。