データベースライブラリの作成と定義

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

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

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

メインメニューからFile » New » Libraryコマンドを選択し、開いたNew Library ダイアログのDatabase領域からDatabase 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プロバイダーは、接続文字列の一部として指定されます。

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

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

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

接続文字列の構築

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

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

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

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

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

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

Data Linkファイルの指定

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

接続の進行

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

接続の詳細に問題がある場合、例えば接続文字列が誤って構築されている、またはパスが誤って入力されているなど、接続は失敗し、この事実を警告するメッセージが表示されます。接続設定を確認し、再度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 parameterフィールドも自動的に部品番号に設定され、Where句のエントリは以下のようになります：

[部品番号] = '{部品番号}'

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

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

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

標準の SQL 構文を使用すると、Where 句は、たとえば複数の Database field/Part parameterエントリを使用して一致するように拡張できます：

[容量] = '{Capacitance}' AND [許容差] = {Tolerance} AND [製造元] = '{Manufacturer}'

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

標準的な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]

データベーステーブルには無制限のフットプリントモデル参照（およびパス）を指定でき、DbLib/SVNDbLibファイルでマッピングできます。予約名では、nは2から始まる正の整数を表します。

• 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]

  • PCB3Dへの参照は、レガシー3Dビューアーに関連しています。これらは新しい設計には使用しないでください。PCBエディターのネイティブ3Dエンジンは、コンポーネントのボディとコンポーネントのフットプリントに関連付けられたインポートされた3Dモデルファイルをレンダリングできます。
  • PCB3DモデルマッピングはSVNDbLibファイルで定義できますが、Subversionリポジトリ内のPCB3Dモデルライブラリの保存はサポートされていません。
• 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]

  下記のシミュレーションモデルマッピングを参照して、シミュレーションモデル関連フィールドの詳細を学んでください。
  外部データベースのコンポーネントには、一つのシミュレーションモデルリンクのみを定義できます。通常、コンポーネントにリンクされるシミュレーションモデルは一つだけです。複数のシミュレーションモデルリンクを設定したい場合、他のリンクはそのコンポーネントをソースの回路図ライブラリファイルに定義して保存する必要があります。
  バージョン管理されたデータベースライブラリ（SVNDbLib）では、リンクされたシミュレーションモデルがサポートされていますが、Subversionリポジトリ内のシミュレーションモデルファイルの保存はサポートされていません。

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

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

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

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

シミュレーションモデルマッピング

このセクションでは、コンポーネントの配置時に作成されるシミュレーションモデルリンクを定義するために、外部データベーステーブルに追加できる各データベースフィールドについて説明します。

• Sim Model Name - 使用したいモデルの名前です。コンポーネントが配置された後、この情報はSim ModelダイアログのModel Nameフィールドに表示されます。

  DBLibファイルでデータベースフィールドを設計パラメータにマッピングする場合、Simモデル名フィールドはフットプリント参照、ライブラリ参照などのフィールドと同様です。
• Sim Description - リンクされたモデルの説明です。この情報はオプションであり、シミュレーションモデルリンクの操作には影響しません。

• Sim File - Sim Model Nameフィールドで指定されたシミュレーションモデルを探すための特定のモデルファイルです。このフィールドを使用する方法はいくつかあります：

  • モデルファイルへの絶対パスを入力できます（例：C:\DbLibs\Switching Diodes\Libraries\JAS33.mdl）。このファイル内でSim Model Name フィールドに指定されたモデルが検索され、見つかった場合は使用されます。
  • モデルファイルへの相対パス（DbLibファイルに対して相対的）を入力できます（例：Libraries\JAS33.mdl）。このファイル内でSim Model Name フィールドに指定されたモデルが検索され、見つかった場合は使用されます。
  • モデルファイル名のみを入力できます（例：JAS33.mdl）。DbLibファイルの一部として定義された検索パスは、指定された名前に一致する最初のモデルファイルを探し、その中にSim Model Name フィールドで指定されたモデルが含まれている場合はそれを使用します。
  • フィールドを空白のままにすることができます。DbLibファイルの一部として定義された検索パスは、Sim Model Name フィールドで指定されたモデルに一致する最初のモデルファイルを探します。
  検索パスは、データベースライブラリオプションダイアログのSymbol & Model Search Pathsタブ（Tools » Options）からDbLibファイルに対して定義されます。
• Sim Kind - リンクされるモデルの親カテゴリです。
• Sim SubKind - リンクされるモデルのタイプです。

