protected var cubeBuildingTimeInterval:int = 5
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The time interval, in milliseconds, used by the timer of the refresh()
method
to iteratively build the cube.
You can set it to a higher value if you can wait longer before the cube is built.
You can set it to a lower value, but it might negatively impact responsiveness of your application.
dataProvider:ICollectionView
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The flat data used to populate the OLAP cube.
You must call the refresh()
method
to initialize the cube after setting this property.
Implementation public function get dataProvider():ICollectionView
public function set dataProvider(value:ICollectionView):void
dimensions:IList
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
All dimensions in the cube, as a list of IOLAPDimension instances.
Implementation public function get dimensions():IList
public function set dimensions(value:IList):void
elements:Array
[write-only]
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Processes the input Array and initializes the dimensions
and measures
properties based on the elements of the Array.
Dimensions are represented in the Array by instances of the OLAPDimension class,
and measures are represented by instances of the OLAPMeasure class.
Use this property to define the dimensions and measures of a cube in a single Array.
Implementation public function set elements(value:Array):void
protected var measureDimensionName:String = "Measures"
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Sets the name of the dimension for the measures of the OLAP cube.
The default value is "Measures".
measures:IList
[write-only]
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Sets the measures of the OLAP cube, as a list of OLAPMeasure instances.
Implementation public function set measures(value:IList):void
name:String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The name of the OLAP cube.
Implementation public function get name():String
public function set name(value:String):void
protected var queryBuildingTimeInterval:int = 1
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The time interval, in milliseconds, used by the timer of the execute()
method
to iteratively process queries.
You can set it to a higher value if you can wait for longer
before the cube generates the query result.
You can set it to a lower value to obtain query results faster,
but it might negatively impact the responsiveness of your application.
protected var resultClass:Class
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The class used by an OLAPCube instance to return the result.
You can replace the default class, OLAPResult, with your own implementation
of the IOLAPResult interface to customize the result.
The default value is OLAPResult.
protected var workDuration:int = 50
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The time, in milliseconds, used by the refresh()
method
to iteratively build the cube.
A higher value would mean more rows would get processed at each timer event.
You can set it to a higher value if you want the cube to be built faster,
but it might negatively impact responsiveness of your application.
public function OLAPCube(name:String = null)
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Constructor.
Parameters | name:String (default = null ) — The name of the OLAP cube.
|
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event.
Parameters
| type:String — The type of event.
|
|
| listener:Function — The listener function that processes the event.
|
|
| useCapture:Boolean (default = false ) — Determines whether the listener works in the capture phase
or the target and bubbling phases.
|
|
| priority:int (default = 0 ) — The priority level of the event listener.
|
|
| useWeakReference:Boolean (default = false ) — Determines whether the reference to the listener is strong or weak.
A strong reference (the default) prevents your listener from being garbage-collected.
A weak reference does not.
|
See also
public function cancelQuery(query:IOLAPQuery):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Aborts a query that has been submitted for execution.
Parameters
public function cancelRefresh():void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Aborts the current cube refresh, if one is executing.
public function dispatchEvent(event:Event):Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Dispatches an event into the event flow.
The event target is the object upon which the dispatchEvent()
method is called.
Parameters
| event:Event — The Event object that is dispatched into the event flow.
|
Returns | Boolean — A value of true if the event was successfully dispatched.
A value of false indicates failure or that the
preventDefault() method was called on the event.
|
See also
public function execute(query:IOLAPQuery):mx.rpc:AsyncToken
Language Version: | ActionScript 3.0 |
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.
|
Returns public function findDimension(name:String):IOLAPDimension
Language Version: | ActionScript 3.0 |
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.
|
Returns | IOLAPDimension — An IOLAPDimension instance representing the dimension,
or null if a dimension is not found.
|
public function hasEventListener(type:String):Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Checks whether the object has any listeners registered for a specific type of event.
This lets you determine where an object has altered handling of
an event type in the event flow hierarchy.
Parameters
| type:String — The type of event.
|
Returns | Boolean — A value of true if a listener of the specified type
is registered; false otherwise.
|
See also
public function refresh():void
Language Version: | ActionScript 3.0 |
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.
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Removes a listener.
If there no matching listener is registered,
a call to this method has no effect.
Parameters
| type:String — The type of event.
|
|
| listener:Function — The listener object to remove.
|
|
| useCapture:Boolean (default = false ) — Specifies whether the listener was registered for
the capture phase or the target and bubbling phases.
|
See also
public function toString():String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns the name of the cube
Returns | String — The name of the cube.
|
public function willTrigger(type:String):Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Checks whether an event listener is registered with this object or any of its ancestors for the specified event type.
This method returns true
if an event listener is triggered during any phase of the event flow
when an event of the specified type is dispatched to this object or to any of its descendants.
Parameters
| type:String — The type of event.
|
Returns | Boolean — A value of true if a listener of the
specified type is triggered; false otherwise.
|
See also
Event Object Type: mx.events.CubeEvent
property CubeEvent.type = mx.events.CubeEvent.CUBE_COMPLETE
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Dispatched when a cube has been created
and is ready to be queried.
The
CubeEvent.CUBE_COMPLETE
constant defines the value of the
type
property of the event object for a
complete
event.
The properties of the event object have the following values:
Property | Value |
---|
bubbles | false |
cancelable | true |
currentTarget | The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget . |
description | Description of what is being processed. |
progress | The number of elements in the cube
that have been updated. |
target | The Object that dispatched the event;
it is not always the Object listening for the event.
Use the currentTarget property to always access the
Object listening for the event. |
total | The total number of elements in the cube
that need to be udpated. |
type | CubeEvent.CUBE_COMPLETE |
Event Object Type: mx.events.CubeEvent
property CubeEvent.type = mx.events.CubeEvent.CUBE_PROGRESS
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Dispatched continuously as a cube is being created
by a call to the refresh()
method.
The
CubeEvent.CUBE_PROGRESS
constant defines the value of the
type
property of the event object for a
progress
event.
The properties of the event object have the following values:
Property | Value |
---|
bubbles | false |
cancelable | true |
currentTarget | The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget . |
description | Description of what is being processed. |
progress | The number of elements in the cube
that have been updated. |
target | The Object that dispatched the event;
it is not always the Object listening for the event.
Use the currentTarget property to always access the
Object listening for the event. |
total | The total number of elements in the cube
that need to be udpated. |
type | CubeEvent.CUBE_PROGRESS |
Event Object Type: mx.events.CubeEvent
property CubeEvent.type = mx.events.CubeEvent.QUERY_PROGRESS
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Dispatched continuously as a query result is being generated
by a call to the execute()
method.
The
CubeEvent.QUERY_PROGRESS
constant defines the value of the
type
property of the event object for a
queryProgress
event.
The properties of the event object have the following values:
Property | Value |
---|
bubbles | false |
cancelable | true |
currentTarget | The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget . |
description | Description of what is being processed. |
progress | The number of elements in the cube
that have been updated. |
target | The Object that dispatched the event;
it is not always the Object listening for the event.
Use the currentTarget property to always access the
Object listening for the event. |
total | The total number of elements in the cube
that need to be udpated. |
type | CubeEvent.QUERY_PROGRESS |