クエリ言語の活用

クエリとは何か?

複雑な電子設計を行う際の最大の課題は、多数の設計オブジェクトを管理することです。回路図シート上のコンポーネント、ネットラベル、テキスト文字列から、PCB上の配線を構成する数百のコンポーネントやトラックまで、これらのオブジェクトにアクセスし、確認し、編集する必要があります。ほとんどのWindowsアプリケーションと同様に、オブジェクトをダブルクリックしてそのプロパティを編集できます。これは単一のオブジェクトに対しては問題ありませんが、300以上のコンポーネント指定子文字列を編集したり、PCB上のすべてのビアを変更したりする必要がある場合には適していません。このような更新を行うには、複数のオブジェクトに同時にアクセスする必要があります。

Altium Designerの回路図エディタとPCBエディタの基盤となっているのは、強力なクエリエンジンです。このエンジンにクエリを入力することで、必要なオブジェクトを正確に見つけて編集することができます。

Altium Designerの強力なデータフィルタリングおよび編集システムを使用すると、指定されたオブジェクトのセットを返すようにソフトウェアに指示することができます。この指示はクエリの形で入力されます。クエリは、特定のキーワードと構文を使用して入力する文字列で、目的のオブジェクトを返します。それらのオブジェクトをどのように扱うかはあなた次第です。たとえば、それらを強調表示して他のすべてのオブジェクトを暗くするか、またはそれらのプロパティを閲覧またはソートして、共有する特定の属性を変更することができます。

クエリを適用できる場所はいくつかありますが、コマンドセンターは下の画像に示されているFilterパネルです。F12を押すとFilterパネルが表示/非表示になります。

PCB FilterおよびPCB FilterおよびSCH Filterパネルにクエリがあります

PCBLIB FilterおよびPCBLIB FilterおよびSCHLIB Filterパネルにクエリがあります

パネルのコントロールを使用して、クエリが適用されるオブジェクトを定義し、クエリをパスしたオブジェクトとパスしなかったオブジェクトの扱い方を決定します。

クエリ結果はどこですか?

Filterパネルにクエリを書いたので、クエリによって返されたオブジェクトにどのようにアクセスしますか?オブジェクトは、Altium Designer環境でアクセスおよび編集する方法が2つあります。

  • Graphically - フィルターを適用した後、デフォルトの動作は、クエリに失敗したすべてのオブジェクトをマスク(フェードさせて編集不可にする)し、合格したオブジェクトのみを残します。このモードは、ワークスペース内のオブジェクトを見つけてレビューするのに優れています。マスクされたオブジェクトは編集できないため、Ctrl+A(すべて選択)などのコマンドは、クエリによって返されたオブジェクトにのみ適用されます。

  • Listパネル - Listパネル(Shift+F12)は、デザインデータへのスプレッドシートのようなビューです。デフォルトでは、すべてのデザインオブジェクトが表示されますが、フィルターが適用されると、クエリによって返されたオブジェクトのみが表示されます。リストパネルは、ソートや選択のための標準的なスプレッドシートのような動作を持ち、単一または複数のセルを直接編集することができます。

The PCB List panel and SCH List panel display the results from the PSB/SCH queries in the previous section.

PCB ListパネルとSCH Listパネルは、前のセクションのPSB/SCHクエリの結果を表示します。

オプションの強調表示

クエリが適用されるたびに(またはデータフィルタリング機能が使用されると)、ターゲットドキュメント内の各オブジェクトはそのフィルタリングアクションの結果のメンバーになります。しかし、結果に含まれるオブジェクトと結果に含まれないオブジェクトがその後どのように表示されるかは、Filterパネルで選択されたハイライトオプションに依存します。利用可能なハイライトオプションは3つあり、これらのオプションは互いに完全に独立しているため、1つ、2つ、またはすべてを選択できます。

ズーム

クエリが適用されるときにZoomオプションが有効になると、対象文書の表示が更新され、結果に含まれるすべてのオブジェクトが占める領域が表示されます。残りの各オブジェクトが更新されたビューに表示されるかどうかは、その領域に対する位置に依存するため、それらのオブジェクトは完全に表示される場合もあれば、部分的に表示される場合も、まったく表示されない場合もあります。