• Sim Netlist - リンクされるモデルのタイプに従ったネットリストテンプレート情報です。特に自分自身のネットリストテンプレートを指定し、Sim SubKindフィールドを汎用エディタに設定した場合、ネットリストに配置される情報をより詳細に制御することができ、このフィールドは特に重要になります。

  このフィールドは定義されていなければならず、空白のままにしてはいけません。そうでないと、モデルはシミュレーションネットリストにエントリが作成されず、データベースライブラリから配置された部品はシミュレートされません。
  ネットリストテンプレートの構文

  ネットリストテンプレートを定義する際に入力される情報は、SPICEの要件と以下に説明される構文ルールに従う必要があります。

  テンプレートに入力された文字は、以下の特殊文字を除いて、SPICEネットリストにそのまま書き込まれます：

  %	percent sign
  @	commercial at
  &	ampersand
  ?	question mark
  ~	tilde
  #	number sign

  これらの文字は、ネットリストを作成する際に、以下の表に示すように変換されます：

  ネットリストテンプレートの構文	ネットリスター
  @<param>	<param>の値。 この名前のパラメーターが存在しない場合、または値が割り当てられていない場合は、エラーが発生します。
  &<param>	<param>の値。 パラメーターが未定義の場合、エラーは発生しません。
  ?<param>s...s	<param>が定義されている場合、s...s 間のテキストの区切り文字。
  ?<param>s...ss...s	<param>が定義されている場合、最初のs...s 間のテキストの区切り文字。定義されていなければ、2 番目の s...s 区切り文字。
  ~<param>s...s	<param> が定義されていない場合、s...s 間のテキストの区切り文字
  ~<param>s...ss...s	<param>が定義されていない場合、最初のs...s 間のテキストの区切り文字。定義されていれば、2 番目の s...s 区切り文字。
  #<param>s...s	<param>が定義されている場合、s...s 間のテキストの区切り文字は無視されますが、 <param> が定義されていなければ、テンプレートの残りの部分は無視されます。
  #s...s	ネットリストテンプレートの後続のエントリからXSpiceネットリストに入力するテキストがある場合、s...sのテキスト区切り文字。
  %<pin id>	回路図ピンが <ピン ID > にマッピングされているネットのネット名。
  %%	リテラルのパーセント文字。

  上の表では、

  • s は区切り文字 (, . ; / |) を表します。
  • <param> は、パラメータの名前を指します。

パラメーター名に英数字以外の文字が含まれている場合は、二重引用符で囲む必要があります。例えば：

@"DC Magnitude" - ここで二重引用符が使用されているのは、名前にスペースが含まれているためです。
&"Init_Cond" - ここで二重引用符が使用されているのは、名前にスペースが含まれているためです。

二重引用符は、パラメータ名に英数字の接頭辞を追加する場合にも使用する必要があります。例えば：

@"DESIGNATOR"A - 二重引用符を使用すると、コンポーネント指定子に A が付加されます。

以下は、前の表の特殊文字構文エントリの例です。いずれの場合も、構文エントリがネットリスタによってどのように変換されるかに関する情報が提供されます。

@"AC Phase"

パラメーター名 AC Phase は、スペースのため中括弧で囲まれています。これは、ネットリストで [AC Phase] パラメーターの値に置き換えられます。この名前のパラメータがない場合、またはその値が空白の場合は、エラーが表示されます。

&Area

Area という名前のパラメーターが存在し、値がある場合、その値がネットリストに入力されます。パラメーターが未定義の場合 (存在しないか、値が割り当てられていない場合)、ネットリストには何も書き込まれませんが、エラーは発生しません。これは、省略可能なパラメーターに使用できます。

?IC|IC=@IC|

IC という名前のパラメータが定義されている場合、||セパレータがネットリストに挿入されます。たとえば、パラメータ IC の値が 0.5 の場合、このエントリの代わりに IC=0.5 がネットリストに挿入されます。パラメータが未定義の場合、ネットリストには何も挿入されません。

?IC/IC=@IC//IC=0/

これは前の例と同じですが、パラメーター IC が未定義の場合、IC=0 がネットリストに挿入されます。また、別の区切り文字が使用されていることにも注意してください。

~VALUE/1k/

VALUE という名前のパラメーターが定義されていない場合、1k というテキストがネットリストに挿入されます。

~VALUE/1k//@VALUE/

これは前の例と同じですが、パラメーター VALUE が定義されている場合、そのテキスト値がネットリストに挿入される点が異なります。

