データベースライブラリの操作

親ページ： コンポーネントとライブラリについての詳細

Altium Designerは、データベースライブラリを作成して使用することで、企業データベースから直接コンポーネントを配置する機能を提供します。配置は、データベースライブラリをインストールした後、データベース内をブラウズする機能を持つComponentsパネルから行われます。

配置後、Update Parameters From Databaseコマンドを使用して、配置されたコンポーネントとデータベース内の対応するリンクされたレコード間で設計パラメータ情報を同期させることができます。グラフィカルシンボル、モデル参照、およびパラメータを含む完全なコンポーネントの更新は、Update From Librariesコマンドを使用して実行できます。データベースからのパラメトリック情も、最終的な部品表（BOM）に含めることができ、コンポーネントの調達に備えることができます。

直接配置 - 単なるリンクを超えて

Altium Designerでは、コンポーネントをデータベースにリンクするための3つの方法が提供されています。それは、データベースリンクファイル(*.DbLink)、データベースライブラリファイル(*.DbLib)、またはSVNデータベースライブラリファイル(*.SVNDbLib)を使用する方法です。DbLinkアプローチは、デザイン（またはライブラリ）で使用されるコンポーネントをデータベースに入力されたデータと同期させてリンクする効率的な手段を提供します。DbLib/SVNDbLibアプローチは、この実証済みのリンク効率に加えて、データベースから直接コンポーネントを配置する自由を提供し、本質的には対応するデータベースレコードに格納された情報から動的にコンポーネントを作成します。

データベースライブラリ機能のさらなる深みに入る前に、これらの方法の違いと、それらを使用する方法について話し合う価値があります。

データベースリンクファイルを使用したリンク

関連ページ： 既存のコンポーネントを貴社のデータベースにリンクする

• この方法を使用すると、データベースリンクファイル（*.DbLink）は、回路図コンポーネントとデータベース内の一致するレコードとの間のリンクを定義します。レコードの一致は、キーフィールドのリンキングによって確立され、これは単一のキーフィールド（例えば部品番号）であるか、または複数のキーフィールド（Where句を定義することによって）である可能性があります。

• このリンキング方法では、コンポーネントのモデルとパラメータ情報は、Altium Designerライブラリコンポーネントの一部として事前に定義されている必要があります。ライブラリコンポーネントには、その定義の一部として必要なキーフィールド情報も含まれている必要があります。これが定義されたら、ライブラリパッケージまたは設計プロジェクトにデータベースリンクファイルを追加し、データベースのフィールドの内容とコンポーネント情報（パラメータ）を同期させることができます。

• 各データベースレコードによって定義された各物理コンポーネントが、ユニークなAltium Designerライブラリコンポーネントにマップする必要はありません - 多くのデータベースコンポーネントが同じコンポーネントシンボルを共有できます - このリンキング方法は通常、「一つのデータベースレコードから一つのAltium Designerコンポーネント」の形式で使用されます。ユニークなAltium Designerコンポーネントは、回路図シート上に配置されたインスタンスであるか、またはコンポーネントライブラリ内のユニークなコンポーネントである可能性があります。

• DbLinkスタイルのデータベースリンキングでは、ライブラリパッケージまたは設計プロジェクトと共にデータベースリンクファイルを含めます。

データベースライブラリファイルを使用したリンク

• この方法を使用すると、データベースライブラリファイル（*.DbLib）は、回路図コンポーネントとデータベース内の対応するレコードとのリンクも定義します。再び、レコードの一致はキーフィールドのリンクによって確立され、これは単一のキーフィールド（例えば部品番号）または複数のキーフィールド（Where句を定義することによって）である可能性があります。

• リンクのこの方法の主な違いは、コンポーネントのシンボル、モデル、およびパラメータ情報が、外部データベース内のそのコンポーネントのレコード定義の一部として保存されることです。参照される回路図コンポーネント（基本的なコンポーネントライブラリ（*.SchLib）に保存されている）はシンボルのみであり、リンクされたモデルも、定義された設計パラメータもありません。

• コンポーネントが配置されると、そのパラメータとモデル情報は、対応するデータベースレコードのフィールドを使用して、定義されたマッピングに従って、その場で作成されます。これらのパラメータの1つ以上が、定義された一致基準に従って、データベースへの継続的なリンクを維持するために使用されることになります。これにより、配置後の将来の同期が可能になります。

• 配置時のコンポーネントの動的な作成により、このリンク方法は、「多くのデータベースレコードから一つのAltium Designerコンポーネントへ」の方法として非常に適しています。

• DbLinkスタイルのデータベースリンクとは異なり、DbLinkファイルをライブラリパッケージ（または設計プロジェクト）に含める必要があるのに対し、DbLib/SVNDbLibファイルをプロジェクトに追加する必要はありません。データベースライブラリ（DbLib）は、Componentsパネルでアクセス可能な利用可能なファイルベースのライブラリに含まれています。利用可能なファイルベースのライブラリには、プロジェクトライブラリ、インストールされたライブラリ、または指定された検索パスに沿って見つかったライブラリが含まれることを覚えておいてください。

• 通常、DbLib/SVNDbLibファイルをライブラリ指向の方法で設定します。例えば、会社のデータベースに詳細に記載されているすべての抵抗器用に1つ、コンデンサ用に別のものなどがあります。

DbLibとSVNDbLibの比較

SVNデータベースライブラリは、データベースライブラリモデルの拡張であり、ソースシンボルとモデルがバージョン管理下に保存される点が異なります。

ソースライブラリは、Subversionベースのリポジトリ内で作成、追加、維持されます。リポジトリへのリンク、および外部データベースへのリンクは、SVNデータベースライブラリファイル(*.SVNDbLib)内で定義されます。そして、このアプローチはデータベースライブラリの拡張であるため、バージョン管理されたデータベースライブラリとよく呼ばれます。

ライブラリアンかデザイナーか？

バージョン管理されたデータベースライブラリを使用するには、基本的にライブラリアンとして、またはデザイナーとしての2つのモードがあります。

ライブラリアンとしては、シンボルとモデルライブラリの外部ソースコントロールリポジトリを設定し、維持するだけでなく、SVNデータベースライブラリファイルの設定も担当します。これには以下が含まれます：

• 外部コンポーネントデータベースへの接続。
• データベースレコードからコンポーネントパラメーター/モデルへのマッピングの定義。
• シンボルとモデルライブラリが格納されているSVNリポジトリへのリンクの指定。

デザイナーとして、ライブラリアンによって生成されたSVNDbLibファイルを取り、Componentsパネルで利用可能にします。これは、利用可能なファイルベースのライブラリリストに追加することで、データベースコンポーネントを閲覧し配置できるようになります。

これらの役割の使用方法は会社によって異なります。大企業では、ライブラリセンターを専門とする部署があり、その役割として、ソースコントロールリポジトリ内のシンボルとモデルライブラリの設定とメンテナンス、およびSVNデータベースライブラリファイルの生成にのみ関与します。その後、SVNDbLibファイルはその会社内のデザイナーに提供され、デザインにコンポーネントを配置するためにライブラリファイルをインストールして使用します。

小規模な会社では、これらの役割が同一人物によって担われることもあります。その人物はライブラリのリポジトリの設定とメンテナンスだけでなく、定義されたSVNDbLibを自身の設計作業にも使用します。

ソースコントロールリポジトリ

関連記事： バージョンコントロールとデザインリポジトリ

シンボルとモデルのライブラリファイルをSubversion（SVN）リポジトリに追加する必要があります。Altium DesignerにはSVNバージョン管理プロバイダが含まれており、これはPreferencesダイアログのData Management - Version Controlページで有効にされ、設定されます。SVNバージョン管理プロバイダが有効になると、PreferencesダイアログのData Management - Design Repositoriesページでリポジトリを作成できます。

SVNリポジトリは、TortoiseSVNなどの外部SVNクライアントおよびサーバーを使用して、Altium Designerの外部でも作成および管理できます。既存のリポジトリは、PreferencesダイアログのData Management - Design Repositoriesページで接続できます。

リポジトリにファイルを追加する際に重要な点は、各シンボルとモデルがそれぞれ独自のライブラリファイルに保存されなければならないということです。通常のライブラリでは、任意の数のシンボル/モデルを保持できますが、単一のエントリを変更すると、バージョン管理システムによってすべてが変更されたとマークされます。ライブラリファイルごとに一つのシンボル/モデルを持つことは、バージョン管理の性質に適しており、何が変更されたか、何が変更されていないかを正確に追跡することができます。 この文書の目的では、リポジトリが既に作成されていることを前提としています。

