Definizione dei dati MDX - creare azioniMDX Data Definition - CREATE ACTION

SI APPLICA A:sìSQL Server Analysis ServicesnoAzure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesnoAzure Analysis Services

Crea un'azione che può essere associata a un cubo, a una dimensione, a una gerarchia o a un oggetto subordinato.Creates an action that can be associated with a cube, dimension, hierarchy, or subordinate object.

SintassiSyntax


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

ArgomentiArguments

Cube_NameCube_Name
Stringa valida che specifica il nome di un cubo.A valid string that provides a cube name.

Nome Action_Action_ Name
Stringa valida che specifica il nome dell'azione da creare.A valid string that provides the name of the action being created.

Nome Hierarchy_Hierarchy_ Name
Stringa valida che specifica il nome di una gerarchia.A valid string that provides a hierarchy name.

Nome Level_Level_ Name
Stringa valida che specifica il nome di un livello.A valid string that provides a level name.

Nome Member_Member_ Name
Stringa valida che specifica il nome o la chiave di un membro.A valid string that provides a member name or member key.

MDX_ExpressionMDX_Expression
Espressione MDX valida.A valid MDX expression.

String_ExpressionString_Expression
Espressione stringa valida.A valid string expression.

OsservazioniRemarks

Le applicazioni client possono creare ed eseguire azioni non sicure, così come possono utilizzare funzioni non sicure.It is possible for client applications to create and run actions that are unsafe; it is also possible for client applications to use unsafe functions. Per evitare queste situazioni, utilizzare il Safety Options proprietà.To avoid these situations, use the Safety Options property. Per ulteriori informazioni, vedere l'argomento dedicato alle opzioni di sicurezza.For more information, see Safety Options Property.

Nota

Questa istruzione è stata inclusa per compatibilità con le versioni precedenti.This statement is included for backwards compatibility. Familiarità con le azioni SQL ServerSQL Server Analysis ServicesAnalysis Services, ad esempio le azioni di drill-through o di un Report, non sono supportati.Actions new to SQL ServerSQL Server Analysis ServicesAnalysis Services, such as Drillthrough or Report actions, are not supported.

Tipi di azioniAction Types

Nella tabella seguente vengono descritti i diversi tipi di azioni disponibili in MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services.The following table describes the different types of actions available in MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services.

Tipo di azioneAction type DescriptionDescription
URLURL Viene restituita una stringa costituita da un URL a cui accedere tramite browser Internet.The returned action string is a URL that should be opened using an Internet browser.

Nota: Se questa azione non inizia con http:// o https://, l'azione sarà disponibile per il browser a meno che non SafetyOptions è impostato su DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.Note: If this action does not start with http:// or https://, the action will be unavailable to the browser unless SafetyOptions is set to DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTMLHTML Viene restituita una stringa costituita da uno script HTML.The returned action string is an HTML script. Tale stringa deve essere salvata in un file che sarà possibile visualizzare utilizzando un browser Internet.The string should be saved to a file and the file should be rendered using an Internet browser. In questo caso è possibile che nell'ambito del codice HTML generato venga eseguito un intero script.In this case, a whole script may be run as part of the generated HTML.
ISTRUZIONESTATEMENT Viene restituita una stringa è un'istruzione che deve essere eseguito mediante l'impostazione di SetText metodo di un oggetto comando per la stringa e la chiamata di ICommand:: Execute(metodo).The returned action string is a statement that needs to be executed by setting the ICommand::SetText method of a command object to the string and calling the ICommand::Executemethod. Se il comando non riesce, verrà restituito un errore.If the command does not succeed, an error is returned.
SET DI DATIDATASET Viene restituita una stringa è un'istruzione MDX che deve essere eseguita impostando il SetText metodo di un oggetto comando per la stringa e la chiamata di ICommand:: Execute metodo.The returned action string is an MDX statement that needs to be run by setting the ICommand::SetText method of a command object to the string and calling the ICommand::Execute method. L'interfaccia richiesta deve essere l'ID (IID) IDataset.The requested interface ID (IID) should be IDataset. Il comando riesce se viene creato un set di dati.The command succeeds if a data set has been created. L'applicazione client deve consentire all'utente di visualizzare il set di dati restituito.The client application should allow the user to browse the returned data set.
SET DI RIGHEROWSET Simile a DATASET, anziché richiedere un IID di IDataset, l'applicazione client deve richiedere un IID di IRowset.Similar to DATASET, but instead of requesting an IID of IDataset, the client application should ask for an IID of IRowset. Il comando riesce se viene creato un set di righe.The command succeeds if a rowset has been created. L'applicazione client deve consentire all'utente di visualizzare il set di righe restituito.The client application should allow the user to browse the returned rowset.
RIGA DI COMANDOCOMMANDLINE L'applicazione client deve eseguire la stringa dell'azione,The client application should execute the action string. che è costituita da una riga di comando.The string is a command line.
PROPRIETARIOPROPRIETARY L'applicazione client può visualizzare o eseguire l'azione esclusivamente se dispone di informazioni personalizzate, non generiche, sull'azione specifica.A client application should not display, nor execute the action unless the application has a custom, nongeneric knowledge of the specific action. Le azioni proprietarie non vengono restituite all'applicazione client, a meno che l'applicazione client richiede in modo esplicito, impostando la restrizione appropriata sul APPLICATION_NAME.Proprietary actions are not returned to the client application unless the client application explicitly asks for these by setting the appropriate restriction on the APPLICATION_NAME.

