SUPAttributeTest

In addition to allowing for arbitrary search criteria, the arbitrary find method lets the user specify a desired ordering of the results and object state criteria. A SUPQuery class is included in one of the client runtime libraries, libclientrt.a. The SUPQuery class is the single object passed to the arbitrary search methods and consists of search conditions, object/row state filter conditions, and data ordering information.

The following classes define arbitrary search methods and filter conditions, and provide methods for combining test criteria and dynamically querying result sets.

SUPQuery and Related Classes
Class Description
SUPQuery Defines arbitrary search methods and can be composed of search conditions, object/row state filter conditions, and data ordering information.
SUPAttributeTest Defines filter conditions for MBO attributes.
SUPCompositeTest Contains a method to combine test criteria using the logical operators AND, OR, and NOT to create a compound filter.
SUPQueryResultSet Provides for querying a result set for the dynamic query API.

In addition queries support select, where, and join statements.

Define these conditions by setting properties in a query:
  • SUPTestCriteria – criteria used to filter returned data.
  • SUPSortCriteria – criteria used to order returned data.
  • Skip – an integer specifying how many rows to skip. Used for paging.
  • Take – an integer specifying the maximum number of rows to return. Used for paging.

SUPTestCriteria can be an SUPAttributeTest or a SUPCompositeTest.

An SUPAttributeTest defines a filter condition using an MBO attribute, and supports these conditions:

Parent topic: Arbitrary Find