Istruzione CREATE ACTION (MDX)

Crea un'azione che può essere associata a un cubo, a una dimensione, a una gerarchia o a un oggetto subordinato.

Sintassi

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

Argomenti

• Cube_Name
  Stringa valida che specifica il nome di un cubo.

• Action_ Name
  Stringa valida che specifica il nome dell'azione da creare.

• Hierarchy_ Name
  Stringa valida che specifica il nome di una gerarchia.

• Level_ Name
  Stringa valida che specifica il nome di un livello.

• Member_ Name
  Stringa valida che specifica il nome o la chiave di un membro.

• MDX_Expression
  Espressione MDX valida.

• String_Expression
  Espressione stringa valida.

Osservazioni

Le applicazioni client possono creare ed eseguire azioni non sicure, così come possono utilizzare funzioni non sicure. Per evitare situazioni di questo tipo, utilizzare la proprietà Safety Options. Per ulteriori informazioni, vedere l'argomento dedicato alle opzioni di protezione.

Nota

Questa istruzione è stata inclusa per compatibilità con le versioni precedenti. Le azioni che rappresentano una novità in SQL Server Analysis Services, ad esempio le azioni drill-through o report, non sono supportate.

Tipi di azioni

Nella tabella seguente vengono descritti i diversi tipi di azioni disponibili in Microsoft SQL Server Analysis Services.

Tipo di azione	Descrizione
URL	Viene restituita una stringa costituita da un URL a cui accedere tramite browser Internet. Nota Se tale stringa non inizia con http:// o https://, l'azione non sarà disponibile al browser, a meno che la proprietà SafetyOptions non sia impostata su DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML	Viene restituita una stringa costituita da uno script HTML. Tale stringa deve essere salvata in un file che sarà possibile visualizzare utilizzando un browser Internet. In questo caso è possibile che nell'ambito del codice HTML generato venga eseguito un intero script.
STATEMENT	Viene restituita una stringa costituita da un'istruzione da eseguire impostando sulla stringa il metodo ICommand::SetText di un oggetto Command e chiamando il metodo ICommand::Execute. Se il comando non riesce, verrà restituito un errore.
DATASET	Viene restituita una stringa costituita da un'istruzione MDX da eseguire impostando sulla stringa il metodo ICommand::SetText di un oggetto Command e chiamando il metodo ICommand::Execute. L'ID di interfaccia (IID) richiesto deve essere IDataset. Il comando riesce se viene creato un set di dati. L'applicazione client deve consentire all'utente di visualizzare il set di dati restituito.
ROWSET	Simile a DATASET. In questo caso, anziché richiedere un IID di tipo IDataset, l'applicazione client deve richiedere un IID di tipo IRowset. Il comando riesce se viene creato un set di righe. L'applicazione client deve consentire all'utente di visualizzare il set di righe restituito.
COMMANDLINE	L'applicazione client deve eseguire la stringa dell'azione, che è costituita da una riga di comando.
PROPRIETARY	L'applicazione client può visualizzare o eseguire l'azione esclusivamente se dispone di informazioni personalizzate, non generiche, sull'azione specifica. Le azioni di questo tipo vengono restituite all'applicazione client esclusivamente se quest'ultima le richiede in modo esplicito, impostando la restrizione appropriata su APPLICATION_NAME.

Tipi di chiamate

Nella tabella seguente vengono descritti i diversi tipi di chiamate disponibili in Analysis Services. Il tipo di chiamata viene utilizzato dall'applicazione client solo per determinare quando richiamare l'azione, ma non determina effettivamente il comportamento di chiamata dell'azione.

Tipo di chiamata	Descrizione
INTERACTIVE	L'azione deve essere richiamata dall'applicazione client tramite l'interazione dell'utente.
ON_OPEN	L'azione deve essere richiamata dall'applicazione client quando viene aperto l'oggetto di destinazione. Questo tipo di chiamata non è attualmente implementato.
BATCH	L'azione deve essere richiamata dall'applicazione client quando l'oggetto di destinazione è coinvolto in un'operazione batch, secondo quanto determinato dall'applicazione client. Questo tipo di chiamata non è attualmente implementato.

Ambito

Ogni azione è definita per un cubo specifico e ha un nome univoco in tale cubo. Un'azione può avere uno degli ambiti elencati nella tabella seguente.

• Ambito cubo
  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.

• Ambito dimensione
  L'azione viene applicata a una dimensione specifica. Le azioni di questo tipo non dipendono dagli specifici livelli o membri selezionati.

• Ambito livello
  L'azione viene applicata a un livello di dimensione specifico. Le azioni di questo tipo non dipendono dallo specifico membro selezionato nella dimensione.

• Ambito membro
  L'azione viene applicata a membri specifici di un livello.

• Ambito cella
  L'azione viene applicata solo a celle specifiche.

• Ambito set
  L'azione viene applicata solo a un set. Il nome ActionParameterSet è riservato per l'utilizzo da parte dell'applicazione all'interno dell'espressione dell'azione.

Vedere anche

Altre risorse

Istruzioni MDX per la definizione dei dati (MDX)