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

親ページ: コンポーネントとライブラリの構築とメンテナンス

Altium Designerは、会社のデータベースから直接コンポーネントを配置する機能を提供し、データベースライブラリを作成して使用することで実現します。配置は、データベースライブラリをインストールした後、データベースへのブラウザとして機能するComponentsパネルから行われます。

配置後、配置されたコンポーネントとデータベース内の対応するリンクされたレコード間で設計パラメータ情報を同期させることができます。これはTools » Update Parameters From Databaseコマンドを使用して行います。グラフィカルシンボル、モデル参照、およびパラメータを含む完全なコンポーネントの更新は、Tools » 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の外部で作成および管理することもできます。既存のリポジトリは、設定ダイアログのData Management - Design Repositoriesページで接続できます。

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

この文書の目的では、リポジトリが既に作成されていることを前提としています。

Library Splitter Wizardの使用

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

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

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

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

1. 分割したい必要なソースライブラリファイルを追加します（これらは同じフォルダにある必要はありません）。

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

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

3. ソースライブラリがどのように分割されるかを制御するための追加オプションを設定します。これには、回路図コンポーネントライブラリの場合、各構成コンポーネントからパラメータやモデル情報を削除し、単なる裸のシンボルだけを残すオプションが含まれます。

4. ソースライブラリとオプションが指定されたら、ウィザードは分析を実行し、その結果として作成される単一のシンボル/モデルライブラリのセットがリストアップされ、レビューのために表示されます。生成される各分割ライブラリの名前と、そのライブラリ内の回路図コンポーネント/フットプリントモデルの実際の名前が表示されます。元のソースライブラリもリストされます。ライブラリの名前は、構成コンポーネント/モデルに使用された名前と同じになります。

   コンポーネント/モデル名に次の文字が使用されている場合、ライブラリ名を作成する際にアンダースコアに置き換えられます: '\', '/', '!', ''', '[', ']'。

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

SVN Database Library Conversion Wizardの使用

ダイアログページ： 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領域からDatabase LibraryまたはSVN Database Libraryオプションを選択することで、これらのNew 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プロバイダーは、接続文字列の一部として指定されます。

接続は、メインメニューからTools » Database Connectionコマンドを選択するか、または領域の下部にあるConnectionボタンの右側にあるAdvancedボタンをクリックすることでアクセスできる、データベース接続ダイアログのConnectタブで定義することもできます。

データベース接続ダイアログのオプションとコントロール

Connectionタブ

• Source of Connection

  • Use Data Link File - 接続文字列は、データベースへの接続情報を文字列形式で表したもので、.udl 拡張子を持つ別のファイルとして保存できます。これを Microsoft データリンクファイルと呼びます。データベースへの接続元としてデータリンクファイルを使用したい場合は、このオプションを選択し、BrowseをクリックしてSelect Data Link Fileダイアログを開くか、ドロップダウンを使用して目的の.udlファイルを検索します。

  • Use Connection String - このオプションを選択し、BuildをクリックしてData Link Propertiesダイアログを開き、コンポーネントのパラメーターのマッピングのためにデータベースへの接続文字列を再構築します。接続文字列に指定される情報は、指定された OLE DB プロバイダーによって異なる場合があります。

   

Advancedタブ

• SQL Options

  • Quote Tables - テーブルを引用するために特定の引用符を使用する場合に有効にします。

    • Left Quote Character - 左の引用符を指定します。デフォルトは "[" です。

    • Right Quote Character - 右の引用符を指定します。デフォルトは "]" です。

     

   

使用される特定の引用符は、使用されるデータベースによって異なります。例えば、角括弧 ([ ]) は Microsoft データベース（MS Access など）でのみ有効であり、MySQL では "`" 文字が引用のために使用されます。

• Include Table Schema Names - このオプションを有効にすると、テーブル回路図名を持つテーブルが含まれます。デフォルトでは、このオプションはオフであり、通常のテーブル名のみを持つテーブルが使用されます。

ほとんどのデータベースには、テーブル名で識別されるテーブルがあります。他のデータベース、例えば Oracle には、table schema nameと呼ばれる接頭辞を持つテーブルもあります。このようなテーブルを含めるには、このオプションを有効にする必要があります。

• Field Data Type - 新しいフィールドのデータ型を指定します。例えば、MS Access や MySQL データベースには TEXT(N) や VARCHAR(N) を使用でき、Oracle データベースには VARCHAR2(N) を使用できます。

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

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

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

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

Data Link ファイルの指定

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

接続の進行

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

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

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

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

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

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

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

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

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

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

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

リスト内のテーブルエントリをクリックすると、そのアイコンがからに変わり、現在アクティブなテーブルであることを区別します。テーブル（およびそのすべてのデータ）は、ドキュメントの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タブのデータベース接続ダイアログで指定された引用符です。このダイアログには、ドキュメントの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句を好きなだけシンプルまたは複雑にすることができます。

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

