Definición de datos de MDX: CREATE ACTION

Crea una acción que puede asociarse con un objeto subordinado, cubo, dimensión, o jerarquía.

Sintaxis

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

Argumentos

Cube_Name
Cadena válida que proporciona un nombre de cubo.

nombre de Action_
Cadena válida que proporciona el nombre de la acción que se va a crear.

nombre de Hierarchy_
Cadena válida que proporciona un nombre de jerarquía.

nombre de Level_
Cadena válida que proporciona un nombre de nivel.

nombre de Member_
Cadena válida que proporciona un nombre de miembro o una clave de miembro.

MDX_Expression
Una expresión MDX válida.

String_Expression
Expresión de cadena válida.

Comentarios

Es posible que las aplicaciones cliente creen y ejecuten acciones que no son seguras; también es posible que las aplicaciones cliente utilicen funciones no seguras. Para evitar estas situaciones, use la propiedad Opciones de seguridad . Para obtener más información, vea el tema sobre la propiedad de opciones de seguridad.

Nota

Esta instrucción se incluye por compatibilidad con versiones anteriores. No se admiten acciones nuevas en Analysis Services, como acciones de obtención de detalles o informes.

Tipos de acción

En la tabla siguiente se describen los distintos tipos de acciones disponibles en Analysis Services.

Tipo de acción	Descripción
URL	La cadena de acción que se devuelve es una dirección URL que debe abrirse mediante un explorador de Internet. Nota: Si esta acción no comienza con https:// o https://, la acción no estará disponible para el explorador a menos que SafetyOptions esté establecida en DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML	La cadena de acción que se devuelve es un script HTML. La cadena debe guardarse en un archivo y ese archivo debe representarse mediante un explorador de Internet. En este caso, un script completo debe ejecutarse como parte del HTML generado.
DECLARACIÓN	La cadena de acción devuelta es una instrucción que debe ejecutarse estableciendo el método ICommand::SetText de un objeto de comando en la cadena y llamando al método ICommand::Execute. Si el comando no ha funcionado, se muestra un error.
DATASET	La cadena de acción devuelta es una instrucción MDX que debe ejecutarse estableciendo el método ICommand::SetText de un objeto de comando en la cadena y llamando al método ICommand::Execute . El identificador de interfaz solicitado (IID) debe ser IDataset. El comando tiene éxito si se ha creado un conjunto de datos. La aplicación cliente debe permitir al usuario explorar el conjunto de datos devuelto.
FILAS	De forma similar a DATASET, pero en lugar de solicitar un IID de IDataset, la aplicación cliente debe solicitar un IID de IRowset. El comando tiene éxito si se ha creado un conjunto de filas. La aplicación cliente debe permitir al usuario explorar el conjunto de filas devuelto.
COMMANDLINE	La aplicación cliente debe ejecutar la cadena de acción. La cadena es una línea de comandos.
PROPIETARIO	Una aplicación cliente no debe mostrar, ni ejecutar la acción a menos que la aplicación tenga un conocimiento personalizado y no genérico de la acción específica. Las acciones propietarias no se devuelven a la aplicación cliente a menos que la aplicación cliente solicite explícitamente estas acciones estableciendo la restricción adecuada en el APPLICATION_NAME.

Tipos de invocación

En la tabla siguiente se describen los distintos tipos de invocaciones disponibles en Analysis Services. La aplicación cliente solamente utiliza el tipo de invocación para ayudar a determinar cuando invocar la acción. El tipo de invocación no determina de hecho el comportamiento de invocación de la acción.

Tipo de invocación	Descripción
INTERACTIVO	La aplicación cliente debe invocar la acción mediante la interacción del usuario.
ON_OPEN	La aplicación cliente debe invocar la acción cuando se abre el objeto de destino. Este tipo de invocación no está implementada actualmente.
LOTE	La aplicación cliente debe invocar la acción cuando el objeto de destino esté relacionado con una operación por lotes, según determine la aplicación cliente. Este tipo de invocación no está implementada actualmente.

Ámbito

Cada acción se define para un cubo específico y tiene un nombre único en ese cubo. Uno de los ámbitos de la acción puede aparecer enumerado en la tabla siguiente.

Ámbito de cubo
Para las acciones con independencia de dimensiones, miembros o celdas concretos; por ejemplo: "Iniciar la emulación de terminal para el sistema de producción de AS/400."

Ámbito de dimensión
La acción se aplica a una dimensión específica. Estas acciones no dependen de la selección específica de niveles o miembros.

Ámbito de nivel
La acción se aplica a un nivel de dimensión específico. Estas acciones no dependen de la selección específica de un miembro de esa dimensión.

Ámbito de miembro
La acción se aplica a miembros de niveles específicos.

Ámbito de celda
La acción solo se aplica a celdas específicas.

Ámbito de conjunto
La acción solo se aplica a un conjunto. El nombre, ActionParameterSet, está reservado para que lo use la aplicación dentro de la expresión de la acción.

Consulte también

Instrucciones de definición de datos de MDX (MDX)