Definicja danych MDX — TWORZENIE AKCJI

Tworzy akcję, którą można skojarzyć z modułem, wymiarem, hierarchią lub obiektem podrzędnym.

Składnia

  
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' ]  

Argumenty (w programowaniu)

Cube_Name
Prawidłowy ciąg, który zawiera nazwę modułu.

nazwa Action_
Prawidłowy ciąg, który zawiera nazwę tworzonej akcji.

nazwa Hierarchy_
Prawidłowy ciąg, który zawiera nazwę hierarchii.

nazwa Level_
Prawidłowy ciąg, który zawiera nazwę poziomu.

nazwa Member_
Prawidłowy ciąg, który zawiera nazwę elementu członkowskiego lub klucz elementu członkowskiego.

MDX_Expression
Prawidłowe wyrażenie MDX.

String_Expression
Prawidłowe wyrażenie ciągu.

Uwagi

Aplikacje klienckie mogą tworzyć i uruchamiać akcje, które są niebezpieczne; aplikacje klienckie mogą również używać niebezpiecznych funkcji. Aby uniknąć takich sytuacji, użyj właściwości Opcje bezpieczeństwa . Aby uzyskać więcej informacji, zobacz Właściwości opcji bezpieczeństwa.

Uwaga / Notatka

Ta instrukcja jest uwzględniana w celu zapewnienia zgodności z poprzednimi wersjami. Akcje nowe w usługach Analysis Services, takie jak przeglądanie szczegółowe lub akcje raportu, nie są obsługiwane.

Typy akcji

W poniższej tabeli opisano różne typy akcji dostępnych w usługach Analysis Services.

Typ akcji	Opis
Adres URL	Zwrócony ciąg akcji to adres URL, który powinien zostać otwarty przy użyciu przeglądarki internetowej. Uwaga: jeśli ta akcja nie rozpoczyna się od https:// lub https://, akcja będzie niedostępna dla przeglądarki, chyba że ustawienie SafetyOptions ma wartość DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML	Zwrócony ciąg akcji jest skryptem HTML. Ciąg należy zapisać w pliku, a plik powinien być renderowany przy użyciu przeglądarki internetowej. W takim przypadku cały skrypt może być uruchamiany w ramach wygenerowanego kodu HTML.
WYPOWIEDŹ	Zwrócony ciąg akcji jest instrukcją, która musi zostać wykonana przez ustawienie metody ICommand::SetText obiektu polecenia na ciąg i wywołanie metody ICommand::Execute . Jeśli polecenie nie powiedzie się, zostanie zwrócony błąd.
DATASET	Zwrócony ciąg akcji jest instrukcją MDX, która musi być uruchamiana przez ustawienie metody ICommand::SetText obiektu polecenia na ciąg i wywołanie metody ICommand::Execute . Żądany identyfikator interfejsu (IID) powinien mieć wartość IDataset. Polecenie powiedzie się, jeśli zestaw danych został utworzony. Aplikacja kliencka powinna zezwolić użytkownikowi na przeglądanie zwróconego zestawu danych.
ZESTAW WIERSZY	Podobnie jak w przypadku zestawu danych, ale zamiast żądać identyfikatora IID IDataset, aplikacja kliencka powinna poprosić o identyfikator IID IRowset. Polecenie powiedzie się, jeśli zestaw wierszy został utworzony. Aplikacja kliencka powinna zezwolić użytkownikowi na przeglądanie zwróconego zestawu wierszy.
WIERSZ POLECENIA	Aplikacja kliencka powinna wykonać ciąg akcji. Ciąg jest wierszem polecenia.
WŁASNOŚCIOWY	Aplikacja kliencka nie powinna wyświetlać ani wykonywać akcji, chyba że aplikacja ma niestandardową, niegeneryczną wiedzę na temat określonej akcji. Zastrzeżone akcje nie są zwracane do aplikacji klienckiej, chyba że aplikacja kliencka jawnie prosi o to, ustawiając odpowiednie ograniczenie dotyczące APPLICATION_NAME.

Typy wywołań

W poniższej tabeli opisano różne typy wywołań dostępnych w usługach Analysis Services. Typ wywołania jest używany tylko przez aplikację kliencka, aby określić, kiedy należy wywołać akcję. Typ wywołania w rzeczywistości nie określa zachowania wywołania akcji.

Typ wywołania	Opis
INTERAKTYWNY	Akcja powinna być wywoływana przez aplikację kliencka za pośrednictwem interakcji użytkownika.
ON_OPEN	Akcja powinna być wywoływana przez aplikację kliencą po otwarciu obiektu docelowego. Ten typ wywołania nie jest obecnie implementowany.
PARTIA	Akcja powinna być wywoływana przez aplikację kliencką, gdy obiekt docelowy jest zaangażowany w operację wsadową określoną przez aplikację kliencką. Ten typ wywołania nie jest obecnie implementowany.

Zakres

Każda akcja jest definiowana dla określonego modułu i ma unikatową nazwę w tym module. Akcja może zawierać jeden z zakresów wymienionych w poniższej tabeli.

Zakres modułu
W przypadku akcji niezależnych od określonych wymiarów, elementów członkowskich lub komórek; na przykład: "Uruchom emulację terminalu dla systemu produkcyjnego AS/400".

Zakres wymiaru
Akcja ma zastosowanie do określonego wymiaru. Te akcje nie są zależne od określonego wyboru poziomów lub elementów członkowskich.

Zakres poziomu
Akcja ma zastosowanie do określonego poziomu wymiaru. Te akcje nie są zależne od określonego wyboru elementu członkowskiego w tym wymiarze.

Zakres elementu członkowskiego
Akcja ma zastosowanie do określonych elementów członkowskich poziomu.

Zakres komórek
Akcja dotyczy tylko określonych komórek.

Ustawianie zakresu
Akcja dotyczy tylko zestawu. Nazwa ActionParameterSet jest zarezerwowana do użycia przez aplikację w wyrażeniu akcji.

Zobacz też

instrukcji definicji danych MDX (MDX)