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 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 de membro ou 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 não seguras; também é possível que os aplicativos cliente usem funções não seguras. Para evitar essas situações, use a propriedade Opções de Segurança . Para obter mais informações, consulte a Propriedade Opções de Segurança.

Observação

Essa declaração está 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. 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 renderizado 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.
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.
ROWSET	Semelhante ao DATASET, mas em vez de solicitar uma IID do IDataset, o aplicativo cliente deve solicitar uma IID do 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	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 solicite explicitamente essas ações 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 apenas pelo aplicativo cliente para ajudar a determinar quando invocar a ação. O tipo de invocação realmente 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.

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 do cubo
Para ações independentes de dimensões, membros ou células específicas; por exemplo: "Iniciar emulação de terminal para sistema de produção AS/400".

Escopo da dimensão
A ação se aplica a uma dimensão específica. Essas ações não dependem de uma 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 nessa dimensão.

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

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

Definir escopo
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)