ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.olap 

OLAPCube  - AS3 Flex

Paketmx.olap
Klassepublic class OLAPCube
VererbungOLAPCube Inheritance Proxy
Implementiert IOLAPCube, IEventDispatcher

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die OLAPCube-Klasse stellt einen OLAPCube dar.

MXML-SyntaxexpandedMXML-Syntax ausblenden

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=""
  />
 
  

Standard-MXML-Eigenschaftelements

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  dataProvider : ICollectionView
Flache Daten, mit welchen der OLAP-Cube gefüllt wird.
OLAPCube
  dimensions : IList
Alle Dimensionen des Cube als Liste von IOLAPDimension-Instanzen.
OLAPCube
  elements : Array
[Nur Schreiben] Verarbeitet das Eingabe-Array und initialisiert die Dimensions- und Measure-Eigenschaften basierend auf den Elementen des Arrays.
OLAPCube
  measures : IList
[Nur Schreiben] Legt die Measures des OLAP-Cube als Liste von OLAPMeasure-Instanzen fest.
OLAPCube
  name : String
Der Name des OLAP-Cube.
OLAPCube
Geschützte Eigenschaften
 EigenschaftDefiniert von
  cubeBuildingTimeInterval : int = 5
Das Zeitintervall in Millisekunden, welches vom Timer der refresh()-Methode benutzt wird, um den Cube iterativ zu erstellen.
OLAPCube
  measureDimensionName : String = "Measures"
Legt den Namen der Dimension für das Measure des OLAP-Cube fest.
OLAPCube
  queryBuildingTimeInterval : int = 1
Das Zeitintervall in Millisekunden, welches vom Timer der execute()-Methode benutzt wird, um Abfragen iterativ zu verarbeiten.
OLAPCube
  resultClass : Class
Die Klasse, die von einer OLAP-Cube-Instanz benutzt wird, um Ergebnisse zurückzugeben.
OLAPCube
  workDuration : int = 50
Das Zeitintervall in Millisekunden, welches von der refresh()-Methode benutzt wird, um den Cube iterativ zu erstellen.
OLAPCube
Öffentliche Methoden
 MethodeDefiniert von
  
OLAPCube(name:String = null)
Konstruktor.
OLAPCube
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
OLAPCube
  
Bricht eine Abfrage ab, welche zur Ausführung übermittelt wurde.
OLAPCube
  
Bricht die aktuelle Cube-Aktualisierung ab, wenn eine ausgeführt wird.
OLAPCube
  
Sendet ein Ereignis in den Ereignisablauf.
OLAPCube
  
Reiht eine OLAP-Abfrage zur Ausführung ein.
OLAPCube
  
Gibt die Dimension mit dem entsprechenden Namen innerhalb des OLAP-Cube zurück.
OLAPCube
  
Überprüft, ob beim Objekt für einen bestimmten Ereignistyp Listener registriert wurden.
OLAPCube
  
Aktualisiert den Cube aus dem Daten-Provider.
OLAPCube
  
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener.
OLAPCube
  
Gibt den Namen des Cube zurück.
OLAPCube
  
Überprüft, ob ein Ereignislistener bei diesem Objekt oder einem Vorgänger für diesen Ereignistyp registriert ist.
OLAPCube
Ereignisse
 Ereignis Übersicht Definiert von
  Wird ausgelöst, wenn ein Cube erzeugt wurde und bereit für die Abfrage ist.OLAPCube
  Wird fortlaufend ausgelöst, während ein Cube durch einen Aufruf der refresh()-Methode erzeugt wird.OLAPCube
  Wird fortlaufend ausgelöst, während ein Abfrageergebnis durch einen Aufruf der execute()-Methode erstellt wird.OLAPCube
Eigenschaftendetails

cubeBuildingTimeInterval