データベースライブラリから配置されたコンポーネントの設計パラメータは、配置時に作成/追加されます。実際に作成されるパラメータと、配置後にその情報を更新するために使用されるオプション - Tools » 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]

• 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と呼ばれている場合、その名前の設計パラメータがそれにマッピングされます。設計パラメータの名前を変更するには、そのセル内をクリックして新しい名前を直接入力します。これらの設計パラメータ名が、回路図シート上に配置された後、コンポーネントの関連プロパティダイアログのParameters領域に表示されます。

データベースに関連付けられたコンポーネントのデータフィールドが多数存在する場合がありますが、回路図シートに配置する際に、それら全てをデザインパラメータとして追加したい、または必要とするわけではありません。この情報の多くは、部品表を生成する際にのみ必要とされる場合があります。リンクされたデータベースから直接BOMにパラメータ情報を追加できるようにするReport Managerダイアログを使用すると、回路図ソースドキュメントに「持ち運ばれる」情報の量を減らすことができます。詳細については、 BOMに直接データベース情報を追加するセクションを参照してください。

データベースから明示的にマッピングされないようにしたいフィールドには、Design Parameterエントリーを[None]に設定してください。マッピングされていないデータベースフィールドは、タブ上で赤い十字アイコン（）を使用して区別されます。マッピングされたデータベースフィールドは、緑のチェックアイコン（）によって区別されます。

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

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

Field Mappingsタブの残りの列では、データベースライブラリからコンポーネントを初めて配置する際、または配置した後にTools » 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 Parameter列に角括弧で示されているエントリー）には、これらが設計パラメータではないため、関連する更新オプションがありません。

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

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

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

第4のポイントは、中央の場所から更新オプションを指定し、各マップされたフィールドの更新オプションを定義する際にその場所を指すことができるため有益です。そのため、データベースフィールドを設計パラメータにマッピングすると、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ダイアログのSymbol and Model Search Pathsタブで定義されます（Tools » Options）。このダイアログは、ドキュメントビューのField Settings領域にあるOptionsボタンをクリックすることでアクセスすることもできます。

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

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

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

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

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

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

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

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

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

SVNDbLibにおいて、シンボルとフットプリントモデルが存在するSubversionリポジトリ内の基本ディレクトリは、Database Library OptionsダイアログのSVN Repositoryタブで指定されます（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コマンドを選択します。そのコンポーネントの編集ダイアログが表示され、親データベーステーブルのすべてのフィールドとその値がリストされます。Field Valueのエントリをクリックして編集します。希望するすべての変更を行った後、OKをクリックします - 変更は外部データベースのテーブルにコミットされ、対応するコンポーネントの更新されたエントリがTable Browserタブに反映されます。

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コマンドを選択します。

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

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

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

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

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

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

必要に応じてサプライヤーリンクの編集を終えたら、OKをクリックします。データベース内のコンポーネントの記録が更新され、新しく追加されたリンクごとにSupplier nとSupplier Part Number nの追加フィールドが追加されます。これらのフィールドのペアは、複数の定義されたサプライヤーリンクを区別するために整数の接尾辞nを持ちます。

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

データベース自体の内容を維持するだけでなく、必要に応じて参照されるシンボルやモデルも維持する必要があります。これには、回路図のシンボルとフットプリントモデルの修正が含まれます。そして、標準データベースライブラリ（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メニューからCheck Out All Working Foldersコマンドを実行します。チェックアウトされるフォルダは、Database Library OptionsダイアログのSVN RepositoryタブのModels Location領域で指定されたものになります。

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

変更を加える

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

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

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

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

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

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

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

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

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

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

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

パネルページ： Storage Manager

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

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

ローカルのシンボルおよびモデルライブラリを扱う際に関連するステータスエントリーは以下の通りです：

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

リビジョンの物理的比較

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

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

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

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

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

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

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

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

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

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

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つのアプローチをサポートしています。

パネル内検索

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

コンポーネントパネル内で直接検索を実行できます。

詳細な検索の実行

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

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

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

詳細な検索機能には、基本的に「フィールドベース」と「SQLベース」のクエリによる2つの「レベル」の検索があります。

フィールドベース検索

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

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

SQLクエリ検索

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

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

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

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

自動キャッシュ更新

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

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

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

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

• PCBエディタでのTools » 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（コンポーネント名 / 部品番号）。これは、DbLib/SVNDbLibファイルのField Settings領域で定義された選択されたキーフィールドで、通常は部品番号です。

• 親の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コマンドを使用して、配置されたフットプリントをソースライブラリに格納されている最新情報に更新します。

二重同期 - DbLib/SVNDbLib と DBLink

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

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

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

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

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

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

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

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