Instrucción CREATE ACTION (MDX)

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.

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

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

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

• Member_ Name
  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, utilice la propiedad Safety Options. 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 las acciones nuevas para SQL Server Analysis Services, como Obtención de detalles o Acciones de informe.

Tipos de acción

En la tabla siguiente se describen los distintos tipos de acciones disponibles en Microsoft SQL Server 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 se inicia con http:// o https://, la acción no estará disponible para el explorador a menos que SafetyOptions se establezca en DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML	La cadena de acción que se devuelve es una script HTML. La cadena debe guardarse en un archivo y ese archivo debe representarse mediante un explorador de Internet. En este caso, una script completa debe ejecutarse como parte del HTML generado.
STATEMENT	La cadena de acción devuelta es una instrucción que debe ejecutarse mediante la definición del método ICommand::SetText de un objeto de comando a la cadena y la llamada 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 de MDX que debe ejecutarse mediante la definición del método ICommand::SetText de un objeto de comando a la cadena y la llamada del método ICommand::Execute. El Id. de interfaz (IID) solicitado 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.
ROWSET	Es 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.
PROPRIETARY	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 de propietario no se devuelven a la aplicación cliente a menos que la aplicación cliente lo solicite explícitamente mediante la definición de la restricción adecuada para 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 sólo 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.

Tipos de invocación	Descripción
INTERACTIVE	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.
BATCH	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 sólo se aplica a celdas específicas.

• Ámbito de conjunto
  La acción sólo se aplica a un conjunto. El nombre, ActionParameterSet, se reserva para que la aplicación lo utilice en la expresión de la acción.

Vea también

Otros recursos

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