アイテムマネージャによるコンテンツの管理

Altium Designer は、接続された Workspace と連携することで、既存の基板設計内のコンポーネントを、その Workspace に存在するコンポーネントへ更新する機能を提供します。データベースライブラリおよびファイルベースライブラリから取得したコンポーネントは、個別に Workspace コンポーネントへ更新することも、Altium Designer の Item Manager を使用して自動パラメータ照合による一括更新を行うこともできます。

Workspace 内の適切なコンポーネントを対象とする高度に設定可能なルールシステムにより、Item Manager ダイアログは、現在の PCB プロジェクトを Workspace Components を使用するプロジェクトへすばやく効果的に変換する方法を提供します。

Item Manager は、基板設計プロジェクト内のコンポーネントおよび再利用可能な回路図回路のシートに関して、2 つの主要な機能を提供します。

• Migration – 1 つ目は、従来の方法に基づくコンポーネントおよび回路図シートを使用している設計プロジェクトを、Workspace エンティティ（コンポーネントおよび管理対象シート）を使用する形へ変換できることです。この点では、「Workspace データを使用するように変換する」機能と考えることができます。
• Synchronization – 2 つ目は、設計が Workspace コンテンツを使用するよう変換された後、Item Manager により、設計で使用されているコンテンツを、更新された Workspace 内の対応するソースコンテンツと簡単に同期できることです。この点では、「Workspace データから更新する」機能と考えることができます。

背景として、設計内の個々のコンポーネントは、回路図エディタの Properties panel から直接 Workspace コンポーネントへ更新できる点に注意してください。これを行うには、回路図シート上でコンポーネントを選択し、パネルの Source ドロップダウンメニューを使用して、コンポーネントデータソースとして Workspace を選択します。アクセスするには、その Workspace に接続している必要があります。続いて表示される Component source ダイアログでは、Workspace から対象コンポーネントを選択するか、コンポーネント識別子（Design Item ID）を保持または置換しつつ、コンポーネントを Workspace にリンクするかを選択できます。

Workspace コンポーネントが選択されると、取得したコンポーネントデータによって既存のコンポーネントおよびモデルが置き換えられ、コンポーネントパラメータも更新されます。パネルには、以下に示すように、そのコンポーネントの現在のライフサイクル状態およびリビジョンステータスも表示されます。

ローカルコンポーネントは、個別に Workspace コンポーネントへ変換することも、Item Manager を使用して一括変換することもできます。ここでは元のコンポーネントを確認できます。画像にカーソルを合わせると、そのコンポーネントが対応する Workspace コンポーネントに切り替わった状態を確認できます。

または、コンポーネントはプロジェクトの ActiveBOM ドキュメント（BomDoc）を通じて置き換える こともできます。

ただし、小規模な基板設計であっても、設計内のすべてのローカルコンポーネントを Workspace コンポーネントへ更新する方法としては手間がかかります。Item Manager は、高度なパラメータ照合（Automatching）と一括更新方式を使用する、シンプルで自動化された変換方法を提供します。Item Manager の典型的な用途は、既存の基板設計を、会社のライブラリから Workspace に移行された Workspace コンポーネントおよび管理対象回路図シートを使用するよう更新することです。

Item Manager へのアクセス

Item Manager ダイアログは、アクティブな回路図ドキュメントのメイン Tools メニュー（Tools » Item Manager）からアクセスでき、アクティブな基板設計プロジェクト内で見つかったすべてのコンポーネントおよびシートシンボルを表示します。

ダイアログ下部の Unmanaged または Components タブを選択すると、現在の設計内のコンポーネント一覧が表示されます。基本的に、ダイアログ左側のセクションにはアクティブプロジェクトのコンポーネント設定（Current Settings）が表示され、右側のセクションには、Workspace から適切な Workspace コンポーネントが割り当てられた際にそれらがどのように変更されるか（New Settings）が一覧表示されます。New Settings 領域には、Current Settings 領域と同じフィールドがあります。シートシンボルを表示してアクセスするには、Sheet Symbols タブを選択します。

回路図エディタのメイン Tools メニューから Item Manager にアクセスします。ダイアログには現在の設計コンポーネント（および回路図シート）が自動的に読み込まれます。

Item Manager ダイアログでのコンポーネントデータの表示方法は、有効化またはグループ化されたデータ列に基づいて高度に設定可能です。これにより、設計コンテンツの一覧と、それに関連付けられたシステム／ユーザーパラメータを、特定のコンポーネント識別方法に合う形で表示できます。たとえば、企業独自の部品番号など、すべてのアイテムパラメータを必要に応じて表示できます。

