PCB_Cmd-RunQueryBuilderRunQueryBuilder_AD

Applied Parameters: RunRuleWizard=True

Summary

This command is used to run the Design Rule Wizard, from where you will be guided, step-by-step, through the process of creating a new design rule.

Access

This command is accessed from the PCB Editor by choosing the Design » Rule Wizard command from the main menus.

Use

After launching the command, the Design Rule Wizard will appear. Use the pages of the Wizard to create a new design rule. Steps involve:

1. Choosing the required rule type, and giving it a meaningful name (and comment if required).
2. Defining the scope of the rule. You will have the opportunity to further enhance scoping through an incarnation of the Query Builder - built in to the Wizard.
3. Setting the rule priority.

If the Launch main design rules dialog option is enabled on the last page of the Wizard, the PCB Rules and Constraints Editor dialog will appear upon clicking the Finish button. This dialog can be used to edit the constraints for your newly-created rule.

Tips

1. The Query Builder is often used wherever there is a need to construct logical query expressions. It is a simpler method of constructing a query, using sensitive condition types and values that only allow a query to be constructed using relevant 'building blocks'. For advanced query construction, with full keyword specification and operator syntax, use the Query Helper, which is available as part of the scoping controls for a rule, in the PCB Rules and Constraints Editor dialog.

Applied Parameters: None

Summary

This command is used to access the Building Query from Board dialog, more commonly referred to as the Query Builder dialog. This dialog enables creation of a query for targeting specific objects in the design document, by simple construction of a string of ANDed and/or ORed conditions.

Access

This command can be accessed from the PCB Editor, and PCB Library Editor, by:

• Choosing the Edit » Build Query command, from the main menus.
• Right-clicking in free space within the main design workspace, and choosing the Build Query command from the context menu.
• Using the Shift+B keyboard shortcut.

Use

After launching the command, the Building Query from Board dialog will appear. Use this dialog to create a simple query to target the set of objects required on the document.

The left-hand section of the dialog is used to specify the condition(s) required to target the set of objects needed. As a condition is defined, a preview of the currently built query is shown in the right-hand section of the dialog. Conditions can be ANDed and/or ORed together, and precedence incorporated (through the use of brackets) to refine the set of targeted objects.

The dialog also contains additional controls, allowing you to define how the resulting set of filtered objects will be visually displayed in the main design window (zoom, select, apply masking). Click the Apply button to apply the filter using the constructed query - enabling you to test if the query meets your needs.

Options are also available to run the editor's Inspector panel upon applying the query, and to also create an expression, which copies the query you have built to the Filter region of the editor's Filter panel, from where you can modify it as desired, using advanced query-building facilities.

Tips

1. When accessed in the PCB Library Editor, you can also opt to have the query expression applied to the entire library, or just the active component.
2. The currently selected condition, or logical operator, on the left of the dialog, is visually confirmed in the preview section on the right, by the entry appearing in red text.
3. The Query Builder is often used wherever there is a need to construct logical query expressions - for example in a filter panel, or when defining scoping of design rules. It is a simpler method of constructing a query, using sensitive condition types and values that only allow a query to be constructed using relevant 'building blocks'. For advanced query construction, with full keyword specification and operator syntax, use the Query Helper.
4. A quicker method of building a filter, based on a template object, is to use the Find Similar Objects feature.

Applied Parameters: LaunchMode=UnderCursor

Summary

This command is used to access the Building Query from Board dialog, more commonly referred to as the Query Builder dialog. This dialog enables creation of a query, based on the object currently under the cursor, for targeting specific objects in the design document, by simple construction of a string of ANDed and/or ORed conditions.

Access

This command can be accessed from the PCB Editor, and PCB Library Editor, by right-clicking over the required object in the main design workspace, and choosing the Build Query command from the context menu.

Use

After launching the command, the Building Query from Board dialog will appear. Use this dialog to create a simple query to target the set of objects required on the document. The conditions and related values will be sensitive to the type of object under the cursor and you will only be able to build a query using conditions possible for that object type.

The left-hand section of the dialog is used to specify the condition(s) required to target the set of objects needed. As a condition is defined, a preview of the currently built query is shown in the right-hand section of the dialog. Conditions can be ANDed and/or ORed together, and precedence incorporated (through the use of brackets) to refine the set of targeted objects.

The dialog also contains additional controls, allowing you to define how the resulting set of filtered objects will be visually displayed in the main design window (zoom, select, apply masking). Click the Apply button to apply the filter using the constructed query - enabling you to test if the query meets your needs.

Options are also available to run the editor's Inspector panel upon applying the query, and to also create an expression, which copies the query you have built to the Filter region of the editor's Filter panel, from where you can modify it as desired, using advanced query-building facilities.

Tips

1. The actual name of the dialog will depend on the specific object under the cursor when you launch the command.
2. When accessed in the PCB Library Editor, you can also opt to have the query expression applied to the entire library, or just the active component.
3. The currently selected condition, or logical operator, on the left of the dialog, is visually confirmed in the preview section on the right, by the entry appearing in red text.
4. The Query Builder is often used wherever there is a need to construct logical query expressions - for example in a filter panel, or when defining scoping of design rules. It is a simpler method of constructing a query, using sensitive condition types and values that only allow a query to be constructed using relevant 'building blocks'. For advanced query construction, with full keyword specification and operator syntax, use the Query Helper.
5. A quicker method of building a filter, based on the template object under the cursor, is to use the Find Similar Objects feature.