このオプションは、他のオプションのいずれかまたは両方と組み合わせて選択されることがよくあります。Maskオプションが有効になっていない場合、結果に含まれていないオブジェクトは、更新された境界内にある限り、グラフィカルビューに表示されます。一見、このオプションを単独で選択することは無意味に思えるかもしれませんが、特定のオブジェクトを含むようにグラフィカルビューを更新したい場合があり、その際にドキュメントのオブジェクトの選択状態やマスク状態を変更しないことがあります。

選択

Selectオプションが有効になっていると、結果にあるすべてのオブジェクトは選択された状態になり、残りのオブジェクトは選択されていません。選択されたオブジェクトは、非選択オブジェクトとは異なる方法で表示されます。

現在のクエリが適用されるときに選択オプションが選択されると、結果セットのメンバーであるすべてのオブジェクトは選択状態を取得し、結果セットのメンバーでない残りのオブジェクトは非選択状態を取得します。このオプションは、現在選択されているオブジェクトのみがその時点でプロパティを更新されるため、通常はグローバル編集手順の直前に選択されます。しかし、特定のオブジェクトを移動、コピー、または削除する必要がある場合など、選択オプションが役立つ他の場面もあります。

マスク

Maskのハイライトオプションは、ターゲットドキュメント内のオブジェクトの更新されたマスクプロパティを決定します。選択されると、結果に含まれるすべてのオブジェクトがマスクされ、残りのオブジェクトはマスク解除されます。マスクされたオブジェクトの主な特徴は、それらとそのプロパティが編集できないことです。(マスクされたオブジェクトはリストビューで薄暗く表示されますが、Listパネルでall objectsオプションが現在選択されていない限り、リストビューには表示されません。)マスクされたオブジェクトの主な特徴は、オブジェクトとそのプロパティが編集できないことです。

クエリビルダー

PCBエディタには専用のQuery Builderダイアログが含まれています。このダイアログを使用すると、ドロップダウンリストからテスト条件を選択して複雑なクエリを構築できます。Query Builderの利点は、異なる種類のオブジェクトをターゲットにしたクエリを作成できることです。

「クエリビルダー」機能の一部である「ビルディングクエリ」ダイアログは、クエリの指定に不慣れな人々を支援します。デザイナーが指定した条件に対応する内容のクエリが自動的に生成されます。

このダイアログの左側のセクションには、デザイナーがこのダイアログによって生成されたクエリによって返される文書の各オブジェクトに必要なプロパティを指定する作業を支援するためのコントロールが含まれています。それぞれの条件が指定または編集されると、対応するクエリの内容が更新され、ダイアログの右側のセクションに表示されます。このダイアログがOK(または適用)ボタンをクリックして閉じられると、関連するクエリが適用されるか、その内容がフィルターパネルにコピーされます(このダイアログが最初にどのように呼び出されたかによります)。

Query Builderダイアログは、以下の場所から起動できます(下の画像に示されています):

  • PCB Filterパネルから、Query Builderボタンをクリックしてクエリを構築し、文字列をパネルに読み込んでください。

  • PCB Rules and Constraints Editorダイアログから、Builderボタンをクリックして、このルールが適用されるオブジェクトを定義するクエリを作成します。

PCB Rules and Constraints EditorダイアログからQuery Builderダイアログにアクセスすると、そのルールの種類にのみ適したオプションが表示されます。

下の画像は、5Vネット上のパッドとビアの両方をターゲットにしたクエリを作成するために使用されているQuery Builderダイアログを示しています。

The Query Builder dialog

Query Builderダイアログ

  • 必要に応じて、ターゲットとなるデザインオブジェクトのセットを絞り込むための追加条件を加えてください。条件はANDまたはORで組み合わせることができます。デフォルトの論理演算子はANDです。

  • 条件間の論理演算子を変更するには、Condition Type/Operator列のANDまたはORの項目をクリックし、必要な演算子を選択します。クエリのプレビューはそれに応じて更新されます。

  • Query Builderダイアログ (Building Query from Board) は、関連する「ビルディングブロック」を使用してのみ構築を許可する敏感な条件タイプと値を使用してクエリを構築する簡単な方法です。完全なキーワード指定と演算子構文を使用した高度なクエリ構築には、Query Helperダイアログを使用してください。

  • クエリ文字列の任意の条件は、Condition Type/Operator列のその条件のエントリをクリックし、ドロップダウンリストの利用可能なエントリから必要な新しい条件を選択することで、いつでも調整できます。クエリのプレビューはそれに応じて更新されます。

  • 選択した条件エントリを構造内で上または下に移動するには、Ctrl+上矢印Ctrl+下矢印のショートカットを使用します。

  • 選択した位置のインデントを増減するには、Ctrl+右矢印およびCtrl+左矢印のキーボードショートカットを使用します(括弧を追加/削除します)。