列

Item Manager に表示する列を設定するには、ダイアログの列見出し領域で右クリックし、コンテキストメニューから Columns » Select Columns を選択します。Select columns ダイアログには、ローカル設計固有のもの（[Current Settings]）および Workspace 内のコンテンツ（[New Settings]）を含む、利用可能なすべてのパラメータが表示されます。エントリ左側の「目」コントロールを使用して、その列を表示する（）か、表示しない（）かを切り替えます。

表示される列とその順序は、Workspace／ライブラリシステムやユーザー設定に合わせて構成できます。

列見出しにカーソルを合わせるとフィルタアイコンが表示され、これを選択すると、Item Manager 内の一覧を特定のエントリタイプまたはユーザー作成のカスタムフィルタに絞り込めます。

グループ化

コンポーネントタイプカテゴリや回路図ドキュメントなど、特定のパラメータ列で一覧コンテンツデータをグループ化するには、目的の列見出しエントリをダイアログ上部のタイトル行（ヒントテキストで示される位置）へドラッグします。コンテンツ一覧は、割り当てられたパラメータ列ごとにエントリをグループ化するよう再構成されます。

任意のデータ列見出しをダイアログ上部の行へドラッグすると、そのパラメータで一覧エントリをグループ化できます。

Workspace 設計コンテンツへの移行

接続された Workspace に components と managed schematic sheets のコレクションが格納されていると仮定すると、現在の基板設計プロジェクトは、適切な一致が利用可能な場合にそれらのコンテンツを使用するよう変換できます。ローカルから Workspace へのマッチングは手動で行うことも、設定可能なパラメータマッチングに基づいて Item Manager を通じた自動処理として行うこともできます。完了すると、ローカル部品定義は対応する Workspace のものに更新されます。

Workspace コンテンツを手動で選択する

ローカル部品（または回路図）を Workspace バージョンに手動で置き換えるには、Item Manager リストでそのエントリを選択し、右クリックのコンテキストオプションから Choose manually を選択します。グリッド内の項目をダブルクリックして、アイテムを手動で選択することもできます。続いて表示される Replace Component dialog で、Workspace 内の適切に一致する Item を参照して選択します（その Item の最新リビジョンが使用されます）。

設計内の既存部品のソースとして使用する Workspace 部品を手動で選択する例。

ダイアログを閉じると（OK）、選択した Workspace 部品の情報がリスト内のそのエントリの New Settings 領域に表示されます。このエントリは保留中の Workspace エンティティになったため、更新されたエントリは Unmanaged タブの一覧から Managed タブの一覧へ移動します。

選択した Workspace Item の詳細は、グリッドの New Settings 領域に Managed タブの下で表示されます。

部品の自動マッチング

一致する Workspace コンテンツの選択プロセスを自動化するために、Item Manager には設定可能な自動マッチング機能が用意されており、各ローカル設計部品を接続された Workspace 内の部品と一致させようとします。一致が見つかると、その Workspace 部品が更新候補として提案されます。

Item Manager の自動パラメータマッチング機能の鍵となるのは、Item Manager ダイアログの ボタンからアクセスできる Item Manager Options ダイアログで利用可能な更新ルールとオプションです。設定可能なルールにより、アクティブな（ローカル）設計内のどの部品パラメータを、選択した Source server 内のすべての Workspace 部品のパラメータと照合するかが決まります。

単純なルールまたは複雑なルールを作成して、ローカル部品を Workspace 内の適切な部品に正確に一致させることができます。

これらのルールがローカルから Workspace への部品マッチングをどれだけ効果的に実現できるかは、利用可能な部品パラメータに依存し、それは企業システムや個人の設定によって異なります。最も単純ですが、おそらく可能性は低いシナリオでは、Comment または Component Name パラメータエントリがローカル部品と対応する Workspace 部品の間で一致する場合があります。しかし理想的には、ローカル部品と Workspace 部品の両方が、会社の参照番号または製造元部品番号パラメータを共有していることです。

たとえばそのような部品番号ルールを作成するには、既存のルールを選択して変更する（名前変更も可能）か、 ボタンを使用して新しいルールを作成します。編集するにはルールが選択（チェック）されている必要があります。Local Parameter と Server Parameter の選択ドロップダウンリストは独立しているため、異なる名前のパラメータを指定できます。以下の例では、ローカルの Libray Reference パラメータと Workspace の Part Number パラメータが会社の部品参照番号を表しています。

