Package | mx.olap |
Interface | public interface IOLAPCube |
Implementors | OLAPCube |
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
An OLAP cube is analogous to a table in a relational database. Where a table in a relational database has two dimensions, an OLAP cube can have any number of dimensions. In its simplest form, the dimensions of an OLAP cube correspond to a field of the flat data set.
After setting the schema of the OLAP cube, you must call
the IOLAPCube.refresh()
method to build the cube.
Upon completion of cube initialization, the OLAP cube dispatches
the complete
event to signal that the cube is ready to query.
Related API Elements
Property | Defined By | ||
---|---|---|---|
dimensions : IList [read-only]
All dimensions in the cube, as a list of IOLAPDimension instances. | IOLAPCube | ||
name : String [read-only]
The name of the OLAP cube. | IOLAPCube |
Method | Defined By | ||
---|---|---|---|
Aborts a query that has been submitted for execution. | IOLAPCube | ||
Aborts the current cube refresh, if one is executing. | IOLAPCube | ||
Queues an OLAP query for execution. | IOLAPCube | ||
Returns the dimension with the given name within the OLAP cube. | IOLAPCube | ||
Refreshes the cube from the data provider. | IOLAPCube |
dimensions | property |
name | property |
cancelQuery | () | method |
public function cancelQuery(query:IOLAPQuery):void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Aborts a query that has been submitted for execution.
Parameters
query:IOLAPQuery — The query to abort.
|
cancelRefresh | () | method |
public function cancelRefresh():void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Aborts the current cube refresh, if one is executing.
execute | () | method |
public function execute(query:IOLAPQuery):mx.rpc:AsyncToken
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Queues an OLAP query for execution.
After you call the refresh()
method to update the cube,
you must wait for a complete
event
before you call the execute()
method.
OLAP cubes can be complex, so you do not want your application
to pause while Flex calculates the results of your OLAP query.
The execute()
method returns an instance of the AsyncToken class,
which lets you set up handlers for asynchronous operations so that
your application can continue to execute during query processing.
When using the AsyncToken class, you set up two functions to handle the query results. In this example, the showResult() function handles the query results when the query succeeds, and the showFault() function handles any errors detected during query execution:
<mx:Script> // Function to execute a query. private function runQuery(cube:IOLAPCube):void { // Create a query instance. var query:IOLAPQuery = getQuery(cube); // Execute the query. var token:AsyncToken = cube.execute(query); // Set up handlers for the query results. token.addResponder(new AsyncResponder(showResult, showFault)); } // Handle a query fault. private function showFault(result:FaultEvent, token:Object):void { Alert.show("Error in query."); } // Handle a query success. private function showResult(result:Object, token:Object):void { if (!result) { Alert.show("No results from query."); return; } myOLAPDG.dataProvider= result as OLAPResult; } </mx:Script> <mx:OLAPDataGrid id="myOLAPDG" width="100%" height="100%" />
Parameters
query:IOLAPQuery — The query to execute, represented by an IOLAPQuery instance.
|
mx.rpc:AsyncToken — An AsyncToken instance.
|
Related API Elements
findDimension | () | method |
public function findDimension(name:String):IOLAPDimension
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the dimension with the given name within the OLAP cube.
Parameters
name:String — The name of the dimension.
|
IOLAPDimension — An IOLAPDimension instance representing the dimension,
or null if a dimension is not found.
|
refresh | () | method |
public function refresh():void
Language Version: | ActionScript 3.0 |
Product Version: | Flex 3 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Refreshes the cube from the data provider. After setting the cube's schema, you must call this method to build the cube.
This method dispatches a progress
event to indicate progress,
and dispatches a complete
event when the cube is complete
and ready to execute queries.
You must wait for a complete
event
before you call the execute()
method to run a query.
Related API Elements
Mon Nov 28 2011, 06:48 AM -08:00