MDX-Datendefinition – CREATE ACTION

Artikel
05/23/2023

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.

Bemerkungen

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

Hinweis

Diese Anweisung wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Neue Aktionen für Analysis Services, z. B. Drillthrough- oder Berichtsaktionen, werden nicht unterstützt.

Aktionstypen

In der folgenden Tabelle werden die verschiedenen Arten von Aktionen beschrieben, die in Analysis Services verfügbar sind.

Aktionstyp	BESCHREIBUNG
URL	Die zurückgegebene Aktionszeichenfolge ist eine URL, die mit einem Internetbrowser geöffnet werden sollte. Hinweis: Wenn diese Aktion nicht mit `https://` oder `https://`beginnt, ist die Aktion für den Browser nicht verfügbar, es sei denn , SafetyOptions ist auf DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL festgelegt.
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.
ANWEISUNG	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-Methodeaufgerufen 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 (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, aber anstatt eine IID von IDataset anzufordern, sollte die Clientanwendung eine IID von 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.
PROPRIETÄRE	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 nicht an die Clientanwendung zurückgegeben, es sei denn, die Clientanwendung fordert diese explizit an, indem die entsprechende Einschränkung für die APPLICATION_NAME festgelegt wird.

Aufruftypen

In der folgenden Tabelle werden die verschiedenen Arten von Aufrufen beschrieben, die in Analysis Services verfügbar sind. 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
INTERAKTIVE	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.

Bereich

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.

Memberbereich
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.

Weitere Informationen

MDX-Datendefinitionsanweisungen (MDX)

Freigeben über