複雑な複数パラメータルールでは、指定したすべての部品パラメータが Workspace 部品内のものと一致する必要があります。

上記のような部品/参照番号マッチングルールを実行すると、ローカル部品と Workspace 部品の間でほぼ完全な一致が得られる可能性があります。ルールを設定したら、Item Manager ダイアログの ボタンでマッチング処理を開始します。

続いて表示される Automatching items ダイアログでは、良好な一致が ステータスアイコンで示され、成功したルール名への参照も含まれます。

共通の部品番号に基づく単一ルールを使用して、多数の部品でローカルから Workspace への一致に成功した例。

一致が見つからない場合、そのエントリは ステータスアイコンで表示され、赤字になり、エラーまたは一致失敗の理由を示す参照情報が含まれます。このようなコンポーネントで正常に一致させるには、別の、または追加のルール を作成する必要があります。また、1つのルールが一致候補として複数の Workspace コンポーネントを検出する場合がある点にも注意してください。これは成功した結果と見なされますが、解決には手動での対応が必要です。この競合は「ambiguous」な結果として扱われ、Item Manager ダイアログで解決できます。詳細は以下を参照してください。

自動一致処理が完了したら、Automatching items ダイアログ（OK）を閉じて、提案された新しいコンポーネント設定を Items Manager ダイアログに反映させます。一致したエントリに適用される保留中の Workspace コンテンツは、ダイアログの Managed タブ内の New Settings 領域、または未一致のコンテンツとともに Components タブに一覧表示されます。

Workspace コンテンツに対する保留中の変更は、ダイアログの New Settings 領域に詳細表示されます。

あいまいなコンテンツ（通常は複数一致が原因）を解決するには、Ambiguous Items（または Ambiguous Footprints）タブを選択し、ダイアログの New Settings セクション内にある Revision HRID セルのドロップダウンメニューから適切な選択肢を選びます（既定では <Not selected> と表示されます）。複数一致、したがって利用可能な選択肢は、実際には同一コンポーネントの異なるリビジョンを参照している場合がある点に注意してください。問題が解決されると（ambiguous と見なされなくなると）、そのコンポーネントエントリは Managed/Components タブの一覧へ移動します。

ルールが複数の一致を検出した場合、Ambiguous Items タブで候補を指定できます。一致が6件を超えるとルールエラーになります。

高度な一致ルール

前述のとおり、Item Manager ルールはローカルプロジェクトのコンポーネントと Workspace コンポーネントの間でパラメータ一致を確立します。ルールはいくつでも作成でき、優先度の高い順に適用されます。最初（最上位）のルールが失敗した場合、次のルールが適用されます。つまり、実質的には順次評価されるブール OR の関係です。ルールは、関連するチェックボックスが有効な場合にのみアクティブになります。

自動一致処理を実行すると、Automatching items ダイアログの State Notes 列に、一致の検出に失敗したルールが表示されます。この場合、利用可能なパラメータを適切に一致させるには、別のルールまたは新しいルールが必要です。

基本的なルールではすべてのコンポーネントに一致が見つからない場合でも、より具体的なパラメトリックルールを作成することで、完全一致の結果を得ることができます。

Item Manager Options ダイアログの Add Rule ボタンを使用して新しいルールを作成し、関連する によって複数のパラメータ一致条件を適用します。 をクリックすると、選択した値を削除します。各パラメータ条件が追加されるごとにルールの条件はより具体的になり、一致を成功させるにはすべての条件を満たす必要があります。つまり、実質的にはブール AND 条件です。Remove ボタンをクリックすると、選択した一致ルールを削除します。

ここで示す例では、（たとえば）部品番号/参照番号パラメータではコンポーネントを一致させられない場合、上に示した未一致のコンデンサ一覧に対して、適切な仕様で一致させる新しいルールを作成できます。

ルールは、一致が見つかるまで上から下の順に動作します。複数パラメータのルールでは、一致のためにすべての条件を満たす必要があります。

更新オプション

Item Manager Options ダイアログには、現在の基板設計に自動一致した Workspace コンポーネントをどのように適用するかをさらに細かく調整するための、さまざまなコンテンツ更新オプションが用意されています。

Matching rules 領域には、一致用に定義された現在のルールが表示されます。詳細は Automatching Components セクションを参照してください。

Item Manager の Update options は、どのパラメータを、どの条件で更新するかを柔軟に決定する方法を提供します。

