Advanced queries

An advanced query retrieves a list of Plant Modeller objects that currently exist in the active project and match the query's test conditions. Advanced queries are commonly used in various parts of the system, and knowing how to build effective queries can significantly expedite locating and selecting specific objects from a project. Typically, you use an advanced query to create a list objects that share a common purpose or property, such as all pipe parts modified after a specific date, or to select objects to be handled as a set.

Advanced queries are dynamic. Running an old query will also consider any matching objects added to the project after the query was last saved. (In contrast, a saved group has a static set of objects, and you have to manually add new objects to it.) You can adjust the query settings and conditions to retrieve a different set of objects.

Advanced queries can be temporary, local to the current user, or available to all users, as described in Query types. Advanced queries are always created and edited in a specific context, but they can often be reused in different contexts, especially when made available to other project users.

Depending on the context, when you select to define an advanced query, one of the following dialogs opens:

• The Edit Query dialog. Here, you define the general query settings, such as which object types to consider. See Query editor.
• The Edit Selection Test dialog. Here, you define selection tests that the queried objects must pass to be included in the query results. See Query test editor.

Use Case Examples

You can use an advanced query, for example, to create a material listing for a set of objects, as described in Advanced query example: material list. Here are some other contexts where you can use advanced queries:

• To find specific objects in the model, as described in Find.
• To select objects to be checked in or out, as described in Checkouts.
• To select two sets of objects for collision checking, as described in Types of test.
• To select a set of objects to be published in an eBrowser model, as described in Publishing an eBrowser model.