ライブラリスプリッターウィザードの使用

ダイアログページ： Library Splitter Wizard

シンボルとモデルのライブラリが新たに作成される場合、ファイルごとに1つのシンボル/モデルのみを保証することに問題はありません。しかし、通常はソースライブラリが既に存在します。これらのライブラリをSVNリポジトリに追加するために単一エンティティファイルに分割する作業を簡素化するために、Altium Designerは分割ツール - Library Splitter Wizardを提供しています。このウィザードは、PCBまたは回路図ライブラリドキュメントを編集しているときにToolsメニューからアクセスできます。

ソースライブラリをファイルごとに1つのシンボル/モデルに分割するには、ライブラリ分割ウィザードを使用します。

分割プロセスの設定には、以下のステップが含まれます：

1. 必要なソースライブラリファイルを追加する。
2. 出力ディレクトリを指定する。デフォルトでは、出力ディレクトリはソースライブラリが保存されている同じディレクトリに設定されます。元のソースライブラリがすべて同じソースディレクトリフォルダに保存されている場合は注意が必要です。出力ディレクトリが指定されず、デフォルトのままで同じソースディレクトリフォルダを指している場合、単一のシンボルとモデルライブラリの非常に大きな混在が発生する可能性があります。リポジトリ構造を作成する際にこれらをふるい分けるのは非常に時間がかかるかもしれません。

分割されたライブラリファイルがSVNリポジトリに追加されるため、リポジトリ内でのシンボル/モデルファイルのフォルダ構造をローカルのハードディスク上で設定しておくと良いでしょう。構造が定義されたら、ソースライブラリをその構造内の各フォルダにコピーします。その後、各ソースライブラリの出力ディレクトリ設定をデフォルトのままにしておけば大丈夫です。分割後、生成された単一のライブラリファイルは既に正しい場所にあります。それから、各フォルダから元のソースライブラリを削除し、選択したSVNクライアントを使用してフォルダをリポジトリに追加できます。

3. ソースライブラリを分割する方法を制御するための追加オプションを設定します。これには、回路図コンポーネントライブラリの場合、各構成コンポーネントからパラメータやモデル情報を削除し、シンボルのみを残すことを可能にするオプションが含まれます。
4. ソースライブラリとオプションが指定されると、ウィザードは分析を実行し、その結果として作成される単一シンボル/モデルライブラリのセットがリストアップされ、レビューのために表示されます。生成される各分割ライブラリの名前が表示されます。ライブラリの名前は、構成コンポーネント/モデルに使用される名前と同じになります。

5. 作成されるライブラリのリストを確認し、次にNextをクリックして分割プロセスを進め、ソースコントロールリポジトリに追加されるライブラリを取得します。

SVNデータベースライブラリ変換ウィザードの使用

ダイアログページ： SVN Database Library Conversion Wizard

既存のライブラリをSVNタイプのデータベースライブラリに変換する別のアプローチは、SVN Database Library Conversion Wizardです。このウィザードは、回路図、PCB、データベース、および統合ライブラリをSVNデータベースライブラリに変換します。ウィザードには、ソースライブラリの分割方法、どのリポジトリのどのディレクトリに保存するか、作成されたSVNDbLibおよびMDBデータベースファイルの出力ディレクトリなど、変換に関連する多くのオプションがあります。

ウィザードは、PCBまたは回路図ライブラリドキュメントを編集するときに、Toolsメニューからアクセスできます。

ウィザードはシンボルとフットプリントライブラリを分割し、リポジトリにチェックインし、SVNDBLibおよびAccessデータベースファイルを作成します。

データベースライブラリファイルの作成

データベースライブラリ機能の基盤はデータベースライブラリファイルです。これには、標準のデータベースライブラリを使用しているか、バージョン管理されたデータベースライブラリを使用しているかに応じて、2つの形式があります：

• 標準データベースライブラリ - データベースライブラリファイル。このファイルは、Altium DesignerのDatabaseLibエディタを使用して作成および管理されます。このエディタは、メインデザインウィンドウのアクティブドキュメントが*.DbLibファイルである場合に利用可能になります。
• バージョン管理データベースライブラリ - SVNデータベースライブラリファイル。このファイルは、Altium DesignerのSVNDatabaseLibエディタを使用して作成および管理されます。このエディタは、メインデザインウィンドウのアクティブドキュメントが*.SVNDbLibファイルである場合に利用可能になります。

データベースLibエディタで開かれたDbLibファイルの例。画像にカーソルを合わせると、SVNDatabaseLibエディタで開かれたSVNDbLibファイルの例が表示されます。

File » New » Library » Database Library コマンド、または File » New » Library » SVN Database Library コマンドをメインメニューから選択して、これらのタイプの新しいファイルを作成します。

外部データベースへの接続

テーブルとマッピングデータは、アクティブなデータベースライブラリ/SVNデータベースライブラリファイルが必要な外部データベースに成功して接続された後にのみ、エディターのメイン表示ウィンドウに表示されます。接続は、Source of Connection領域で提供されるコントロールを使用して定義されます。

DbLibファイルを通じて外部データベースへの接続を指定します。画像にカーソルを合わせると、SVNDbLibファイルを通じた接続が表示されます。

OLE DBサポートを提供する任意のデータベースに接続できます。この領域で提供されるオプションは、それぞれOLE DB接続文字列を使用して対象データベースに接続します。一部のデータベースではOLE DBサポートが提供されていない場合があります。しかし、現在使用されているほぼすべてのデータベース管理システムは、Open Database Connectivity (ODBC) インターフェースを通じてアクセスできます。データベースリンク機能は、MicrosoftのODBCプロバイダを使用し、ADO (ActiveX Data Object) が任意のODBCデータソースに接続できるようにします。その結果、任意のODBCデータベースに接続できます。ODBCデータベースのためのOLE DBプロバイダは、接続文字列の一部として指定されます。

AccessおよびExcelデータベースへの迅速な接続

Select Database Typeオプションは、ターゲットデータベースがMicrosoft AccessまたはMicrosoft Excelを使用して作成された場合に、接続文字列を迅速に作成する方法を提供します。このオプションを使用して、データベースタイプを選択し、必要なデータベースファイルを参照して選択します。対応する接続文字列が自動的に作成され、Use Connection Stringオプションのフィールドに入力されます。

接続文字列の構築

会社のデータベースがAccessまたはExcelベースでなく、接続文字列を明示的に構築したい場合は、Use Connection Stringオプションを有効にして、右側のBuildボタンをクリックします。Data Link Propertiesダイアログが表示されます。

Data Link Propertiesダイアログを通じて接続文字列を構築する。

ダイアログはConnectionタブで開きます。OLE DB プロバイダMicrosoft Office <Version> Access Database Engine OLE DB ProviderがダイアログのProviderタブでデフォルトで設定されています。これは、新しいデータベースライブラリ/SVNデータベースライブラリファイルのデフォルトプロバイダ設定であり、Accessデータベースファイル(*.mdb)に接続するためにも使用されます。必要に応じてプロバイダを変更してください。

Connectionタブから、接続したいデータベースの名前（パスを含む）を入力してください。

データベースがログイン許可を要求する場合は、必要に応じてこれを入力し、ダイアログのAdvancedタブから利用可能なその他の高度な設定を行ってください。Allタブでは、定義されたリンクオプションの要約リストと、選択したOLE DBプロバイダに関連する拡張オプションが提供されます。このタブから必要に応じてオプションを変更できます。

リンクオプションが定義されたら、ConnectionタブにあるTest Connectionボタンをクリックして、接続が成功したかどうかを確認できます。成功した接続は、その旨の確認ダイアログが表示されます。

Data Link ファイルの指定

接続したいデータソースが Microsoft Data Link ファイル (*.udl) を使用して記述されている場合は、接続オプションの三番目 - Use Data Link File - を有効にし、関連するBrowseボタンをクリックして必要なファイルを探します。Data Link ファイルは、基本的に接続文字列のための格納容器です。

接続の進行

外部データベースへの接続を定義した後、Connectボタンのテキストが太字になり、接続を進めることができることを示します。接続の詳細が正しい場合、対象データベースのテーブルとマッピング情報がデータベースライブラリ/SVNデータベースライブラリファイルに読み込まれます。ConnectボタンのテキストはConnectedに変わり、ボタンはグレーアウトされます。

