CREATE ACTION-Anweisung (MDX)

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 ServerAnalysis Services neu eingeführten Aktionen, z. B. Drillthrough- oder Berichtsaktionen, werden nicht unterstützt.

Aktionstypen

In der folgenden Tabelle sind die verschiedenen Typen von Aktionen beschrieben, die in MicrosoftSQL ServerAnalysis Services zur Verfügung stehen.

Aktionstyp	Beschreibung
URL	Die zurückgegebene Aktionszeichenfolge ist eine URL, die 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.

Scope

Siehe auch

Andere Ressourcen