Definición de datos MDX: CREATE ACTION

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

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
Expresión MDX válida.

String_Expression
Expresión de cadena válida.

Observaciones

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

Nota:

Esta instrucción se incluye para la compatibilidad con versiones anteriores. No se admiten las acciones nuevas en Analysis Services, como las acciones 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 devuelta es una dirección URL que se debe abrir 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é establecido en DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML	La cadena de acción devuelta es un script HTML. La cadena debe guardarse en un archivo y el archivo debe representarse mediante un explorador de Internet. En este caso, se puede ejecutar un script completo como parte del CÓDIGO 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 se realiza correctamente, se devuelve un error.
CONJUNTO DE DATOS	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 se ejecuta correctamente si se ha creado un conjunto de datos. La aplicación cliente debe permitir al usuario examinar el conjunto de datos devuelto.
ROWSET	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 se ejecuta correctamente si se ha creado un conjunto de filas. La aplicación cliente debe permitir al usuario examinar 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 lo solicite explícitamente 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 solo usa el tipo de invocación para ayudar a determinar cuándo invocar la acción. El tipo de invocación no determina realmente 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á implementado actualmente.
LOTE	La aplicación cliente debe invocar la acción cuando el objeto de destino participa en una operación por lotes, según lo determine la aplicación cliente. Este tipo de invocación no está implementado actualmente.

Ámbito

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

Ámbito del cubo
Para acciones independientes de dimensiones, miembros o celdas específicas; por ejemplo: "Iniciar emulación de terminal para el sistema de producción AS/400".

Ámbito de dimensión
La acción se aplica a una dimensión específica. Estas acciones no dependen de una 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 una selección específica de un miembro de esa dimensión.

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

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

Establecer ámbito
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.

Véase también

instrucciones de definición de datos MDX (MDX)