これらのオプションは ECO プロセスを通じて現在の設計に適用され、動作は次のとおりです。

• Update ‘Lock Designator’ field – チェックすると、ローカルコンポーネントの Designator フィールドに対する Locked 状態は、リンクされた Workspace コンポーネントの状態で上書きされます。
• Update ‘Lock Part-ID’ field – チェックすると、ローカルコンポーネントのマルチパートデバイス ID セレクタの Locked 状態は、リンクされた Workspace コンポーネントの状態を採用します。
• Update Parameters – チェックすると、コンポーネントのパラメータをリンクされた Workspace コンポーネントのものに更新できるようになります。以下のオプションが有効になります。
  • button – Library Update Settings ダイアログを開きます（以下を参照）。
  • Preserve parameter location – チェックすると、回路図シート上の可視パラメータの位置は、リンクされた Workspace コンポーネントの既定位置にリセットされず、変更されないまま保持されます。
  • Preserve parameter visibility – チェックすると、パラメータの Visible ステータスは、リンクされた Workspace コンポーネントのものを採用せず、変更されないまま保持されます。

Library Update Settings ダイアログには、現在の基板プロジェクト内のすべてのコンポーネントについて、利用可能なすべてのパラメータの一覧が含まれます（右クリックで一括オン/オフ機能にアクセス可能）。一覧でチェックされたパラメータは、ローカルコンポーネントが Workspace コンポーネントに置き換えられる、または更新される際に更新されます。この更新の動作は、以下に示すオプションによって決まります。

どのコンポーネントパラメータを更新するかは、正確に指定できます。右クリックでチェックオプションを利用できます。

パラメータの置換（または追加）の動作は、ダイアログ下部の2つのオプションによって決まります。

• Library parameters not in sheet – Workspace コンポーネント（Library）のパラメータがローカル（Sheet）コンポーネントに存在しない場合の更新動作を設定します。
  • Add – 更新時にそのパラメータをコンポーネントへ追加します。
  • Do not add – 更新時にそのパラメータをコンポーネントへ追加しません。
  • Add if not blank – 有効なデータがある場合のみ（Value エントリが空白でない場合のみ）、更新時にそのパラメータをコンポーネントへ追加します。
• Sheet parameters not in library – ローカル（Sheet）コンポーネントのパラメータがリンクされた Workspace コンポーネント（Library）に存在しない場合の更新動作を設定します。
  • Remove – 更新時に既存の（ローカル）パラメータをコンポーネントから削除します。
  • Do not remove – 更新時に既存のパラメータをコンポーネントから削除しません。
  • Remove if blank – 有効なデータがない場合のみ（Value エントリが空白の場合のみ）、更新時に既存のパラメータをコンポーネントから削除します。

更新の適用

Item Manager で設定した提案変更は、Engineering Change Order（ECO）を生成して実行することで現在の基板設計に適用されます。更新したい一覧コンポーネントの範囲を選択し、 ボタンメニューから目的の ECO オプションを選択します。オプションは次のとおりです。

• Generate ECO – このコマンドを使用すると、Engineering Change Order ダイアログを通じて ECO を生成して実行します。ダイアログ内では、変更を実装するために実行されるアクションを確認し、必要に応じて任意のアクションを無効にできます。問題なければ ECO を実行すると、変更が適用されます。
• Apply ECO – このコマンドを使用すると、ECO を「quietly」（Engineering Change Order ダイアログを表示せずに）直接作成して実行します。

変更は Engineering Change Order（ECO）を使用して実装され、サイレント実行することも、ダイアログ経由で実行することもできます（図参照）。

実行された ECO プロセスにより、プロジェクトコンポーネントはそれに応じて更新され、その後 Item Manager ダイアログには、現在最新の Workspace コンポーネントとして一覧表示されます。各エントリの以前のアイコン（）が、Workspace コンポーネントへの参照を示すもの（）に変わっている点に注意してください。

PCB プロジェクト内の設計コンテンツについて、新しい現在設定を示す Item Manager。以前はローカルだった設計コンポーネントは、完全に Workspace コンポーネントへ置き換えられています。

回路図エディタでは、更新されたコンポーネントは Workspace 内の一致したコンポーネントにリンクされます。このアクティブリンク情報により、Workspace コンポーネントのリビジョン状態が後で更新された場合、その変更を検出できます。設計領域でコンポーネントを選択し、Properties panel 内の Source と関連情報を確認してください。

