CREATE ACTION-Anweisung (MDX)

Aktualisiert: 17. Juli 2006

Erstellt eine Aktion, die einem Cube, einer Dimension, einer Hierarchie oder einem untergeordneten Objekt zugeordnet werden kann.

Syntax

CREATE ACTION CURRENTCUBE | Cube_Name
      .Action_Name <action body>
<action body> ::= 
FOR 
        CUBE 
    | Hierarchy_Name [MEMBERS] 
    | Level_Name [MEMBERS] 
    | CELLS 
    | SET } 
      AS 'MDX_Expression' 
        [, TYPE = '
              { URL 
            | HTML 
            | STATEMENT 
               | DATASET 
            | ROWSET 
            | COMMANDLINE 
               | PROPRIETARY } 
         ']
   [ , INVOCATION = 'INTERACTIVE | ON_OPEN | BATCH ' ]
   [ , APPLICATION = String_Expression ]
   [ , DESCRIPTION = String_Expression ]
   [ , CAPTION = 'MDX_Expression' ]

Argumente

• Cube_Name
  Eine gültige Zeichenfolge, die einen Cubenamen bereitstellt.

• Action_ Name
  Eine gültige Zeichenfolge, die den Namen der zu erstellenden Aktion bereitstellt.

• Hierarchy_ Name
  Eine gültige Zeichenfolge, die einen Hierarchienamen bereitstellt.

• Level_ Name
  Eine gültige Zeichenfolge, die einen Ebenennamen bereitstellt.

• Member_ Name
  Eine gültige Zeichenfolge, die einen Elementnamen oder Elementschlüssel bereitstellt.

• MDX_Expression
  Ein gültiger MDX-Ausdruck.

• String_Expression
  Ein gültiger Zeichenfolgenausdruck.

Hinweise

Es ist möglich, dass Clientanwendungen unsichere Aktionen erstellen und ausführen oder unsichere Funktionen verwenden. Um diese Situationen zu vermeiden, sollten Sie die Safety Options-Eigenschaft verwenden. Weitere Informationen finden Sie im Abschnitt zur Safety Options-Eigenschaft.

Hinweis:
Diese Anweisung wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Die in SQL Server 2005 Analysis Services (SSAS) neu eingeführten Aktionen, wie z. B. Drillthrough- oder Berichtsaktionen, werden nicht unterstützt.

Aktionstypen

In der folgenden Tabelle sind die verschiedenen Typen von Aktionen beschrieben, die in Microsoft SQL Server 2005 Analysis Services (SSAS) zur Verfügung stehen.

Aktionstyp

Beschreibung

URL

Die zurückgegebene Aktionszeichenfolge ist ein URL, der mit einem Internetbrowser geöffnet werden sollte.

Hinweis:

Beginnt diese Aktion nicht mit http:// oder https://, steht die Aktion für den Browser nur zur Verfügung, wenn SafetyOptions auf DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL festgelegt ist.

HTML

Die zurückgegebene Aktionszeichenfolge ist ein HTML-Skript. Die Zeichenfolge sollte in einer Datei gespeichert werden, und die Datei sollte mit einem Internetbrowser gerendert werden. In diesem Fall kann ein ganzes Skript als Teil des generierten HTML-Codes ausgeführt werden.

STATEMENT

Die zurückgegebene Aktionszeichenfolge ist eine Anweisung, die ausgeführt werden muss, indem die ICommand::SetText-Methode eines Befehlsobjekts auf die Zeichenfolge festgelegt und die ICommand::Execute-Methode aufgerufen wird. Wenn der Befehl nicht erfolgreich ausgeführt werden kann, wird ein Fehler zurückgegeben.

DATASET

Die zurückgegebene Aktionszeichenfolge ist eine MDX-Anweisung, die ausgeführt werden muss, indem die ICommand::SetText-Methode eines Befehlsobjekts auf die Zeichenfolge festgelegt und die ICommand::Execute-Methode aufgerufen wird. Die angeforderte Schnittstellen-ID (Interface ID, IID) sollte IDataset sein. Der Befehl ist erfolgreich, wenn ein Dataset erstellt wurde. Die Clientanwendung sollte dem Benutzer das Durchsuchen des zurückgegebenen Datasets ermöglichen.

ROWSET

Ähnlich wie DATASET, jedoch sollte die Clientanwendung statt der IID IDataset die IID IRowset anfordern. Der Befehl ist erfolgreich, wenn ein Rowset erstellt wurde. Die Clientanwendung sollte dem Benutzer das Durchsuchen des zurückgegebenen Rowsets ermöglichen.

COMMANDLINE

Die Clientanwendung sollte die Aktionszeichenfolge ausführen. Die Zeichenfolge stellt eine Befehlszeile dar.

PROPRIETARY

Eine Clientanwendung sollte die Aktion nicht anzeigen oder ausführen, wenn sie nicht über benutzerdefiniertes, nicht generisches Wissen über die bestimmte Aktion verfügt. Proprietäre Aktionen werden nur dann an die Clientanwendung zurückgegeben, wenn sie explizit von der Clientanwendung angefordert werden, indem die entsprechende Einschränkung für APPLICATION_NAME festgelegt wird.

Aufruftypen

In der folgenden Tabelle sind die verschiedenen Typen von Aufrufen beschrieben, die in Analysis Services zur Verfügung stehen. Der Aufruftyp wird nur von der Clientanwendung verwendet, um zu bestimmen, wann die Aktion aufgerufen werden soll. Das Aufrufverhalten der Aktion selbst wird nicht durch den Aufruftyp bestimmt.

Aufruftyp	Beschreibung
INTERACTIVE	Die Aktion sollte von der Clientanwendung durch Benutzerinteraktion aufgerufen werden.
ON_OPEN	Die Aktion sollte von der Clientanwendung aufgerufen werden, wenn das Zielobjekt geöffnet wird. Dieser Aufruftyp ist zurzeit nicht implementiert.
BATCH	Die Aktion sollte von der Clientanwendung aufgerufen werden, wenn das Zielobjekt an einem von der Clientanwendung bestimmten Batchvorgang beteiligt ist. Dieser Aufruftyp ist zurzeit nicht implementiert.

Scope

Jede Aktion ist für einen bestimmten Cube definiert und besitzt einen eindeutigen Namen innerhalb des Cubes. Eine Aktion kann für einen der Bereiche in der folgenden Tabelle gelten.

• Cubebereich
  Die Aktion ist unabhängig von bestimmten Dimensionen, Elementen oder Zellen. Beispiel: "Launch terminal emulation for AS/400 production system".

• Dimensionsbereich
  Die Aktion gilt für eine bestimmte Dimension. Diese Aktionen sind nicht von einer bestimmten Auswahl von Ebenen oder Elementen abhängig.

• Ebenenbereich
  Die Aktion gilt für eine bestimmte Dimensionsebene. Diese Aktionen sind nicht von einer bestimmten Auswahl eines Elements in dieser Dimension abhängig.

• Elementbereich
  Die Aktion gilt für bestimmte Ebenenelemente.

• Zellenbereich
  Die Aktion gilt nur für bestimmte Zellen.

• Mengenbereich
  Die Aktion gilt nur für eine Menge. Der Name, ActionParameterSet, ist für die Verwendung durch die Anwendung innerhalb des Ausdrucks der Aktion reserviert.

Siehe auch

Andere Ressourcen

MDX-Datendefinitionsanweisungen (MDX)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
17. Juli 2006	Geänderter Inhalt: Syntax und Argumente wurden zur Verdeutlichung aktualisiert.