Instruction CREATE ACTION (MDX)

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.

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.

É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