接続の詳細に問題がある場合、たとえば接続文字列が正しく構築されていない、またはパスが誤って入力されているなど、接続は失敗し、この事実を警告するメッセージが表示されます。接続設定を確認して、Connectボタンを再度クリックしてください。

データベースライブラリで接続失敗を示す例。

初回接続に成功し、データベースライブラリ/SVNデータベースライブラリファイルを保存した後、対象データベースの場所とファイル名が変更されていない限り、ファイルを開くたびに自動的に接続が行われます。

バージョン管理リポジトリへのリンクの指定 (SVNDbLibのみ)

DbLibでは、シンボルとモデルのライブラリは、ハードディスクやその他のローカル/ネットワーク媒体に保存されます。しかし、SVNDbLibの場合、これらのライブラリはSubversionリポジトリの下にバージョン管理されていることを覚えておいてください。SVNDbLibファイルの一部として、このリポジトリへのリンクを定義する必要があります。SVNリポジトリへの接続は、 Database Library Optionsダイアログ（Tools » Options）のSVN Repositoryタブで定義されます。このダイアログは、ドキュメントビューのField Settings領域にあるOptions ボタンをクリックすることでアクセスすることもできます。

ファイルベースのSVNリポジトリへの接続例。

データベーステーブルリスト

外部データベースへの接続に成功すると、テーブルとマッピングデータが読み込まれます。DbLib/SVNDbLibドキュメントの左側には、接続されたデータベースに存在するすべてのテーブルがリストされます。

接続されたデータベースに存在するテーブル。

各テーブルエントリーの隣にあるEnableオプションを使用すると、そのテーブルを結果のデータベースライブラリに含めるかどうかを制御できます。データベースライブラリがComponentsパネルで閲覧するための利用可能なファイルベースのライブラリリストに追加されると、各テーブルは別々のライブラリエンティティとして表示されます。したがって、実際には1つのデータベースライブラリが追加されるだけですが、Componentsパネルの観点からは、複数の異なるライブラリを追加したかのように見えます。詳細については、データベースライブラリの利用可能にするを参照してください。

リスト内のテーブルエントリをクリックすると、そのアイコンがからに変わり、現在アクティブなテーブルであることを区別します。テーブル（およびそのすべてのデータ）はドキュメントのTable Browserタブに表示されます。これはテーブルの編集可能なビューであり、外部データベース自体を起動することなく、その内容をすぐに参照し、必要に応じて編集できます。

接続されたデータベース内のソーステーブルを閲覧中。

一致条件の指定

外部データベースからコンポーネントが配置された後、配置されたコンポーネントとそれを作成するために使用されたデータベースレコードの情報との間にリンクを保持する方法が必要です。本質的に、二つを一致させる必要があります。

コンポーネントが配置されると、そのパラメータ情報は、データベースレコードの対応するフィールドを使用してその場で作成されます。配置後の回路図コンポーネントとデータベースレコードとのリンクは、これらのパラメータの1つ以上を使用して確立されます。Field Settings領域のドキュメントでは、一致基準を定義できます - 単純な単一キー検索、またはWhere句を使用したより高度な一致です。

配置後の照合基準を制御します。

単一キー検索

Single key lookupオプションが有効になっている（デフォルト）場合、Database fieldとPart parameterフィールドが利用可能になります。前者は、データベースのアクティブテーブルにある利用可能なフィールド名（列見出し）をすべてリストアップします。回路図コンポーネントのパラメータが配置されると追加されるため、Part parameterフィールドは選択されたデータベースフィールドを反映します。

通常、外部データベース内の各コンポーネントを一意に識別するために使用されるルックアップキーフィールドは、パート番号のようなものです。選択されたルックアップフィールドは、ドキュメントのField Mappingsタブで、灰色で表示されたDesign Parameterエントリによって区別されます。

パート番号による単一キーマッピング。

配置後のある段階でUpdate Parameters From Database機能を使用すると、配置された回路図コンポーネント内の選択されたキーパラメータから情報が読み取られ、選択された（キー）フィールドのデータベース内で検索されます - 有効なすべてのテーブルを通じて。一致するものがある場合、親テーブルのそのレコードの他のセルからの情報を、回路図コンポーネント内のマップされたパラメータに戻すことができます。

高度なマッチング - Where句

Single key lookupオプションは、一意の部品番号/IDにマッチングする場合にはうまく機能しますが、容量や抵抗のように一意でないパラメータでマッチングする場合にはあまり効果的ではありません。この場合、より高度なWhere句を使用するべきで、これにより複数のキーマッチングを指定して、回路図コンポーネントをそのソースデータベースレコードにリンクすることができます。

最も単純な形では、Where句（SQL構文を使用して記述）は、単一キー検索を定義する選択されたエントリを反映します。例えば、Database fieldがデフォルトのPart Numberに設定された場合、Part parameter フィールドも自動的にPart Numberに設定され、Where句のエントリは以下のようになります：

[Part Number] = '{Part Number}'

データベースフィールド（テーブル列）の周りの角括弧は、AdvancedタブのDatabase Connectionダイアログで指定された引用符です。このダイアログには、ドキュメントのSource of Connection領域のAdvancedボタンをクリックするか、メインのToolsメニューからアクセスします。

Database ConnectionダイアログのAdvancedタブでは、構築されたWhere句でテーブルを引用したり、テーブルスキーマ名を使用するための追加のSQLオプションが提供されます。

波括弧（ブレース）は、参照されているエントリが設計パラメータであることを指定します。シングルクォートは、設計パラメータを文字列として扱うために使用されます（引用符なしでは数値として扱われます）。型の一致は非常に重要で、SQLは型に敏感です。設計パラメータは、データベースの列と同じ型にする必要があります。

標準SQL構文を使用すると、Where句は複数のDatabase field/Part parameterエントリを使用してマッチングを拡張することができます。例えば：

[Capacitance] = '{Capacitance}' AND [Tolerance] = {Tolerance} AND [Manufacturer] = '{Manufacturer}'

この場合、データベースの関連テーブルにある単一のレコードが、3つの異なる設計パラメーターを使用してリンクされます。 Tolerance 設計パラメーターのエントリーに引用符がないことに注意してください。これは、関連するテーブルのデータベースの列のタイプがNumberであり、String ではないことを意味します。

標準のSQL構文を使用すると、Where句を好きなだけシンプルまたは複雑にすることができます。

データベースフィールドを設計パラメーターにマッピングする

データベースライブラリから配置されたコンポーネントの設計パラメータは、配置時に作成/追加されます。実際に作成されるパラメータと、配置後にその情報を更新するために使用されるオプション - Update Parameters From Databaseコマンドを使用して - は、データベースライブラリ/SVNデータベースライブラリファイルで指定されたマッピングと更新情報によって決定されます。これらの設定は、メインドキュメントビューの Field Mappingsタブで行われます。

DbLib/SVNDbLibドキュメントのField Mappingsタブで、パラメータマッピングと更新オプションを指定します。

モデルとパラメータのマッピング

Field Mappingsタブの左から2列は、データベースからの情報がコンポーネントの属性、モデル、およびパラメータにどのようにマッピングされるかを制御するために使用されます。

• Database Field Name - この列には、現在アクティブなデータベースのテーブル内のすべてのフィールド（列）名がリストされています。

• Design Parameter - この列は、データベース内の各対応するフィールドがどのように使用されるかを定義します。これは、コンポーネントのシンボルやフットプリントモデルをソースするために使用される場合（角括弧で囲まれます）、またはコンポーネントパラメータとして含まれる場合があります（これらは括弧で囲まれません）。

データベースへの接続時に、すべてのデータベースフィールドが自動的にマッピングされます。

属性 & モデル

データベースのフィールド名が以下の予約名のいずれかである場合、対応する属性/モデルのマッピングエントリーはDesign Parameterフィールドに自動的に設定されます：

• Description → [Description]

• Footprint Ref → [Footprint Ref]

• Footprint Path → [Footprint Path]

• Footprint Ref n → [Footprint Ref n]

• Footprint Path n → [Footprint Path n]

• Library Ref → [Library Ref]

• Library Path → [Library Path]

• Orcad Footprint → [Orcad Footprint]

• Orcad Library → [Orcad Library]