Tipi di chiamateInvocation Types

Nella tabella seguente vengono descritti i diversi tipi di chiamate disponibili in Analysis ServicesAnalysis Services.The following table describes the different types of invocations available in Analysis ServicesAnalysis Services. Il tipo di chiamata viene utilizzato dall'applicazione client solo per determinare quando richiamare l'azione,The invocation type is used only by the client application to help determine when to invoke the action. ma non determina effettivamente il comportamento di chiamata dell'azione.The invocation type does not actually determine the invocation behavior of the action.

Tipo di chiamataInvocation type DescriptionDescription
INTERATTIVOINTERACTIVE L'azione deve essere richiamata dall'applicazione client tramite l'interazione dell'utente.The action should be invoked by the client application through user interaction.
ON_OPENON_OPEN L'azione deve essere richiamata dall'applicazione client quando viene aperto l'oggetto di destinazione.The action should be invoked by the client application when the target object is opened. Questo tipo di chiamata non è attualmente implementato.This invocation type is not currently implemented.
BATCHBATCH L'azione deve essere richiamata dall'applicazione client quando l'oggetto di destinazione è coinvolto in un'operazione batch, secondo quanto determinato dall'applicazione client.The action should be invoked by the client application when the target object is involved in a batch operation, as determined by the client application. Questo tipo di chiamata non è attualmente implementato.This invocation type is not currently implemented.

AmbitoScope

Ogni azione è definita per un cubo specifico e ha un nome univoco in tale cubo.Each action is defined for a specific cube and has a unique name in that cube. Un'azione può avere uno degli ambiti elencati nella tabella seguente.An action can have one of the scopes listed in the following table.

Ambito cuboCube scope
Per azioni indipendenti da una dimensione, una cella o un membro specifico, ad esempio l'avvio di un'emulazione di terminale per un sistema di produzione AS/400.For actions independent of specific dimensions, members, or cells; for example: "Launch terminal emulation for AS/400 production system".

Ambito dimensioneDimension scope
L'azione viene applicata a una dimensione specifica.The action applies to a specific dimension. Le azioni di questo tipo non dipendono dagli specifici livelli o membri selezionati.These actions are not dependent on specific selection of levels or members.

Ambito livelloLevel scope
L'azione viene applicata a un livello di dimensione specifico.The action applies to a specific dimension level. Le azioni di questo tipo non dipendono dallo specifico membro selezionato nella dimensione.These actions are not dependent on specific selection of a member in that dimension.

Ambito membroMember scope
L'azione viene applicata a membri specifici di un livello.The action applies to specific level members.

Ambito cellaCell scope
L'azione viene applicata solo a celle specifiche.The action applies to specific cells only.

Ambito setSet scope
L'azione viene applicata solo a un set.The action applies to a set only. Il nome, ActionParameterSet, è riservato per usi dall'applicazione all'interno dell'espressione dell'azione.The name, ActionParameterSet, is reserved for use by the application inside the expression of the action.

Vedere ancheSee Also

Le istruzioni di definizione dei dati MDX ( MDX )MDX Data Definition Statements (MDX)