Definice dat MDX – CREATE ACTION

Vytvoří akci, která může být přidružena k datové krychli, dimenzi, hierarchii nebo podřízeného objektu.

Syntaxe

  
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

Cube_Name
Platný řetězec, který obsahuje název datové krychle.

název Action_
Platný řetězec, který obsahuje název vytvářené akce.

název Hierarchy_
Platný řetězec, který poskytuje název hierarchie.

název Level_
Platný řetězec, který poskytuje název úrovně.

název Member_
Platný řetězec, který poskytuje název člena nebo klíč člena.

MDX_Expression
Platný výraz MDX.

String_Expression
Platný řetězcový výraz.

Poznámky

Klientské aplikace mohou vytvářet a spouštět akce, které jsou nebezpečné; Je také možné, aby klientské aplikace používaly nebezpečné funkce. Chcete-li se těmto situacím vyhnout, použijte vlastnost Možnosti zabezpečení . Další informace naleznete v tématu Vlastnosti možnosti zabezpečení.

Poznámka:

Tento příkaz je součástí zpětné kompatibility. Akce nové ve službě Analysis Services, jako jsou podrobné analýzy nebo akce sestavy, se nepodporují.

Typy akcí

Následující tabulka popisuje různé typy akcí dostupných ve službě Analysis Services.

Typ akce	Popis
Adresa URL	Vrácený řetězec akce je adresa URL, která by se měla otevřít v internetovém prohlížeči. Poznámka: Pokud tato akce nezačíná https:// nebo https://, nebude tato akce dostupná v prohlížeči, pokud není možnost SafetyOptions nastavena na DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML	Vrácený řetězec akce je skript HTML. Řetězec by se měl uložit do souboru a soubor by se měl vykreslit pomocí internetového prohlížeče. V tomto případě se může spustit celý skript jako součást vygenerovaného kódu HTML.
VÝROK	Vrácený řetězec akce je příkaz, který je třeba provést nastavením ICommand::SetText metody objektu příkazu na řetězec a volání ICommand::Execute metoda. Pokud příkaz neuspěje, vrátí se chyba.
DATASET	Vrácený řetězec akce je příkaz MDX, který je třeba spustit nastavením ICommand::SetText metody objektu příkazu na řetězec a volání ICommand::Execute metoda. Požadovaná ID rozhraní (IID) by měla být IDataset. Příkaz bude úspěšný, pokud byla vytvořena datová sada. Klientská aplikace by měla uživateli umožnit procházet vrácenou sadu dat.
SADA ŘÁDKŮ	Podobně jako u datové sady, ale místo požadavku na IDataset by klientská aplikace měla požádat o IID IRowset. Příkaz proběhne úspěšně, pokud byla vytvořena sada řádků. Klientská aplikace by měla uživateli umožnit procházet vrácenou sadu řádků.
PŘÍKAZOVÝ ŘÁDEK	Klientská aplikace by měla spustit řetězec akce. Řetězec je příkazový řádek.
PROPRIETÁRNÍ	Klientská aplikace by neměla zobrazit ani provést akci, pokud aplikace nemá vlastní negenerické znalosti konkrétní akce. Proprietární akce se nevrátí do klientské aplikace, pokud klientská aplikace explicitně nepožádá o ně nastavením příslušného omezení na APPLICATION_NAME.

Typy volání

Následující tabulka popisuje různé typy vyvolání dostupných ve službě Analysis Services. Typ vyvolání používá pouze klientská aplikace k určení, kdy se má akce vyvolat. Typ vyvolání ve skutečnosti nezjišťuje chování vyvolání akce.

Typ vyvolání	Popis
INTERAKTIVNÍ	Akce by měla být vyvolána klientskou aplikací prostřednictvím interakce uživatele.
ON_OPEN	Akce by měla vyvolat klientská aplikace při otevření cílového objektu. Tento typ vyvolání není aktuálně implementován.
VÁRKA	Akce by měla vyvolat klientská aplikace, když je cílový objekt zapojen do dávkové operace, jak je určeno klientskou aplikací. Tento typ vyvolání není aktuálně implementován.

Rozsah

Každá akce je definována pro konkrétní datovou krychli a má v této datové krychli jedinečný název. Akce může mít jeden z oborů uvedených v následující tabulce.

Rozsah datové krychle
Pro akce nezávislé na konkrétních rozměrech, členech nebo buňkách; Například: "Spuštění emulace terminálu pro produkční systém AS/400".

Rozsah dimenze
Akce se vztahuje na konkrétní dimenzi. Tyto akce nejsou závislé na konkrétním výběru úrovní nebo členů.

Rozsah úrovně
Akce se vztahuje na konkrétní úroveň dimenze. Tyto akce nejsou závislé na konkrétním výběru člena v dané dimenzi.

Rozsah člena
Akce se vztahuje na konkrétní členy úrovně.

Obor buňky
Akce se vztahuje pouze na konkrétní buňky.

Nastavit rozsah
Akce se vztahuje pouze na sadu. Název ActionParameterSet je vyhrazen pro použití aplikací uvnitř výrazu akce.

Viz také

příkazy definice dat MDX (MDX)