Definizione dei dati MDX - CREATE ACTION
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.
nome Action_
Stringa valida che specifica il nome dell'azione da creare.
nome Hierarchy_
Stringa valida che specifica il nome di una gerarchia.
nome Level_
Stringa valida che specifica il nome di un livello.
nome Member_
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 queste situazioni, utilizzare la proprietà Safety Options . Per ulteriori informazioni, vedere l'argomento dedicato alle opzioni di sicurezza.
Nota
Questa istruzione è stata inclusa per compatibilità con le versioni precedenti. Le azioni nuove di 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 Analysis Services.
| Tipo di azione | Descrizione |
|---|---|
| URL | Viene restituita una stringa costituita da un URL a cui accedere tramite browser Internet. Nota: se questa azione non inizia con https:// o https://, l'azione non sarà disponibile per il browser a meno che 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. |
| AFFERMAZIONE | La stringa di azione restituita è un'istruzione che deve essere eseguita impostando il metodo ICommand::SetText di un oggetto comando sulla stringa e chiamando il metodo ICommand::Execute. Se il comando non riesce, verrà restituito un errore. |
| DATASET | La stringa di azione restituita è un'istruzione MDX che deve essere eseguita impostando il metodo ICommand::SetText di un oggetto comando sulla stringa e chiamando il metodo ICommand::Execute . L'ID dell'interfaccia richiesta (IID) 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. |
| RIGHE | Analogamente a DATASET, ma invece di richiedere un IID di IDataset, l'applicazione client deve richiedere un IID di 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. |
| PROPRIETARIO | L'applicazione client può visualizzare o eseguire l'azione esclusivamente se dispone di informazioni personalizzate, non generiche, sull'azione specifica. Le azioni proprietarie non vengono restituite all'applicazione client, a meno che l'applicazione client non richieda esplicitamente queste richieste impostando la restrizione appropriata sul 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 |
|---|---|
| INTERATTIVA | 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. |
| LOTTO | 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. |
Scope
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'uso da parte dell'applicazione all'interno dell'espressione dell'azione.