クエリヘルパー

クエリ作成スキルを向上させるための次のステップは、Query Helperダイアログを使用することです。Query Helperダイアログには、希望するクエリを入力できるQueryボックスが含まれており、Queryフィールドの下にある構文ボタン(例:AndOr<NotLikeなど)や、Categoriesフィールド内のすべてのクエリキーワードの完全なリストも使用できます。

「クエリヘルパー」ダイアログは、自分のクエリを指定したいデザイナーのための支援を提供します。リストされている各キーワードには簡単な説明が付いていますが、キーワードがハイライトされている状態でF1キーを押すことでオンラインヘルプにアクセスできます。これにより、ハイライトされたキーワードによってドキュメント内のどのオブジェクトが返されるか、そのキーワードの使用方法、およびその使用例が1つ以上提供されるAltium Designerドキュメンテーションライブラリダイアログが呼び出されます。

ダイアログには以下の方法でアクセスできます:

  • FilterパネルのHelperボタンをクリックしてください。

PCB Filterパネルアクセス 

SCH Filterパネルアクセス

  • File-based Libraries Searchダイアログ(コンポーネントパネルの右上隅をクリックし、ドロップダウンメニューからFile-based Libraries Searchを選択してアクセス)で、Helperボタンをクリックします。

Helperボタンは、File-based Libraries SearchダイアログでAdvancedをクリックした後に利用可能です。

File-based Libraries SearchダイアログアクセスFile-based Libraries Searchダイアログアクセス

ダイアログの上部にあるQueryセクションを使用して、利用可能な関数を使用してクエリ式を作成します。テキストボックスでは、検索式を確認および/またはさらに編集できます。テキストボックスに直接入力して検索式を編集します。特定のキーワードを追加するために入力を開始します。入力している間、ダイアログはこれまでに書かれたテキストに一致する利用可能なキーワードのドロップダウンメニューを提供します。キーワードをクリックして選択の入力を自動的に完了します。希望のキーワードがハイライトされている場合、Enterを押すことでも選択を自動的に完了できます。

利用可能なキーワードのCategoriesを閲覧して、必要なものを探します。Maskフィールドを使用すると、正確なキーワードがわからない場合に役立ちます。たとえば、回路図エディタのQuery Helperで、Maskフィールドに*harを入力すると、下の画像に示されているように、ハーネスに特に適用されるキーワードが見つかります。Maskフィールドは、キーワードのNameフィールドとDescriptionフィールドの両方で機能するため、可能性のあるキーワードを見つける最も迅速な方法です。

キーワードがハイライトされているか、入力したキーワード内にカーソルがある場合にF1を押すと、そのキーワードのドキュメントが開きます。これは、各クエリキーワードの基本的な動作を学ぶための最も価値のあるリソースです。

グリッド内のキーワードをダブルクリックすると、現在のカーソル位置にクエリが追加されます。

ダイアログの中央領域には、式を構築する際に使用する一連の演算子を提供する構文ボタンが含まれています。各構文ボタンの個々の機能の詳細については、下の論理クエリ式演算子セクションを参照してください。式が文法的に正しいかどうかを確認するには、ダイアログの左下にあるCheck Syntaxボタンを使用します。

履歴クエリ

フィルタパネル(SCH Filter SCHLIB FilterPCB Filter PPCBLIB Filter)から新しいクエリを入力して適用すると、クエリ履歴リストに追加されます。パネル上のHistoryボタンをクリックしてこのリストにアクセスします。Expression Managerダイアログが開き、Historyタブがアクティブになります。