これらの参照は、OrCAD CIS設定ファイルとライブラリをインポートし、標準データベースライブラリ（DbLib）を生成する際に使用されます。

• PCB3D Ref → [PCB3D Ref]

• PCB3D Path → [PCB3D Path]

• Sim Description → [Sim Description]

• Sim Excluded Parts → [Sim Excluded Parts]

• Sim File → [Sim File]

• Sim Kind → [Sim Kind]

• Sim Model Name → [Sim Model Name]

• Sim Netlist → [Sim Netlist]

• Sim Parameters → [Sim Parameters]

• Sim Port Map → [Sim Port Map]

• Sim Spice Prefix → [Sim Spice Prefix]

• Sim SubKind → [Sim SubKind]

これらのマッピングは、コンポーネントの属性とモデル情報を定義します。コンポーネントが配置されると、対応するデータベースレコードの[Library Ref]フィールドによって指定された回路図シンボルが指定された回路図ライブラリから抽出されます。同様に、レコードに保存されたPCBフットプリントとシミュレーションモデル情報が、それぞれリンクされたフットプリントとシミュレーションモデルとしてコンポーネントに追加されます。

[Library Ref]エントリはDesign Parameter列に存在し、回路図シンボルを指定するDatabase Field Nameにマッピングされている必要があります。これにより、データベースライブラリ/SVNデータベースライブラリから回路図にコンポーネントを配置できます。データベーステーブルが異なるDatabase Field Name、例えばSCH Symbolの下にシンボル参照を含む場合、そのセルの利用可能なドロップダウンリストを使用して、このフィールドの関連するDesign Parameterエントリを手動で[Library Ref]に設定する必要があります。

同様に、モデル参照情報が異なるフィールド名を使用してデータベースに入力されている場合、適切なDesign Parameterエントリ（[Footprint Ref]、[Footprint Ref n]、[PCB3D Ref]、[Sim Model Name]など）をドロップダウンリストから選択し、各フィールドに対して手動でマッピングする必要があります。

コンポーネントを配置する際にシンボルとモデル情報を定義するためには、データベース内のシンボルとモデル参照フィールドが重要なマッピングエンティティです - 定義されたマッピングの一部としてシンボルと少なくとも1つのPCBフットプリント参照があることを確認してください。

パラメータ

他のすべてのデータベースフィールド名は、同じ名前を使用して設計パラメータに自動的にマッピングされます。例えば、データベース内のフィールドがToleranceと呼ばれている場合、Toleranceの名前の設計パラメータがそれにマッピングされます。設計パラメータの名前を変更するには、そのセル内をクリックして直接新しい名前を入力します。これらの設計パラメータ名が、回路図シート上に配置された後、コンポーネントの関連プロパティダイアログのParameters領域に表示されます。

データベースに関連付けられたコンポーネントのデータフィールドが多数存在する場合がありますが、それらの全てを回路図シートに配置する際にデザインパラメータとして追加したい、または必要とするわけではありません。この情報の多くは、部品表を生成する際にのみ必要とされる場合があります。Report Managerダイアログを使用すると、リンクされたデータベースから直接BOMにパラメータ情報を追加できるため、回路図ソースドキュメントに「持ち運ばれる」情報の量を減らすことができます。詳細については、BOMに直接データベース情報を追加するセクションを参照してください。 データベースから明示的にマッピングされないようにしたいフィールドには、Design Parameterエントリーを[None]に設定してください。マッピングされていないデータベースフィールドは、タブ上で赤い十字アイコン（）を使用して区別されます。マッピングされたデータベースフィールドは、緑のチェックアイコン（）によって区別されます。

必要に応じてパラメータマッピングを設定します。データベース内のパラメータが配置されたコンポーネントにマッピングされないようにするには、[None]に設定します。
マッピングされていないパラメータは、必要に応じてBOMに直接含めることができます。

パラメータ更新オプション

Field Mappingsタブの残りの列では、データベースライブラリからコンポーネントを初めて配置する際、または配置したコンポーネントをUpdate Parameters From Databaseコマンドを使用して更新した後に、パラメータに対して行われるアクションを指定できます。

4つの列は以下の通りです：

• Update Values - この列のセルは、パラメータが回路図シートとデータベースの両方に存在するが、現在の値が異なる場合に取るべきアクションを決定するために使用されます。配置されたコンポーネントのパラメータをデータベースに保存されている値で更新する(Update)か、全く更新しない(Do not update)かを選択できます。このオプションは、コンポーネントが配置された後にUpdate Parameters From Databaseコマンドを使用する際に従われます。

• Add To Design - この列のセルは、パラメータがデータベースに見つかるが、配置されたコンポーネントには存在しない場合に取るべきアクションを決定するために使用されます。パラメータを追加する(Add)、パラメータを追加しない(Do not add)、またはデータベースに値が割り当てられている場合にのみパラメータを追加する(Add only if not blank in database)を選択できます。このオプションは、データベースライブラリからコンポーネントを初めて配置する際と、コンポーネントが配置された後にUpdate Parameters From Databaseコマンドを使用する際の両方で従われます。

• Visible On Add - この列のチェックボックスは、初期配置または配置後の更新から生じる新しく追加されたパラメータが、回路図シート上のコンポーネントに対して表示されるかどうか（有効）または表示されないか（無効）を決定するために使用されます。

• Remove From Design - この列のセルは、パラメータが配置されたコンポーネントに存在するが、データベースには存在しないか、または存在するが値がない場合に取るべきアクションを決定するために使用されます。パラメータを全く削除しない(Do not remove)か、データベースに割り当てられた値がない場合にのみ削除する(Remove only if blank in database)を選択できます。このオプションは、コンポーネントが配置された後にデータベースからパラメータを更新するコマンドを使用する際に従われます。

最初に、各マップされたデータベースフィールドに対して、Update Values、Add To Design、Remove From Designフィールドは、エントリーDefaultに設定され、Visible On Addオプションは無効になります。以下の画像で示されています。

初期（デフォルト）のパラメータ更新オプション。

画像を見ると、更新オプションに関して重要な4点があります：

1. マッピングされていないデータベースフィールドには、関連する更新オプションがありません。

2. 属性およびモデルに基づくマッピング（Design Paramete列に角括弧で示されるエントリ）には、これらが設計パラメータではないため、関連する更新オプションがありません。

3. キーフィールド（画像のPart Numberなど）には、関連する更新オプションがありません。このフィールドは、パラメータの照合目的でのみ使用されます。

4. デフォルトの設定は、Database Library Optionsダイアログ(Tools » Options)のDefault Actionsタブに指定されている対応するデフォルト定義に従って更新オプションが適用されます。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでアクセスすることもできます。

デフォルトのパラメータ更新オプションをDbLibの中央の場所で定義します。画像にカーソルを合わせると、SVNDbLibに相当するものが表示されます。

第四のポイントは、中央の場所から更新オプションを指定できるようにし、各マップされたフィールドの更新オプションを定義する際にその場所を指すことができるため有益です。そのため、データベースフィールドを設計パラメータにマッピングすると、Defaultエントリが関連する更新フィールドに自動的に読み込まれます。

更新オプションのデフォルト設定を上書きしたい場合は、Field Mappingsタブの関連する更新フィールド内をクリックし、もう一度クリックして適用可能な更新選択肢を提供するドロップダウンにアクセスしてください。

必要に応じて、パラメータ更新オプションを手動で上書きできます。

この方法では、設計のパラメータがどのように更新されるかを完全に制御できます。Defaultにすべてのフィールドを設定し、必要な更新の決定をDatabase Library Optionsダイアログから行うか、各更新フィールドを個別に設定するか、またはその両方の組み合わせを選ぶことができます - 決定は完全にあなた次第です。配置されたコンポーネントの場合、更新はEngineering Change Orderダイアログを使用して実行されます。この段階で、行いたくない更新がある場合は、それら特定の変更を含めないように選択できます - どの設計パラメータを更新するかについて、最終的かつ究極の決定を下すことができます。

シンボルとモデルライブラリの場所を指定する

データベースライブラリからコンポーネントを配置すると、[Library Ref] マッピングで指定されたそのシンボルは、指定された回路図ライブラリ (*.SchLib) から抽出されます。同様に、データベースで指定された任意のモデル参照（フットプリント、PCB3D、シミュレーション）は、基礎となるPCBライブラリ (*.PcbLib)、PCB3Dライブラリ (*.PCB3DLib)、シミュレーションモデル (*.mdl、*.ckt) ファイルに存在します。これらのファイルへのパスは、データベースで以下の方法で明示的に指定できます：

