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