HistoryタブのExpression Managerダイアログは、過去に使用されたクエリ式のリストを提供します。ここでは、回路図の履歴クエリの例が示されています。PCBの類似の例リストを表示するには、画像の上にマウスを移動させます。HistoryタブのExpression Managerダイアログは、過去に使用されたクエリ式のリストを提供します。ここでは、回路図の履歴クエリの例が示されています。PCBの類似の例リストを表示するには、画像の上にマウスを移動させます。

リストから履歴クエリを使用するには、そのエントリを選択してApply Expressionボタンをクリックするか、エントリを直接ダブルクリックします。ダイアログが閉じ、クエリの式が関連するフィルタパネルの中央領域にロードされます。

履歴クエリは、そのエントリを選択してAdd To Favoritesボタンをクリックすることで、お気に入りクエリのリストに追加できます。履歴リストを「フラッシュ」したい場合は、Clear Historyボタンを使用します。

リストから最も最近に使用されたクエリ式のうち最大9つが、フィルタパネルの右クリックHistoryサブメニューから使用できます。

Historyリストの内容は、設計ドメインのフィルターパネル(回路図編集ドメインのSCH Filter SCHLIB Filter、PCB編集ドメインのPCB Filter PCBLIBFilter)で共通しており、アクセス可能であることに注意してください。一部のクエリ式は、回路図エディタで使用されると結果を返さない場合があります。特に、それらが回路図ライブラリエディタ内でのみ利用可能なオブジェクトをターゲットにして作成された場合はそうです。

お気に入りのクエリ

定義されたクエリは、次の2つの方法でお気に入りのクエリのリストに追加できます。

  • Add To Favoritesボタンをクリックするか、メインのQuery Expression領域で右クリックして、コンテキストメニューからAdd to Favoritesコマンドを選択して、アクティブなフィルターパネルの中央領域で現在定義されているクエリ式を追加します。

  • Expression ManagerダイアログのHistoryタブで履歴クエリエントリを選択し、次にAdd To Favoritesボタンをクリックします。

お気に入りのクエリ式は、式マネージャーダイアログのFavoritesタブに保存され、管理されます。フィルターパネル(SCH Filter SCHLIB Filter、 PCB Filter PCBLIB Filter)のFavoritesボタンを使用するか、フィルターパネルのQuery Expression領域を右クリックして、コンテキストメニューからOrganize Favoritesコマンドを選択することでアクセスできます。デザインスペースからは、Yショートカットキーを使用してダイアログにアクセスし、ポップアップフィルターメニューからOrganize Favoritesを選択します。

Access a listing of your favorite queries from the editor's filter panel or from the design space, using the filtering pop-up menu.

エディタのフィルタパネルやデザインスペースから、フィルタポップアップメニューを使用してお気に入りのクエリのリストにアクセスします。

クエリ式がFavoritesリストに追加されると、ユニークな名前が割り当てられます。デフォルトでは、一般的な名前が割り当てられます - Favorite_n - ここでnは次に使用可能な未使用の番号です。エントリの名前は、次のいずれかの方法を使用して、いつでも変更できます:

  • クエリエントリを選択してから、Renameボタンをクリックします。

  • クエリエントリを選択し、右クリックメニューからEditコマンドを選択します。

  • クエリエントリを選択し、次にNameフィールド内を再度クリックします。

各場合において、新しい名前を必要に応じて入力し、変更を適用するためにNameフィールドの外をクリックしてください。

お気に入りのクエリ式を編集するには、リスト内のエントリを選択し、次にEditボタンをクリックします(または右クリックしてコンテキストメニューからEditを選択します)。Edit Favoriteダイアログが開きます。このダイアログを使用して、お気に入りの名前を変更し、式自体を変更し、フィルターを通過するデザインオブジェクトと通過しないデザインオブジェクトの取り扱いを決定します。

Modify an existing favorite query using the Edit Favorite dialog, shown here for Schematic (left) and PCB (right).

回路図(左)とPCB(右)のために示されたEdit Favoriteダイアログを使用して、既存のお気に入りクエリを修正します。

Favoritesリストからクエリを削除するには、リスト内のエントリを選択し、Removeボタンをクリックするか、右クリックメニューからRemoveコマンドを選択します。削除の確認を求めるダイアログが表示されます。