#"AC Magnitude"|AC@"AC Magnitude"|@"AC Phase"

この例は、正弦波電圧源の定義済みのネットリスト テンプレートで確認できます。

AC Magnitude パラメーターが定義されている場合、セパレーターの内容が評価され、ネットリストに挿入されます。ネットリスト内の後続のすべてのエントリも評価され、ネットリストに入力されます (この場合は @"AC Phase")。

たとえば、AC Magnitude=1 で AC Phase=0 の場合、AC 1 0 がネットリストに挿入されます。ただし、AC フェーズが未定義の場合は、エラーが発生します。

パラメーター AC Magnitude が未定義の場合、ネットリスト テンプレートの #"AC Magnitude" エントリに続くものはネットリストに入力されません。

#|PARAMS:|?Resistance|Resistance=Resistance|?Current|Current=@Current|

この例は、パラメーター化されたサブサーキットの事前定義されたネットリスト テンプレートで確認できます (Fuse.PrjPcb の F1 を参照)。

[Resistance] パラメータと [Current] パラメータが両方とも未定義の場合、ネットリストの #|PARAMS:|エントリなので、区切り文字のテキストも省略されます。

たとえば、パラメータの値が Resistance=1k および Current=5mA の場合、#|PARAMS:|エントリとPARAMS: Resistance=1k Current=5mA がネットリストに入力されます。

@DESIGNATOR%1%2@VALUE

この例は、% 文字の使用法を示すためのものです。

たとえば、パラメータの値が DESIGNATOR=R1 と VALUE=1k で、ピンが次の表に従ってSim Model ダイアログの Pin Mapping領域にマップされている場合、次のようになります：

次に、R1 GND OUT 1k というテキストが、このコンポーネントの SPICE ネットリストに配置されます。

• Sim Spice Prefix – リンク先のモデルタイプの SPICE プレフィックス。
• Sim Port Map – 回路図コンポーネントからリンク モデルのピンへのピンのマッピング。コンポーネントを配置すると、この情報がSim Model ダイアログの Pin Mapping領域に表示されます。

各ピンの組み合わせは、次の形式で入力する必要があります：

(SchematicPinNumber:ModelPinNumber),

マップされた各ペアはコンマで区切られます。

たとえば、回路図のピン 1 (アノード) をモデルのピン 1 (アノード) にマッピングし、回路図のピン 3 (カソード) をモデルのピン 2 (カソード) にマッピングする必要があるダイオード シミュレーション モデルをマッピングする場合、これは次のようにデータベース フィールドに入力されます：

(1:1),(3:2)

Sim Excluded Parts – このフィールドは、マルチパートコンポーネントの特定の部分をシミュレーションから除外する場合に、データベースに作成します。この情報はSim ModelダイアログのPin Mapping領域にあるExclude part from simulationオプションに対応します。

既定では、マルチパート コンポーネントのすべてのパーツがシミュレーションに含まれるため、除外するパーツを番号で指定するだけで済みます。除外リスト内の複数の部分は、コンマで区切ります。たとえば、構成部品に 4 つの部品があり、部品 2 と 4 をシミュレーションに含めない場合は、データベース フィールドに次のように入力します：

2,4

Sim Parameters – このフィールドは、モデルのシミュレーションパラメータに値を割り当てる場合にデータベースに作成します。これらは、モデルファイルに含めることができるより高度なパラメータとは対照的に、コンポーネントレベルで定義できるパラメータです。

パラメータは、次の形式で入力する必要があります。

ParameterName=Value,

複数のパラメーターは、パイプ文字 (|) で区切る必要があります。

コンポーネントレベルのシミュレーションパラメータは、コンポーネントパラメータとして設定することもでき、関連するComponent PropertiesダイアログのParameters領域に表示され、回路図シートに表示することができます。デフォルトでは、Sim Parametersフィールドのパラメータエントリは、コンポーネントパラメータとして自動的に追加されます。シミュレーションパラメータをコンポーネントパラメータとして追加したくない場合は、パラメータ名に感嘆符の接頭辞を追加するだけです(例:!Initial Voltage=100mV)。

次の4つのコンポーネントレベルのパラメータを持つダイオードモデルについて考えてみます：

• Area Factor
• Starting Condition
• Initial Voltage
• Temperature

次に、データベースにArea Factor (2 など) とTemperature (22°C など) の値を追加することを検討します。また、これらの両方をコンポーネント パラメーターとして追加しないでください。Sim Parametersフィールドのエントリは、次のようになります：

