A Selection
object consists of the following items:
A series of ordered steps -- Specifies the criteria for selecting a set of members for a particular dimension.
A sort specification -- Defines how selected members will be sorted.
A drill step -- Stores the drill state for a selection.
A Selection
object can have zero or one drill step. Each DrillStep
object specifies information about how to navigate up and down through the levels in a hierarchy. For example, drilling on the value USA expands the hierarchy to include the cities that are associated with USA.
Selection
objects are shared by the Query
object and the QueryBuilder bean. Selection
objects are created and modified:
Programmatically.
By the QueryBuilder bean.
By the Favorite Tool, which modifies the query by creating a new Selection
for the selected dimension and applying the selected favorite.
By the Sort Tool, which modifies the query by adding a ConditionSortStep
to the Selection
for the selected dimension.
A Selection
object has the following characteristics:
Is represented by an instance of the Selection
class in the oracle.dss.selection
package.
Can save and restore its state based on an XML stream.
Can interact with the Persistence Manager because a Selection
object implements the Persistable
interface.
Selection
classThe following figure shows the Selection
class, which aggregates the Step
, SortSpec
, and DrillSpecification
classes.