Favoritesリストの内容は、設計ドメインのフィルターパネル(回路図編集ドメインのSCH Filter / SCHLIB Filterフィルタ、PCB編集ドメインのPCB Filter PCBLIB Filter)で共通しており、アクセス可能です。一部のクエリ式は、回路図エディタで使用されると結果を返さない場合があります。特に、それらが回路図ライブラリエディタ内でのみ利用可能なオブジェクトをターゲットにして作成された場合です。

お気に入りのクエリを使用する

お気に入りのクエリを使用する方法は3つあります:

  1. Expression ManagerダイアログのFavoritesタブから、エントリを選択してApply Expressionボタンをクリックするか、エントリをダブルクリックします。ダイアログは閉じ、クエリのエクスプレッションが関連するフィルターパネルの中央領域に読み込まれます。

  2. フィルタパネルの右クリックメニューの上部から(お気に入りリストに最近追加されたクエリ式のうち最大10個が利用可能です)。

  3. デザインスペースのフィルタリングポップアップメニューから(Yを押す) - お気に入りのクエリ式がメニューの上部に最大10個表示されます。選択したクエリ式は、関連するフィルタパネルの中央領域に読み込まれます。

フィルタメニューをカスタマイズして、お気に入りにショートカットキーを定義することもできます。Altium Designer環境のカスタマイズに関する詳細は、Altium Designerの設定とカスタマイズを参照してください。

事前パッケージ化された例の使用

回路図エディタとPCBエディタの両方に、事前パッケージ化された例のクエリセットが用意されています。これらの例は、フィルタパネルの式領域を右クリックするか、デザインスペースでYショートカットキーを使用してアクセスしたフィルタリングメニューから利用できます。Examplesにマウスを合わせると、サブメニューが表示されます。

サブメニューの項目を選択すると、そのフィルタの背後にあるクエリが適用されます。例の1つの実際のクエリを表示するには、それを適用した後のHistoryリストを見てください。このリストは、フィルタリングポップアップメニューからもアクセスできます。

フィルタリングをクリアするには、デザインスペースでShift+Cを押すか、デザインスペースで右クリックしてコンテキストメニューのClear Filterコマンドを選択します。

クエリ構築ツール

クエリを書く最も簡単な方法の1つは、Altium Designerに書かせることです!これは、Find Similar ObjectsダイアログまたはQuery Builderダイアログを使用して行うことができます。

類似オブジェクトの検索ダイアログ

Find Similar Objectsダイアログを使用すると、必要なオブジェクトを見つけるクエリが生成されます。Create Expressionオプションが有効になっている場合、そのクエリはFilterパネルに表示されます。これは、異なるクエリキーワードを学ぶのに優れた技術です。

Find Similar Objectsダイアログは、設計ドキュメント内の任意の非マスクオブジェクトを右クリックしてから、コンテキストメニューからFind Similar Objectsを選択すると開きます。

左の画像:PCBバージョン;右の画像:SCHバージョン左の画像:PCBバージョン;右の画像:SCHバージョン

このダイアログでは、右クリックしたオブジェクトに類似したオブジェクトを見つけ、そのオブジェクトの属性のうちどれが同じ(または異なる)である必要があるかを定義できます。たとえば、設計内のすべてのGNDパッドを変更したい場合、そのようなパッドの1つを右クリックしてFind Similar Objectsを選択し、NetフィールドをAny(デフォルト設定)からSameに変更します。ダイアログでApplyをクリックすると、すべてのGNDパッドが選択されます。Create Expressionオプションが有効になっている場合、次のクエリがFilterパネルに表示されます:(ObjectKind = 'Pad') And (Net = 'GND')。

回路図からの例として、ドキュメント内で特定のテキストプロパティ(例:'GND')を持つすべての電源オブジェクトのColorプロパティを同じ値に変更できます。たとえば、PCBからは、ドキュメント内で特定のVia Diameterプロパティを持つすべてのビアのHole Sizeプロパティを同じ値に変更できます。

類似オブジェクトの検索ダイアログの使用に関する詳細は、類似オブジェクトの検索ツールの使用を参照してください。

既存のオプションのクリア

検索を適用する前に、既存の選択または編集マスクをクリアするには、Clear Existingオプションを有効にします。連続した検索を行い、結果が蓄積されることが望ましい場合は、このオプションを無効にします。

フィルタツールバー

