Partager via


Définition de données MDX - CREATE ACTION

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

Les arguments

Cube_Name
Chaîne valide qui fournit un nom de cube.

nom de Action_
Chaîne valide qui fournit le nom de l’action en cours de création.

nom de Hierarchy_
Chaîne valide qui fournit un nom de hiérarchie.

nom de Level_
Chaîne valide qui fournit un nom de niveau.

nom Member_
Chaîne valide qui fournit un nom de membre ou une clé de membre.

MDX_Expression
Expression MDX valide.

String_Expression
Expression de chaîne valide.

Remarques

Il est possible que les applications clientes créent et exécutent des actions non sécurisées ; Il est également possible que les applications clientes utilisent des fonctions non sécurisées. Pour éviter ces situations, utilisez la propriété Options de sécurité . Pour plus d’informations, consultez La propriété Options de sécurité.

Remarque

Cette instruction est incluse pour la compatibilité descendante. Les actions nouvelles d’Analysis Services, telles que les actions d’extraction ou de rapport, ne sont pas prises en charge.

Types d’actions

Le tableau suivant décrit les différents types d’actions disponibles dans Analysis Services.

Type d'action Descriptif
URL La chaîne d’action retournée est une URL qui doit être ouverte à l’aide d’un navigateur Internet.

Remarque : Si cette action ne commence https:// pas ou https://si l’action n’est pas disponible pour le navigateur, sauf si SafetyOptions est défini sur DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML La chaîne d’action retournée est un script HTML. La chaîne doit être enregistrée dans un fichier et le fichier doit être rendu à l’aide d’un navigateur Internet. Dans ce cas, un script entier peut être exécuté dans le cadre du code HTML généré.
DÉCLARATION 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 de commande sur la chaîne et en appelant la méthode ICommand ::Execute . Si la commande ne réussit pas, une erreur est retournée.
JEU DE DONNÉES 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 la chaîne et en appelant la méthode ICommand ::Execute . L’ID d’interface demandé (IID) doit être IDataset. La commande réussit si un jeu de données a été créé. L’application cliente doit autoriser l’utilisateur à parcourir le jeu de données retourné.
ROWSET Similaire à DATASET, mais au lieu de demander un IID d’IDataset, l’application cliente doit demander un IID d’IRowset. La 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. La chaîne est une ligne de commande.
PROPRIÉTAIRE Une application cliente ne doit pas s’afficher ni exécuter l’action, sauf si l’application possède une connaissance personnalisée et non générique de l’action spécifique. Les actions propriétaires ne sont pas retournées à l’application cliente, sauf si l’application cliente les demande explicitement en définissant la restriction appropriée sur le APPLICATION_NAME.

Types d’appel

Le tableau suivant décrit les différents types d’appels disponibles dans Analysis Services. Le type d’appel est utilisé uniquement par l’application cliente pour déterminer quand appeler l’action. Le type d’appel ne détermine pas réellement le comportement d’appel de l’action.

Type d’appel Descriptif
INTERACTIF L’action doit être appelée par l’application cliente par le biais de l’interaction utilisateur.
ON_OPEN L’action doit être appelée par l’application cliente lorsque l’objet cible est ouvert. Ce type d’appel n’est actuellement pas implémenté.
LOT L’action doit être appelée par l’application cliente lorsque l’objet cible est impliqué dans une opération de traitement par lots, comme déterminé par l’application cliente. Ce type d’appel n’est actuellement pas implémenté.

Étendue

Chaque action est définie pour un cube spécifique et a un nom unique dans ce cube. Une action peut avoir l’une des étendues répertoriées dans le tableau suivant.

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

Étendue de dimension
L’action s’applique à une dimension spécifique. Ces actions ne dépendent pas d’une sélection spécifique de niveaux ou de membres.

Étendue de niveau
L’action s’applique à un niveau de dimension spécifique. Ces actions ne dépendent pas de la sélection spécifique d’un membre dans cette dimension.

Étendue du membre
L’action s’applique aux membres de niveau spécifique.

Étendue de cellule
L’action s’applique uniquement aux cellules spécifiques.

Définir l’étendue
L’action s’applique uniquement à un ensemble. Le nom , ActionParameterSet, est réservé à une utilisation par l’application à l’intérieur de l’expression de l’action.

Voir aussi

MDX (Data Definition Statements) MDX