Eigenschaft
protected var cubeBuildingTimeInterval:int = 5

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Zeitintervall in Millisekunden, welches vom Timer der refresh()-Methode benutzt wird, um den Cube iterativ zu erstellen. Sie können den Wert erhöhen, wenn Sie länger auf den zu erstellenden Cube warten können. Sie können den Wert verringern, aber dies könnte die Reaktionsfähigkeit Ihrer Anwendung negativ beeinflussen.

dataProvider

Eigenschaft 
dataProvider:ICollectionView

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Flache Daten, mit welchen der OLAP-Cube gefüllt wird. Sie müssen die refresh()-Methode aufrufen, um den Cube nach der Einstellung dieser Eigenschaft zu initialisieren.



Implementierung
    public function get dataProvider():ICollectionView
    public function set dataProvider(value:ICollectionView):void

dimensions

Eigenschaft 
dimensions:IList

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Alle Dimensionen des Cube als Liste von IOLAPDimension-Instanzen.



Implementierung
    public function get dimensions():IList
    public function set dimensions(value:IList):void

elements

Eigenschaft 
elements:Array  [Nur Schreiben]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Verarbeitet das Eingabe-Array und initialisiert die dimensions- und measures-Eigenschaften basierend auf den Elementen des Arrays. Dimensionen werden im Array von Instanzen der OLAPDimension-Klasse dargestellt. Measures werden durch Instanzen der OLAPMeasure-Klasse dargestellt.

Verwenden Sie diese Eigenschaft, um die Dimensionen und Measures eines Cube in einem einzelnen Array zu definieren.



Implementierung
    public function set elements(value:Array):void

measureDimensionName

Eigenschaft 
protected var measureDimensionName:String = "Measures"

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Legt den Namen der Dimension für das Measure des OLAP-Cube fest.

Der Standardwert ist "Measures".

measures

Eigenschaft 
measures:IList  [Nur Schreiben]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Legt die Measures des OLAP-Cube als Liste von OLAPMeasure-Instanzen fest.



Implementierung
    public function set measures(value:IList):void

name

Eigenschaft 
name:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Der Name des OLAP-Cube.



Implementierung
    public function get name():String
    public function set name(value:String):void

queryBuildingTimeInterval

Eigenschaft 
protected var queryBuildingTimeInterval:int = 1

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Zeitintervall in Millisekunden, welches vom Timer der execute()-Methode benutzt wird, um Abfragen iterativ zu verarbeiten. Sie können den Wert erhöhen, wenn Sie länger auf die vom Cube erstellten Abfrageergebnisse warten können. Sie können den Wert verringern, wenn Sie Abfrageergebnisse schneller erhalten möchten, aber dies kann die Reaktionsfähigkeit Ihrer Anwendung negativ beeinflussen.

resultClass

Eigenschaft 
protected var resultClass:Class

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Klasse, die von einer OLAP-Cube-Instanz benutzt wird, um Ergebnisse zurückzugeben. Sie können die Standardklasse, OLAPResults, durch Ihre eigene Implementation der OLAPResult-Schnittstelle ersetzen, um das Ergebnis anzupassen.

Der Standardwert ist OLAPResult.

workDuration

Eigenschaft 
protected var workDuration:int = 50

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Zeitintervall in Millisekunden, welches von der refresh()-Methode benutzt wird, um den Cube iterativ zu erstellen. Ein höherer Wert bedeutet, dass mehr Zeilen pro Timerereignis verarbeitet werden. Sie können den Wert erhöhen, wenn Sie möchten, dass der Cube schneller erstellt wird, aber dies kann die Reaktionsfähigkeit Ihrer Anwendung negativ beeinflussen.

Konstruktordetails

OLAPCube

()Konstruktor
public function OLAPCube(name:String = null)

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Parameter
name:String (default = null) — Der Name des OLAP-Cube.
Methodendetails

addEventListener

()Methode
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.

Parameter

type:String — Der Typ des Ereignisses.
 
listener:Function — Die Listener-Funktion, die das Ereignis verarbeitet.
 