!Area Factor=2|!Temperature=22

データベースライブラリからコンポーネントを配置したら、シミュレーションリンクに定義された情報が必要なものとして確認できます。配置されたコンポーネントが設計スペースで選択された場合、パラメータ領域のプロパティパネルでシミュレーションモデルエントリを選択し、ボタンをクリックしてSim Modelダイアログにアクセスします。そこから以下を確認できます：

• モデルファイルが期待通りに見つかった場合、ダイアログのモデルファイルタブにファイルの内容が表示されます。
• データベースからの残りのシミュレーション情報が期待通りにダイアログに追加されています。

データベースフィールドに保存された値は、データベースライブラリから配置されたコンポーネントに対してシミュレーションを実行する際に使用されます。ただし、データベースライブラリから配置されたコンポーネントのシミュレーションモデルのSim ModelダイアログにアクセスしてOKをクリックすると、選択されたモデルテキストに基づいてそのコンポーネントのSim NetlistおよびSim Spice Prefixフィールドが自動的に設定されます。

パラメータ

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

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

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

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

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

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

• Update Values - この列のセルは、パラメータが回路図シートとデータベースの両方に存在するが、現在の値が異なる場合に取るべきアクションを決定するために使用されます。配置されたコンポーネントのパラメータをデータベースに保存されている値で更新する（更新）、または全く更新しない（更新しない）を選択できます。このオプションは、コンポーネントが配置された後にUpdate Parameters From Databaseコマンドを使用する際に従われます。
• Add To Design加 - この列のセルは、パラメータがデータベースに見つかるが、配置されたコンポーネントには存在しない場合に取るべきアクションを決定するために使用されます。パラメータを追加する（追加）、パラメータを追加しない（追加しない）、またはデータベースに値が割り当てられている場合にのみパラメータを追加する（データベースで空白でない場合のみ追加）を選択できます。このオプションは、データベースライブラリからコンポーネントを初めて配置する際と、コンポーネントが配置された後にUpdate Parameters From Databaseコマンドを使用する際に従われます。
• Visible On Add - この列のチェックボックスは、初期配置または配置後の更新から生じる新しく追加されたパラメータが、回路図シート上のコンポーネントに対して表示されるかどうか（有効）または表示されないか（無効）を決定するために使用されます。
• Remove From Design - この列のセルは、パラメータが配置されたコンポーネントに存在するが、データベースには存在しないか、または存在するが値がない場合に取るべきアクションを決定するために使用されます。パラメータを全く削除しない（削除しない）、またはデータベースに割り当てられた値がない場合にのみ削除する（データベースで空白の場合のみ削除）を選択できます。このオプションは、コンポーネントが配置された後にUpdate Parameters From 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にすべてのフィールドを設定し、データベースライブラリオプションダイアログから必要な更新決定を行うか、各更新フィールドを個別に設定するか、またはその両方の混合を行うことができます - 決定は完全にあなた次第です。配置されたコンポーネントに対しては、更新が行われる際にはエンジニアリング変更命令ダイアログを通じて実行されます。この段階で、行いたくない更新がある場合は、その特定の変更を含めないように選択できます - これにより、どの設計パラメータが更新されるかについて最終的かつ究極の決定権を持つことができます。

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

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

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

データベースにパス情報のためのフィールドを定群している場合、これらのフィールドは適切な設計パラメーターにマッピングする必要があります - [ライブラリパス]、[フットプリントパス]、[PCB3Dパス]、[シムファイル]など（モデルとパラメータマッピングを参照してください）。

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

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

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

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

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

1. ライブラリ検索パス領域の下にあるフィールドに直接パスを入力するか、または ボタンをクリックしてフォルダを参照ダイアログにアクセスし、必要なライブラリ/モデルファイルが存在するディレクトリを探します。
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. データベースにライブラリファイル情報が存在しない場合、指定されたモデルの場所を使用して、適用される参照フィールドで指定されたシンボルまたはフットプリントモデルに一致する最初のライブラリファイルを探します。

シンボル/フットプリントを検索する際、システムは最初にそのシンボルまたはフットプリント自体の名前と同じ名前のライブラリを探します。例えば、データベース内の論理シンボル名が（[Library Ref]のマッピングによって指定されている）Capacitor_NonPolarizedである場合、システムは最初にCapacitor_NonPolarized.SchLibという名前のファイルを探し、このファイル内でシンボルを探します。この方法でシンボル/フットプリントが見つからない場合、システムはすべてのライブラリ内で一致するものを探します。