Definição de dados MDX – CREATE ACTION

Cria uma ação que pode ser associada a um cubo, uma dimensão, uma hierarquia ou um objeto subordinado.

Sintaxe

  
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
Uma cadeia de caracteres válida que fornece um nome de cubo.

Nome do Action_
Uma cadeia de caracteres válida que fornece o nome da ação que está sendo criada.

Nome do Hierarchy_
Uma cadeia de caracteres válida que fornece um nome de hierarquia.

Nome do Level_
Uma cadeia de caracteres válida que fornece um nome de nível.

Nome do Member_
Uma cadeia de caracteres válida que fornece um nome ou chave de membro.

MDX_Expression
Uma expressão MDX válida.

String_expression
Uma expressão de cadeia de caracteres válida.

Comentários

Os aplicativos cliente podem criar e executar ações que não são seguras, além de usar funções que não são seguras. Para evitar essas situações, use a propriedade Opções de Segurança . Para obter mais informações, consulte as Propriedade de Opções de Segurança.

Observação

Esta instrução é incluída para compatibilidade com versões anteriores. Não há suporte para ações novas no Analysis Services, como ações de detalhamento ou relatório.

Tipos de ação

A tabela a seguir descreve os diferentes tipos de ações disponíveis no Analysis Services.

Tipo de ação	Descrição
URL	A cadeia de caracteres de ação retornada é uma URL que deve ser aberto usando um navegador de Internet. Observação: se essa ação não começar com https:// ou https://, a ação ficará indisponível para o navegador, a menos que SafetyOptions esteja definido como DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML	A cadeia de caracteres de ação retornada é um script HTML. A cadeia de caracteres deve ser salva em um arquivo e o arquivo deve ser processado com um navegador de Internet. Neste caso, um script inteiro pode ser executado como parte do HTML gerado.
DECLARAÇÃO	A cadeia de caracteres de ação retornada é uma instrução que precisa ser executada definindo o método ICommand::SetText de um objeto de comando para a cadeia de caracteres e chamando o método ICommand::Execute. Se o comando não tiver êxito, um erro será retornado.
DATASET	A cadeia de caracteres de ação retornada é uma instrução MDX que precisa ser executada definindo o método ICommand::SetText de um objeto de comando para a cadeia de caracteres e chamando o método ICommand::Execute . A IID (ID da interface) solicitada deve ser IDataset. O comando terá êxito se um conjunto de dados tiver sido criado. O aplicativo cliente deve permitir que o usuário navegue pelo conjunto de dados retornado.
LINHAS	Semelhante ao DATASET, mas em vez de solicitar um IID do IDataset, o aplicativo cliente deve solicitar um IID de IRowset. O comando terá êxito se um conjunto de linhas tiver sido criado. O aplicativo cliente deve permitir que o usuário navegue pelo conjunto de linhas retornado.
COMMANDLINE	O aplicativo cliente deve executar a cadeia de caracteres de ação. A cadeia de caracteres é uma linha de comando.
PROPRIETÁRIO	O aplicativo cliente não deve exibir nem executar a ação, a não ser que o aplicativo tenha um conhecimento personalizado e não genérico da ação específica. As ações proprietárias não são retornadas ao aplicativo cliente, a menos que o aplicativo cliente solicite explicitamente isso definindo a restrição apropriada no APPLICATION_NAME.

Tipos de invocação

A tabela a seguir descreve os diferentes tipos de invocações disponíveis no Analysis Services. O tipo de invocação é usado somente pelo aplicativo cliente para ajudar a determinar quando a ação deve ser invocada. O tipo de invocação não determina realmente o comportamento de invocação da ação.

Tipo de invocação	Descrição
INTERATIVO	A ação deve ser invocada pelo aplicativo cliente por meio da interação do usuário.
ON_OPEN	A ação deve ser invocada pelo aplicativo cliente quando o objeto de destino é aberto. Esse tipo de invocação não é implementado atualmente.
LOTE	A ação deve ser invocada pelo aplicativo cliente quando o objeto de destino é envolvido em uma operação em lotes, conforme determinado pelo aplicativo cliente. Esse tipo de invocação não é implementado atualmente.

Escopo

Cada ação é definida para um cubo específico e tem um nome exclusivo nesse cubo. Uma ação pode ter um dos escopos listados na tabela a seguir.

Escopo de cubo
Para ações independentes de dimensões, membros ou células específicos; por exemplo, “Lançar emulação terminal para o sistema de produção AS/400”.

Escopo de dimensão
A ação se aplica a uma dimensão específica. Essas ações não dependem da seleção específica de níveis ou membros.

Escopo de nível
A ação se aplica a um nível de dimensão específico. Essas ações não dependem da seleção específica de um membro dessa dimensão.

Escopo de membro
A ação se aplica a membros de nível específicos.

Escopo de célula
A ação se aplica somente a células específicas.

Escopo de conjunto
A ação se aplica somente a um conjunto. O nome , ActionParameterSet, é reservado para uso pelo aplicativo dentro da expressão da ação.

Consulte Também

Instruções de definição de dados MDX (MDX)