Definição de dados MDX - CREATE ACTION

Cria uma ação que pode ser associada a um cubo, dimensão, hierarquia ou 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 Action_
Uma cadeia de caracteres válida que fornece o nome da ação que está sendo criada.

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

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

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

MDX_Expression
Uma expressão MDX válida.

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

Observações

É possível que os aplicativos cliente criem e executem ações que não são seguras; Também é possível que os aplicativos cliente usem funções inseguras. Para evitar essas situações, use a propriedade Opções de segurança . Para obter mais informações, consulte 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 aberta usando um navegador da Internet. Nota: Se esta ação não começar com https:// ou https://, a ação não estará disponível para o navegador, a menos que SafetyOptions esteja definido para 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 usando um navegador da Internet. Nesse 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 for bem-sucedido, um erro será retornado.
CONJUNTO DE DADOS	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 . O ID de interface solicitado (IID) 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.
CONJUNTO DE LINHAS	Semelhante a DATASET, mas em vez de solicitar um IID de 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.
LINHA DE COMANDO	O aplicativo cliente deve executar a cadeia de caracteres de ação. A cadeia de caracteres é uma linha de comando.
PROPRIETÁRIO	Um aplicativo cliente não deve exibir, nem executar a ação, a menos 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 as solicite explicitamente, 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 invocar a ação. Na verdade, o tipo de invocação não determina 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 está implementado no momento.
LOTE	A ação deve ser invocada pelo aplicativo cliente quando o objeto de destino estiver envolvido em uma operação em lote, conforme determinado pelo aplicativo cliente. Esse tipo de invocação não está implementado no momento.

Âmbito de aplicação

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.

Âmbito do cubo
Para ações independentes de dimensões, membros ou células específicas; por exemplo: "Emulação de terminal de lançamento para o sistema de produção AS/400".

Âmbito da dimensão
A ação aplica-se a uma dimensão específica. Estas ações não dependem de uma seleção específica de níveis ou membros.

Nível de âmbito
A ação aplica-se a um nível de dimensão específica. Estas ações não dependem da seleção específica de um membro nessa dimensão.

Âmbito do membro
A ação aplica-se a membros de nível específico.

Âmbito da célula
A ação aplica-se apenas a células específicas.

Definir âmbito
A ação aplica-se apenas a um conjunto. O nome, ActionParameterSet, é reservado para uso pelo aplicativo dentro da expressão da ação.

Ver também

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