• ファイルへの絶対パスを入力します。
• ファイルへの相対パスを入力します。

データベースにパス情報のためのフィールドを定義している場合、これらのフィールドを適切な設計パラメーターにマッピングする必要があります - [Library Path] 、[Footprint Path]、[PCB3D Path]、[Sim File]など（モデルとパラメータマッピングを参照してください）。

データベーステーブルにパスを入力することは、たとえ相対パスであっても、少し制限があるかもしれません。ライブラリやモデルファイルの場所を移動した場合、データベーステーブルをそれに応じて更新する必要があります。より大きな自由を提供するために、DbLib/SVNDbLibファイル自体内でライブラリ検索情報を指定する能力があります。これにより、データベースでソースライブラリやモデルファイルの名前を指定するか、またはまったく定義しないことができます。

データベースライブラリ用

DbLibの場合、ライブラリ検索パスはDatabase Library Optionsダイアログ（Tools » Options）のSymbol and Model Search Pathsタブで定義されます。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでアクセスすることもできます。

シンボルとモデルライブラリの検索パスを指定。

リストにパスを追加するには：

1. ライブラリ検索パス領域の下にあるフィールドに直接パスを入力するか、またはボタンをクリックしてフォルダを参照ダイアログにアクセスし、必要なライブラリ/モデルファイルが存在するディレクトリを探します。

2. フルパス、またはDbLibファイルの位置に対して相対パスとして追加できます。Add/Update As Relative Pathオプションを使用してこれを制御します。

3. 必要なパスを指定した後、Addボタンをクリックして検索パスリストに追加します。

4. 必要に応じて追加の検索パスを続けて追加します。

ライブラリ検索パスは、データベースライブラリから配置する際や配置後にモデルを検索する際に、ライブラリファイルやモデルファイルをどこで見つけるかを決定します。使用される特定のモデルは、ライブラリ検索パスの設定方法とデータベースに特定のライブラリ情報を追加したかどうかに依存します。検索は以下の順序で進行します：

1. シンボルまたはモデルのマップされたパスフィールドに完全なパスが存在する場合、そのライブラリ/モデルファイルを使用し、適用される参照フィールドで指定されたシンボルまたはモデルを抽出します。
2. シンボルまたはモデルのマップされたパスフィールドに相対パスが存在する場合、そのライブラリ/モデルファイルを使用し、適用される参照フィールドで指定されたシンボルまたはモデルを抽出します。
3. シンボルまたはモデルのマップされたパスフィールドにライブラリ/モデルファイル名のみが存在する場合、検索パスを使用して、指定された名前に一致し、適用される参照フィールドで指定されたシンボルまたはモデルに一致する最初のライブラリ/モデルファイルを探します。
4. データベースにライブラリ/モデルファイル情報が存在しない場合、検索パスを使用して、適用される参照フィールドで指定されたシンボルまたはモデルに一致する最初のライブラリ/モデルファイルを探します。

SVNデータベースライブラリの場合

SVNDbLibにおいて、シンボルとフットプリントモデルが存在するSubversionリポジトリ内の基本ディレクトリは、SVN RepositoryタブのDatabase Library Optionsダイアログ（Tools » Options）で指定されます。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでアクセスすることもできます。

シンボルとフットプリントのための基本リポジトリディレクトリを指定。

Models Location領域にある利用可能なフィールドを使用して、シンボルとフットプリントのベースディレクトリを指定します。 ボタンをフィールドの右側でクリックして、Browse for directoryダイアログにアクセスします - リンクされたリポジトリへの窓です。このダイアログを使用して、必要なフォルダを選択します。

リンクされたSVNリポジトリ内の関連ディレクトリを探索中。

モデルの場所は、バージョン管理されたデータベースライブラリから配置する際や配置後にモデルを検索する際に、ライブラリファイルとモデルファイルがどこにあるかを決定します。使用される特定の回路図シンボルとフットプリントモデルは、これらの場所をどのように設定したか、およびデータベースに特定のライブラリ情報を追加したかどうかに依存します。検索は次の順序で進行します：

1. シンボルまたはフットプリントモデルのマップされたパスフィールドに完全なパスが存在する場合（例：http://MyServer/svn/MyCompany/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib）、そのライブラリファイルを使用し、該当する参照フィールドに指定されたシンボルまたはフットプリントを抽出します。
2. シンボルまたはフットプリントモデルのマップされたパスフィールドにリポジトリのルートに対する相対パスが存在する場合（例：/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib）、そのライブラリファイルを使用し、該当する参照フィールドに指定されたシンボルまたはフットプリントを抽出します。ダイアログのリポジトリサーバー接続領域に指定されたリポジトリのURLが入力されたパスの前に追加され、絶対アドレスが与えられます。
3. シンボルまたはフットプリントモデルのマップされたパスフィールドにライブラリファイル名のみが存在する場合（例：Capacitor_NonPolarized.SchLib）、リポジトリ内の指定されたモデルの場所を使用して、指定された名前に一致し、該当する参照フィールドに指定されたシンボルまたはフットプリントモデルを含む最初のライブラリファイルを探します。

4. データベースにライブラリファイル情報が存在しない場合、指定されたモデルの場所を使用して、適用される参照フィールドで指定されたシンボルまたはフットプリントモデルに一致する最初のライブラリファイルを探します。

データベーステーブルの修正

データベース内のコンポーネントレコードに変更が必要になることがよくあります。既存のコンポーネントは、その現在の状態をより正確に反映するために、1つ以上のフィールドを更新する必要があるかもしれません。新しいコンポーネントが使用可能になり、関連するデータベーステーブルに追加する必要があるかもしれません。コンポーネントに供給チェーン情報を追加する必要がある場合もあります。コンポーネントが「廃止」とマークされ、設計での使用がもはや推奨されないため、データベースから完全に削除する必要があるかもしれません。

DatabaseLib EditorとSVNDatabaseLib Editorの両方が、Table Browserを通じてこれらのアクションを直接実行できるようにします。これにより、外部データベースを開く必要がなくなります。必要なテーブルが選択されると、データベース内のエントリを操作するためのコマンドが右クリックメニューから利用可能になります。

リンクされたデータベース内の選択されたテーブルを変更するためのコマンドにアクセスします。

既存のコンポーネントの編集

リンクされたデータベーステーブル内の既存のコンポーネントレコードは、次の2つの方法で変更できます：

• その場での編集 - 必要なフィールド内をクリックして、必要に応じてその値を変更します。Enterキーを押すか、フィールド外をクリックして完了し、変更をコミットする（データベースに登録する）ことを確認する後続のダイアログでYesをクリックします。

• ダイアログベースの編集 - 必要なコンポーネントレコードのエントリを右クリックし、コンテキストメニューからEdit Componentコマンドを選択します。そのコンポーネントのeditingダイアログが表示され、親データベーステーブルのすべてのフィールドとその値がリスト表示されます。Field Valueのエントリをクリックして編集します。希望のフィールドの変更が完了したら、OKをクリックして、変更をデータベースにコミットします。

2つの編集方法を使用して、コンポーネントレコードフィールドの編集を示す。

新しいコンポーネントの追加

データベーステーブルに新しいコンポーネントを追加するには、Table Browser内のどこかを右クリックし、コンテキストメニューからAdd New Componentコマンドを選択します。New Componentダイアログが表示され、親データベーステーブルのすべてのフィールドがリストされます。必要に応じてこの新しい物理コンポーネントの情報を入力し、OKをクリックします。新しいコンポーネントはテーブルの最下部に追加されます。

リンクされたデータベースのテーブルに新しいコンポーネントを追加することを示しています。

既存のコンポーネントの削除

データベーステーブルから既存のコンポーネントを永久に削除するには、Table Browserでそのエントリを右クリックし、コンテキストメニューからDelete Componentコマンドを選択します。確認ダイアログが表示されるので、削除を進めるにはYesをクリックします。

サプライチェーン情報の管理

関連ページ： サプライヤーデータへのリンク

