• Articolo

Set di righe MDSCHEMA_ACTIONS

Descrive le azioni che possono essere disponibili per l'applicazione client.

Colonne del set di righe

Il set di righe MDSCHEMA_ACTIONS contiene le colonne seguenti.

Nome colonna

Indicatore del tipo

Lunghezza

Descrizione

CATALOG_NAME

DBTYPE_WSTR

Nome del database.

SCHEMA_NAME

DBTYPE_WSTR

Non supportato. Contiene sempre VT_NULL.

CUBE_NAME

DBTYPE_WSTR

Nome del cubo a cui appartiene questa azione.

ACTION_NAME

DBTYPE_WSTR

Nome di questa azione.

ACTION_TYPE

DBTYPE_I4

Bitmap utilizzata per specificare il metodo di attivazione dell'azione. Nel file Msmd.h sono definite le seguenti costanti del valore bit per questa bitmap:

  • MDACTION_TYPE_URL (0x01)

  • MDACTION_TYPE_HTML (0x02)

  • MDACTION_TYPE_STATEMENT (0x04)

  • MDACTION_TYPE_DATASET (0x08)

  • MDACTION_TYPE_ROWSET (0x10)

  • MDACTION_TYPE_COMMANDLINE (0x20)

  • MDACTION_TYPE_PROPRIETARY (0x40)

  • MDACTION_TYPE_REPORT (0x80)

  • MDACTION_TYPE_DRILLTHROUGH (0x100)

COORDINATE

DBTYPE_WSTR

Espressione MDX che specifica un oggetto o una coordinata nello spazio multidimensionale in cui viene eseguita l'azione. Il valore di questa colonna di restrizione viene fornito dall'applicazione client.

CORDINATE deve essere risolto in un oggetto specificato in COORDINATE_TYPE.

COORDINATE_TYPE

DBTYPE_I4

Bitmap che specifica come viene interpretata la colonna di restrizione COORDINATE. Nel file Msmd.h sono definite le seguenti costanti del valore bit per questa bitmap:

  • MDACTION_COORDINATE_CUBE (1)

  • MDACTION_COORDINATE_DIMENSION (2)

    fa riferimento alle gerarchie delle dimensioni.

  • MDACTION_COORDINATE_LEVEL (3)

  • MDACTION_COORDINATE_MEMBER (4)

  • MDACTION_COORDINATE_SET (5)

  • MDACTION_COORDINATE_CELL (6)

ACTION_CAPTION

DBTYPE_WSTR

Nome dell'azione se non viene specificata alcuna didascalia né alcuna traduzione in DDL.

Se viene specificata una didascalia o una traduzione e CaptionIsMDX è false, una delle seguenti stringhe:

  • Traduzione per la lingua appropriata.

  • Didascalia specificata se non è stata trovata alcuna traduzione per la lingua specificata.

  • Nome dell'azione se non è stata trovata alcuna traduzione e la didascalia non è stata specificata in DDL.

Se viene specificata una didascalia o una traduzione e CaptionIsMDX è true, stringa risultante dall'individuazione della traduzione appropriata per la lingua specificata o della traduzione specificata nella didascalia DDL e dal calcolo della formula per creare la stringa.

Se l'azione è stata specificata nello script MDX, non vi sono traduzioni e la didascalia viene sempre considerata come un'espressione MDX.

DESCRIPTION

DBTYPE_WSTR

Descrizione semplice dell'azione.

CONTENT

DBTYPE_WSTR

Espressione o contenuto dell'azione da eseguire.

APPLICATION

DBTYPE_WSTR

Nome dell'applicazione da utilizzare per eseguire l'azione.

INVOCATION

DBTYPE_I4

Informazioni sulla modalità con cui richiamare l'azione:

  • MDACTION_INVOCATION_INTERACTIVE (1) indica un'azione regolare utilizzata durante il normale funzionamento. È il valore predefinito per questa colonna.

  • MDACTION_INVOCATION_ON_OPEN (2) indica che l'azione deve essere eseguita alla prima apertura del cubo.

  • MDACTION_INVOCATION_BATCH (4) indica che l'azione viene eseguita come parte di un'operazione batch o di un'attività di Microsoft SQL Server Integration Services.

Questi valori di enumerazione sono definiti nel file Msmd.h.

Il set di righe viene ordinato in base a CATALOG_NAME, SCHEMA_NAME, CUBE_NAME e ACTION_NAME.

Nota

Le azioni di tipo MDACTION_TYPE_PROPRIETARY devono fornire un valore per la colonna APPLICATION.

Colonne di restrizione

Il set di righe MDSCHEMA_ACTIONS può essere limitato nelle colonne elencate nella tabella seguente.

Nome colonna

Indicatore del tipo

Stato della restrizione

CATALOG_NAME

DBTYPE_WSTR

Facoltativo

SCHEMA_NAME

DBTYPE_WSTR

Facoltativo

CUBE_NAME

DBTYPE_WSTR

Obbligatorio

ACTION_NAME

DBTYPE_WSTR

Facoltativo

ACTION_TYPE

DBTYPE_I4

Facoltativo

COORDINATE

DBTYPE_WSTR

Obbligatorio

COORDINATE_TYPE

DBTYPE_I4

Obbligatorio

INVOCATION

DBTYPE_I4

(Facoltativo) L'impostazione predefinita della colonna di restrizione INVOCATION è il valore di MDACTION_INVOCATION_INTERACTIVE. Per recuperare tutte le azioni, utilizzare il valore MDACTION_INVOCATION_ALL nella colonna di restrizione INVOCATION.

CUBE_SOURCE

DBTYPE_UI2

(Facoltativo) Una bitmap con uno dei seguenti valori validi:

  • 1 CUBO

  • 2 DIMENSIONE

La restrizione predefinita è impostata sul valore 1.
Nota importanteImportante

Il valore predefinito della colonna di restrizione INVOCATION è MDACTION_INVOCATION_INTERACTIVE. Qualsiasi set di righe dello schema che non specifichi in modo esplicito un valore per questa colonna contiene solo righe con questo valore. Se si desidera che il set di righe contenga l'intero set di azioni, utilizzare la costante MDACTION_INVOCATION_ALL nella colonna di restrizione INVOCATION.

Nelle applicazioni client è possibile definire più ACTION_TYPE tramite l'operatore OR.

Osservazioni

Nella tabella seguente vengono elencate le combinazioni di COORDINATE e COORDINATE_TYPE valide.

Tipo di oggetto COORDINATE

COORDINATE_TYPE

Cube

MDACTION_COORDINATE_CUBE

Dimension

MDACTION_COORDINATE_DIMENSION

MDACTION_COORDINATE_LEVEL

MDACTION_COORDINATE_MEMBER

MDACTION_COORDINATE_SET

MDACTION_COORDINATE_CELL

Hierarchy

MDACTION_COORDINATE_DIMENSION

Level

MDACTION_COORDINATE_LEVEL

Member

MDACTION_COORDINATE_MEMBER

Set

MDACTION_COORDINATE_SET

cell

MDACTION_COORDINATE_CELL