Query and find - SmartPlant Foundation - IM Update 46 - Help - Hexagon

SmartPlant Foundation Help

Language
English
Product
SmartPlant Foundation
Search by Category
Help
SmartPlant Foundation / SDx Version
10
SmartPlant Markup Plus Version
10.0 (2019)
Smart Review Version
2020 (15.0)

The Find menu lists all the quick find methods that a user has access to through specified role assignments. Quick find methods allow the user to search for items based on their name. Additional criteria or properties comparison are often specified on these methods to further filter or control the items returned. The configuration of these methods, their filters, and the list views that display their results are critical to query performance.

This configuration is important when searching for simple objects, like tags, but it is even more important when searching for complex objects, like documents. Documents are composed of separate objects for the master, revision, and version. Choosing which of these to query and how to display the results is dependent on the individual system configuration. The following sections provide guidance on how the standard configuration may be changed. When querying for documents, the method can be configured to search for either the master, revision, or the version by specifying the query interface on the method. This is important as it is more efficient to search for the version and expand up the relationship to the parent revision and master than to search for the master and find the latest revision. For more information, see Property comparisons for more details.

  • Be as specific as possible with the interface definition to search for, as this determines domains for the search scope.

  • If searching for one class definition, specify this in the criteria using IObject~ObjDefUID~=~SPFFolder.

    • This is because the instance of the class definition is stored in the object table, whereas the instances of the interfaces are stored as a relationship.

    • For documents, use the class definition that realizes the interface definition you are searching for.