套件 | mx.olap |
類別 | public class OLAPCube |
繼承 | OLAPCube Proxy |
實作 | IOLAPCube, IEventDispatcher |
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
The <mx:OLAPCube>
tag inherits all of the tag attributes
of its superclass, and adds the following tag attributes:
<mx:OLAPCube Properties dataProvider="" dimensions="" elements="" measures="" />
預設 MXML 屬性elements
更多範例
Creating a query axis
Executing a query and returning the results to an OLAPDataGrid control
Writing a query for a simple OLAP cube
Writing a query for a complex OLAP cube
Creating a query using a nondefault measure
相關 API 元素
屬性 | 定義自 | ||
---|---|---|---|
dataProvider : ICollectionView
The flat data used to populate the OLAP cube. | OLAPCube | ||
dimensions : IList
All dimensions in the cube, as a list of IOLAPDimension instances. | OLAPCube | ||
elements : Array [唯寫]
Processes the input Array and initializes the dimensions
and measures properties based on the elements of the Array. | OLAPCube | ||
measures : IList [唯寫]
Sets the measures of the OLAP cube, as a list of OLAPMeasure instances. | OLAPCube | ||
name : String
The name of the OLAP cube. | OLAPCube |
屬性 | 定義自 | ||
---|---|---|---|
cubeBuildingTimeInterval : int = 5
The time interval, in milliseconds, used by the timer of the refresh() method
to iteratively build the cube. | OLAPCube | ||
measureDimensionName : String = "Measures"
Sets the name of the dimension for the measures of the OLAP cube. | OLAPCube | ||
queryBuildingTimeInterval : int = 1
The time interval, in milliseconds, used by the timer of the execute() method
to iteratively process queries. | OLAPCube | ||
resultClass : Class
The class used by an OLAPCube instance to return the result. | OLAPCube | ||
workDuration : int = 50
The time, in milliseconds, used by the refresh() method
to iteratively build the cube. | OLAPCube |
方法 | 定義自 | ||
---|---|---|---|
Constructor. | OLAPCube | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | OLAPCube | ||
Aborts a query that has been submitted for execution. | OLAPCube | ||
Aborts the current cube refresh, if one is executing. | OLAPCube | ||
Dispatches an event into the event flow. | OLAPCube | ||
Queues an OLAP query for execution. | OLAPCube | ||
Returns the dimension with the given name within the OLAP cube. | OLAPCube | ||
Checks whether the object has any listeners registered for a specific type of event. | OLAPCube | ||
Refreshes the cube from the data provider. | OLAPCube | ||
Removes a listener. | OLAPCube | ||
Returns the name of the cube
| OLAPCube | ||
Checks whether an event listener is registered with this object or any of its ancestors for the specified event type. | OLAPCube |
事件 | 摘要 | 定義自 | ||
---|---|---|---|---|
Dispatched when a cube has been created and is ready to be queried. | OLAPCube | |||
Dispatched continuously as a cube is being created by a call to the refresh() method. | OLAPCube | |||
Dispatched continuously as a query result is being generated by a call to the execute() method. | OLAPCube |
cubeBuildingTimeInterval | 屬性 |
protected var cubeBuildingTimeInterval:int = 5
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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 | 屬性 |
dataProvider:ICollectionView
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
實作
public function get dataProvider():ICollectionView
public function set dataProvider(value:ICollectionView):void
dimensions | 屬性 |
elements | 屬性 |
elements:Array
[唯寫] 語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
實作
public function set elements(value:Array):void
measureDimensionName | 屬性 |
protected var measureDimensionName:String = "Measures"
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Sets the name of the dimension for the measures of the OLAP cube.
預設值為 "Measures"。
measures | 屬性 |
name | 屬性 |
queryBuildingTimeInterval | 屬性 |
protected var queryBuildingTimeInterval:int = 1
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
resultClass | 屬性 |
protected var resultClass:Class
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
預設值為 OLAPResult。
workDuration | 屬性 |
protected var workDuration:int = 50
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
OLAPCube | () | 建構函式 |
addEventListener | () | 方法 |
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
參數
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.
|
相關 API 元素
cancelQuery | () | 方法 |
public function cancelQuery(query:IOLAPQuery):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Aborts a query that has been submitted for execution.
參數
query:IOLAPQuery — The query to abort.
|
cancelRefresh | () | 方法 |
public function cancelRefresh():void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Aborts the current cube refresh, if one is executing.
dispatchEvent | () | 方法 |
public function dispatchEvent(event:Event):Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
參數
event:Event — The Event object that is dispatched into the event flow.
|
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.
|
相關 API 元素
execute | () | 方法 |
public function execute(query:IOLAPQuery):mx.rpc:AsyncToken
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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%" />
參數
query:IOLAPQuery — The query to execute, represented by an IOLAPQuery instance.
|
mx.rpc:AsyncToken — An AsyncToken instance.
|
findDimension | () | 方法 |
public function findDimension(name:String):IOLAPDimension
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Returns the dimension with the given name within the OLAP cube.
參數
name:String — The name of the dimension.
|
IOLAPDimension — An IOLAPDimension instance representing the dimension,
or null if a dimension is not found.
|
hasEventListener | () | 方法 |
public function hasEventListener(type:String):Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
參數
type:String — The type of event.
|
Boolean — A value of true if a listener of the specified type
is registered; false otherwise.
|
相關 API 元素
refresh | () | 方法 |
public function refresh():void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
removeEventListener | () | 方法 |
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Removes a listener. If there no matching listener is registered, a call to this method has no effect.
參數
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.
|
相關 API 元素
toString | () | 方法 |
willTrigger | () | 方法 |
public function willTrigger(type:String):Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | 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.
參數
type:String — The type of event.
|
Boolean — A value of true if a listener of the
specified type is triggered; false otherwise.
|
相關 API 元素
complete | 事件 |
mx.events.CubeEvent
屬性 CubeEvent.type =
mx.events.CubeEvent.CUBE_COMPLETE
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Dispatched when a cube has been created and is ready to be queried.
TheCubeEvent.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 |
progress | 事件 |
mx.events.CubeEvent
屬性 CubeEvent.type =
mx.events.CubeEvent.CUBE_PROGRESS
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Dispatched continuously as a cube is being created
by a call to the refresh()
method.
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 |
queryProgress | 事件 |
mx.events.CubeEvent
屬性 CubeEvent.type =
mx.events.CubeEvent.QUERY_PROGRESS
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Dispatched continuously as a query result is being generated
by a call to the execute()
method.
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 |
Tue Jun 12 2018, 03:47 PM Z