useCapture:Boolean (default = false) — Bestimmt, ob der Listener in der Erfassungsphase oder in der Ziel- und Bubbling-Phase arbeitet.
 
priority:int (default = 0) — Die Prioritätsstufe des Ereignis-Listeners.
 
useWeakReference:Boolean (default = false) — Bestimmt, ob der Verweis auf den Listener stark oder schwach ist. Ein starker Verweis (der Standard) verhindert, dass der Listener von einem Garbage Collector entfernt wird. Ein schwacher Verweis hingegen nicht.

Verwandte API-Elemente

cancelQuery

()Methode 
public function cancelQuery(query:IOLAPQuery):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Bricht eine Abfrage ab, welche zur Ausführung übermittelt wurde.

Parameter

query:IOLAPQuery — Die abzubrechende Abfrage.

cancelRefresh

()Methode 
public function cancelRefresh():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Bricht die aktuelle Cube-Aktualisierung ab, wenn eine ausgeführt wird.

dispatchEvent

()Methode 
public function dispatchEvent(event:Event):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das Objekt, für das die dispatchEvent()-Methode aufgerufen wird.

Parameter

event:Event — Das Ereignisobjekt, das in den Ereignisablauf gesendet wird.

Rückgabewerte
Boolean — Der Wert true, wenn das Ereignis erfolgreich ausgelöst wurde. Der Wert false weist entweder auf einen Fehler hin oder auf die Tatsache, dass die preventDefault()-Methode für das Ereignis aufgerufen worden ist.

Verwandte API-Elemente

execute

()Methode 
public function execute(query:IOLAPQuery):mx.rpc:AsyncToken

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Reiht eine OLAP-Abfrage zur Ausführung ein. Nachdem Sie die refresh()-Methode aufgerufen haben, um den Cube zu aktualisieren, müssen Sie das complete-Ereignis abwarten, bevor Sie die execute()-Methode aufrufen können.

Der OLAP-Cube kann komplex sein, vermeiden Sie daher, dass Ihre Anwendung pausiert, während Flex die Ergebnisse Ihrer OLAP-Abfrage berechnet. Die execute()-Methode gibt eine Instanz der AsyncToken-Klasse zurück, welche es Ihnen erlaubt, Prozeduren für asynchrone Vorgänge zu erstellen, sodass Ihre Anwendung auch während der Verarbeitung einer Abfrage weiterhin ausgeführt werden kann.

Bei der Benutzung der AsyncToken-Klasse erstellen Sie zwei Funktionen zur Verarbeitung der Abfrageergebnisse. In diesem Beispiel verarbeitet die showResult()-Funktion die Abfrageergebnisse, wenn die Abfrage erfolgreich war. Die showFault()-Funktion verarbeitet Fehler, welche während der Ausführung der Abfrage ermittelt wurden:

      <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%" />
      

Parameter

query:IOLAPQuery — Die auszuführende Abfrage, dargestellt von einer IOLAPQuery-Instanz.

Rückgabewerte
mx.rpc:AsyncToken — Eine AsyncToken-Instanz.

findDimension

()Methode 
public function findDimension(name:String):IOLAPDimension

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt die Dimension mit dem entsprechenden Namen innerhalb des OLAP-Cube zurück.

Parameter

name:String — Der Name der Dimension.

Rückgabewerte
IOLAPDimension — Eine IOLAPDimension-Instanz, welche die Dimension darstellt oder „null“, wenn die Dimension nicht gefunden wurde.

hasEventListener

