Instruction CREATE ACTION (MDX)

Article
12/15/2008

Mis à jour : 17 juillet 2006

Crée une action qui peut être associée à un cube, une dimension, une hiérarchie ou un objet subordonné.

Syntaxe

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

Arguments

Cube_Name
Chaîne valide qui précise le nom d'un cube.

Action_ Name
Chaîne valide qui fournit le nom d'une action en cours de création.

Hierarchy_ Name
Chaîne valide qui précise le nom d'une hiérarchie.

Level_ Name
Chaîne valide qui précise le nom d'un niveau.

Member_ Name
Chaîne valide qui précise un nom de membre ou une clé de membre.

MDX_Expression
Expression MDX valide.

String_Expression
Expression de chaîne valide.

Notes

Les applications clientes peuvent créer et exécuter des actions qui ne sont pas sûres ; elles peuvent également utiliser des fonctions peu sûres. Pour éviter ces situations, utilisez la propriété Safety Options. Pour plus d'informations, consultez la propriété Safety Options.

Remarque :
Cette instruction est comprise pour des raisons de compatibilité descendante. Les actions nouvelles dans SQL Server 2005 Analysis Services (SSAS), telles que les actions d'extraction ou de rapport, ne sont pas prises en charge.

Types d'actions

Le tableau ci-dessous décrit les différents types d'actions disponibles dans Microsoft SQL Server 2005 Analysis Services (SSAS).

Type d'action

Description

URL

La chaîne d'action retournée est une URL qui doit être ouverte dans un navigateur Internet.

ms144885.note(fr-fr,SQL.90).gif Remarque :

Si cette action ne commence pas par http:// ou https://, l'action ne sera pas disponible dans le navigateur à moins que SafetyOptions ne soit défini sur DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.

HTML

La chaîne d'action retournée est un script HTML. Cette chaîne doit être enregistrée dans un fichier, qui devra être rendu à l'aide d'un navigateur Internet. Dans ce cas, un script entier peut être exécuté en tant que partie du fichier HTML généré.

STATEMENT

La chaîne d'action retournée est une instruction qui doit être exécutée en définissant la méthode ICommand::SetText d'un objet commande sur cette chaîne et en appelant la méthode ICommand::Execute . Si la commande échoue, un message d'erreur est retourné.

DATASET

La chaîne d'action retournée est une instruction MDX qui doit être exécutée en définissant la méthode ICommand::SetText d'un objet de commande sur cette chaîne et en appelant la méthode ICommand::Execute. L'ID d'interface (IID) requise doit être IDataset. Cette commande réussit si un dataset a été créé. L'application cliente doit autoriser l'utilisateur à parcourir le dataset retourné.

ROWSET

Semblable à DATASET, mais au lieu de demander un IID de IDataset, l'application cliente demande un IID de IRowset. Cette commande réussit si un ensemble de lignes a été créé. L'application cliente doit autoriser l'utilisateur à parcourir l'ensemble de lignes retourné.

COMMANDLINE

L'application cliente doit exécuter la chaîne d'action. Cette chaîne est une ligne de commande.

PROPRIETARY

Une application cliente ne doit pas afficher ni exécuter l'action, à moins d'avoir une connaissance personnalisée, non générique, de cette action spécifique. Les actions propriétaires ne sont pas retournées à l'application cliente, à moins que celle-ci ne les demande explicitement en définissant la restriction appropriée sur APPLICATION_NAME.

Types d'invocations

Le tableau ci-dessous décrit les différents types d'invocations disponibles dans Analysis Services. Le type d'invocation n'est utilisé que par l'application cliente pour déterminer à quel moment appeler l'action. Il ne détermine pas réellement le comportement d'invocation de l'action.

Type d'invocation	Description
INTERACTIVE	Cette action doit être appelée par l'application cliente via l'interaction de l'utilisateur.
ON_OPEN	Cette action doit être appelée par l'application cliente lors de l'ouverture de l'objet cible. Ce type d'invocation n'est actuellement pas implémenté.
BATCH	Cette action doit être appelée par l'application cliente lorsque l'objet cible est impliqué dans une opération par lots, comme déterminé par l'application cliente. Ce type d'invocation n'est actuellement pas implémenté.

Étendue

Chaque action est définie pour un cube spécifique et possède un nom unique dans ce cube. Une action peut avoir l'une des étendues répertoriées dans le tableau ci-après.

Étendue de cube
Pour les actions indépendantes de dimensions, membres ou cellules spécifiques ; par exemple : « Lancer l'émulation de terminaux pour un système de production AS/400 ».

Étendue de dimension
Cette action s'applique à une dimension spécifique. Elle ne dépend pas d'une sélection spécifique de niveaux ou de membres.

Étendue de niveau
Cette action s'applique à un niveau de dimension spécifique. Elle ne dépend pas de la sélection spécifique d'un membre dans cette dimension.

Étendue de membre
Cette action s'applique aux membres d'un niveau spécifique.

Étendue de cellule
Cette action s'applique uniquement à des cellules spécifiques.

Étendue de jeu
Cette action s'applique uniquement à un jeu. Le nom, ActionParameterSet, n'est utilisé que par l'application à l'intérieur de l'expression de l'action.

Voir aussi

Autres ressources

Instructions MDX de définition de données (MDX)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Contenu modifié : Mise à jour de la syntaxe et des arguments à des fins d'éclaircissement.

Partager via