Définition de données MDX - CREATE ACTION

Article
05/23/2023

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.

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

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

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

nom Member_
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.

Remarques

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é Options de sécurité . Pour plus d'informations, consultez la propriété Safety Options.

Notes

Cette instruction est comprise pour des raisons de compatibilité descendante. Les actions nouvelles dans 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	Description
URL	La chaîne d'action retournée est une URL qui doit être ouverte dans un navigateur Internet. Remarque : Si cette action ne commence pas par `https://` ou `https://`, l’action ne sera 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. 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é.
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 é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 la chaîne et en appelant la méthode ICommand::Execute . L’ID d’interface demandé (IID) 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	Comme pour DATASET, mais au lieu de demander un IID d’IDataset, l’application cliente doit demander un IID d’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.
PROPRIÉTAIRE	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, sauf si l’application cliente les demande explicitement en définissant la restriction appropriée sur le APPLICATION_NAME.

Types d'invocations

Le tableau suivant décrit les différents types d’appels 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é.
LOT	Cette action doit être appelée par l'application cliente lorsque l'objet cible est impliqué dans une opération de traitement, 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, est réservé à l’application à l’intérieur de l’expression de l’action.

Voir aussi

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

Partager via