• Article

Ensemble de lignes MDSCHEMA_ACTIONS

Décrit les actions qui peuvent être disponibles pour les applications clientes.

Colonnes de l'ensemble de lignes

L'ensemble de lignes MDSCHEMA_ACTIONS contient les colonnes suivantes.

Nom de la colonne

Indicateur de type

Longueur

Description

CATALOG_NAME

DBTYPE_WSTR

Nom de la base de données.

SCHEMA_NAME

DBTYPE_WSTR

Non prise en charge. Contient toujours VT_NULL.

CUBE_NAME

DBTYPE_WSTR

Nom du cube auquel appartient cette action.

ACTION_NAME

DBTYPE_WSTR

Nom de cette action.

ACTION_TYPE

DBTYPE_I4

Bitmap utilisé pour spécifier la méthode de déclenchement de l'action. Le fichier Msmd.h définit les constantes de valeur binaire suivantes pour cette image 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

Expression MDX (Multidimensional Expressions) qui spécifie un objet ou une coordonnée dans l'espace multidimensionnel dans lequel l'action est effectuée. L'application cliente est chargée de fournir la veleur de cette colonne de restriction.

Le CORDINATE doit résoudre l'objet spécifié dans COORDINATE_TYPE.

COORDINATE_TYPE

DBTYPE_I4

Bitmap qui spécifie la manière dont la colonne de restriction COORDINATE est interprétée. Le fichier Msmd.h définit les constantes de valeur binaire suivantes pour cette image bitmap :

  • MDACTION_COORDINATE_CUBE (1)

  • MDACTION_COORDINATE_DIMENSION (2)

    fait référence aux hiérarchies de dimensions.

  • MDACTION_COORDINATE_LEVEL (3)

  • MDACTION_COORDINATE_MEMBER (4)

  • MDACTION_COORDINATE_SET (5)

  • MDACTION_COORDINATE_CELL (6)

ACTION_CAPTION

DBTYPE_WSTR

Nom de l'action si aucune légende n'a été spécifiée et si aucune traduction n'a été spécifiée dans le DDL.

Si une légende ou des traductions ont été spécifiées, et que CaptionIsMDX est faux, l'une des chaînes suivantes :

  • Traduction pour la langue appropriée.

  • Légende spécifiée si aucune traduction n'a été trouvée pour la langue spécifiée.

  • Nom de l'action si aucune traduction n'a été trouvée et si la légende n'a pas été spécifiée dans un DDL.

Si une légende ou des traductions ont été spécifiées, et que CaptionIsMDX soit vrai, chaîne qui résulte de la détection de la traduction appropriée pour la langue spécifiée ou de la traduction spécifiée dans la légende DDL, et du calcul de la formule pour créer la chaîne.

Si l'action a été spécifiée dans un script MDX, il n'y a pas de traductions et la légende est toujours traitée comme une expression MDX.

DESCRIPTION

DBTYPE_WSTR

Description conviviale de l'action.

CONTENT

DBTYPE_WSTR

Expression ou contenu de l'action qui sera exécutée.

APPLICATION

DBTYPE_WSTR

Nom de l'application qui sera utilisée pour exécuter l'action.

INVOCATION

DBTYPE_I4

Informations sur la manière dont l'action doit être appelée :

  • MDACTION_INVOCATION_INTERACTIVE (1) indique une action régulière utilisée au cours d'opérations normales. Il s'agit de la valeur par défaut pour cette colonne.

  • MDACTION_INVOCATION_ON_OPEN (2) indique que l'action doit être exécutée lors de la première ouverture du cube.

  • MDACTION_INVOCATION_BATCH (4) indique que l'action est exécutée dans le cadre d'une opération non interactive ou d'une tâche MicrosoftSQL ServerIntegration Services.

Les valeurs de l'énumération sont définies dans le fichier, Msmd.h.

L'ensemble de lignes est trié sur CATALOG_NAME, SCHEMA_NAME, CUBE_NAME, ACTION_NAME.

[!REMARQUE]

Les action de type MDACTION_TYPE_PROPRIETARY doivent fournir une valeur pour la colonne APPLICATION.

Colonnes de restriction

L'ensemble de lignes MDSCHEMA_ACTIONS peut être restreint sur les colonnes répertoriées dans le tableau suivant.

Nom de la colonne

Indicateur de type

État de la restriction

CATALOG_NAME

DBTYPE_WSTR

Facultative

SCHEMA_NAME

DBTYPE_WSTR

Facultative

CUBE_NAME

DBTYPE_WSTR

Obligatoire

ACTION_NAME

DBTYPE_WSTR

Facultative

ACTION_TYPE

DBTYPE_I4

Facultative

COORDINATE

DBTYPE_WSTR

Obligatoire

COORDINATE_TYPE

DBTYPE_I4

Obligatoire

INVOCATION

DBTYPE_I4

(Facultative) La colonne de restriction INVOCATION a comme valeur par défaut la valeur de MDACTION_INVOCATION_INTERACTIVE. Pour récupérer toutes les actions, utilisez la valeur MDACTION_INVOCATION_ALL dans la colonne de restriction INVOCATION.

CUBE_SOURCE

DBTYPE_UI2

(Facultatif) Bitmap avec l'une des valeurs valides suivantes :

  • 1 CUBE

  • 2 DIMENSION

La restriction par défaut est la valeur 1.

Important

La colonne de restriction INVOCATION a une valeur par défaut de MDACTION_INVOCATION_INTERACTIVE. Tout ensemble de lignes de schéma qui ne spécifie pas explicitement une valeur pour cette colonne contient uniquement des lignes avec cette valeur. Si vous souhaitez que l'ensemble de lignes contienne l'ensemble d'actions entier, utilisez la constante MDACTION_INVOCATION_ALL dans la colonne de restriction INVOCATION.

Les applications clientes peuvent définir plusieurs ACTION_TYPE en utilisant l'opérateur OR.

Notes

Le tableau suivant répertorie les combinaisons COORDINATE et COORDINATE_TYPE valides.

Type d'objet 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