Altium Designerのライブサプライヤーデータ機能を使用すると、Altium Designer内からサプライヤーのデータベースを検索し、設計コンポーネントを対応するサプライヤーアイテムにリンクすることができます。検索を通じて見つかった任意のサプライヤーアイテムについては、そのパラメータ、データシートリンク、価格、在庫情報を、DbLib/SVNDbLibのターゲットコンポーネントのパラメータとしてもインポートできます。さらに、サプライヤーアイテムから直接、対象のデータベーステーブルに新しいコンポーネントを作成することもできます！リンクされたサプライヤーデータは、設計リリース時に、特にプロジェクトのコスト計算や調達の観点から、部品表に含めることができます。

この機能の核心はサプライヤーリンクです。この基本的なエンティティは、Altium Designerのコンポーネントとサプライヤーの電子部品データベース内のアイテムとの間のライブリンクを提供します。

サプライヤーリンクの作成には、対象のAltium Designerコンポーネントに2つのパラメータを追加することが含まれます：

• Supplier n

• Supplier Part Number n

nは整数の接尾辞であり、同じコンポーネントに複数のリンクが追加される場合にサプライヤーアイテムを区別するために使用されます。

サプライヤーリンクの追加

サプライヤーリンクを作成するのは簡単なプロセスです。手動でこのプロセスを最も容易に行うには、Manufacturer Part Searchパネルを使用して必要な部品を検索します。見つかったら、パネルの結果領域で選択したアイテムをクリックして選択します。選択されると、下の画像に示されているように、SPNドロップダウン（サプライヤー部品番号）が表示されます。ドロップダウンをクリックしてSPNタイルを表示します。各タイルには、そのサプライヤーから選択した部品の価格と在庫状況に関するリアルタイム情報が詳細に記載されています。

表示されたサプライヤーのいずれかをデータベースライブラリにサプライヤーリンクとして追加できます。

メーカー部品検索パネルを使用して、次のいずれかの方法でサプライヤーリンクを作成できます：

• Manufacturer Part Searchパネル内のサプライヤータイルをクリック＆ホールドし、データベースライブラリのテーブルブラウザ内のコンポーネントレコードにドラッグ＆ドロップすることで（下のアニメーションに示されています）。
• Manufacturer Part Searchパネル内のサプライヤータイルを右クリックし、Add Supplier Link Toコマンドを選択します。DbLib/SVNDbLibファイルがアクティブな場合、サプライヤーリンクがフォーカスされたコンポーネントレコードに追加されます。
• Manufacturer Part Searchパネル内のサプライヤータイルを右クリックし、Add Supplier Link And Parameters Toコマンドを選択します。このコマンドは、選択したサプライヤーアイテムのパラメータ、データシートリンク、価格および在庫情報を一括で追加し、そのアイテムへのサプライヤーリンクも同時に追加します。DbLib/SVNDbLibファイルがアクティブな場合、パラメータとサプライヤーリンクがフォーカスされたコンポーネントレコードに追加されます。
• 新しいライブラリコンポーネントを作成する際に、Manufacturer Part Searchパネル内のサプライヤータイルを右クリックし、Import Into LibraryName As ComponentName / PartNumberコマンドを選択します。このコマンドは、選択したサプライヤーアイテムから直接ターゲットライブラリDbLib/SVNDbLibに新しいコンポーネントを作成するために使用されます。新しいコンポーネントのComponentName/PartNumberは、サプライヤーアイテムの製造者部品番号パラメータを使用して命名されます。アイテムへのサプライヤーリンクがコンポーネントレコードに追加され、そのアイテムのすべてのパラメータ（パラメータ、データシートリンク、価格および在庫情報）も追加されます。

リンクされたデータベース内のコンポーネントレコードにサプライヤーリンクを追加することを示す。

サプライヤーリンクの表示/編集

データベースコンポーネントに現在定義されているサプライヤーリンクは、Supplier Links forダイアログを使用して表示および編集できます。このダイアログにアクセスするには、アクティブなDbLib/SVNDbLibファイルのTable Browserタブでコンポーネントのレコード内を右クリックし、コンテキストメニューからEdit Supplier Linksコマンドを選択します。

選択したデータベースコンポーネントの現在定義されているサプライヤーリンクを編集する例。追加のサプライヤーを検索するには、追加をクリックしてAdd Supplier Linksダイアログを開きます。

Supplier Links for ダイアログには、コンポーネントに現在定義されているすべてのサプライヤーリンクがリストされています。

このダイアログでは、以下の操作ができます：

• サプライヤーを選択し、削除ボタン（  _​ ）をクリックしてそのサプライヤーを削除します。

• サプライヤーをクリックしてドラッグし、サプライヤーの順序を変更します。

• Addボタンをクリックして追加のサプライヤーを追加します。Add Supplier Linksダイアログが表示され、そこから追加のサプライヤーリンクを検索して追加できます。サプライヤー項目の検索は、Manufacturer Part Searchパネルを使用するのと同じ方法で行われます。

シンボルとフットプリントの修正

データベース内のコンテンツを維持するだけでなく、必要に応じて参照されるシンボルやモデルも維持する必要があります。これには、回路図のシンボルとフットプリントモデルの修正が含まれます。そして、標準データベースライブラリ(DbLib)の場合、シミュレーションモデルファイル内の定義も含まれます。

データベースライブラリには、標準タイプとバージョン管理タイプの両方があり、どちらもアクティブなドキュメントとして開かれたメインのDbLib/SVNDbLibドキュメントビュー内から、参照されたシンボルとフットプリントモデルを直接編集するためのアクセス機能を提供します。以下のセクションでは、それをどのように行うかについて説明しますが、これはSVNDbLibを使用する場合、少し複雑ですが、より強力です。

DbLibを使用する場合

コンポーネントの参照されたシンボル/フットプリントモデルライブラリファイルを編集するために開くには、Table Browserでコンポーネントのエントリを右クリックし、コンテキストメニューから適切なコマンド - Open SymbolまたはOpen Footprint - を選択します。該当するライブラリファイルが開かれ、シンボル/フットプリントがワークスペースでアクティブなエンティティとして表示され、編集を行う準備が整います。

必要に応じて変更を加えた後、ライブラリファイルを保存してください。

DbLib内から直接、データベースコンポーネントの参照シンボルにアクセスする例。

SVNDbLibを使用する場合

前述の通り、データベースコンポーネントによって参照され、SVNDbLibファイルを通じてアクセスされるシンボルとモデルにアクセスして編集する能力は、少し複雑ですが、より強力です。変更は、SVNリポジトリに格納されているライブラリのローカル作業コピーに対して行われます。

ローカルワークスペースの指定

コンポーネントシンボルとフットプリントモデルを変更するには、リポジトリからローカル作業ディレクトリにファイルをチェックアウトする必要があります。PreferencesダイアログのData Management - SVN Librariesページで使用するディレクトリを指定します。デフォルトの作業フォルダーの場所が定義されています - \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder。必要に応じて、既存のフォルダーを参照するためにボタンをクリックするか、直接フォルダーへのパスを入力して変更します。

ローカル作業ディレクトリを指定する。

リポジトリから指定したローカル作業フォルダにすべてのシンボルモデルライブラリとフットプリントモデルライブラリをすばやくチェックアウトするには、SVNDatabaseLibエディタのメインToolsメニューからすべての作業フォルダをチェックアウトコマンドを実行します。チェックアウトされるフォルダは、Database Library OptionsダイアログのSVNリポジトリタブにあるモデルの場所領域で指定したフォルダになります。

シンボルとフットプリントの例 - SVNリポジトリ内に保存され、Database Library Optionsの一部として指定され、ローカルの作業フォルダにチェックアウトされます。

変更を加える

シンボルとフットプリントモデルライブラリが指定されたローカル作業フォルダにチェックアウトされたら、必要に応じて変更を加えることができます。これには、回路図シンボルとフットプリントモデルのローカルコピーを変更し、それらの変更をSVNリポジトリにコミットする作業が含まれます。

DbLibと同様に、シンボル/モデルを編集するためにアクセスする方法は以下の通りです：

• VNDbLibドキュメント内で、Table Browserのコンポーネントのエントリを右クリックし、コンテキストメニューから適切なコマンド - Open SymbolまたはOpen Footprint - を選択します。

• SVNDbLibが利用可能なファイルベースのライブラリリストに追加されると、Componentsパネルを通じて直接編集コマンドにアクセスできます。必要なコンポーネントエントリを選択し、それぞれComponents領域の右クリックコンテキストメニューでEdit Symbolコマンド、またはModels領域の右クリックコンテキストメニューでEdit Footprint コマンドを使用します。