()Methode 
public function hasEventListener(type:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Überprüft, ob beim Objekt für einen bestimmten Ereignistyp Listener registriert wurden. Damit können Sie bestimmen, wo ein Objekt die Verarbeitung eines Ereignistyps in der Ereignisablaufhierarchie geändert hat.

Parameter

type:String — Der Typ des Ereignisses.

Rückgabewerte
Boolean — Der Wert true, wenn ein Listener des angegebenen Typs registriert ist; andernfalls false.

Verwandte API-Elemente

refresh

()Methode 
public function refresh():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Aktualisiert den Cube aus dem Datenprovider. Nach der Einstellung des Cube-Schemas müssen Sie diese Methode aufrufen, um den Cube zu erstellen.

Diese Methode löst ein progress-Ereignis aus, um den Fortschritt anzuzeigen und löst ein complete-Ereignis aus, wenn der Cube fertiggestellt und bereit ist, Abfragen auszuführen. Sie müssen auf ein complete-Ereignis warten, bevor Sie die execute()-Methode aufrufen können, um eine Abfrage auszuführen.

removeEventListener

()Methode 
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Entfernt einen Listener. Wenn kein passender Listener registriert wurde, bleibt ein Aufruf dieser Methode ohne Wirkung.

Parameter

type:String — Der Typ des Ereignisses.
 
listener:Function — Das zu entfernende Listener-Objekt.
 
useCapture:Boolean (default = false) — Gibt an, ob der Listener für die Erfassungsphase oder die Ziel- und Bubbling-Phase registriert wurde.

Verwandte API-Elemente

toString

()Methode 
public function toString():String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt den Namen des Cube zurück.

Rückgabewerte
String — Der Name des Cube.

willTrigger

()Methode 
public function willTrigger(type:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Überprüft, ob ein Ereignislistener bei diesem Objekt oder einem Vorgänger für diesen Ereignistyp registriert ist. Diese Methode gibt den Wert true zurück, wenn während des Ereignisablaufs ein Ereignis-Listener ausgelöst wird, wenn ein Ereignis des festgelegten Typs an dieses Objekt oder eines seiner untergeordneten Elemente gesendet wird.

Parameter

type:String — Der Typ des Ereignisses.

Rückgabewerte
Boolean — Der Wert true, wenn ein Listener des angegebenen Typs ausgelöst wird oder false, wenn nicht.

Verwandte API-Elemente

Ereignisdetails

complete

Ereignis
Ereignisobjekttyp: mx.events.CubeEvent
Eigenschaft CubeEvent.type = mx.events.CubeEvent.CUBE_COMPLETE

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wird ausgelöst, wenn ein Cube erzeugt wurde und bereit für die Abfrage ist.

Die CubeEvent.CUBE_COMPLETE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein complete-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelabletrue
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
descriptionBeschreibung der verarbeiteten Elemente.
progressDie Anzahl der Elemente im Würfel, die aktualisiert wurden.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.
totalDie Gesamtzahl der Elemente im Würfel, die aktualisiert werden müssen.
typeCubeEvent.CUBE_COMPLETE

progress

Ereignis  
Ereignisobjekttyp: mx.events.CubeEvent
Eigenschaft CubeEvent.type = mx.events.CubeEvent.CUBE_PROGRESS

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wird fortlaufend ausgelöst, während ein Cube durch einen Aufruf der refresh()-Methode erzeugt wird.

Die CubeEvent.CUBE_PROGRESS-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein progress-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelabletrue
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
descriptionBeschreibung der verarbeiteten Elemente.
progressDie Anzahl der Elemente im Würfel, die aktualisiert wurden.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.
totalDie Gesamtzahl der Elemente im Würfel, die aktualisiert werden müssen.
typeCubeEvent.CUBE_PROGRESS

queryProgress

Ereignis  
Ereignisobjekttyp: mx.events.CubeEvent
Eigenschaft CubeEvent.type = mx.events.CubeEvent.QUERY_PROGRESS

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wird fortlaufend ausgelöst, während ein Abfrageergebnis durch einen Aufruf der execute()-Methode erstellt wird.

Die CubeEvent.QUERY_PROGRESS-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein queryProgress-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelabletrue
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
descriptionBeschreibung der verarbeiteten Elemente.
progressDie Anzahl der Elemente im Würfel, die aktualisiert wurden.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.
totalDie Gesamtzahl der Elemente im Würfel, die aktualisiert werden müssen.
typeCubeEvent.QUERY_PROGRESS




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.