Filter ToolbarはPCBドキュメント用に提供され、指定されたプロパティを持つオブジェクトや指定されたコンポーネントの一部を形成するオブジェクトを除いて、ドキュメント内のすべてのオブジェクトをマスクすることができます。ツールバーの最右フィールドはクエリの内容を指定するために使用されます。フィールドにクエリを入力するか、ドロップダウンを使用して最近のクエリ(クエリHistoryリストに存在するもの)から選択できます。Filter Toolbarからクエリが適用される際にどのオプションを使用するかを指定することはできず、すべての場合において、以前のクエリはクリアされ、マスクおよびズームオプションは現在のクエリと共に使用されます。クエリオプションを使用するには、Filterパネル、Query Builderダイアログ、Query Helperダイアログ、またはFind Similar Objectsダイアログを使用してください。

  • ボードが配線されていない場合、フィルターが適用されると選択したネットに関連する論理接続が表示されます。ボードが配線されている場合、フィルターが適用されると選択したネットに関連する配線トラックが表示されます。

  • マスキングが適用されると、フィルター範囲に含まれないすべてのオブジェクトは選択/編集できなくなります。適用されたマスキングの範囲は、View ConfigurationパネルView OptionsタブにあるMask and Dim SettingsセクションでアクセスできるMasked Objectsスライダーを使用して手動で調整できます。

  • 既存の(適用された)フィルターは、Shift+Cのキーボードショートカットを使用するか、Filterツールバーのボタンをクリックすることで、いつでも手動でクリアできます。

論理クエリ式演算子

以下は、クエリ言語を使用して論理クエリ式を定義する際に使用できる演算子の概要です。

算術演算子

演算子 説明
+ 加算演算子 NetPinCount + NetViaCount
- 減算演算子 ArcStopAngle - ArcStartAngle
* 乗算演算子 PadXSize_BottomLayer * PadYSize_BottomLayer
/ 除算演算子 HoleDiameter / ViaDiameter
Div 整数除算演算子 Color Div 65536
これは、Colorを65536で割り、結果の小数部分を切り捨てる計算です。
Mod 剰余演算子 Color Mod 256
これは、結果の小数部分を決定せずに、Colorを256で割ったときの余りを計算します。

論理演算子

演算子 説明
And 論理AND演算子 IsPad And OnMultiLayer
パッドであり、マルチレイヤー層に存在するオブジェクトが返されます。
&& 論理AND演算子(低い優先度) IsPad && OnMultiLayer
パッドであり、マルチレイヤー層に存在するオブジェクトが返されます。
Or 論理OR演算子 IsPad Or IsVia
パッドまたはビアのオブジェクトが返されます。
|| 論理OR演算子(低い優先度) IsPad || IsVia
パッドまたはビアのオブジェクトが返されます。
Xor 論理的EX-OR演算子 OnMultiLayer Xor (HoleDiameter <> 0)
オブジェクトがマルチレイヤー層にあり、Hole Diameterがゼロであるか、マルチレイヤー層にないがHole Diameterがゼロでないオブジェクトが返されます。
Not 論理NOT演算子 Not OnMultiLayer
マルチレイヤー層に存在しないオブジェクトが返されます。

PCBエディタのクエリ式で特定のタイプのプリミティブを除外するためにNot演算子を使用する際、これらのプリミティブがグループオブジェクトの一部であり、これらのグループオブジェクトも式によって除外されていない場合、除外されないことに注意してください。例えば、Not IsPadクエリ式はフリーパッドオブジェクトを除くすべてのオブジェクトを返しますが、パッドを含むコンポーネントオブジェクトも返すため、コンポーネント内のパッドはこの式によって返されます。また、パッドはPCBエディタでグループオブジェクトと見なされるネットにも含まれる可能性があります。すべてのパッドオブジェクトを除外するには、Not IsPad And Not IsComponent And Not IsNetクエリ式を使用する必要があります。

比較演算子