• ライブラリエディターのFile » Openコマンドを使用して、必要なライブラリ（ローカルの作業フォルダ内）を参照し、開きます。

• Windowsエクスプローラーから直接、ライブラリファイル（ローカルの作業フォルダ内）をAltium Designerにドラッグアンドドロップします。

いずれの場合も、必要に応じて変更を加えた後、ライブラリファイルを保存してください。

しかし、ローカル作業フォルダにチェックアウトされたフォルダやファイルとリポジトリ自体との主なインターフェースは、Storage Managerパネルです。SVNDbLibファイルがアクティブなドキュメントである場合、Storage Managerパネルは、ローカル作業フォルダにチェックアウトされたシンボルとモデルのフォルダを表示します。リストされる正確なフォルダは、Database Library OptionsダイアログのSVN RepositoryタブのModel Locations領域で指定されたものになります。

Storage Managerパネルは、SVNDbLibファイルがAltium Designer内でアクティブなドキュメントである場合に、ローカル作業フォルダを反映します。

ライブラリファイルを編集するために開くには、パネルのAll Files領域にあるそのエントリを右クリックし、表示されるコンテキストメニューからOpenを選択します。必要に応じて変更を加え、関連するエディターの標準Saveコマンドを使用してファイルを通常どおり保存します。

リポジトリへの変更のコミット

パネルページ： ストレージマネージャー

ライブラリを編集するために開く方法はいくつかありますが、Altium Designer内で行われた変更をコミットすることは、Storage Managerパネルを通じてのみ行うことができます。

Storage Managerパネルを使用する際に最も重要なことの一つは、ローカルの作業フォルダー/ファイル（パネルに表示されている）とソースコントロールリポジトリ内の対応するフォルダー/ファイルとの間のリンクの状態を更新することです。個別に選択されたライブラリについては、パネルのAll Files領域で右クリックメニューから利用可能なRefreshコマンドを使用してこれを実現します。フォルダ全体の状態をすばやく更新するには、Ctrl+F5キーボードショートカットを使用します。

アイコン	ステータス	説明
	No modification	ライブラリのローカルコピーはリポジトリのものと同一です。ファイルを開いて変更を加えることができます。
	Out of date	作業フォルダ内のファイルのローカルコピーは、リポジトリ内の対応するファイルよりも古く、したがって古い状態です。自分の変更をコミットする前に、リポジトリから最新バージョンのファイルを取得する必要があります - 自分のローカル作業コピーを更新します - 右クリックコンテキストメニューのUpdateコマンドを使用して、リポジトリから最新のファイルを取得してください。
	Modified	ファイルのローカルコピーはAltium Designerで変更され、作業フォルダに保存されました。ローカルの変更をリポジトリにプッシュするには、ファイルのエントリを右クリックし、コンテキストメニューからコミットコマンドを選択します。リポジトリにチェックインされると、ステータスはNo modificationに戻ります。
	Conflict	他のAltium Designerユーザーによってファイルがコミットされた後で、自分が編集して保存したバージョンのファイルをコミットしようとしています。UpdateまたはResolveコマンドを使用して、リポジトリの最新リビジョンとなるファイルのバージョンを決定してください。
	Locked	ファイルは自分自身または他のユーザーによってロックされています。ロックされたファイルは、他のユーザーによって新しいリビジョンに更新されることはありません（強制的にロックを解除されない限り）。この状態は、Modified や No Modification など、他のアイコンと関連付けられることがあります、これらのステータス条件も適用される場合です。

リビジョンの物理的比較

物理的比較は、同じシンボル（モデルライブラリ）の任意の2つのリビジョン間で実行できます。これにより、連続するリビジョンまたは非連続するリビジョンのファイル間で行われた変更を視覚的に明確に確認できます。

Storage Managerパネル内で、パネルの下部にあるVCS Revisions領域から比較が実行されます。

Storage Managerパネルは、選択したファイルの履歴に対して2つのビューを提示し、VCSリビジョンとローカル履歴のための別々の領域があります。

任意の2つのリビジョン間の比較が可能です。Ctrl+クリック選択技術を使用してWindowsで、パネルのVCS Revisions領域内で比較したいライブラリの2つのリビジョンを選択し、右クリックしてCompareを選択します。

Compareコマンドが実行されると、選択された2つのドキュメントリビジョンがワークスペース内で並べて開かれ、グラフィカルな比較が行われ、2つの間に検出された違いはすべて差分パネルにリストされます。

ライブラリエディタのワークスペースで直接グラフィカル比較。

データベースライブラリを利用可能にする

他のライブラリと同様に、標準（またはバージョン管理された）データベースライブラリは、利用可能なファイルベースのライブラリリストに追加することでComponentsパネルを通じて利用可能になります。Componentsパネルから、右上にあるMenuボタン（ ）をクリックしてメニューを開き、File-Based Libraries Preferencesコマンドを選択します。Available File-based Librariesダイアログが開きます。DbLib/SVNDbLibは、プロジェクトライブラリとして、またはインストールされたライブラリの一部として追加でき、これによりアクティブなプロジェクトだけでなく、すべてのプロジェクトで利用可能になります。また、DbLib/SVNDbLibファイルが存在するフォルダへの検索パスを指定することもできます。

インストールされたライブラリとしてデータベースライブラリを追加することで使用可能にします。

Componentsパネルは、リンクされた外部データベースと、それが含むコンポーネントのテーブルを閲覧する「ブラウジングウィンドウ」になります。

データベースコンポーネントの閲覧

DbLib/SVNDbLibが利用可能なファイルベースのライブラリリストに追加されると、データベース内のコンポーネントをComponentsパネルで閲覧できるようになります。単一のDbLib/SVNDbLibファイルが追加されても、リンクされたデータベース内の各テーブルは、それぞれが独立したライブラリであるかのように表示されます。

パネルの上部のドロップダウンリストは、次の形式のエントリで埋められます：

• <LibraryName>.DbLib - <TableName> または <LibraryName>.SVNDbLib - <TableName> ----データベースにテーブルがある場合
• <LibraryName>.DbLib - <SheetName>$ または <LibraryName>.SVNDbLib - <SheetName>$ ----データベースがExcelスプレッドシートのシートで構成されている場合。

3つのテーブルを持つDbLib、1つのテーブルを持つ別のDbLib、および1つのテーブルを持つSVNDbLibの例。

パネル内の各コンポーネントエントリは、データベースのその特定のテーブル内のレコードに対応しています。実際には、ロードされたデータベースライブラリを閲覧するとき、Componentsパネルは直接のデータベースブラウザのように振る舞います。シンボルとモデルの情報は、データベースの関連フィールドによって指し示された基礎となるシンボルおよびモデルライブラリから取得されます（そして、定義された検索パス/場所と連携しています）。

データベースライブラリを通じて外部データベースにリンクされたコンポーネントを閲覧します。

デフォルトでは、パネルのコンポーネントリスト領域にはPart Number（部品番号）とLibrary Ref（ライブラリ参照）フィールドのみが表示されます。データベーステーブルの他のフィールドを「表示」するには、領域内を右クリックしてコンテキストメニューからSelect Columnsを選択します。これにより、Select Columnsダイアログにアクセスし、そのテーブルの追加フィールドの表示を有効にすることができます。

コンポーネントの検索

接続した外部データベースには、多数のテーブルが含まれており、それぞれに大量のコンポーネントレコードが存在する場合があります。データベースから直接配置できることは一つのことですが、配置したい特定のコンポーネントを見つけることはより困難になることがあります。Componentsパネルは、検索するための2つのアプローチをサポートしています。

パネル内検索

ComponentsパネルにはSearchフィールドが含まれており、文字列を入力してEnterを押すと、現在のライブラリ内でその文字列を含むコンポーネントを、表示されているコンポーネントパラメータ内で検索します。

Componentsパネルで直接検索を実行できます。

詳細な検索の実行

より詳細な検索には、File-Based Libraries Searchダイアログが使用されます。

パネルの上部にあるMenuボタンをクリックして、ファイルベースのライブラリ検索ダイアログを開きます。ここから、インストールされたDbLib/SVNDbLibファイルの単一のテーブル内のデータベースコンポーネントを検索できます。データベースコンポーネントの検索を有効にするには、Search inフィールドをDatabase Componentsに設定し、必要なTableを選択します。選択したテーブルにある列見出しに応じて、上のドロップダウンにリストされているFieldsが変更されることに注意してください。ダイアログの残りのオプションは、データベースライブラリを検索する際には関連がないため、グレーアウトされます。