ローカルコンポーネントの置き換えが正常に行われた例。Properties パネルには、置き換え後コンポーネントの Workspace ソースとリビジョン状態が表示されています。

変更された Workspace コンテンツとの同期

製品開発の過程では、設計のソースコンポーネントや管理対象の回路図シートに変更が発生する可能性が非常に高くなります。たとえば、コンポーネントモデルが新しい作図標準に更新されたり、新しいパラメータを追加するためにコンポーネント定義が更新されたりすることがあります。設計で使用されている Workspace コンポーネントおよび管理対象シートに対して行われたこうした変更は、検出され、影響を受ける回路図シートへ反映される必要があります。

更新が必要な場合の検出

個別に選択したコンポーネントまたはシートシンボルについては、Properties パネルの適切な Component または Sheet Symbol モードにより、そのオブジェクトが Workspace のソースデータに対して最新ではないことが即座に示されます。関連する または ボタンを使用して、そのオブジェクトのデータをソース Workspace から更新してください。

コンポーネントまたは管理対象回路図シートが最新ではない状態であることは、オブジェクトを選択した際に Properties パネルに表示されます。選択したオブジェクトを最新リビジョンに更新するためのボタンも用意されています。

また、Item Manager は、現在 Workspace エンティティではないコンポーネントや回路図シート（[Not Managed] と表示され、Workspace をソースとしていないもの）を検出・管理するために使用されるだけでなく、最新ではないすべてのコンテンツを検出・管理するためにも使用されます。

Item Manager を開くと、すべてのコンポーネントと管理対象回路図シートが自動的に検出されて一覧表示され（Workspace をソースとしているかどうかも示されます）、その後、回路図上の各 Workspace コンテンツの Item-Revision が、Workspace 内で利用可能なそのコンテンツのリビジョンと比較されます。Workspace に新しいリビジョンが存在するコンテンツがある場合、それは Item Manager の Revision Status 列で Out of date として示されます。

Out of Date として検出されたコンポーネントおよび管理対象回路図シートを確認し、それらを選択して右クリックし、Update を実行します。

コンテンツの更新

最新ではないコンテンツを最新の状態にするには、それを選択し、右クリックのコンテキストメニューから Update to latest revision コマンドを適用する必要があります。すると、ダイアログの New Settings 領域に各新しい Item-Revision の詳細が表示されます。

必要な変更を設定したら、それらの変更を実装する必要があります。これは Engineering Change Order（ECO）によって行われます。Item Manager の下部にある ECO  ボタンに関連付けられたドロップダウンメニューには、更新を実行するための 2 つの方法があります。

• Generate ECO - このコマンドを使用すると、Engineering Change Order ダイアログを通じて ECO を生成して実行できます。このダイアログでは、変更を実装するために実行されるアクションを確認できます。必要に応じて任意のアクションを無効にでき、何を変更するかを常に完全に制御できます。準備ができたら ECO を実行すると、変更が反映されます。
• Apply ECO - このコマンドを使用すると、Engineering Change Order ダイアログを表示せずに、ECO を直接作成して静かに実行できます。

最新ではないコンテンツを選択し、Update to latest revision の右クリックコマンドを使用して、New Settings 領域に更新後のリビジョン詳細を読み込みます。その後、ECO を通じて更新を適用し、設計内のコンポーネントおよび管理対象回路図シートに反映します。

置き換えが実際に正常に行われたことの確認は、基板設計プロジェクトの回路図シート内で、個々のコンポーネント／シートシンボル単位で実行できます。選択した項目の Properties パネルにアクセスすると、対応するソース管理対象 Item へのリンクが表示されます。あるいは、Item Manager に戻ってすばやく確認することもでき、基板設計プロジェクト内の項目に対する新しい設定を反映するよう更新され、グリッドの Current Settings 領域に表示されます。

Item Manager レポート

Item Manager でコンポーネントの更新または変更処理を確定する前に、ダイアログの Export 機能を使用して現在の一覧情報のスナップショットを生成しておくのが賢明な場合があります。これを行うには、Item Manager 内の任意の場所を右クリックしてコンテキストメニューから Export を選択し、適切な場所に移動して必要に応じてレポート名を付けます。レポートは HTML ファイルとして生成され、現在の Item Manager 表示と同じレイアウトで表示されます。

Item Manager からレポートを生成するには、右クリックメニューから Export を選択します。レポートは HTML 形式で生成され、完全な Item Manager 一覧のスナップショットを表します。