演算子 説明
< 小なり演算子 HoleDiameter < 40
物体のHole Diameterが40未満のオブジェクトを返します。
<= 小なりイコール演算子 HoleDiameter <= 40
物体のHole Diameterが40以下のオブジェクトを返します。
>= 大なりイコール演算子 HoleDiameter >= 40
物体のHole Diameterが40以上のオブジェクトを返します。
> 大なり演算子 HoleDiameter > 40
物体のHole Diameterが40より大きいオブジェクトを返しますい
<> 不等演算子 HoleDiameter <> 40
物体のHole Diameterが40以外のオブジェクトを返します。
= イコール演算子 HoleDiameter = 40
物体のHole Diameterが40のオブジェクトを返します。
Between...And... 包括的範囲演算子 HoleDiameter Between 30 And 50
物体のHole Diameterが30以上50以下のオブジェクトを返します。
Like LIKE演算子 Name Like 'ADDR?*'
これは、関連する(テキスト)文字列がADDRで始まり、少なくとももう1文字を含むNameプロパティを持つオブジェクトを返します。

ワイルドカード文字

ワイルドカード文字を使用すると、正確に指定されていない文字列を提供できます。これらの文字は通常、他の文字と組み合わせて使用され、部分的に指定された文字列を提供します。一部の特別なキーワードは、正確に指定されていない文字列パラメータを受け入れることができますが、ほとんどの場合、文字列にはLike演算子によって比較される場合に限り、ワイルドカード文字を含めることができます。

オペレータ 説明
? 任意のタイプの単一文字に置き換えることができます Footprint Like 'DIP1?'
これは、FootprintプロパティがDIP10、またはDIP12、またはDIP14などのオブジェクトを返します。
* 任意の数の文字に置き換えることができ、それぞれ任意のタイプの文字である Footprint Like 'SIP*'
これは、FootprintプロパティがSIP1、またはSIP12、またはSIP216などのオブジェクトを返します('*'は文字がない場合にも置き換えられるため、FootprintプロパティがSIPのオブジェクトも返されます)

ブール文字列

オペレータ 説明
True キーワードの意味を肯定します IsPad = True
返されるオブジェクトはパッドでなければなりません
False キーワードの意味を否定します IsVia = False
返されるオブジェクトはビアであってはなりません

丸括弧と優先順位

論理クエリ式で使用される演算子の優先順位を見ておくことは価値があります。そうでなければ、式が必要なオブジェクトを対象としない可能性があります。

丸括弧は、ソフトウェアによってクエリが解釈される際に定義されたさまざまな演算子の優先順位の中で最も高い優先順位を持ちます(ユーザーが丸括弧を提供していない場合)。この優先順位の順序は、最も高いものから最も低いものまで、以下の通りです:

  1. 丸括弧 ()
  2. Not
  3. ^, *, /, Div, Mod, And
  4. +, -, Or, Xor
  5. =, <>, <, >, <=, >=
  6. &&, ||
この優先順位の順序は、Pascal型言語で使用されるものと似ています。曖昧さは左から右へと作業することで解決されます。丸括弧は内側から外側へと評価され、同じレベルは左から右へと評価されます。

クエリが正しく解釈されない可能性がある場合は、丸括弧を使用することを強くお勧めします。丸括弧を多用することで疑念が取り除かれ、他の人が結果として得られるクエリを読みやすくします。

グローバルシステムクエリ機能

Global system query functions shown in the Query Helper dialog
Query Helperダイアログに表示されるグローバルシステムクエリ関数

このセクションでは、Altium Designerのスキーマティック、PCB、およびライブラリ文書で利用可能なクエリ言語キーワードの詳細を説明します。特定のクエリキーワードに関するヘルプが必要な場合は、以下の折りたたみセクションを使用するか、任意のキーワードをハイライト(またはクリック)し、Query HelperFilterパネル、またはPCB設計ルールのQueryフィールドでF1を押して、そのセクションにすぐにアクセスしてください。

Altium Designerの特定のエディタやツールで利用可能なクエリ言語キーワードの詳細については、以下のページを参照してください:

算術関数

三角関数

指数関数と対数関数

集約関数

システム関数

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
機能の可用性

利用できる機能は、所有する Altium ソリューション (Altium DevelopAltium Agile のエディション (Agile Teams、または Agile Enterprise)、または Altium Designer (有効な期間)) によって異なります。

説明されている機能がお使いのソフトウェアに表示されない場合、Altium の営業担当者にお問い合わせください

従来のドキュメント

Altium Designer のドキュメントは、バージョンごとに掲載されなくなりました。Altium Designer の旧バージョンのドキュメントは、Other Installers ページの Legacy Documentation の項目をご覧ください。

Content