ファイルベースのライブラリ検索ダイアログへのアクセス。

詳細な検索機能は、基本的に2つの「レベル」の検索を提供します - フィールドベースとSQLベースのクエリ。

フィールドベース検索

これは「粗い」検索で、指定されたテーブルで見つかったすべてのデータベースコンポーネントを返します。Searchボタンをクリックして、画面左下にあるFile-based Libraries Searchダイアログで検索を開始します。ダイアログが閉じ、検索結果がComponentsパネルにリストされます。検索を実行した後、ライブラリのドロップダウンリストにはFile Searchというエントリが含まれ、このリストが検索結果であることを示します。

フィールドベースの検索を実施した後の例示結果。

SQLクエリ検索

SQLクエリ検索を行うには、Libraries Searchダイアログで>>Advancedリンクをクリックします。ダイアログが変更され、次の画像に示すような外観になります。この検索レベルでは、「細かい」検索が提供され、指定されたクエリ式に基づいてSQLクエリをダイアログのクエリエディタセクションに直接入力できます。

画像にマウスを合わせると、Advancedをクリックしたときのダイアログの変化がわかります。より強力なSQLベースのクエリ検索にアクセスできます。Advancedをもう一度クリックすると、シンプルなスタイルの検索に戻ります。

ローカライズされたキャッシング（SVNDbLibのみ）

SVNDbLibファイルが使用可能なライブラリリストに追加されると、リポジトリ内のシンボルとモデルライブラリがデザイナーのコンピュータのローカルにある一時フォルダにキャッシュされます。ソフトウェア内のアクションが回路図のシンボルやモデルの使用を要求すると、そのシンボル/モデルはローカルキャッシュから取得されます。

自動キャッシュ更新

ソフトウェア内で以下のアクションを実行すると、キャッシュ内のライブラリはソースコントロールリポジトリから最新のものに自動的に更新されます：

• インストールされたSVNDbLibファイルからのコンポーネントの配置（Componentsパネルから）。

• デザイン転送の実行（つまり、PCBの更新）。

• 回路図エディタでのUpdate From Librariesコマンドの使用。

• PCBエディタでのUpdate From PCB Librariesコマンドの使用。

更新は自動的に行われますが、PreferencesダイアログのData Management - SVN Librariesページで利用可能なオプションを使用して制御することができます。以下の画像で強調表示されています。

ローカルキャッシュの最小更新時間閾値を設定します。

このオプションは、基本的にローカルキャッシュのための「更新タイマー」を提供します。指定された時間が最後にキャッシュが更新されてから経過している場合、リストされたアクションのいずれかが実行されたときにキャッシュが自動的に更新されます。この時間内にアクションが実行された場合、キャッシュの現在の内容が使用されますが、これはリポジトリの内容と比較して古い可能性があります。

キャッシュの更新を手動で強制する

ローカルキャッシュを強制的に更新して、ソースコントロールリポジトリに現在保存されている最新のライブラリを確実に取得したい場合があります。例えば、回路図からPCBへの設計を移行する準備をしているときなどです。

以下の方法のいずれかを使用して、手動でキャッシュを強制的に更新できます：

• Componentsパネルの右クリックメニューから利用可能なRefreshコマンドのいずれかを使用する。

• SVNDbLibファイルをアンインストールしてから、利用可能なライブラリリストに再インストールする。

コンポーネントの配置

配置は、Componentsパネルでロードされ利用可能な他のライブラリと同様に実行されます。対象の回路図シートをアクティブなドキュメントとして開いた状態で、パネルから配置したいコンポーネントを選択し、右クリックしてPlaceコマンドを選択するか、またはコンポーネントを直接シート上にドラッグアンドドロップします。コンポーネントはその場で構築され、以下のアクションが行われます：

• データベースレコードで指定された回路図シンボルが、関連する回路図コンポーネントライブラリから取得されます。

• 参照されたフットプリントモデル（およびDbLibを使用している場合は、参照されたシミュレーションモデル）がリンクされます。

• DbLib/SVNDbLibファイルで指定された設計パラメータが、関連するAdd To Design更新設定に従ってコンポーネントに追加されます。

配置後、回路図上のコンポーネントをダブルクリックして、Propertiesパネルを開き、コンポーネントのプロパティを編集できます。パネルのGeneralタブには以下が表示されます：

• Design Item ID（コンポーネント名 / 部品番号）。これは、Field Settings領域のDbLib/SVNDbLibファイルで定義された選択されたキーフィールドであり、通常は部品番号です。

• 親DbLib/SVNDbLibファイルの名前 - およびコンポーネントが存在する特定のデータベーステーブル。

• リンクされたフットプリントとシンボルモデル。

設計パラメータは、パネルのParametersタブに詳細が記載されます。

DbLibファイルを使用してリンクされたデータベースから配置されたコンポーネントに追加された情報。画像にマウスを合わせると、SVNDbLibファイルを使用してリンクされたデータベースから配置された例を見ることができます。

Design Item IDフィールドの省略記号ボタン（）をクリックすると、同じテーブル内の他のコンポーネントに置き換えることができます。これにより、Replaceダイアログが開き、初期状態では同じテーブル内のすべてのコンポーネントがリストされます。実際には、同じDbLib/SVNDbLibファイルの異なるテーブル内のコンポーネントに変更したり、異なるファイルベースのライブラリを参照したり、利用可能な管理コンテンツサーバーから配置することもできます。選択したコンポーネントの新しい情報に応じて、領域が更新されます。

同期の確保

配置後、選択されたキーフィールドパラメーターを使用して、回路図上に配置されたコンポーネントが外部データベースのそのコンポーネントの対応するレコードへのリンクを保持するようにします。これは、将来の任意の段階で、データベース内のパラメーターやモデル情報の変更を配置されたコンポーネントに簡単に反映させ、両者を同期させることができることを意味します。

パラメータ情報を更新する場合は、Update Parameters From Databaseコマンドを使用してください。これは、回路図エディターのメインToolsメニューから利用できます。

パラメータ、モデル、および回路図シンボルのグラフィカル属性を含む完全な更新を行うには、Update From Librariesコマンド（回路図エディターのメインToolsメニューからも利用可能）を使用してください。

PCBエディターでは、Tools » Update From PCB Libraries commandを使用して、配置されたフットプリントをソースライブラリに格納されている最新情報で更新します。

二重同期 - DbLib/SVNDbLib と DBLink

既存の設計プロジェクトがあり、配置された部品の大部分がDbLinkファイルを使用して外部データベースにリンクされている場合があります。設計変更により追加の回路が必要になり、そのコンポーネントはデータベースライブラリ機能を使用して配置されるかもしれません。関連するDbLib/SVNDbLibファイルは、全く異なる外部データベースを指している可能性があります。

 Update Parameters From Databaseコマンドを使用すると、配置されたコンポーネントのすべてのリンクされたパラメータが、使用されたリンク方法に関係なく、すべてのリンクされたデータベースを横断して照会され、それらのパラメータの検出された違いがSelect Parameter Changesダイアログに表示されます。

BOMに直接データベース情報を追加する

関連ページ： レポートマネージャーでのBOM設定

過去、部品表（BOM）の情報源は、設計のために配置されたコンポーネントのパラメータ情報から取得されていました。しかし、これはBOMのためだけに使用される多くの情報が回路図に添付されることにつながります。配置されたAltium Designerコンポーネントがデータベースライブラリファイルを使用して外部データベースにリンクされている場合、BOMジェネレーターは、コンポーネントの設計パラメータとして追加されていない他のレコード情報を抽出することができます。

Report Manageダイアログを使用して部品表レポートを設定する際には、ダイアログの「列」タブでDatabase Parametersボタン（  ）をクリックし、これらをBOMのソースとして含めます。このオプションは、設計内の1つ以上のコンポーネントが外部データベースにリンクされている場合にのみ利用可能です。

Columnsリストでは、 アイコンが使用され、リンクされた外部データベースにおいて1つ以上の配置されたコンポーネントに存在するパラメータを区別します。可視性アイコンをクリックして目のアイコン()になるようにし、その列（パラメータ）をBOMに含めます。

外部データベースにのみ存在する追加のコンポーネント情報を含めます。